> ## Documentation Index
> Fetch the complete documentation index at: https://arizeai-433a7140-claude-llms-txt-2026-08-12.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# NeMo Agent Toolkit Tracing

> Instrument and observe NVIDIA NeMo Agent Toolkit workflows

Phoenix provides seamless observability and tracing for NVIDIA NeMo Agent Toolkit workflows. This guide walks you through setting up telemetry to view traces in the Phoenix UI.

## Install

Install the Phoenix subpackage to enable tracing capabilities:

```bash theme={null}
uv pip install -e '.[phoenix]'
```

## Setup

<Steps>
  <Step title={<span className="step-title">Start Phoenix</span>}>
    <Card>
      <Tabs>
        <Tab title="Self-Host">
          Run Phoenix on your own infrastructure, backed by PostgreSQL so traces persist beyond a single process. This is the option to reach for once Phoenix is shared across a team or environment.

          The [self-hosting guide](/docs/phoenix/self-hosting) covers [Kubernetes](/docs/phoenix/self-hosting/deployment-options/kubernetes), [Helm](/docs/phoenix/self-hosting/deployment-options/kubernetes-helm), [Railway](/docs/phoenix/self-hosting/deployment-options/railway), [AWS CloudFormation](/docs/phoenix/self-hosting/deployment-options/aws-with-cloudformation), [Google Cloud Run](/docs/phoenix/self-hosting/deployment-options/google-cloud-run), [Azure](/docs/phoenix/self-hosting/deployment-options/azure), and [Render](/docs/phoenix/self-hosting/deployment-options/render), plus authentication and configuration.
        </Tab>

        <Tab title="Local">
          ```bash theme={null}
          uvx arize-phoenix serve
          ```

          No [uv](https://docs.astral.sh/uv/)? `pip install arize-phoenix && phoenix serve` does the same thing. See [Terminal setup](/docs/phoenix/environments#terminal) for customization.
        </Tab>

        <Tab title="Container">
          ```bash theme={null}
          docker run -p 6006:6006 -p 4317:4317 arizephoenix/phoenix:latest
          ```

          Images are published to [Docker Hub](https://hub.docker.com/r/arizephoenix/phoenix). See [Docker](/docs/phoenix/self-hosting/deployment-options/docker) for volumes, PostgreSQL, and other options.
        </Tab>
      </Tabs>

      Phoenix serves its UI and OTLP HTTP on port **6006**, and OTLP gRPC on port **4317**. For a local instance that's [http://localhost:6006](http://localhost:6006) — leave it running while you work.
    </Card>
  </Step>

  <Step title={<span className="step-title">Configure Your Workflow</span>}>
    Update your workflow configuration file to include the telemetry settings. Add the following to your workflow configuration:

    ```yaml theme={null}
    general:
      telemetry:
        tracing:
          phoenix:
            _type: phoenix
            endpoint: http://localhost:6006/v1/traces
            project: my_workflow_project
    ```

    This setup enables tracing through Phoenix at `http://localhost:6006/v1/traces`, with traces grouped into your specified project.
  </Step>
</Steps>

## Run Your Workflow

From the root directory of the NeMo Agent toolkit library, install dependencies and run your workflow:

```bash theme={null}
# Install the workflow and plugins
uv pip install -e examples/observability/simple_calculator_observability/

# Run the workflow with Phoenix telemetry settings
nat run --config_file examples/observability/simple_calculator_observability/configs/config-phoenix.yml --input "What is 1*2?"
```

As the workflow runs, trace data will show up in Phoenix.

## Observe

Open your browser and navigate to `http://0.0.0.0:6006` to view your workflow traces:

* Locate your workflow traces under your project name in projects
* Inspect execution details (latency, tokens, etc.) and run evaluations on your traces

## Resources

<CardGroup>
  <Card title="NVIDIA NeMo Agent Toolkit Documentation" href="https://docs.nvidia.com/nemo/agent-toolkit/latest/workflows/observe/observe-workflow-with-phoenix.html" icon="globe" horizontal description="NeMo toolkit docs" />

  <Card title="NeMo Agent Toolkit Overview" href="https://docs.nvidia.com/nemo/agent-toolkit/latest/index.html" icon="globe" horizontal description="NeMo toolkit overview" />
</CardGroup>