Deprecated (see below)
Logpusher is now deprecated because there are better solutions. The goal of this tool has always been to enable getting log lines into an Observability system (via the OpenTelemetry collector) in the easiest possible way.
There are now two better ways:
- If you want to send a one-off log line entry to a backend system: Use the webhookevent receiver
- If you have log files that you need to send to a system: Use the filelog receiver
With these two combinations, the requirement for logpusher is effectively zero.
As the original author of this tool, I (@agardnerit) want to thank every contributor to this tool for their time, commitments, ideas and improvements.
Push OpenTelemetry log lines easily to a collector.
Want to do this with OpenTelemetry traces? Try tracepusher. Better still, use them together to correlate logs and traces.
YouTube: logpusher in action with Grafana & Loki.
- Push OpenTelemetry compatible logs from any script, pipeline or process
- Correlate log entries with OpenTelemetry traces
- Send logs from the past with time shifting and/or timestamp
- Add attributes to logs
See try logpusher in-browser without installation.
See download and use logpusher as a standalone binary
See use logpusher as a Python script.
See use logpusher as a docker image.
See run a CI pipeline step as a docker image with logpusher.
See dry run mode flag.
See debug mode flag.
See time shifting.
See OpenTelemetry Collector configuration
Do you use logpusher? Thanks and we'd love to know!
Submit a PR and add your details to ADOPTERS.md
See FAQ.
See Breaking changes
Note: PyInstaller is platform dependent. You must build on whatever platform you wish to run logpusher on.
When logpusher is released, the build_standalone_binaries.yml workflow completes this step and uploads the resulting binaries to S3 where we (currently manually) attach each generated binary to the release notes.
python -m PyInstaller --onefile logpusher.py
Run all build commands from the root directory:
docker buildx build --platform linux/arm64,linux/amd64 --push -t logpusher:dev-ci -f ./docker/ci/Dockerfile .
docker buildx build --platform linux/arm64,linux/amd64 --push -t logpusher:dev -f ./docker/standard/Dockerfile .
Run the test suite:
pytest
All contributions are most welcome!
Get involved:
- Tackle a good first issue
- Create an issue to suggest something new
- File a PR to fix something
Made with contrib.rocks.