Datadog-URL-Monitoring: Redirect-Metriken für Kurzlinks

Datadog-URL-Monitoring für Elido-Kurzlinks stammt aus zwei Quellen. Elido selbst sendet Klickdaten: einen Log pro Klick an den Datadog-Logs-Intake sowie drei Klickzahl-Metriken, die alle 60 Sekunden geschrieben werden. Redirect-Latenz oder Statuscodes sendet es nicht. Dafür richten Sie einen Datadog-Synthetics-HTTP-Test auf einen Canary-Kurzlink, und das Redirect-Latenz-Dashboard, die Monitore und das SLO sitzen auf diesem Paar auf.

Diese Aufteilung ist das ganze Design. Die Klickseite sagt Ihnen, wie viele Leute durch Ihre Links gegangen sind und von wo, und die synthetische Seite sagt, ob der Redirect geantwortet hat, wie schnell und mit dem richtigen Status. Dieser Beitrag behandelt die genauen Formen von Metriken und Logs, wie man sie verbindet, was aufs Dashboard gehört und wo es endet.

Wenn Latenz der Grund ist, warum Sie hier sind, lesen Sie zuerst, wie das Budget von p95 unter 15 ms funktioniert. Es erklärt, wie eine gesunde Zahl aussieht, bevor Sie einen Schwellenwert wählen.

Was Elido tatsächlich an Datadog sendet

Jeder Klick in einem verbundenen Workspace nimmt zwei Pfade. Der Log-Pfad schickt einen Batch mit einem Eintrag an https://http-intake.logs.<site>/api/v2/logs, direkt nachdem der Klick erfasst wurde. Der Metrik-Pfad erhöht einen In-Memory-Zähler, und ein Flusher schickt die Zählwerte einmal pro Minute an https://api.<site>/api/v2/series. Beide authentifizieren sich mit dem Header DD-API-KEY.

Die Metriken sind Gauges, und der Wert ist die Zahl der Klicks, die seit dem vorigen Flush gezählt wurden. Ein Punkt mit 37 bedeutet also 37 Klicks in etwa der letzten Minute. Das ist die natürliche Einheit für ein Ops-Diagramm, und es heißt, dass Sie für Summen über die Zeit aufsummieren, statt as_count() anzuwenden. Beachten Sie, was fehlt: Die Metriken tragen weder ein link_id- noch ein slug-Tag. Ich halte das für eine vernünftige Entscheidung bei den Kosten, denn Datadog rechnet Custom Metrics pro eindeutiger Tag-Kombination ab, und ein Slug-Tag bei einem ausgelasteten Workspace würde die Zahl der Serien mit der Zahl der Links multiplizieren.

Der Log trägt link_id ebenfalls als Datadog-Tag, ist mit service:click-ingester und dem Host elido-edge getaggt, das ist also der Dienstname, nach dem Sie filtern. Die Felder kommen verschachtelt unter einem attributes-Objekt an, im Log Explorer sehen die Facetten also wie @attributes.slug und @attributes.country aus. Klappen Sie einen Log auf, bevor Sie etwas bauen. Zehn Sekunden, und es erspart eine kaputte Abfrage.

Datadog in Ihrem Elido-Workspace verbinden

Die Einrichtung besteht aus zwei Feldern. Sie brauchen einen Datadog-API-Key (keinen Application Key) und die Site, auf der Ihre Organisation läuft.

1. Öffnen Sie in Datadog Organization Settings, dann API Keys, und erstellen Sie einen mit einem Namen wie elido-forwarder.
2. Prüfen Sie Ihre Site. Der Datadog-Site-Leitfaden ordnet jede Login-URL ihrer Site zu; app.datadoghq.eu bedeutet, Sie geben datadoghq.eu ein, us5.datadoghq.com bedeutet, Sie geben genau das ein.
3. Öffnen Sie in Elido Integrationen, wählen Sie Datadog, fügen Sie den Key ein, tippen Sie die Site und speichern Sie. Der Key wird im Ruhezustand verschlüsselt.
4. Warten Sie bis zu fünf Minuten, weil der Forwarder Integrationseinstellungen des Workspaces cacht, klicken Sie dann von einem Handy auf einen eigenen Link und suchen Sie im Log Explorer nach source:elido.

Lassen Sie die Site leer, nimmt Elido datadoghq.com an. Für eine EU-Organisation ist das der klassische stille Fehler. Ein Tippfehler bewirkt dasselbe. Jeder POST scheitert, und niemand sieht den Fehler.

Die Schaltfläche Test connection sendet einen Test-Log (markiert mit elido_test: true) an Ihre Datadog-Site und zeigt die Antwort von Datadog, sodass ein falscher Key oder eine falsche Site gleich dort mit Datadogs 403 scheitert. Ein Bestehen beweist, dass der Key funktioniert, nicht dass Ihre Pipelines und Indizes die Logs behalten, der echte Beweis bleibt also ein auftauchender Klick-Log. Dieselbe Regel wie beim Mixpanel-Klick-Forwarder: echter Klick, sonst ist es nicht passiert.

