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

# Overview

<Note>
  **Note:**

  You can use traces only in:

  * watsonx Orchestrate SaaS.
  * watsonx Orchestrate Developer Edition, when you start the server with the `--with-ibm-telemetry` flag. For more information, see [Initializing watsonx Orchestrate Developer Edition server](../developer_edition/manage_local_server#initializing-watsonx-orchestrate-developer-edition-server).
</Note>

Traces give you a high-level view of what happens when an agent receives a request. They visualize the complete path a request takes through the agent, so you can understand agent behavior. A tracer records observations with detailed information about specific operations. Each observation represents a distinct unit of work or activity.

With the watsonx Orchestrate ADK, you can access traces and their observations in two ways:

* [**Using ADK CLI**](./traces_with_cli)

  Run the `orchestrate observability traces` command to retrieve traces from your active environment.

* [**Using a Python script**](./traces_with_python)

  Use the ADK Python library to write a script that retrieves traces from your watsonx Orchestrate environment.

You can also access traces through the UI and the API. For more information, see [Trace details](https://www.ibm.com/docs/en/watsonx/watson-orchestrate/base?topic=agents-monitoring#trace-details) and [Observability](https://developer.ibm.com/apis/catalog/watsonorchestrate--custom-assistants/api/API--watsonorchestrate--agentops-and-analytics#getTraces).