https://github.com/github/heroku-buildpack-lightstep-satellite

Heroku buildpack to run the lightstep collector in each dyno
https://github.com/github/heroku-buildpack-lightstep-satellite

buildpack heroku heroku-buildpack lightstep lightstep-collector observability tracing

Last synced: about 2 months ago
JSON representation

Heroku buildpack to run the lightstep collector in each dyno

• Host: GitHub
• URL: https://github.com/github/heroku-buildpack-lightstep-satellite
• Owner: github
• License: mit
• Archived: true
• Created: 2021-01-26T18:43:45.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2021-12-08T16:15:02.000Z (almost 3 years ago)
• Last Synced: 2024-09-25T21:09:53.391Z (about 2 months ago)
• Topics: buildpack, heroku, heroku-buildpack, lightstep, lightstep-collector, observability, tracing
• Language: Shell
• Homepage:
• Size: 24.4 KB
• Stars: 5
• Watchers: 4
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

README

        
# 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! :hooray:

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:

- [x] 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](https://elements.heroku.com/buildpacks/github/heroku-buildpack-lightstep-satellite).~

## 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.

- `COLLECTOR_SATELLITE_TYPE_FLAVOR`: **Required** Must be set to `micro`

- `COLLECTOR_SAMPLE_ONE_IN_N`: **Required** Must be set to to a sampling value. Set to `1` to sample all traces.

Additional configuration variables can be found [in LightStep's documentation](https://docs.lightstep.com/docs/docker-install-and-configure-satellites).

## Notes

We'd love [contributions](./CONTRIBUTING.md) 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](https://github.com/github/heroku-buildpack-lightstep-satellite) and let us know what you think!

All discussion should happen on the repo in issues; however, we can also be contacted at `[email protected]` if the need arises.