Datadog lança o DatadogInstrumentation para gerenciar observabilidade no Kubernetes
Aprofundamento CEVIU
Aprofundamento
O DatadogInstrumentation é um custom resource do Kubernetes que reúne em um só manifesto as configurações de checks de integração, coleta de logs e APM de um workload. A Datadog descreve o problema que ele ataca: hoje essas configurações ficam espalhadas. Em anotações de pod, qualquer mudança exige rollout do Deployment. Em arquivos de configuração do Agent, a equipe da aplicação precisa combinar com a equipe de plataforma, que pode ter de reiniciar o Agent.
No exemplo do post, um time de checkout usa o spec.targetRef para apontar o Deployment e o spec.config para definir checks (em YAML estruturado, não JSON embutido), logs e APM. O APM usa Single Step Instrumentation, com ddTraceVersions para escolher o SDK Java e ddTraceConfigs para serviço e ambiente. O Cluster Agent valida o recurso na hora do apply, então configuração inválida faz o kubectl apply devolver erro. As condições ChecksReady, LogsReady e APMReady aparecem no kubectl describe. Mudanças em checks e logs valem em runtime, sem reiniciar aplicação nem Agent. Já tracing e profiling só afetam pods novos, então pedem rollout. Os requisitos são Agent e Cluster Agent v7.85 ou superior, com Datadog Operator v1.31 ou superior ou Helm chart v3.255.0 ou superior.
Por que isso importa
Para quem opera plataforma, a leitura é que o manifesto de observabilidade passa a seguir o mesmo fluxo de pull request e GitOps do Deployment. Isso tira o time de plataforma do caminho em mudanças de tracing e reduz rollouts só para ajustar um check ou uma regra de máscara de logs. O Agent continua sob controle da plataforma, o que mantém a fronteira de responsabilidade. Vale checar as versões mínimas antes de planejar a adoção.
Perguntas frequentes
O que é o DatadogInstrumentation?
É um custom resource do Kubernetes que concentra checks de integração, coleta de logs e configurações de APM de um workload em um único manifesto. Ele é mantido pela equipe da aplicação junto ao Deployment. A Datadog o disponibiliza como lançamento oficial.
Mudar a configuração exige reiniciar a aplicação ou o Agent?
Para checks e logs, não: as mudanças valem em runtime, sem rollout e sem restart do Agent. Para tracing e profiling, a alteração só vale para pods novos, então é preciso um rollout para substituir os existentes.
Quais versões são necessárias?
O exemplo que combina checks, logs e APM exige Datadog Agent e Cluster Agent v7.85 ou superior. Também é preciso Datadog Operator v1.31 ou superior, ou Datadog Helm chart v3.255.0 ou superior. A instalação do CRD é feita por Operator ou Helm.
Como saber se a configuração foi aceita?
O Cluster Agent valida o recurso no apply, e um erro de configuração aparece no kubectl apply. Depois, o kubectl describe mostra as condições ChecksReady, LogsReady e APMReady. Também dá para conferir os dados no próprio Datadog.
Fontes
- datadoghq.comfonte original
- Categoria
- CEVIU DevOps
- Publicado
- 09 de novembro de 2026
- Editoria
- CEVIU DevOps

