Zum Hauptinhalt springen
Wir werden Sie in Kürze zur neuen Abfragesyntax für das Logging migrieren. Dadurch können Sie Ihre Logs effizienter abfragen. Die neue Abfragesyntax wirkt sich auf folgende Logging-Bereiche aus. Schauen Sie sich jeden davon an, um die wichtigsten Änderungen zu sehen: Stellen Sie sicher, dass Sie sich all dieser Änderungen bewusst sind, und kontaktieren Sie den Support, um den Migrationsprozess zu starten.

Abfragesprache

Die Abfragesprache ändert sich in einigen wesentlichen Punkten. Hier sind einige der wichtigsten Änderungen:
  1. Kein attributes.-Präfix mehr — Benutzerdefinierte Attribute können jetzt direkt abgefragt werden. Anstelle von attributes.user_id_int=12345 verwenden Sie einfach user_id=12345.
  2. Keine Typ-Suffixe mehr — Sie müssen _int, _string oder _double nicht mehr an Attributnamen anhängen. Die Abfrage-Engine bestimmt den korrekten Typ automatisch basierend auf dem verwendeten Operator.
  3. Unterstützung für verschachteltes JSON — Fragen Sie verschachtelte Objekte über Punktnotation ab: user.email="user@example.com" und Array-Elemente per Index: user.roles.0=admin.
  4. OR-Logik und Klammern — Erstellen Sie komplexe Abfragen mit expliziten OR-Operatoren und Klammern zur Gruppierung: severity=error AND (hostname=web-1 OR hostname=web-2).
  5. Listensyntax ersetzt — Die Syntax field=[value1, value2] wird durch OR-Anweisungen ersetzt, was flexibler ist und alle Operatoren unterstützt, nicht nur exakte Übereinstimmungen.
Zum Beispiel: Alte Syntax:
message:"API request" attributes.user_id_int=12345 severity=[info, warn]
Neue Syntax:
message:"API request" user.id=12345 (severity=info OR severity=warn)
Für vollständige Details zur neuen Syntax siehe unsere Dokumentation zur Abfragesyntax. Zur Referenz der alten Syntax siehe die Dokumentation zur Legacy-Abfragesyntax.

Gespeicherte Ansichten

Ihre gespeicherten Ansichten werden auf die neue Abfragesyntax aktualisiert. Überprüfen Sie nach der Migration die Ansichten auf etwaige Probleme.

Log-Trigger

Ihre Log-Trigger werden auf die neue Abfragesyntax aktualisiert. Überprüfen Sie nach der Migration die Trigger auf etwaige Probleme. Trigger, die geöffnet waren, werden geschlossen, und Sie erhalten nach der Migration neue Issues.

Langzeitspeicherung

Wir nehmen eine Änderung am Output der Langzeitspeicher-Exporte vor. Anstelle eines Attributfeldes, das eine eindimensionale Map von Attribut-Schlüssel-Wert-Paaren enthält, exportieren wir ein als String formatiertes JSON-Objekt mit allen Attributen. Zum Beispiel: Alter Output:
{
  "timestamp": "1970-01-01 00:04:00.000",
  "source_id": "source-json",
  "hostname": null,
  "group": "group",
  "severity": "info",
  "message": null,
  "attributes": {
    "user.name": "alice",
    "user.id": "123",
    "request_id": "abc-123",
    "status_code": "200",
    "response_time": "45.67",
    "success": "true"
  }
}
Neuer Output:
{
  "timestamp": "1970-01-01 00:04:00.000",
  "hostname": null,
  "group": "group",
  "severity": "info",
  "message": null,
  "source_id": "source-json",
  "attributes": "{\"user\": {\"name\":\"alice\", \"id\":\"123\"},\"request_id\":\"abc-123\",\"status_code\":200,\"response_time\":45.67,\"success\":true}"
}