Fly.io

If you’re deploying your app on Fly.io, you can add Subtrace in just a couple of steps. Depending on the kind of Fly builder you’re using, the instructions are different. We’ll use a Python Uvicorn server as an example, but you can do this with any language and framework.

Dockerfile
Buildpacks

Make the following changes to your app’s Dockerfile:

- CMD ["uvicorn", "main:app", "--host", "0.0.0.0"]
+ RUN curl -fsSLO "https://subtrace.dev/download/latest/$(uname -s)/$(uname -m)/subtrace" && chmod +x ./subtrace
+ CMD ["./subtrace", "run", "--", "uvicorn", "main:app", "--host", "0.0.0.0"]

Get a SUBTRACE_TOKEN from the Tokens page on the dashboard and set it as a Fly.io secret:

fly secrets set SUBTRACE_TOKEN=subt_...

Deploy your app as you normally would:

fly deploy

That’s it! You can now visit your app and make some requests to see them automatically appear in the Subtrace dashboard.

If you have a custom buildpack, add this line to its bin/build file to download Subtrace:

curl -fSLO "https://subtrace.dev/download/$(uname -s)/$(uname -m)/subtrace" && chmod +x ./subtrace

Change the command(s) in your fly.toml file to use Subtrace:

# fly.toml

[processes]
-   web = "uvicorn main:app --host 0.0.0.0"
+   web = "./subtrace run -- uvicorn main:app --host 0.0.0.0"

Get a SUBTRACE_TOKEN from the Tokens page on the dashboard and set it as a Fly.io secret:

fly secrets set SUBTRACE_TOKEN=subt_...

Deploy your app as you normally would:

fly deploy

That’s it! You can visit your app and make some requests to see them automatically appear in the Subtrace dashboard.

Getting Started

Platforms

Language guides

Configuration

Tutorials

Advanced

Reference