Pular para o conteúdo principal
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.

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 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.
Configuração do coletor OpenTelemetry
  1. (opcional) Clique em Test Connection para verificar se o CrewAI consegue acessar o endpoint com as credenciais fornecidas.
  2. Clique em Save.
Você pode adicionar múltiplos coletores — por exemplo, um para traces e outro para logs, ou enviar para diferentes backends para diferentes propósitos.