Traceroute-Check

Perstat verfolgt die Route zu einem Host aus bis zu 6 Regionen und zeichnet Hop-Zahl und letzten Hop auf. Weil ein unerreichtes Ziel als eingeschränkt gilt, kombinieren Sie den Monitor mit einem Ping- oder HTTP(S)-Check.

Alle Checktypen traceroute

Die Monitoransicht eines Traceroute-Checks für perstat.io mit 6 Regionen, den Zahlen für Uptime und Checks und einem leeren Antwortzeit-Diagramm. Darunter folgen der Verfügbarkeitsstreifen und die Aufschlüsselung nach Region und IP-Familie.
Auf dieser Seite

Was er prüft

Ein Traceroute-Monitor führt in jedem Intervall aus jeder seiner Regionen das Traceroute des Systems gegen den Host aus. Er sendet ein Paket je Hop mit 2 s Wartezeit und verfolgt in der Voreinstellung bis zu 20 Hops. Das Ergebnis enthält die Hop-Zahl und die letzte Zeile, und das Ziel gilt als erreicht, wenn dieser letzte Hop geantwortet hat. Der Typ misst keine Antwortzeit und fällt kein Verfügbarkeitsurteil. Ein unerreichtes Ziel ist eingeschränkt, nicht ausgefallen, und öffnet nie einen Incident.

Wann Sie ihn einsetzen

  • Ein Ping- oder HTTP(S)-Check daneben schlägt fehl, und Sie wollen je Region aufgezeichnet haben, ob der Weg das Ziel in diesem Moment noch erreicht hat.
  • Ein Host antwortet aus einigen Regionen, aus anderen nicht, und Sie wollen Hop-Zahl und letzten Hop jeder Region in der Aufzeichnung haben.
  • Hop-Zahl und die Zeile des letzten Hops sollen mit jedem Check je Region protokolliert werden, damit eine Routing-Änderung einen Zeitstempel hat.

Ein Traceroute-Ergebnis ist kein Verfügbarkeitsurteil. Ein Ziel, das den letzten Hop filtert, meldet eingeschränkt, nie ausgefallen, und ein unerreichter Weg öffnet keinen Incident. Für die Erreichbarkeit nutzen Sie den Ping-Check, für die Antwort eines Dienstes den HTTP(S)- oder TCP-Check.

Das Monitor-Formular mit Typ Traceroute: Name, Host und der eingeklappte Check-Abschnitt mit Intervall, Regionen und Alarmregel.
Das Traceroute-Formular nimmt einen Host, ohne Port und ohne Bedingungen. Intervall, Regionen und Alarmregel liegen im Check-Abschnitt. Echte Produktoberfläche, Beispieldaten.

Konfiguration

Ziel. Ein Hostname oder eine IP-Adresse, ohne Port. Der Knoten löst die erste Adresse der gewählten Familie über seinen eigenen Resolver auf und prüft sie. Loopback-, private, Link-local- und Cloud-Metadaten-Adressen werden abgewiesen, der Monitor lässt sich also nicht in ein internes Netz richten.

FeldPflichtWerte und VoreinstellungBedeutung
hostHostjaHostname oder IP-AdresseDer Host, zu dem die Route verfolgt wird, eine Adresse je Familie. Der Knoten prüft die erste Adresse dieser Familie gegen die Sperrliste und startet dann Traceroute mit dem Hostnamen, fest auf die Familie gesetzt.
max_hopsoptionalVoreinstellung 20Die Höchstzahl der Hops, an Traceroute als -m übergeben. Sie setzen den Wert über die API oder MCP, ein im Formular angelegter Monitor läuft mit 20.
interval_secondsPrüfintervalloptionalVoreinstellung 300. Angehoben auf die Untergrenze des Tarifs, höchstens 24 hWie oft jede Region den Check ausführt. Das Formular bietet Vorgaben von 30 s bis 1 h, Intervalle von 15 s oder 10 s brauchen MCP.
regionsRegionenoptionalTeilmenge aus na, eu, as, sa, af, oce. Voreinstellung: die ersten n dieser Liste, n = Regionslimit des TarifsWelche Kontinente den Check ausführen. Mehr Regionen, als der Tarif erlaubt, werden abgelehnt, nicht gekürzt.
address_familiesIP-Familienoptional["ipv4"] (Voreinstellung), ["ipv6"] oder ["ipv4", "ipv6"]Verfolgt die Route über eine oder beide Familien, mit je einer Adresse. Bei beiden entscheidet family_fail_severity, was eine Familie bedeutet, die nicht auflöst oder gesperrt ist.

