Conecte o Datadog ao DevStats para sincronizar incidentes automaticamente e alimentar as métricas de Change Failure Rate (CFR) e Mean Time to Recovery (MTTR).
Pré-requisitos
Antes de conectar, você precisa de duas credenciais do Datadog e do site correto para a sua organização.
API Key
- No Datadog, acesse Organization Settings > API Keys.
- Clique em New Key, dê um nome (por exemplo,
DevStats) e copie o valor gerado.
Application Key
- No Datadog, acesse Organization Settings > Application Keys.
- Clique em New Key, dê um nome (por exemplo,
DevStats) e copie o valor gerado.
| Escopo | Descrição |
|---|---|
incident_read |
Obrigatório. Sem esse escopo, o DevStats rejeita a conexão com um erro de permissão. |
create_webhooks |
Criar webhooks. |
incident_notification_settings_read |
Ler configurações de notificação de incidentes. |
incident_notification_settings_write |
Atualizar configurações de notificação de incidentes. |
integrations_read |
Ler integrações. |
manage_integrations |
Gerenciar integrações. |
teams_read |
Ler teams. |
teams_manage |
Criar e gerenciar teams. |
Se você vir um erro de "missing scope" durante a configuração, edite a application key no Datadog e confirme que incident_read está habilitado.
Site / Região
Escolha o site do Datadog que corresponde ao local onde os dados da sua organização estão hospedados:
| Site | Região | Quando usar |
|---|---|---|
| US1 (padrão) | Estados Unidos | Maioria das contas, criadas em app.datadoghq.com |
| EU | Europa | Contas criadas em app.datadoghq.eu |
| US3 | Estados Unidos 3 | Contas criadas em us3.datadoghq.com |
| US5 | Estados Unidos 5 | Contas criadas em us5.datadoghq.com |
| AP1 | Ásia-Pacífico | Contas criadas em ap1.datadoghq.com |
Você pode confirmar o seu site verificando a URL que utiliza para acessar o Datadog.
Conectando o Datadog
Passo 1: No DevStats, acesse Settings > Incidents. Selecione Datadog como fonte de dados.
Passo 2: Informe sua API Key, Application Key e escolha o Site / Região correto. Clique em Connect Datadog para validar as credenciais.
Erros de validação
| Erro | Causa | Solução |
|---|---|---|
| Credenciais inválidas | API Key ou Application Key incorreta | Verifique as duas chaves no Datadog |
| Scope ausente | Application Key não possui incident_read |
Edite a chave no Datadog e adicione o scope |
| Falha de conexão | Problema de rede ou firewall | Verifique a conectividade com o endpoint da API do Datadog para o seu site |
Após a validação, o DevStats salva as credenciais e abre o Setup Wizard.
Setup Wizard
O wizard é executado logo após a conexão e configura quais incidentes serão sincronizados e como mapeá-los para seus squads.
Passo 1 — Severidades
O DevStats lista todos os níveis de severidade disponíveis na sua conta do Datadog. Selecione quais devem ser sincronizados como incidentes no DevStats.
| Severidade Datadog | Severidade DevStats |
|---|---|
| SEV-1 | Critical |
| SEV-2 | High |
| SEV-3 | Medium |
| SEV-4 | Low |
| SEV-5 | Low |
| UNKNOWN | Low |
Somente incidentes com as severidades selecionadas serão sincronizados.
Passo 2 — Mapeamento de Teams
Este passo permite mapear teams do Datadog a squads do DevStats.
- O DevStats busca os teams da sua conta Datadog.
- Para cada squad, selecione um team do Datadog ou crie um novo. Cada team pode ser mapeado a apenas um squad.
- Clique em Save & Finish para concluir o wizard.
Incidentes pertencentes a teams sem mapeamento ainda são sincronizados, mas não serão atribuídos a nenhum squad e não aparecerão nos breakdowns de CFR/MTTR por squad.
O que é Sincronizado
Frequência de sincronização
O DevStats executa uma sincronização automática uma vez por dia para cada workspace com a configuração do Datadog completa. A sincronização também é disparada imediatamente ao salvar uma alteração de mapeamento ou ao rotacionar credenciais.
O que é coletado
- Todos os incidentes que correspondem às severidades selecionadas.
- O estado do incidente no momento da sincronização.
- Os timestamps do incidente: data de criação e data de resolução.
- Os teams do incidente, usados para resolver os squads associados.
Mapeamento de estados
| Estado Datadog | Estado DevStats |
|---|---|
| active | Investigating |
| stable | Mitigated |
| resolved | Resolved |
Resolução de squads e repositórios
Quando um incidente é sincronizado, o DevStats consulta os teams no mapeamento configurado, associa os squads correspondentes ao incidente e vincula todos os repositórios desses squads. É essa ligação que conecta um incidente aos deploys que podem tê-lo causado, viabilizando o cálculo do CFR.
Como os Incidentes Alimentam CFR e MTTR
Change Failure Rate (CFR)
CFR = incidentes no período / deploys no período
Um incidente contribui para o CFR de todos os repositórios vinculados aos seus squads associados.
Mean Time to Recovery (MTTR)
MTTR = resolved_at − created_at
Incidentes sem resolved_at são excluídos do MTTR até que sejam resolvidos.
Editando a Integração
Para alterar credenciais, severidades ou o mapeamento de teams, desconecte a integração e refaça a configuração. Os incidentes históricos são preservados.
Desconectando o Datadog
- Acesse Settings > Incidents > Datadog.
- Clique em Delete integration e confirme.
O que é removido: API Key, Application Key, configuração de severidades e mapeamento de teams.
O que é mantido: todos os incidentes já sincronizados. A desconexão não apaga os incidentes sincronizados.
Após a desconexão, nenhum novo incidente será coletado do Datadog. Você pode reconectar a qualquer momento.