Traces - GroundForge

A Trace explains one GroundForge request.

Example

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

gforge traces list --limit 10
gforge traces describe <trace-id> -o yaml
gforge traces spans <trace-id> --limit 100

See Analytics, Traces in the platform, and Request Tracing.

Last modified on July 27, 2026