Logs senden

So funktioniert der Ingest

• Du sendest Batches per HTTPS an logs.uptimeeye.com, mit einem Ingest-Key.
• Der Key führt zu deiner Organisation; die Zeilen werden im isolierten Tenant deiner Organisation gespeichert.
• Jede Zeile wird zu einem Eintrag mit einer Nachricht, einer Zeit und beliebig vielen Feldern. Kein Schema, keine Index-Konfiguration.
• Etwa eine Sekunde später ist der Eintrag auf der Logs-Seite durchsuchbar; Live-Tail zeigt ihn nach rund 6 s.

Ingest-Keys

Erstell Keys unter API-Keys → Neuer API-Key mit dem Typ „Log-Ingest“. Sie beginnen mit ue_ingest_, werden nur einmal angezeigt und können nur Logs schreiben – ein Management-Key (ue_live_) wird von den Ingest-Endpoints abgelehnt, und ein Ingest-Key kann in deinem Konto nichts lesen oder ändern.

Schick den Key als Bearer-Token oder, für Tools, die nur Benutzer und Passwort kennen, per HTTP Basic Auth (beliebiger Benutzername, der Key als Passwort):

Authorization: Bearer ue_ingest_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
# or
Authorization: Basic base64("key:ue_ingest_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX")

Endpoints

Basis-URL https://logs.uptimeeye.com. Alle Endpoints akzeptieren gzip-komprimierte Bodys (Content-Encoding: gzip) bis 16 MiB unkomprimiert.

Nachricht, Zeit und Felder

Ein Eintrag ist eine flache Menge von String-Feldern. Drei Namen sind besonders; alles andere gehört dir:

Verschachteltes JSON wird zu Namen mit Punkten aufgelöst: {"http":{"status":500}} wird zum Feld http.status. Arrays werden als JSON-Strings gespeichert. Feldnamen unterscheiden Groß- und Kleinschreibung.

Gute Feldhygiene

• Schick immer service und env mit – sie steuern den Bereich „Felder“, die Setup-Beispiele und die meisten Filter.
• Pack Kennungen (order_id, user_id, trace_id) in Felder, nicht in den Nachrichtentext.
• Bleib über alle Services hinweg bei einem Namen pro Konzept (duration_ms, nicht latency hier und took dort).
• Log-Level als kleingeschriebene Wörter (info, warn, error), damit level:error überall funktioniert.

Stream-Felder

Ein Stream ist die Menge der Einträge mit denselben Werten der Stream-Felder – etwa {service="api", env="prod"}. Streams werden zusammen gespeichert, deshalb ist ein Filter darauf (_stream:{...} oder einfach ein angeklickter Wert eines Stream-Felds) der schnellste Weg, eine Suche einzugrenzen, und der Bereich „Felder“ listet Stream-Felder zuerst.

• Wähl sie pro Request mit _stream_fields=service,env (Query-Argument oder Header VL-Stream-Fields). Bis zu 6 Felder; Standard ist service,host.
• Nimm Felder mit wenigen verschiedenen Werten, nach denen du ständig filterst: service, env, namespace, region, host.
• Nimm nie Werte mit hoher Kardinalität (request_id, pod auf einem vollen Cluster, user_id) – jede eindeutige Kombination ist ein eigener Stream.

Ingest-Optionen

Optionen übergibst du bei jedem Endpoint als Query-Argumente oder, für Agents, die die URL nicht setzen können, als Header. Query-Argumente haben Vorrang.

Der Klartext-Endpoint kennt zusätzlich _time_source=ingest und _multiline=off und behandelt jedes Query-Argument ohne Unterstrich als konstantes Feld.

Limits, Kontingent, Aufbewahrung

Response-Codes

Integration wählen

Überprüfen

Öffne Logs, wähl den Zeitraum „15 Min.“ und such nach service:=<your service>. Erscheint nichts, schau im Log des Agents nach dem HTTP-Status seiner letzten Anfrage (siehe Tabelle oben) und nach der Zeit: Ein Agent, dessen Uhr um Minuten falsch geht, legt Zeilen außerhalb des 15-Minuten-Fensters ab – probier „24 Std.“.

Weiter geht es mit Logs durchsuchen.

FAQ