The purpose of this repo is to demonstrate how to integrate Spandex into a variety of application scenarios you might see in real life. It also gives us a way to easily validate that the right trace and span data is getting sent to the supported back-ends.
For your convenience, we've created named branches that allow you to easily see
what's needed to use Spandex to add tracing to a Plug.Router
or add
tracing to a Phoenix.Endpoint
so that you can get started quickly with
tracing your own projects.
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 key
Then, run all the things:
docker-compose build
docker-compose up -d
You'll be able to hit the gateway
service from your development machine at
http:https://localhost:4000 and the backend
service at http:https://localhost:4001.