Telemetria

Entendendo os dados de telemetria coletados pelo CrewAI e como eles contribuem para o aprimoramento da biblioteca.

​

Telemetria

Por padrão, não coletamos dados que possam ser considerados informações pessoais segundo a GDPR e outras regulamentações de privacidade. Coletamos nomes das ferramentas e funções dos agentes, portanto, evite incluir qualquer informação pessoal nos nomes das ferramentas ou nas funções dos agentes. Como nenhuma informação pessoal é coletada, não é necessário se preocupar com localidade dos dados. Quando share_crew está ativado, dados adicionais são coletados e podem conter informações pessoais caso sejam incluídas pelo usuário. Usuários devem tomar cuidado ao habilitar este recurso para garantir conformidade com regulamentações de privacidade.

O CrewAI utiliza telemetria anônima para coletar estatísticas de uso com o objetivo principal de aprimorar a biblioteca. Nosso foco está em melhorar e desenvolver as funcionalidades, integrações e ferramentas mais utilizadas pelos usuários.

É fundamental compreender que, por padrão, NENHUM dado pessoal é coletado referente a prompts, descrições de tarefas, histórias ou objetivos dos agentes, uso de ferramentas, chamadas de API, respostas, quaisquer dados processados pelos agentes ou segredos e variáveis de ambiente. Quando o recurso share_crew está ativado, dados detalhados, incluindo descrições das tarefas, histórias ou objetivos dos agentes e outros atributos específicos são coletados para fornecer insights mais detalhados. Essa coleta expandida pode incluir informações pessoais caso o usuário as tenha inserido em seus crews ou tarefas. Usuários devem considerar cuidadosamente o conteúdo de seus crews e tarefas antes de habilitar o share_crew. A telemetria do CrewAI pode ser desabilitada ao definir CREWAI_DISABLE_TELEMETRY como true, 1, yes ou on (qualquer capitalização). OTEL_SDK_DISABLED com os mesmos valores também desabilita o exportador do CrewAI. O SDK do OpenTelemetry em si ainda só reconhece true para desabilitar as demais instrumentações do processo. O rastreamento AMP é tratado em Tracing.

​

Exemplos:

# Desabilitar apenas a telemetria do CrewAI
os.environ['CREWAI_DISABLE_TELEMETRY'] = 'true'

# Desabilitar todo o OpenTelemetry (incluindo CrewAI)
os.environ['OTEL_SDK_DISABLED'] = 'true'

CREWAI_DISABLE_TELEMETRY=1 (ou yes / on) funciona como true. Valores não reconhecidos são ignorados e a telemetria permanece ligada.

​

Isolamento da sua própria configuração do OpenTelemetry

A telemetria do CrewAI roda em seu próprio TracerProvider privado e nunca se registra como o provider global. Isso mantém as duas direções separadas:

• Spans de outras bibliotecas instrumentadas no seu processo — frameworks web, clientes de banco de dados, clientes HTTP — nunca são enviados ao CrewAI.
• Os spans de telemetria do CrewAI nunca são enviados ao seu backend de observabilidade, portanto não aparecerão no Langfuse, Braintrust, Phoenix ou em qualquer outro coletor que você configurar.

As integrações de observabilidade não são afetadas: elas instrumentam o CrewAI por meio do próprio tracer provider, que é independente do descrito aqui.

​

Explicação dos Dados:

