Fly.io

To integrate with Fly.io, you'll need to stand up HyperDX's Fly log shipper, which extends the functionality of the default Fly log shipper.

This Guide Integrates:  Logs

Getting Started

Create a Log Shipper

# Make a directory for your log shipper app
mkdir hyperdxlogshipper
cd hyperdxlogshipper
 
# Create the app but don't deploy just yet
fly launch --no-deploy --image ghcr.io/hyperdxio/fly-log-shipper:latest

Configure Secrets

# Set required secrets, including your HyperDX API key
fly secrets set ORG=personal # Set to your Fly org id
fly secrets set ACCESS_TOKEN=$(fly auth token)
fly secrets set HYPERDX_API_KEY="<YOUR_API_KEY_HERE>"

Configure the Shipper

Before deploying the log shipper, you'll need to edit the generated fly.toml and remove the [http_service] section entirely and configure or add the entire [[services]] section with:

[[services]]
  http_checks = []
  internal_port = 8686
  auto_stop_machines = false
  auto_start_machines = false
  min_machines_running = 1

To ensure the log shipper will pass health checks and will not scale down.

Deploy the Log Shipper

Then you can deploy the log shipper:

fly deploy --ha=false

We'll need to disable high availability for the log shipper deployment, as we only want a single instance (to prevent duplicate logs from being sent). For an HA setup, you can follow the instructions here (opens in a new tab).

Read more about Fly's log shipper here (opens in a new tab).