> ## Documentation Index
> Fetch the complete documentation index at: https://docs.augmentcode.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Content and privacy

> What Trace Export sends, what it never sends, how content is redacted and limited, and where the data goes.

> [!NOTE]
>
> This feature is in early access and behind a feature flag. Contact your Augment Solutions Architect to enable it for your tenant

## At a glance

| | |
| - | - |
| **Sent by default** | Metadata only: identifiers, timing, status, errors, expert, model and tool names, token counts, credits and cost, and a hash of each model request's system instructions |
| **Off by default** | Prompts and responses, model inputs, tool inputs and outputs, user ID and email |
| **Never sent** | Private model reasoning, credentials Cosmos recognizes, MCP servers' own error text from failed connections, Augment-internal identifiers and infrastructure details |
| **Where it goes** | Only to the destinations your admins configure |
| **What Augment keeps** | No span content. Exported data is held in memory only until it's delivered or dropped. Augment keeps delivery metadata only: delivered and dropped counts for the last hour, the last 20 delivery attempts from the last 24 hours (time, outcome, HTTP status, span count, size and latency), and the time of the last success and the last error |

## Content levels

Every span includes **metadata**, which can't be turned off. An admin can turn on each content level separately in **Settings → Trace Export → Content**. These settings apply to the whole organization and normally take effect within about 30 seconds, on or off. Content already queued or being sent can still arrive during that time. If Cosmos briefly can't read your settings, it keeps using the last settings it read for up to five minutes.

| Level | What it adds | On which spans | Sent as |
| - | - | - | - |
| **Conversation** | The user's prompts and the agent's final response | The agent's turn (`invoke_agent auggie`) | `gen_ai.input.messages`, `gen_ai.output.messages` |
| **Model inputs** | The exact system instructions, messages and tool definitions sent to the model, and the model's output | Each model request (`chat`) | `gen_ai.system_instructions`, `gen_ai.input.messages`, `gen_ai.tool.definitions`, `gen_ai.output.messages` |
| **Tool inputs and outputs** | Tool arguments and results, including file contents and command output the agent saw. Not for subagents' tool calls | Each tool call (`execute_tool`) | `gen_ai.tool.call.arguments`, `gen_ai.tool.call.result` |

Choose levels by what you need:

