Monitoramento de URL no Datadog: métricas de redirecionamento

O monitoramento de URL no Datadog para links curtos do Elido vem de duas fontes. O próprio Elido envia dados de cliques: um log por clique para o intake de Logs do Datadog, mais três métricas de contagem de cliques enviadas a cada 60 segundos. Ele não envia latência de redirecionamento nem códigos de status. Para isso, você aponta um teste HTTP do Datadog Synthetics para um link curto canário, e o painel de latência de redirecionamento, os monitores e o SLO ficam todos sobre esse par.

Essa divisão é o projeto inteiro. O lado dos cliques diz quantas pessoas passaram pelos seus links e de onde, e o lado sintético diz se o redirecionamento respondeu, com que rapidez e com o status certo. Este post cobre os formatos exatos de métricas e logs, como conectá-los, o que colocar no painel e onde tudo isso termina.

Se a latência é o motivo de você estar aqui, leia primeiro como funciona o orçamento de p95 abaixo de 15ms. Ele explica como é um número saudável antes de você escolher um limiar.

O que o Elido Realmente Envia ao Datadog

Todo clique em um workspace conectado segue dois caminhos. O caminho do log envia um lote de uma única entrada para https://http-intake.logs.<site>/api/v2/logs, logo depois de o clique ser registrado. O caminho das métricas incrementa um contador em memória, e um flusher envia as contagens para https://api.<site>/api/v2/series uma vez por minuto. Ambos se autenticam com o cabeçalho DD-API-KEY.

As métricas são gauges, e o valor é o número de cliques contados desde o envio anterior. Então um ponto de 37 significa 37 cliques no último minuto, aproximadamente. Essa é a unidade natural para um gráfico de operações, e significa que você soma ao longo do tempo para obter totais, em vez de aplicar as_count(). Repare no que falta: não há tag link_id nem slug nas métricas. Eu chamaria isso de uma decisão sensata por custo, porque o Datadog cobra métricas personalizadas por combinação única de tags, e uma tag de slug em um workspace movimentado multiplicaria o número de séries pelo número de links.

O log também leva link_id como tag do Datadog, e vem com a tag service:click-ingester e o host elido-edge, então esse é o nome de serviço para filtrar. Os campos chegam aninhados sob um objeto attributes, então no Log Explorer as facetas ficam como @attributes.slug e @attributes.country. Expanda um log antes de montar qualquer coisa. São dez segundos e evitam uma consulta quebrada.

Conectando o Datadog no Seu Workspace do Elido

A configuração tem dois campos. Você precisa de uma chave de API do Datadog (não uma chave de aplicação) e do site em que a sua organização roda.

1. No Datadog, abra Organization Settings, depois API Keys, e crie uma chamada algo como elido-forwarder.
2. Confira o seu site. O guia de sites do Datadog mapeia cada URL de login para o seu site; app.datadoghq.eu significa que você digita datadoghq.eu, us5.datadoghq.com significa que você digita exatamente isso.
3. No Elido, abra Integrations, escolha Datadog, cole a chave, digite o site e salve. A chave é criptografada em repouso.
4. Espere até cinco minutos, porque o forwarder guarda em cache as configurações de integração do workspace, depois clique em um dos seus próprios links a partir de um celular e procure source:elido no Log Explorer.

Se você deixar o site em branco, o Elido assume datadoghq.com. Para uma organização da UE, essa é a falha silenciosa clássica. Um erro de digitação faz o mesmo. Todo POST falha, e ninguém vê o erro.

O botão Test connection envia um log de teste (marcado com elido_test: true) ao seu site do Datadog e mostra a resposta dele, então uma chave ou um site errado falha ali mesmo, com o 403 do Datadog. Passar prova que a chave funciona, não que os seus pipelines e índices mantêm os logs, então a prova real continua sendo um log de clique aparecendo. Mesma regra do encaminhador de cliques para o Mixpanel: clique real, ou não aconteceu.

