Export to Datadog: Forward Future AGI Logs and Metrics

Forward Agent Command Center logs and metrics from Future AGI to Datadog automatically for centralized monitoring and alerting.

📝
TL;DR

Connect your Datadog account and Future AGI will push Agent Command Center request logs and aggregated metrics on every sync cycle. Logs land in Datadog Logs, metrics land in Datadog Metrics.

What this does

This integration exports stored Agent Command Center request logs in each sync window to Datadog, including available model, cache, guardrail and routing fields. It also sends window aggregates for requests, errors, latency, token usage and cost. Sync windows overlap, so exported logs can repeat and summed count metrics can be inflated; do not use them as exact billing or usage totals.

Once in Datadog, you can build dashboards, set up monitors, search logs, and alert on anomalies using data from your LLM gateway.

What gets exported

Logs

Each exported request log includes:

FieldExampleDescription
message[openai] gpt-4o status=200 latency=842ms tokens=1523 cost=$0.02One-line summary
statusinfo or errorBased on whether the request errored
attributes.modelgpt-4oModel used
attributes.provideropenaiProvider
attributes.latency_ms842End-to-end latency
attributes.input_tokens1200Prompt tokens
attributes.output_tokens323Completion tokens
attributes.cost0.02Cost in USD
attributes.cache_hittrueWhether the response was cached
attributes.guardrail_triggeredfalseWhether a guardrail fired

Every log has model, provider, status_code, and gateway tags. The error, cache, guardrail, and routing tags are added when applicable. Error messages may be included in the log summary; review your data handling policy before enabling export.

Metrics

Aggregated over each sync window under the agentcc.gateway.* namespace. These windows overlap by one minute; adding count points across windows can count the same requests, errors, tokens and cost more than once.

MetricTypeDescription
agentcc.gateway.requestscountTotal requests in the window
agentcc.gateway.errorscountFailed requests
agentcc.gateway.latency_msgaugeAverage latency
agentcc.gateway.input_tokenscountTotal prompt tokens
agentcc.gateway.output_tokenscountTotal completion tokens
agentcc.gateway.costcountTotal cost in USD

Before you start

You’ll need:

  • A Datadog account (any plan, including free tier)
  • A Datadog API key, found in Datadog > Organization Settings > API Keys
  • Admin or Owner role in your Future AGI workspace
  • The Agent Command Center set up and receiving traffic

Note

Know which Datadog site/region your account is on (US1, US3, US5, EU1, AP1, or US1-FED). The integration needs this to send data to the right endpoint.


Connect Datadog

Open Integrations

Go to Settings > Integrations in your Future AGI workspace. Click Add Integration or click the Datadog card in the Available Platforms grid.

Integrations settings with Datadog in the available platforms grid

The Integrations page lists Datadog among the available platforms; this view does not show a connected export.

Enter your Datadog credentials

On the Credentials step, fill in:

FieldRequiredDescription
Datadog SiteYesThe region your Datadog account is in. Defaults to US1 (datadoghq.com).
API KeyYesYour Datadog API key.
Application KeyNoOptional Datadog application key.

Click Validate & Continue.

Configure sync settings

Set the sync interval and historical data option.

Sync Interval controls how often Future AGI batches and sends data to Datadog. Every 5 minutes works for most setups. Use 1-2 minutes if you need near real-time visibility.

Historical Data lets you select a backfill start time. Without one, the first sync exports the previous 24 hours. Subsequent sync windows overlap by one minute, so logs and metrics can include repeated data.

Click Connect Integration.

Done

Data starts flowing to Datadog on the next sync cycle. Head to Datadog to verify.


Verify in Datadog

Once the first sync completes:

  • Logs: Go to Datadog > Logs and search for source:agentcc or filter by tags like model:gpt-4o
  • Metrics: Go to Datadog > Metrics Explorer and search for agentcc.gateway.requests

If nothing shows up after 10 minutes, check the sync status in Settings > Integrations and look at the sync history for errors.


Sync status

Monitor your integration from the detail page (Settings > Integrations > click your Datadog connection).

StatusMeaningAction
ActiveExporting on scheduleNone needed
SyncingA batch is being sent right nowWait for it to finish
PausedYou paused the export manuallyClick Resume when ready
ErrorAPI key revoked or Datadog rejected the requestCheck your API key and Datadog site region

Troubleshooting

No logs appearing in Datadog

Check that you selected the correct Datadog site/region. US1 (datadoghq.com) is the default, but if your account is on EU1 (datadoghq.eu) or another region, logs are being sent to the wrong endpoint. Edit the integration and change the site.

Logs appear but metrics are missing

Metrics are only sent when there’s at least one request in the sync window. If your gateway had no traffic during a cycle, no metrics are emitted. Check that the Agent Command Center is actively receiving requests.

Connection shows Error status

This usually means your Datadog API key was revoked or is invalid. Generate a new API key in Datadog > Organization Settings > API Keys, then edit the integration to update it.

High latency or delayed data

Logs are sent in batches of 500. At high request volumes, a sync cycle can take longer to complete. Check the integration’s sync history for errors if data is delayed.


What’s next

Was this page helpful?

Questions & Discussion