mirror of
https://github.com/crewAIInc/crewAI.git
synced 2026-07-29 02:29:31 +00:00
f523a7d029
* docs: udpate docs to reflect new state of OpenTelemetry collector * docs: add OTel collector and Datadog screenshots These images are referenced by the capture_telemetry_logs guides but were missing from the tree, which broke the link checker across all locales. * docs: address PR review on OTel collector guide - Clarify that OpenTelemetry Traces and Logs are separate integrations sharing the same fields (resolves Traces/Logs wording inconsistency) - List regional Datadog OTLP hosts (US1/US3/US5/EU1/AP1) so users outside US5 can copy the right domain
64 lines
3.4 KiB
Plaintext
64 lines
3.4 KiB
Plaintext
---
|
|
title: "Exportação OpenTelemetry"
|
|
description: "Exporte traces e logs das suas implantações CrewAI AMP para seu próprio coletor OpenTelemetry"
|
|
icon: "magnifying-glass-chart"
|
|
mode: "wide"
|
|
---
|
|
|
|
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></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></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>
|