Montando um Painel de Latência de Redirecionamento que Mede o Salto

Como o Elido não envia tempos, os dados de latência precisam vir de algo que faz requisições. Um teste HTTP do Datadog Synthetics é a ferramenta certa, e mede o que o visitante sente, incluindo DNS e TLS.

Este é o teste que configuro em todo workspace:

• URL: um link canário dedicado, de preferência no seu próprio domínio personalizado, apontando para algum lugar sem graça e estável.
• Seguir redirecionamentos: desativado. Com ele ativado, você está medindo a sua landing page, e uma imagem hero lenta vai acordá-lo às 3h da manhã por um redirecionamento que estava bem.
• Asserções: o código de status é 302 (o padrão; use 301 ou 307 se foi o que você definiu, e 301 vs 302 explica a troca), o cabeçalho location contém o seu destino e o tempo de resposta fica abaixo de um limiar.
• Locais: pelo menos três, com um na região da UE em que o seu público está. Execute a cada minuto.
• Cabeçalho: um User-Agent contendo bot, para que o Elido trate a sonda como bot e ignore o evento de clique.

Escolha o limiar a partir do que você observar durante uma semana, não a partir de um post de blog. Os tempos sintéticos incluem o caminho de rede da própria sonda, então uma sonda em outro continente nunca vai igualar um número dentro da região, e tudo bem. O que você quer é uma linha que se mantenha plana.

O painel então precisa de quatro widgets. Tempo de resposta por local, como uma série temporal do teste sintético. Taxa de aprovação das asserções. Cliques por minuto de elido.clicks. E uma lista dos principais países.

# Clicks per minute across the workspace (gaps become zeros)
default_zero(sum:elido.clicks{workspace_id:42})

# Hourly click totals
sum:elido.clicks{workspace_id:42}.rollup(sum, 3600)

# Top 10 countries over the dashboard window
top(sum:elido.clicks_by_country{workspace_id:42} by {country}, 10, 'sum', 'desc')

Por que default_zero? Porque um minuto sem cliques não produz ponto algum, e sem a função de interpolação o Datadog traça uma linha reta atravessando a lacuna. Essa linha mente.

Monitores para Quedas de Cliques e Links Curtos Quebrados

Três monitores cobrem a maior parte do que dá errado com links, e cada um usa uma fonte diferente, que é onde a divisão da primeira seção compensa.

Redirecionamento quebrado ou lento. O teste sintético já é um monitor. Alerte quando dois ou mais locais falharem na mesma execução, para que uma região de sonda instável não acorde ninguém. Qualquer resposta diferente do seu 302 falha na asserção de status, então um link canário apagado, expirado ou pausado aparece aqui como um 404 ou um 410.

Tráfego parado. Crie um monitor de métrica em sum:elido.clicks{workspace_id:42} e ative a notificação de dados ausentes depois de, digamos, 30 minutos. Como o Elido não envia nada em um minuto tranquilo, "sem dados" aqui realmente significa "sem cliques", que é o evento que importa durante uma campanha.

Tráfego estranho. Um monitor de anomalia na mesma métrica, com a direção definida como abaixo, pega uma campanha que normalmente faz 4.000 cliques por hora e de repente faz 200. Vi esse padrão três vezes, e em todas a causa estava fora do link: um anúncio reprovado, uma newsletter que foi para o segmento errado, um pôster de QR atrás de um andaime. Dê a ele algumas semanas de histórico antes de confiar nas suas faixas.

Quer alertas por link? As métricas não conseguem, mas os logs conseguem. Crie uma métrica baseada em logs a partir de source:elido agrupada por @attributes.slug, e você obtém uma contagem de cliques por slug que dá para monitorar. Limite-a a um conjunto filtrado de slugs de campanha, ou o custo de cardinalidade volta pela porta dos fundos.

Um SLO que Você Consegue Defender

