The purpose of this repo is to demonstrate how to integrate OpenTelemetry into BEAM applications and collect telemetry from a variety of popular libraries. It also gives us a way to validate that data is getting sent successfully to supported vendor collector back-ends.
To get you started quickly if you want to try running the examples in this repo, we've arranged the example projects using docker-compose. We run all of the following in a self-contained environment, so all you need to have installed is Docker and Docker Compose.
- A Cowboy- and Plug-based API gateway service (just to show distributed tracing)
- A Phoenix-based database-backed application (to show Phoenix and Ecto integration)
- A Postgres database
- A Datadog agent to collect traces and forward them to Datadog APM
First, you'll need to set your API key:
cp datadog.env.example datadog.env
# Modify datadog.env to specify your API keyThen, run all the things:
docker-compose build
docker-compose up -dYou'll be able to hit the gateway service from your development machine at
http://localhost:4000 and the backend service at http://localhost:4001.