Voltar
Como gerenciar a observability no Kubernetes com o DatadogInstrumentation

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

Avalie este artigo:
Categoria
CEVIU DevOps
Publicado
09 de novembro de 2026
Editoria
CEVIU DevOps

Quer receber mais sobre CEVIU DevOps?

Conteúdo curado diariamente, direto no seu e-mail.

Conteúdo curado diariamenteDiversas categoriasCancele quando quiser