* **Read what users asked and what the agent answered:** Conversation. This is the smallest content level.
* **Debug why the model did something, or build evaluations from real traffic:** Model inputs. To keep spans small, each model request sends only what changed since the previous one. See [Content attributes](https://docs.augmentcode.com/cosmos/trace-export/reference.md#content-attributes).
* **Debug a failing tool or command:** Tool inputs and outputs. This is usually the largest level, and the most likely to contain source code.

The levels overlap: **Model inputs** contains the conversation and the results of earlier tool calls, because that's what the model is sent. Turning **Tool inputs and outputs** off doesn't keep tool output out of a destination when **Model inputs** is on.

Content attributes hold JSON strings in the shapes the GenAI conventions define. Log events and metrics never contain content.

### Send less content to one destination

A destination can receive fewer content levels than the organization setting, never more. The Trace Export page doesn't have a general control for this yet. Today a destination is narrowed in one case only: when it rejects spans as too large, its problem banner offers **Turn off tool outputs**, which stops sending **Tool inputs and outputs** to that destination alone. Its details then show **This destination receives less content than your organization setting**, and **Use organization setting** removes the narrowing.

To keep content away from a platform, turn the level off for the whole organization, or send to your own OpenTelemetry Collector and remove the content attributes there before forwarding.

## Names and hashes in metadata

Some metadata is derived from your configuration, so treat it as you would your expert and model settings:

* **Expert names** name run spans (`invoke_agent PR Fixer`) and are sent as `gen_ai.agent.name`. **Model picker names**, including custom Prism titles, name model request spans. A name that contains something that looks like a credential isn't sent.
* **`cosmos.system_prompt.hash`** is the SHA-256 of a model request's system instructions, sent at every content level so you can see when a prompt changed without sending the prompt. A hash can't be reversed, but anyone who can guess the exact system instructions can confirm the guess. If your system instructions are short and predictable and that matters, tell your platform's admins.
* **MCP server names** name MCP setup spans (`initialize linear`) and are sent as `cosmos.mcp.server.name`.

## Before content leaves Cosmos

* **Credentials in content are redacted.** These are replaced with `[REDACTED]`, including inside nested JSON:

  * private keys (`-----BEGIN … PRIVATE KEY-----`), bearer tokens, JWTs, and `Authorization`, `Cookie` and `X-API-Key` header values;
  * GitHub and GitLab tokens, AWS access key IDs, Slack tokens, `sk-…` API keys and Google API keys;
  * assignments such as `api_key=…`, `secret: …` or `PASSWORD=…`;
  * values under JSON keys named like credentials (for example `password`, `api_key`, `authorization`, `cookie`, or a name ending in `token`), and `value` fields next to such a name, as in lists of headers or environment variables;
  * user names and passwords in URLs (`https://user:pass@host`);
  * the value of any environment variable in the agent's environment whose name looks like a secret (contains `TOKEN`, `SECRET`, `PASSWORD`, `API_KEY`, `CREDENTIAL`, `PRIVATE_KEY` or `AUTH`) and that is at least 8 characters long, wherever it appears.

  An environment listing, such as the output of `env`, is replaced as a whole.
* **Free-text metadata is scrubbed further.** Error and status text also has email addresses, file paths, home directories, UUIDs and long hex or token-like strings replaced. Free-text attributes are cut to 256 characters and status messages to 1 KB.
* **Private reasoning is removed.** Model thinking and reasoning blocks are never sent.
* **Metadata is checked against an allowlist.** Only the attributes in the [Export reference](https://docs.augmentcode.com/cosmos/trace-export/reference.md) are sent, each in a fixed format.
* **MCP connection failures use fixed messages.** A failed MCP server connection reports one of [17 fixed messages](https://docs.augmentcode.com/cosmos/trace-export/reference.md#mcp-server-failures), never the server's own error text. This covers connecting only: an MCP tool call's result, including an error result, is ordinary content and is sent when **Tool inputs and outputs** or **Model inputs** is on.

The Trace Export page shows how many spans were changed by redaction in the last hour.

> [!WARNING]
>
> Redaction catches common credential formats, not every secret, and enabled content can include other sensitive data such as source code, file contents, customer data in tool output, or personal data in prompts. Turn on only the levels each destination is approved to receive, and apply your platform's access and retention controls.

## Content limits

Content is limited in two steps:

1. **Capture limit, about 120 KB per span.** When a span's content is larger, the agent shortens it before upload: it first cuts every long text value (to 32 KB, then smaller as needed), then keeps fewer items in long lists. Images appear as `[image]`, and JSON nested more than 32 levels deep as `[truncated]`. This limit can't be raised.
2. **Destination limit, Max content size.** Each destination can lower the limit to between 1 and 128 KB. Leave it empty to send everything that was captured. A new Honeycomb destination starts at 50 KB, below Honeycomb's attribute limit.

When content is over a destination's **Max content size**, Cosmos shortens it in this order, keeping the latest turn:

1. Drops tool definitions and system instructions.
2. Drops the earliest input messages.
3. Shortens long text from its end.
4. Drops whole attributes, as a last resort.

Shortened spans carry no marker attribute. With **Model inputs**, shortening a span also breaks [rebuilding full model inputs](https://docs.augmentcode.com/cosmos/trace-export/reference.md#content-attributes) from the chain of linked spans, so leave **Max content size** empty if you rely on that.

Change **Max content size** in these cases:

* **Your platform, or a proxy in front of it, rejects large attributes or requests**, for example with HTTP 413 or by truncating fields: lower it.
* **Long prompts or tool results are cut short** and your platform accepts larger values: leave it empty.

Keep **Max content size** well below **Max request size**. A single span is always sent whole, so a span larger than the endpoint accepts is dropped as **Too large**.

> [!NOTE]
>
> The capture limit is lower than some other agent platforms' defaults. For example, the Claude API sends up to 0.75 MB of content per span by default. Very long model inputs are shortened, so use **Model inputs** to see what changed between requests rather than to archive full prompts.

## User identity

**Include user identity** is an organization setting in the **Content** section, off by default. When it's on, spans, metrics and log events carry `user.id` and `user.email` for the user each session belongs to. Use it for per-user dashboards and chargeback.

Turning it off stops sending both attributes within about 30 seconds and restarts metric totals, so per-user series end cleanly.

## Which sessions are exported

By default, every session in the organization is exported. To export only some, choose **Only selected experts** under **Sessions to export**. See [Choose which sessions to export](https://docs.augmentcode.com/cosmos/trace-export/setup.md#5-choose-which-sessions-to-export).

## Destination credentials

* Header values and the URL's path and query are write-only. After you save, Cosmos shows only the URL's scheme and host, and `••••` for each header value.
* Saved header values are sent only to the host they were entered for. Changing the URL's scheme, host or port requires entering them again.
* Destinations must be public HTTPS endpoints. Cosmos won't send to private, loopback, link-local or reserved addresses, and checks this again on every connection.
* Resource attributes aren't secret. Keys named like credentials are rejected.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.