Ein Redirect-Latenz-Dashboard bauen, das den Hop misst

Da Elido keine Zeiten sendet, müssen die Latenzdaten von etwas kommen, das Anfragen stellt. Ein Datadog-Synthetics-HTTP-Test ist das richtige Werkzeug, und er misst, was der Besucher spürt, DNS und TLS eingeschlossen.

Das ist der Test, den ich in jedem Workspace einrichte:

• URL: ein eigener Canary-Link, idealerweise auf Ihrer eigenen Custom Domain, der auf etwas Langweiliges und Stabiles zeigt.
• Redirects folgen: aus. Ist es an, messen Sie Ihre Landingpage, und ein langsames Hero-Bild weckt Sie um 3 Uhr nachts wegen eines Redirects, der in Ordnung war.
• Assertions: Statuscode ist 302 (der Standard; nutzen Sie 301 oder 307, wenn Sie das eingestellt haben, und 301 vs. 302 erklärt den Kompromiss), der Header location enthält Ihr Ziel, und die Antwortzeit liegt unter einem Schwellenwert.
• Standorte: mindestens drei, einer davon in der EU-Region Ihres Publikums. Lassen Sie ihn jede Minute laufen.
• Header: ein User-Agent mit bot, damit Elido die Probe als Bot behandelt und das Klick-Ereignis überspringt.

Wählen Sie den Schwellenwert nach dem, was Sie eine Woche lang beobachten, nicht nach einem Blogbeitrag. Synthetische Zeiten enthalten den eigenen Netzwerkpfad der Probe, eine Probe auf einem anderen Kontinent wird also nie zu einer Zahl innerhalb der Region passen, und das ist in Ordnung. Sie wollen eine Linie, die flach bleibt.

Das Dashboard braucht dann vier Widgets. Antwortzeit nach Standort als Zeitreihe des synthetischen Tests. Assertion-Erfolgsquote. Klicks pro Minute aus elido.clicks. Und eine Top-Liste der Länder.

# 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')

Warum default_zero? Weil eine Minute ohne Klicks gar keinen Punkt erzeugt und Datadog ohne die Interpolationsfunktion eine gerade Linie über die Lücke zieht. Diese Linie lügt.

Monitore für Klickeinbrüche und defekte Kurzlinks

Drei Monitore decken das meiste ab, was bei Links schiefgeht, und jeder nutzt eine andere Quelle, wo sich die Aufteilung aus dem ersten Abschnitt auszahlt.

Redirect defekt oder langsam. Der synthetische Test ist bereits ein Monitor. Alarmieren Sie, wenn zwei oder mehr Standorte im selben Lauf scheitern, damit eine wackelige Proben-Region niemanden weckt. Jede andere Antwort als Ihr 302 scheitert an der Status-Assertion, ein gelöschter, abgelaufener oder pausierter Canary-Link zeigt sich hier also als 404 oder 410.

Traffic gestoppt. Erstellen Sie einen Metrik-Monitor auf sum:elido.clicks{workspace_id:42} und aktivieren Sie die Benachrichtigung bei fehlenden Daten nach, sagen wir, 30 Minuten. Da Elido in einer ruhigen Minute nichts sendet, bedeutet "no data" hier wirklich "keine Klicks", das Ereignis, das Sie während einer Kampagne interessiert.

Traffic ungewöhnlich. Ein Anomalie-Monitor auf derselben Metrik, mit Richtung unterhalb, erwischt eine Kampagne, die normalerweise 4.000 Klicks pro Stunde macht und plötzlich 200. Ich habe dieses Muster dreimal gesehen, und jedes Mal lag die Ursache außerhalb des Links: eine abgelehnte Anzeige, ein Newsletter, der an das falsche Segment ging, ein QR-Poster hinter einem Baugerüst. Geben Sie ihm ein paar Wochen Historie, bevor Sie seinen Bändern vertrauen.

Sie wollen Alarme pro Link? Die Metriken können das nicht, aber die Logs. Erstellen Sie eine logbasierte Metrik aus source:elido, gruppiert nach @attributes.slug, und Sie erhalten eine Klickzahl pro Slug, die Sie überwachen können. Beschränken Sie sich auf einen gefilterten Satz von Kampagnen-Slugs, sonst kommen die Kardinalitätskosten durch die Hintertür zurück.

Ein SLO, das Sie vertreten können

Ein Service Level Objective für einen Kurzlink bedeutet nur etwas, wenn seine Quelle den Redirect misst. Bauen Sie es auf dem synthetischen Test auf. Ein monitorbasiertes SLO mit diesem einen Test als Monitor erledigt das.