IP-Familien

Die Route wird je IP-Familie verfolgt, mit je einer Adresse, und jede Familie wird ein eigenes Teilergebnis. Eine Familie, deren Adresse nicht auflöst oder gesperrt ist, schlägt fehl. Ist eine von zwei Familien betroffen, entscheidet family_fail_severity. Sind beide betroffen, schlägt der Check fehl. Eine Familie, die auflöst, das Ziel aber nicht erreicht, ist eingeschränkt, und der Check übernimmt das schlechtere der beiden Ergebnisse. Das Formular bietet IPv6 nur an, wenn der Host einen AAAA-Record hat oder ein IPv6-Literal ist. Dann bleiben nur Regionen wählbar, die IPv6 prüfen.

FeldPflichtWerte und VoreinstellungBedeutung
address_familiesoptional["ipv4"] (Voreinstellung), ["ipv6"] oder ["ipv4", "ipv6"]Welche Familien verfolgt werden. Leer oder fehlend bedeutet nur IPv4.
family_fail_severityoptionaldegraded (Voreinstellung) oder failedWas der Ausfall einer von zwei Familien für den Zustand des Monitors bedeutet.

So läuft ein Check ab

  1. Jede Region, deren Intervall fällig ist, löst den Host über den eigenen Resolver des Knotens auf. Sie nimmt die erste Adresse der gewählten Familie und prüft sie gegen die gesperrten Bereiche.
  2. Der Knoten führt das Traceroute des Systems gegen den Host aus, fest auf diese Familie gesetzt. Es nutzt numerische Ausgabe, ein Paket und 2 s Wartezeit je Hop und höchstens max_hops Hops. Der ganze Lauf darf bis zu 20 s dauern, also der größere Wert aus 20 s und dem Zeitlimit des Monitors von 10 s.
  3. Die Ausgabe wird gelesen: Die Kopfzeile fällt weg, die Hop-Zeilen werden gezählt, und die letzte Zeile wird behalten.
  4. Das Ziel gilt als erreicht, wenn die letzte Zeile kein * trägt, der letzte Hop also geantwortet hat. Andernfalls, oder wenn keine Hop-Zeile zurückkam, ist das Ergebnis eingeschränkt.
  5. Das Ergebnis der Region geht an die Control Plane. Die Alarmregel entscheidet dann über ihr Quorum, ob eine fehlgeschlagene Auflösung oder ein gesperrtes Ziel zum Incident wird. Ein eingeschränkter Weg öffnet keinen.
Die Monitoransicht eines Traceroute-Checks für perstat.io mit 6 Regionen, den Zahlen für Uptime und Checks und einem leeren Antwortzeit-Diagramm. Darunter folgen der Verfügbarkeitsstreifen und die Aufschlüsselung nach Region und IP-Familie.
Die Monitoransicht mit 6 Regionen, dem Verfügbarkeitsstreifen und der Aufschlüsselung nach Region und Familie. Die Antwortzeitreihe ist leer, weil der Typ keine aufzeichnet. Der Streifen zeigt eingeschränkt, den Zustand, den dieser Typ meldet, wenn der letzte Hop stumm bleibt. Echte Produktoberfläche, Beispieldaten.

Was ein Ergebnis enthält

Hop-Zahl
Wie viele Hop-Zeilen der Lauf erzeugt hat, je Region und je Familie.
Letzter Hop
Die letzte Zeile der Traceroute-Ausgabe, wörtlich. Sie ist der Hop des Ziels, wenn es erreicht wurde, oder eine *-Zeile, wenn der letzte Hop stumm blieb.
Detailzeile
Eine Zeile je Check mit Hop-Zahl und letztem Hop.
Erreicht oder nicht
Ob der letzte Hop geantwortet hat. Das entscheidet zwischen ok und eingeschränkt.
Region und Familie
Jedes Ergebnis trägt die Region, die es gemessen hat, und ein Teilergebnis je IP-Familie. Es gibt kein Teilergebnis je Adresse oder je Hop, und die vollständige Hop-Liste wird nicht gespeichert.
Antwortzeit und Statuscode
Der Typ zeichnet beides nicht auf, deshalb bleibt das Antwortzeit-Diagramm in der Monitoransicht leer.

