Back to Docs
Recipe

Datadog Setup

Ship Meridian telemetry to Datadog in under 10 minutes. Real-time dashboards, anomaly alerts, and retention policies tuned for licensing infrastructure.

Prerequisites

  • Datadog account with API key
  • Meridian instance running v2.4+
  • Outbound HTTPS from your Meridian host

Step 1 — Create API Key

In Datadog, navigate to Organization Settings → API Keys. Create a new key scoped to metrics and logs ingestion only.

DD_API_KEY=abc123def456

Step 2 — Configure Meridian

Set the following environment variables on your Meridian host:

MERIDIAN_TELEMETRY_BACKEND=datadog
DD_API_KEY=abc123def456
DD_SITE=datadoghq.com
DD_SERVICE=meridian-prod

Step 3 — Verify Ingestion

Restart Meridian and check the Datadog metrics explorer for the following namespaces:

  • meridian.license.activations
  • meridian.license.validations
  • meridian.hwid.mismatch

Recommended Dashboards

Import the Meridian dashboard template from the dashboards library. It includes activation rate, HWID mismatch spike detection, and geo-distribution heatmaps.

Need help? Open a ticket or ping #engineering in Discord.