Ich würde bei 99,9 % über 30 Tage anfangen. Das sind etwa 43 Minuten fehlgeschlagener Checks im Monat, ein Budget, das Sie einer Marketingleitung in einem Satz erklären können. Bauen Sie es nicht auf dem Klickvolumen auf. Klicks messen Nachfrage, nicht Gesundheit; ein Link, den niemand anklickt, ist vollkommen verfügbar.

Wenn eine flache Linie in diesem SLO-Widget das ist, was Ihnen gefehlt hat, richten Sie einen Workspace ein, richten Sie den Canary auf Ihre eigene Domain und lassen Sie ihn eine Woche laufen, bevor Sie das Ziel festlegen.

Selbst gehostetes Elido: die Redirect-Zähler scrapen

Wenn Sie den Redirect-Dienst selbst betreiben (möglich nur als Enterprise-Vertragsdeployment in Ihrer eigenen Infrastruktur; Elido wird nicht als herunterladbares selbst gehostetes Produkt verkauft), erhalten Sie eine weitere Quelle. Der Redirect-Dienst stellt unter /metrics einen Prometheus-Endpunkt bereit, und der OpenMetrics-Check des Datadog Agent kann ihn scrapen. Die nützliche Serie ist elido_edge_redirect_total, ein Zähler mit den Labels fleet und outcome, wobei die Outcomes ok, notfound, expired, paused, disabled, blocked, capped und error umfassen.

Damit erhalten Sie, was die SaaS-Integration nicht liefert: eine echte 404-Rate über den gesamten Traffic, berechnet als notfound geteilt durch die Gesamtzahl. Ein zweiter Zähler, edge_redirect_clicks_filtered_bot_total, zeigt, wie viele Redirects an Bots ohne Klick-Ereignis ausgeliefert wurden. Ein Latenz-Histogramm gibt es auf diesem Endpunkt allerdings nicht. Die Latenz kommt weiterhin aus Synthetics, selbst gehostet oder nicht. Das k3s-Self-Hosting-Playbook behandelt, wo dieser Endpunkt im Deployment sitzt.

Wo die Datadog-Integration endet

Nun die Grenzen, die zuerst beißen dürften.

Die Zustellung erfolgt nach bestem Bemühen und kommt aus der Klick-Pipeline, kann dem Redirect also einen Moment hinterherhinken. Ein fehlgeschlagener Log-POST wird nach einer Sekunde einmal wiederholt und dann verworfen. Ein fehlgeschlagener Metrik-Flush wird gar nicht wiederholt; diese Minute ist weg, und das nächste Fenster beginnt sauber. Behandeln Sie elido.clicks als Trendlinie und gleichen Sie Summen mit Elidos eigener Klick-Analytics ab, die der maßgebliche Nachweis ist.

Die Logs tragen die Besucher-IP und die vollständige Ziel-URL, UTM-Tags eingeschlossen. Liegt Ihre Datadog-Organisation in den USA, sind das personenbezogene Daten, die die EU verlassen, und der Leitfaden zur EU-Datenresidenz für Marketingteams zeigt, wie man das abwägt. Wählen Sie mindestens die EU-Site, wenn Sie eine haben.

Die Log-Kosten wachsen mit den Klicks, ein erfasster Log pro Klick. Ein viraler Link macht eine virale Rechnung. Ausschlussfilter oder eine logbasierte Metrik mit einem Index kurzer Aufbewahrung halten sie im Rahmen.

Und der Umfang sind Klicks. Keine Link-Erstellungs-Ereignisse, keine Conversions, keine Latenz, keine Statuscodes. Ehrlich gesagt bin ich nicht sicher, ob ein Klick-Forwarder überhaupt Latenz tragen sollte; die Probe, die von außen misst, ist ohnehin der ehrlichere Zeuge.

Die oben verlinkten Datadog-Dokuseiten wurden am 2026-10-25 abgerufen. Zum Latenzbudget hinter dem Redirect siehe den Beitrag zu p95 unter 15 ms

Weiterlesen im Blog

• Mixpanel-Link-Tracking - derselbe Klick-Forwarder, auf Produkt-Analytics gerichtet.
• Cache-Strategie für URL-Redirects - warum die Redirect-Latenz so aussieht, wie sie aussieht.
• Strategie gegen Link Rot - was zu tun ist, nachdem der 404-Monitor ausgelöst hat.
• Kurzlink-Klicks vs. GA4-Sitzungen - warum Ihre Klickzahlen und Analytics-Sitzungen voneinander abweichen.
• GA4-Server-Side-Tracking über Redirects - serverseitige Klick-Ereignisse, stattdessen an Google gesendet.
• Klaviyo-Link-Tracking - derselbe Klick-Forwarder, der jeden Klick an Klaviyo sendet.