Exportação 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 além de atributos adicionais específicos do CrewAI.

Tip

OpenTelemetry é o caminho de observabilidade recomendado — neutro em relação a fornecedores, funciona com qualquer backend compatível com OTLP (Grafana, Honeycomb, NewRelic, seu próprio coletor). Se você usa especificamente o Datadog, veja o guia dedicado Integração com Datadog, que cobre tanto o caminho do Datadog Agent quanto o ingest OTLP do Datadog.

Pré-requisitos

Conta CrewAI AMP

Sua organização deve ter uma conta CrewAI AMP ativa.

Coletor OpenTelemetry

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

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:

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.

Datadog

Para configurar o Datadog, veja o guia dedicado Integração com Datadog — ele cobre tanto o caminho do Datadog Agent (recomendado, mais barato para volumes altos de log) quanto o ingest OTLP do Datadog, com os passos completos de configuração do coletor.

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.