Zustände und Schwere

  • okDer letzte Hop hat geantwortet: Das Ziel wurde innerhalb von max_hops erreicht.
  • eingeschränktDie letzte Zeile trägt ein *, das Ziel wurde also nicht erreicht, oder der Lauf lieferte keine Hop-Zeilen. Bei voreingestellter Schwere ist der Check auch eingeschränkt, wenn eine IP-Familie nicht auflöst, während die andere verfolgt wird.
  • ausgefallenDer Host löst nicht auf oder löst auf eine gesperrte Adresse auf. Mit beiden Familien und family_fail_severity auf failed ist der Check auch ausgefallen, wenn eine Familie nicht auflöst. Der Weg selbst erzeugt diesen Zustand nie.
  • FehlerDer Knoten kann den Check nicht ausführen, weil das Traceroute-Programm fehlt oder der Lauf seine Grenze von 20 s überschritten hat. Das zählt als Ausfall mit Schwere critical.

Per Quorum bestätigt: Standardmäßig müssen 2 Regionen den Fehler melden, bevor Perstat einen Incident öffnet. Die Voreinstellung der Organisation verlangt 2 Regionen und 2 aufeinanderfolgende Checks. Ein Monitor kann eine eigene Regel tragen (Anzahl oder Prozent, aufeinanderfolgende Checks, Mindestdauer). Nur ausgefallen und Fehler gehen in die Incident-Bewertung ein, ein unerreichter Weg bleibt also eingeschränkt und öffnet von sich aus nie einen Incident.

Tarife und Grenzen

Kürzestes Intervall
300 s in Free, 60 s in Pulse und 30 s in Sentinel. Command erlaubt 15 s und Enterprise 10 s, beides nur über MCP. Das Formular bietet Vorgaben von 30 s bis 1 h.
Regionen
2 von 6 in Free, 3 von 6 in Pulse und alle 6 ab Sentinel.
Monitore
10 in Free, 50 in Pulse, 150 in Sentinel und 500 in Command. In Enterprise gelten individuelle Kontingente. Das Kontingent zählt über die elf regionalen Checktypen, Agent- und Heartbeat-Monitore haben eigene Kontingente.

Alle Tarifgrenzen vergleichen

Aus der Pipeline oder von einem Agenten

Dieselbe config gilt im Deploy-Schritt, in einem MCP-Client wie Claude Code und im Formular oben. create_monitor braucht einen API-Schlüssel für die ganze Organisation. Wenn Sie regions weglassen, wählt der Tarif seine Voreinstellung.

{
  "name": "Gateway path",
  "type": "traceroute",
  "interval_seconds": 900,
  "config": {
    "host": "gateway.example.com",
    "max_hops": 30,
    "address_families": ["ipv4", "ipv6"],
    "family_fail_severity": "degraded"
  }
}

Jede Schnittstelle mit ihrer Grenze

Grenzen

  • Der Check dient der Diagnose und ist kein Verfügbarkeitssignal, ein unerreichtes Ziel ist also eingeschränkt und öffnet keinen Incident. Der Lauf selbst erzeugt nur dann einen Ausfall, wenn Traceroute nicht starten kann oder die Grenze von 20 s überschreitet. Kombinieren Sie ihn mit dem Ping- oder HTTP(S)-Check.
  • Jeder Hop bekommt ein Paket mit 2 s Wartezeit, die Voreinstellung sind 20 Hops. Der ganze Lauf ist auf 20 s begrenzt.
  • max_hops setzen Sie über die API oder MCP, nicht im Formular.
  • Der Check verfolgt eine Adresse je Familie, ohne Teilergebnisse je Adresse oder je Hop. Über Hop-Zahl und letzte Zeile hinaus wird die Hop-Liste nicht gespeichert.
  • Der Check zeichnet keine Antwortzeit und keinen Statuscode auf.
  • Ziele auf privaten, Loopback-, Link-local- und Cloud-Metadaten-Adressen werden abgewiesen.
  • Nicht jede Region prüft IPv6, deshalb schränkt die Auswahl von ipv6 die nutzbaren Regionen ein.

Alle Checktypen