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

# Read Your First Trace

> Understand what happened during an agent run without guessing.

A trace is the timeline for one agent run. It connects the request, model, tools, approvals, retries, and result.

## Start at the top

Read the status, trigger, channel, session, model, token usage, and estimated cost. These fields tell you where the run came from and what it used.

## Read the timeline

The timeline shows checkpoints and audit events in order. Look for tool calls, approval decisions, retries, memory activity, schedules, and webhook delivery events.

## Inspect request and response

The request and response panels are redacted. Use them to confirm the input shape and returned data without exposing secrets or sensitive values.

## Common diagnoses

* **Pending approval:** the action is waiting for an operator decision.
* **Repeated failures:** inspect the retry state and the first upstream error.
* **Slow run:** compare latency, model usage, and external tool timing.
* **No tool call:** check that the integration is connected and the capability is included in the bot.
* **Wrong behavior after a deploy:** compare the HiveLang and prompt version hashes with the deployment history.