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. |
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 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. Você pode alterar essa seleção a qualquer momento nas configurações da integração.
Passo 2 — Mapeamento de Services e Teams
Incidentes no Datadog pertencem a services e teams. Este passo permite mapear cada service/team a um squad do DevStats.
- O DevStats busca todos os services e teams da sua conta Datadog.
- Para cada squad no DevStats, selecione quais services e/ou teams do Datadog devem ser mapeados a ele.
- Clique em Save mapping para concluir o wizard.
Incidentes pertencentes a services ou 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. Você pode atualizar o mapeamento a qualquer momento.
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 services e 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 services e 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
Acesse Settings > Incidents > Datadog para atualizar a integração a qualquer momento.
Rotação de credenciais
- Informe a nova API Key e/ou Application Key.
- Opcionalmente, altere o Site / Região.
- Clique em Test connection para validar sem salvar.
- Clique em Save para aplicar as alterações.
Atualizando severidades
Acesse a seção Severities e ative ou desative os níveis desejados. As alterações são aplicadas na próxima sincronização.
Atualizando o mapeamento
Acesse a seção Mapping, ajuste os squads e salve. A próxima sincronização usará o mapeamento atualizado.
Desconectando o Datadog
- Acesse Settings > Incidents > Datadog.
- Clique em Disconnect e confirme.
O que é removido: API Key, Application Key, configuração de severidades e mapeamento de services/teams.
O que é mantido: todos os incidentes já sincronizados. Os dados históricos nunca são apagados.
Após a desconexão, nenhum novo incidente será coletado do Datadog. Você pode reconectar a qualquer momento.