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

# Exportação OpenTelemetry

> Exporte traces e logs das suas implantações CrewAI AMP para seu próprio coletor OpenTelemetry

O CrewAI AMP pode exportar **traces** e **logs** do OpenTelemetry das suas implantações diretamente para seu próprio coletor. Isso permite que você monitore o desempenho dos agentes, rastreie chamadas de LLM e depure problemas usando sua stack de observabilidade existente.

Os dados de telemetria seguem as [convenções semânticas GenAI do OpenTelemetry](https://opentelemetry.io/docs/specs/semconv/gen-ai/) além de atributos adicionais específicos do CrewAI.

## Pré-requisitos

<CardGroup cols={2}>
  <Card title="Conta CrewAI AMP" icon="users">
    Sua organização deve ter uma conta CrewAI AMP ativa.
  </Card>

  <Card title="Coletor OpenTelemetry" icon="server">
    Você precisa de um endpoint de coletor compatível com OpenTelemetry (por exemplo, seu próprio OTel Collector, Datadog, Grafana ou qualquer backend compatível com OTLP).
  </Card>
</CardGroup>

## Configurando um coletor

1. No CrewAI AMP, vá para **Settings** > **OpenTelemetry Collectors**.
2. Clique em **Add Collector**.
3. Selecione uma integração:
   * **OpenTelemetry Traces** e **OpenTelemetry Logs** — exporte para qualquer coletor ou backend compatível com OTLP.
   * **Datadog** — envie traces diretamente para a ingestão OTLP do Datadog, sem precisar de um coletor separado ou do Datadog Agent.
4. Configure a conexão. Os campos dependem da integração selecionada:

<Tabs>
  <Tab title="OpenTelemetry Traces / Logs">
    **OpenTelemetry Traces** e **OpenTelemetry Logs** são integrações separadas que compartilham os mesmos campos — escolha a que corresponde ao sinal que você quer exportar.

    * **Endpoint** — O endpoint OTLP do seu coletor (por exemplo, `https://otel-collector.example.com:4317`).
    * **Service Name** — Um nome para identificar este serviço na sua plataforma de observabilidade.
    * **Custom Headers** *(opcional)* — Adicione headers de autenticação ou roteamento como pares chave-valor.
    * **Certificate** *(opcional)* — Forneça um certificado TLS se o seu coletor exigir um.

    <Frame>
      <img src="https://mintcdn.com/crewai/e0fGLZYK_rDdsRVj/images/crewai-otel-collector-opentelemetry.png?fit=max&auto=format&n=e0fGLZYK_rDdsRVj&q=85&s=8883e445b99a92062bbfdce66fbb6963" alt="Configuração do coletor OpenTelemetry" width="2780" height="1818" data-path="images/crewai-otel-collector-opentelemetry.png" />
    </Frame>
  </Tab>

  <Tab title="Datadog">
    * **Datadog Site Domain** — Apenas o host OTLP do seu site Datadog, sem protocolo ou caminho. O CrewAI monta o endpoint HTTPS OTLP completo para você. Use o host correspondente ao seu [site Datadog](https://docs.datadoghq.com/getting_started/site/):
      * `otlp.datadoghq.com` (US1)
      * `otlp.us3.datadoghq.com` (US3)
      * `otlp.us5.datadoghq.com` (US5)
      * `otlp.datadoghq.eu` (EU1)
      * `otlp.ap1.datadoghq.com` (AP1)
    * **API Key** — Sua chave de API do Datadog. Veja [como criar uma](https://docs.datadoghq.com/account_management/api-app-keys/#api-keys).

    A integração com o Datadog exporta **traces**.

    <Frame>
      <img src="https://mintcdn.com/crewai/e0fGLZYK_rDdsRVj/images/crewai-otel-collector-datadog.png?fit=max&auto=format&n=e0fGLZYK_rDdsRVj&q=85&s=bb218555702d9375e6f340cf3f48de95" alt="Configuração do coletor Datadog" width="2766" height="2054" data-path="images/crewai-otel-collector-datadog.png" />
    </Frame>
  </Tab>
</Tabs>

5. *(opcional)* Clique em **Test Connection** para verificar se o CrewAI consegue acessar o endpoint com as credenciais fornecidas.
6. Clique em **Save**.

<Tip>
  Você pode adicionar múltiplos coletores — por exemplo, um para traces e outro para logs, ou enviar para diferentes backends para diferentes propósitos.
</Tip>