This feature is in early access and behind a feature flag. Contact your Augment Solutions Architect to enable it for your tenant
- Open Trace Export.
- Add a destination and test it.
- Check that spans arrive.
- Optional: choose what content to send and which sessions to export.
What you need
- The admin role in a Cosmos organization on an Enterprise or team plan.
- An OTLP/HTTP endpoint that accepts protobuf over HTTPS, at a public host name or public IP address. Cosmos sends from the cloud, so it can’t reach
localhost, private or reserved IP ranges, or internal names such as*.localor*.internal. If you run your own OpenTelemetry Collector, its OTLP/HTTP receiver listens on port 4318 by default. Expose it over HTTPS with a certificate from a public certificate authority. - Credentials for the endpoint, such as an API key, sent as request headers.
Cosmos sends OTLP/HTTP, not OTLP/gRPC. A gRPC endpoint (usually port 4317) doesn’t work.
1. Open Trace Export
In Cosmos, open Settings, then Trace Export in the Organization section. The page lists your destinations, at most five, and the organization-wide Content and Sessions to export settings.2. Add a destination
Click Add Destination (or, before you have any destinations, a provider tile on the page). Pick your platform from the provider list, or paste its endpoint URL into the search box: Cosmos detects the provider and region from the host and opens its form with the endpoint filled in. Providers are grouped into APM & observability, AI & LLM observability and Cloud.- Supported provider
- Custom OTLP
The provider form asks only for what that platform needs, such as its region and API key, and shows where to find each value in the platform. Each field’s hint and the Setup guide link point to the vendor’s own instructions.
- Region, site or zone: pick it from the list. Choose Other… to enter a value that isn’t listed.
- Keys and tokens: paste the bare value. Cosmos adds any required prefix, such as
BearerorApi-Token. - User and secret pairs: for platforms that use HTTP Basic authentication, such as Grafana Cloud and Langfuse, enter both parts. Cosmos encodes them in your browser.
- Fixed headers: headers the platform requires with a documented constant value, such as Datadog’s
compute_stats: true, are added for you.
Send metrics and logs
Turn on Send metrics to also send token, cost, duration and session counts to/v1/metrics. Turn on Send logs to also send run, model, tool and MCP events to /v1/logs. Both are off by default and need a traces URL that ends in /v1/traces. Cosmos replaces only that ending and keeps the rest of the path and the query, so https://otlp-gateway-prod-us-east-0.grafana.net/otlp/v1/traces sends metrics to …/otlp/v1/metrics and logs to …/otlp/v1/logs. For platforms that accept only traces, the provider form disables the switch and says, for example, “Langfuse doesn’t accept OTLP metrics.” For what’s sent, see Metrics and Log events.
Advanced settings
Resource attribute rules:
- Keys start with a letter and use letters, digits,
.,_or-, at most 128 characters. Each key can appear once. - Values are 1 to 256 bytes of UTF-8 without control characters.
service.nameandservice.versionare set by Cosmos and can’t be used.- Keys that look like credentials (containing
key,token,secret,passwordorauth) are rejected. Resource attributes aren’t secret, so put credentials in a header.
Test and save
Click Add destination. Cosmos first tests the connection, then saves and enables the destination if the test passes. To test without saving, click Test connection instead. The test sends one span namedexport_test to your endpoint through the same checks and path as real exports, without content and without retries. If Send metrics or Send logs is on, it also sends an empty request to each of those endpoints, so an endpoint that accepts only traces fails the test instead of silently dropping them.
The Connection test shows each step and where it failed, with a suggested fix:
When the test passes, the destination is saved and enabled. Find the test span in your platform within about 30 seconds by searching for
service.name = augment-cosmos.
If the test fails, click Fix and retry to jump to the field the failure points at, or Save anyway to save the destination as it is. If the test couldn’t run, click Save without testing or Keep editing. You can run 10 tests per minute in an organization.
When you edit a destination, the button is Save. Editing works differently from adding:
- Save tests the connection only if you changed the URL or headers. Other changes, such as the name, are saved without a test.
- Saving keeps the destination’s Enabled setting as it is. Saving a fix to a disabled destination doesn’t enable it; turn on Enabled in Advanced, or use Test and re-enable.
3. Check that spans arrive
- Start a session in Cosmos.
- On the Trace Export page, check the destination’s status. It shows Waiting for the first span until the first delivery, then Healthy. See Destination status.
- In your platform, filter on
service.name=augment-cosmos.
invoke_agent span arrives when the agent finishes responding.
4. Choose what to send
By default, destinations receive only metadata. The Content section adds more for every destination in the organization:- Conversation, Model inputs and Tool inputs and outputs are off by default. Turning one on asks you to confirm. Turning one on or off takes effect within about 30 seconds, so content already being sent can still arrive during that time.
- Include user identity adds the user ID and email to spans, metrics and logs.
5. Choose which sessions to export
Sessions to export sets whose sessions are sent, for every destination:- All sessions: every session in your organization. The default.
- Only selected experts: only sessions started from the experts you select, up to 200. Select Also export sessions not started from an expert to include those too. Use All spaces or a single space to filter the expert list.
Manage destinations
Open a destination’s Actions menu to Edit or test, Disable or Enable, or Delete it. Changes take effect within about 30 seconds.- Header values and the URL path are write-only. After you save, Cosmos shows only the URL’s scheme and host, and
••••for header values. To keep a saved value, leave its field empty when you edit. - Changing the host needs the header values again. If you change the URL’s scheme, host or port, enter every header value again, so saved credentials are never sent to a new host.
- A disabled destination receives nothing. Spans aren’t queued while it’s disabled and aren’t sent after you enable it again.
- Five destinations at most. When you have five, Add Destination is disabled. Delete one to add another.
Next steps
Use your data
Find sessions, count tokens and cost, and set up alerts.
Delivery and troubleshooting
Destination states, delivery errors and limits.