Padrão	Dados	Razão e Especificidades
Sim	Versão do CrewAI e Python	Rastreia versões dos softwares. Exemplo: CrewAI v1.2.3, Python 3.8.10. Sem dados pessoais.
Sim	Metadados do Crew	Inclui: chave e ID gerados aleatoriamente, tipo de processo (ex: ‘sequential’, ‘parallel’), flag booleana para uso de memória (true/false), uma flag booleana indicando se alguma entrada foi passada para a execução (true/false — nunca as chaves ou os valores das entradas, que só são coletados quando share_crew está habilitado), quantidade de tarefas, quantidade de agentes. Tudo não pessoal.
Sim	Dados do Agente	Inclui: chave e ID gerados aleatoriamente, nome da função (não deve incluir info pessoal), configurações booleanas (verbose, delegação habilitada, execução de código permitida), máximo de iterações, máximo de RPM, limite de tentativas, info do LLM (ver Atributos LLM), lista de nomes de ferramentas (não deve conter info pessoal). Sem dados pessoais.
Sim	Metadados da Tarefa	Inclui: chave e ID gerados aleatoriamente, configurações de execução booleanas (async_execution, human_input), função e chave do agente associado, lista de nomes de ferramentas. Tudo não pessoal.
Sim	Estatísticas de Uso de Ferramentas	Inclui: nome da ferramenta (não deve incluir info pessoal), número de tentativas de uso (inteiro), atributos LLM utilizados. Sem dados pessoais.
Sim	Dados de Execução de Testes	Inclui: chave e ID aleatórias do crew, número de iterações, nome do modelo usado, score de qualidade (float), tempo de execução (em segundos). Tudo não pessoal.
Sim	Dados do Ciclo de Vida da Tarefa	Inclui: horários de criação, início/fim de execução, identificadores de crew e tarefa, e se a tarefa foi bem-sucedida ou falhou. Quando uma tarefa falha, o nome da classe da exceção é registrado (por exemplo TimeoutError) para que as falhas possam ser contadas e diagnosticadas — nunca a mensagem de erro, que pode conter prompts, saída do modelo, caminhos de arquivos ou credenciais. Armazenado como spans com timestamps. Sem dados pessoais.
Sim	Atributos do LLM	Inclui: nome, model_name, model, top_k, temperatura e nome da classe do LLM. Todos técnicos, sem dados pessoais.
Sim	Criação de Projeto pelo CLI do crewAI	Inclui: o fato de um novo projeto ter sido criado por crewai create, de qual tipo ele é (crew, json_crew ou flow) e o ID de projeto gerado para esse novo projeto e gravado no pyproject.toml dele. É o ID do próprio projeto novo, registrado separadamente do project_id do diretório de onde o comando foi executado — os dois podem diferir. Sem nome de projeto, sem conteúdo de arquivos, sem código. Sem dados pessoais.
Sim	Tentativa de Deploy do Crew pelo CLI do crewAI	Inclui: O fato de um deploy estar sendo realizado e o crew id, se está tentando buscar logs, e se o deploy foi iniciado por um comando do CLI ou pela TUI de execução. Não inclui conteúdo do projeto ou do crew nem dados pessoais.
Sim	Ambiente de Execução	Inclui: qual assistente de código com IA está executando o processo, se houver (um valor de uma lista fixa como claude_code, codex, cursor ou unknown), onde o processo é executado (um valor de uma lista fixa como ci, container, serverless, interactive), o project_id do seu pyproject.toml quando houver um configurado e uma faixa aproximada de tamanho da máquina (uma de 1-2, 3-4, 5-8, 9-16, 17-32, 33+ ou unknown). A faixa é um intervalo, nunca a contagem exata de núcleos — a contagem exata é opcional, em Informações de Ambiente abaixo. A faixa de tamanho vem da contagem de núcleos do host; a detecção do assistente e do local de execução lê apenas se variáveis de ambiente conhecidas estão definidas, nunca seus valores. Sem dados pessoais.
Sim	Sinais de Ciclo de Vida do Flow	Inclui: que um flow iniciou, se foi concluído ou falhou, se um de seus métodos falhou, se pausou para entrada ou feedback humano, se o início foi uma execução retomada, se um turno de conversa falhou, quanto tempo o flow executou, e se o flow é um que a CrewAI executa internamente ou um que você escreveu. O nome do flow é registrado, como já é para criação e execução de flow. Quando um flow ou um de seus métodos falha, o nome da classe da exceção é registrado (por exemplo TimeoutError) para permitir o diagnóstico de falhas — nunca a mensagem de erro, que pode conter prompts, saída do modelo, caminhos de arquivo ou credenciais. Nomes de métodos e estado do flow nunca são registrados. Nenhum dado pessoal.
Sim	Sinal de Compartilhamento de Trace	Inclui: que um lote de traces foi compartilhado com sucesso com o CrewAI AMP, e se foi compartilhado anonimamente (antes de você ter uma conta) ou vinculado à sua conta. Como todo span, também carrega os atributos de Ambiente de Execução descritos acima (project_id quando configurado, o assistente de programação e o runtime). Esta linha descreve apenas a telemetria do compartilhamento — não o conteúdo dos traces nem o acesso concedido por links de traces compartilhados. O conteúdo dos traces, entradas e saídas nunca são registrados neste sinal. Antes de compartilhar traces, revise segredos, dados pessoais e as configurações de redação e retenção do AMP.
Não	Dados Expandidos do Agente	Inclui: descrição do objetivo, texto da história, identificador de arquivo i18n prompt. Usuários devem garantir que não haja info pessoal nesses campos de texto.
Não	Informações Detalhadas da Tarefa	Inclui: descrição da tarefa, descrição do resultado esperado, referências de contexto. Usuários devem garantir que não haja info pessoal nessas áreas.
Não	Informações de Ambiente	Inclui: plataforma, release, sistema, versão e quantidade de CPUs. Exemplo: ‘Windows 10’, ‘x86_64’. Sem dados pessoais.
Não	Entradas e Saídas de Crew e Tarefas	Inclui: parâmetros de entrada e resultados como dados não identificáveis. Usuários devem garantir que não haja info pessoal.
Não	Dados Abrangentes de Execução do Crew	Inclui: logs detalhados das operações do crew, dados de todos os agentes e tarefas, resultado final. Tudo de natureza técnica, sem dados pessoais.

“Não” na coluna “Padrão” indica que esse dado só é coletado quando share_crew está configurado como true.

​

Compartilhamento Avançado de Telemetria (Opt-In)

Usuários podem optar por compartilhar toda a telemetria habilitando o atributo share_crew como True nas configurações do seu crew. Ao habilitar share_crew, há coleta detalhada dos dados de execução do crew e das tarefas, incluindo goal, backstory, context e output das tarefas. Isso permite uma compreensão mais profunda dos padrões de uso.

Se você habilitar o share_crew, os dados coletados podem incluir informações pessoais caso estas estejam presentes nas configurações do crew, descrições de tarefas ou outputs. Os usuários devem revisar cuidadosamente seus dados e garantir conformidade com a GDPR e outras regulamentações de privacidade antes de habilitar esse recurso.