6d0652d957
chore: Upgrade to last version of classic |
||
---|---|---|
bin | ||
extra | ||
CODE_OF_CONDUCT.md | ||
CONTRIBUTING.md | ||
LICENSE | ||
README.md | ||
SECURITY.md |
README.md
heroku-buildpack-lightstep-satellite
A Heroku buildpack to run a LightStep satellite in each dyno.
Features:
- It runs in the background of each dyno, so you can submit trace data without resorting to using the public satellites! 🎉
Limitations:
- It'll eat up a lot of RAM if you're not careful.
- It cannot bind to default ports, and the debug UI cannot be exposed.
Goals:
- To enable submitting LightStep traces in Heroku without using the public collectors.
- ???
Status: proof-of-concept. We're using it internally, but it's not well-tested.
Installation
For now, you'll need to add this repo as a buildpack to your application. We'll release it on Heroku Elements soon!
~Follow the instructions on the Heroku Elements page.~
Configuration
Configure this buildpack by setting configuration variables for your app. At minimum, you must set:
COLLECTOR_SATELLITE_KEY
: the satellite requires this to function.COLLECTOR_PLAIN_PORT
: the satellite tries to bind to port 80 by default, which will not work with Heroku.
Additional configuration variables can be found in LightStep's documentation.
Notes
We'd love contributions if you have any! We don't have any real roadmap for this buildpack, but we're open to any ideas you may have - file an issue and let us know what you think!
All discussion should happen on the repo in issues; however, we can also be contacted at opensource+heroku-buildpack-lightstep-satellite@github.com
if the need arises.