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

# Uptrace

> Configuring the Uptrace backend (Managed)

### Getting Started

<img src="https://d15jtxgb40qetw.cloudfront.net/uptrace.svg" alt="uptrace" className="not-prose h-20" />

{/*
  !! Do not remove this comment, this acts as a key indicator in `docs/sync-dest-doc.py` !!
  !! END CUSTOM EDIT !!
*/}

### Configuring Destination Fields

<Accordion title="Supported Signals:">
  ✅ Traces
  ✅ Metrics
  ✅ Logs
  ❌ Profiles
</Accordion>

* **UPTRACE\_DSN** `string` : Data Source Name (DSN).
  * This field is required
* **UPTRACE\_ENDPOINT** `string` : Endpoint. Overwrite Uptrace endpoint when self-hosting
  * This field is optional and defaults to `https://otlp.uptrace.dev:4317`

### Adding Destination to Odigos

There are two primary methods for configuring destinations in Odigos:

##### **Using the UI**

<Steps>
  <Step>
    Use the [Odigos CLI](https://docs.odigos.io/cli/odigos_ui) to access the UI

    ```bash theme={null}
    odigos ui
    ```
  </Step>

  <Step>
    Click on `Add Destination`, select `Uptrace` and follow the on-screen instructions
  </Step>
</Steps>

##### **Using Kubernetes manifests**

<Steps>
  <Step>
    Save the YAML below to a file (e.g. `uptrace.yaml`)

    ```yaml theme={null}
    apiVersion: odigos.io/v1alpha1
    kind: Destination
    metadata:
      name: uptrace-example
      namespace: odigos-system
    spec:
      data:
        UPTRACE_DSN: <Data Source Name (DSN)>
        # Note: The commented fields below are optional.
        # UPTRACE_ENDPOINT: <Endpoint (default: https://otlp.uptrace.dev:4317)>
      destinationName: uptrace
      signals:
      - TRACES
      - METRICS
      - LOGS
      type: uptrace
    ```
  </Step>

  <Step>
    Apply the YAML using `kubectl`

    ```bash theme={null}
    kubectl apply -f uptrace.yaml
    ```
  </Step>
</Steps>
