> ## 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.

# Discovery and Traces

> Inspect discovery, changes, runtime mismatches, and request timelines.

## Agent discovery

```bash theme={null}
gforge agents discovery <agent-id>
gforge agents discovery <agent-id> --status
gforge agents observations <agent-id>
gforge agents drifts <agent-id>
```

`discovery` shows the latest tool inventory. `--status` shows progress for a discovery request. Observations and Drifts read saved records; they do not start a new discovery.

## MCP discovery

```bash theme={null}
gforge providers discover <provider-id>
gforge providers inventory <provider-id>
gforge providers discoveries <provider-id> --limit 10
```

## Traces

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

Use the Trace to inspect one request. Use Events when you need callback or lifecycle details around it.

See [Discovery](/concepts/discovery), [Observations](/concepts/observations), and [Drifts](/concepts/drifts) and [Traces](/observability/traces).


## Related topics

- [External Agents](/platform/external-agents.md)
- [CLI Overview](/cli/overview.md)
- [Discovery](/concepts/discovery.md)
- [Traces](/observability/traces.md)