> ## 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.

# Destinations

> Add destinations to the Odigos VM Agent so telemetry can be sent to your backends.

There are two ways to add [destinations](../../../overview#key-concepts) to the Odigos VM Agent: use `odictl` or use YAML files.

<Tabs>
  <Tab title="odictl">
    <Steps>
      <Step title="Launch odictl">
        ```shell theme={null}
        odictl
        ```
      </Step>

      <Step title="Select the destination menu">
        Use `Tab` to focus on the Destinations pane or press `d`, then press `Enter` or click `+ Add Destination` with your mouse.

        <img
          src="https://mintcdn.com/odigos/plx_nD0F6Hp-pnSU/images/vmagent/destination/odictl-destination-select.png?fit=max&auto=format&n=plx_nD0F6Hp-pnSU&q=85&s=3329c50ec1bb32cf13cb21651bcd2f9d"
          alt="Select Destination section of the odictl interface"
          style={{    
      width: "700px",
      height: "auto",
      display: "block",
      margin: "0 auto"
    }}
          width="3378"
          height="1690"
          data-path="images/vmagent/destination/odictl-destination-select.png"
        />
      </Step>

      <Step title="Select a destination">
        Type the name of the destination in the search bar at the top, and/or press `Tab` and scroll through the list
        of destinations. Once your destination is highlighted, press `Enter`.

        <img
          src="https://mintcdn.com/odigos/plx_nD0F6Hp-pnSU/images/vmagent/destination/odictl-destination-type.png?fit=max&auto=format&n=plx_nD0F6Hp-pnSU&q=85&s=22893d4f49ff325f7ec1da58ce1e5238"
          alt="Select Destination"
          style={{    
      width: "700px",
      height: "auto",
      display: "block",
      margin: "0 auto"
    }}
          width="1994"
          height="1760"
          data-path="images/vmagent/destination/odictl-destination-type.png"
        />
      </Step>

      <Step title="Configure destination">
        Set each field according to your destination type. See [Destinations](../../../../enterprise/backends-overview)
        for field details and requirements.

        <Frame caption="Example of an [OTLP http](../../../../enterprise/backends-overview) destination">
          <img
            src="https://mintcdn.com/odigos/plx_nD0F6Hp-pnSU/images/vmagent/destination/odictl-destination-configure.png?fit=max&auto=format&n=plx_nD0F6Hp-pnSU&q=85&s=3b1a539c8a65f182dce90e4ba6acb61b"
            alt="Configure Destination"
            style={{    
        width: "700px",
        height: "auto",
        display: "block",
        margin: "0 auto"
      }}
            width="1994"
            height="1760"
            data-path="images/vmagent/destination/odictl-destination-configure.png"
          />
        </Frame>

        Fill in the required fields. Press `Tab` to navigate to `Apply`, then press `Enter` to save your destination.
      </Step>

      <Step title="Finish adding the destination">
        Select `OK`.

        <img
          src="https://mintcdn.com/odigos/plx_nD0F6Hp-pnSU/images/vmagent/destination/odictl-destination-finish.png?fit=max&auto=format&n=plx_nD0F6Hp-pnSU&q=85&s=ecd34a8da47fbf063603ccf6b68d19d2"
          alt="Complete Adding Destination"
          style={{    
      width: "500px",
      height: "auto",
      display: "block",
      margin: "0 auto"
    }}
          width="1224"
          height="342"
          data-path="images/vmagent/destination/odictl-destination-finish.png"
        />

        Your destination appears in the `Destinations` section in `odictl`.

        <img
          src="https://mintcdn.com/odigos/plx_nD0F6Hp-pnSU/images/vmagent/destination/odictl-destination-end.png?fit=max&auto=format&n=plx_nD0F6Hp-pnSU&q=85&s=8caf2f7cc03385eaad7135d12751c8df"
          alt="Verify Destination"
          style={{    
      width: "700px",
      height: "auto",
      display: "block",
      margin: "0 auto"
    }}
          width="3378"
          height="1690"
          data-path="images/vmagent/destination/odictl-destination-end.png"
        />
      </Step>
    </Steps>
  </Tab>

  <Tab title="YAML">
    <Steps>
      <Step title="Navigate to the /etc/odigos-vmagent/destinations.d folder">
        ```shell theme={null}
        cd /etc/odigos-vmagent/destinations.d
        ```
      </Step>

      <Step title="Create destination YAML file">
        Create a YAML file for your destination's configuration using the editor of your choice. The example below uses [vi](https://en.wikipedia.org/wiki/Vi).

        ```shell theme={null}
        sudo vi example.yaml
        ```
      </Step>

      <Step title="Add the destination configuration">
        Set each field according to your destination type. See [Destinations](../../../../enterprise/backends-overview) for field details and requirements.

        For example:

        ```yaml theme={null}
        - name: otlphttp
          type: otlphttp
          config:
            OTLP_HTTP_COMPRESSION: none
            OTLP_HTTP_ENDPOINT: https://otlp-example.com
            OTLP_HTTP_INSECURE_SKIP_VERIFY: "false"
            OTLP_HTTP_OAUTH2_ENABLED: "false"
            OTLP_HTTP_TLS_ENABLED: "false"
          signals:
            - TRACES
        ```

        <Info>The above is an example of an [OTLP http](../../../../enterprise/backends-overview) destination.</Info>

        <Note>You can define multiple destinations in a single YAML file, and you can organize destinations across multiple YAML files.</Note>
      </Step>

      <Step title="Save the file">
        ```shell theme={null}
        :wq!
        ```
      </Step>

      <Step title="Verify the destination has been added successfully">
        ```shell theme={null}
        sudo journalctl -u odigos-vmagent | grep 'Destination signals configured'
        ```

        ```
        Mar 11 20:50:18 ip-10-0-1-51 odigos-vmagent[611]: time=2026-03-11T20:50:18.401Z level=INFO source=/go/src/github.com/keyval/odigos-vmagent/pkg/components/controller/destination/controller.go:177 msg="Destination signals configured" destination=otlphttp signals=[TRACES]
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>