Segments (also known as Journal) is read-only API to acquire information about segments defined via web administration interface.
It provides:
- Segment API for checking members of segments.
- Journal API for acquiring raw events and aggregated statistics about events.
If you have docker installed, you can run
make docker-buildwhich will generate tarball containing amd64 targetted build with swagger.json.
This tarball can be safely used within any Docker image, including alpine or busybox.
If you have Go 1.8+ environment set up, you can run the build manually by running
make buildAs a dependency management tool we're using github.com/golang/dep. We also commit all dependencies into the
repository, so you don't need to rely on our dependency tool of choice. However if you make a commit updating
the dependency, please make sure to run also dep ensure -update to keep stuff consistent.
Once you have your environment variables set or .env file ready, run the built binary.
| variable | example value |
|---|---|
| SEGMENTS_ADDR | :8082 |
| SEGMENTS_DEBUG | true |
| SEGMENTS_MYSQL_NET | tcp |
| SEGMENTS_MYSQL_ADDR | mysql:3306 |
| SEGMENTS_MYSQL_DBNAME | beam |
| SEGMENTS_MYSQL_USER | root |
| SEGMENTS_MYSQL_PASSWD | secret |
| SEGMENTS_ELASTIC_ADDR | http://elasticsearch:9200 |
| SEGMENTS_ELASTIC_USER | elastic |
| SEGMENTS_ELASTIC_PASSWD | secret |