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

# Traces

> Follow one request from input to response.

A Trace explains one GroundForge request.

## Example

```text theme={null}
WhatsApp message: “What is the weather in Ottawa?”
├─ Channel accepts the message
├─ Agent selects get_weather
├─ Gateway allows get_weather
├─ Tool input: {"city": "Ottawa"}
├─ Tool returns a result
└─ Channel delivers the response
```

Use a Trace to answer:

* Which capability did the Agent choose?
* Which Gateway action was applied?
* Did the capability run?
* Was an Operator Review required?
* Did Agent execution succeed?
* Did Channel delivery succeed?

## CLI examples

```bash theme={null}
gforge traces list --limit 10
gforge traces describe <trace-id> -o yaml
gforge traces spans <trace-id> --limit 100
```

See [Analytics](/concepts/analytics), [Traces in the platform](/observability/traces), and [Request Tracing](/guides/request-tracing).


## Related topics

- [Traces](/observability/traces.md)
- [Discovery and Traces](/cli/observability.md)
- [List Traces](/api-reference/endpoints/list-traces.md)
- [Search Traces](/api-reference/endpoints/search-traces.md)