Um objetivo de nível de serviço (SLO) em um link curto só significa algo se a sua fonte mede o redirecionamento. Construa-o sobre o teste sintético. Um SLO baseado em monitor com esse único teste como monitor resolve.

Eu começaria em 99,9% em 30 dias. Isso dá cerca de 43 minutos de verificações com falha por mês, e é um orçamento que você consegue explicar a um líder de marketing em uma frase. Não o construa sobre o volume de cliques. Cliques medem demanda, não saúde; um link em que ninguém clica está perfeitamente disponível.

Se uma linha plana nesse widget de SLO é o que faltava para você, crie um workspace, aponte o canário para o seu próprio domínio e execute-o por uma semana antes de definir a meta.

Elido Auto-Hospedado: Coletando os Contadores do Redirecionamento

Se você executa o serviço de redirecionamento por conta própria (possível apenas como implementação Enterprise por contrato na sua própria infraestrutura; o Elido não é vendido como produto auto-hospedado para baixar), ganha mais uma fonte. O serviço de redirecionamento expõe um endpoint Prometheus em /metrics, e o check OpenMetrics do Datadog Agent consegue coletá-lo. A série útil é elido_edge_redirect_total, um contador com os rótulos fleet e outcome, em que os resultados incluem ok, notfound, expired, paused, disabled, blocked, capped e error.

Isso dá o que a integração SaaS não dá: uma taxa real de 404 em todo o tráfego, calculada como notfound sobre o total. Um segundo contador, edge_redirect_clicks_filtered_bot_total, mostra quantos redirecionamentos foram servidos a bots sem um evento de clique. Não há, porém, histograma de latência nesse endpoint. A latência continua vindo do Synthetics, auto-hospedado ou não. O playbook de auto-hospedagem em k3s mostra onde esse endpoint fica na implantação.

Onde a Integração com o Datadog Termina

Agora os limites, começando pelos que mais provavelmente vão incomodar.

A entrega é de melhor esforço e vem do pipeline de cliques, então pode ficar um instante atrás do redirecionamento. Um POST de log que falha recebe uma nova tentativa após um segundo e depois é descartado. Um envio de métricas que falha não é repetido de forma alguma; aquele minuto está perdido, e a próxima janela começa limpa. Trate elido.clicks como uma linha de tendência e reconcilie os totais com as próprias análises de cliques do Elido, que são o registro de verdade.

Os logs carregam o IP do visitante e a URL de destino completa, incluindo as tags UTM. Se a sua organização do Datadog está nos EUA, isso é dado pessoal saindo da UE, e o guia de residência de dados na UE para equipes de marketing mostra como ponderar isso. No mínimo, escolha o site da UE se você tiver um.

O custo dos logs cresce com os cliques, um log ingerido para cada um. Um link viral gera uma conta viral. Filtros de exclusão, ou uma métrica baseada em logs combinada com um índice de retenção curta, mantêm isso sob controle.

E o escopo são cliques. Sem eventos de criação de link, sem conversões, sem latência, sem códigos de status. Sinceramente, não tenho certeza de que um encaminhador de cliques deva carregar latência; a sonda que mede de fora é a testemunha mais fiel de qualquer forma.

As páginas de documentação do Datadog linkadas acima foram acessadas em 2026-10-25. Para o orçamento de latência por trás do redirecionamento, veja o post sobre p95 abaixo de 15ms

Relacionados no Blog

• Rastreamento de links com Mixpanel - o mesmo encaminhador de cliques, apontado para análise de produto.
• Estratégia de cache para redirecionamentos de URL - por que a latência do redirecionamento é como é.
• Estratégia de prevenção de link rot - o que fazer depois que o monitor de 404 dispara.
• Cliques em links curtos vs sessões do GA4 - por que as suas contagens de cliques e as sessões de análise divergem.
• Rastreamento server-side do GA4 via redirecionamentos - eventos de clique no servidor, enviados ao Google.
• Rastreamento de links com Klaviyo - o mesmo encaminhador de cliques, enviando cada clique ao Klaviyo.