Logs verwerfen, nachdem Metriken extrahiert wurden

Angenommen, ein Online-Shop schreibt einen Log-Eintrag, jedes Mal wenn ein Kunde seinen Katalog durchsucht. Ein einzelner Eintrag beschreibt eine Suche, während die Anzahl der Einträge über die Zeit größere Veränderungen aufzeigen kann. Wenn die Suchaktivität sinkt, während der gesamte Traffic des Shops stabil bleibt, kann das darauf hindeuten, dass Kunden die Suchfunktion nicht erreichen oder nutzen können. AppSignal kann Metrikdaten aus passenden Log-Zeilen extrahieren, bevor es sie verwirft. Die Metrik bleibt für Dashboards und Trigger verfügbar, aber AppSignal speichert die passenden Zeilen nicht. Aktivieren Sie Drop log line after metric extraction, wenn Sie eine Log-basierte Metrik erstellen oder bearbeiten. AppSignal richtet das Verwerfen für Sie ein. Sie können die zugrunde liegenden Actions auch über AppSignal MCP erstellen, wie im Log-Verarbeitungs-Workflow beschrieben.

So funktioniert es

Wenn eine neue Log-Zeile zu einer gespeicherten Log-basierten Metrik passt, extrahiert AppSignal die Metrikdaten, bevor es die Zeile verwirft. Die Metrik bleibt für Dashboards und Trigger verfügbar, aber die passende Log-Zeile wird nicht gespeichert. Der Schalter erstellt direkt nach der metrics-Action einen zugehörigen Filter mit derselben Abfrage und denselben Log-Quellen. Wenn Sie die Metrik in der AppSignal-UI bearbeiten, aktualisiert AppSignal auch den Filter. Das Deaktivieren des Schalters oder das Löschen der Metrik entfernt den zugehörigen Filter.

Diese Einstellung gilt nur für Logs, die nach ihrer Aktivierung empfangen werden. Sie entfernt keine Logs, die AppSignal bereits gespeichert hat.

Die Data preview im Metrik-Formular und die Logs-Seite verwenden gespeicherte Log-Daten. Sie können weiterhin frühere passende Zeilen anzeigen, enthalten aber keine Zeilen, die nach der Metrik-Extraktion verworfen wurden. Verwenden Sie ein Dashboard, um zu bestätigen, dass die gespeicherte Metrik neue Daten empfängt.

Bevor Sie beginnen

Eine Log-Quelle, die die Zeilen empfängt, die Sie messen möchten
Eine Abfrage, die diese Zeilen matcht
Für den MCP-Weg: AppSignal MCP, eingerichtet in Ihrem AI-Agenten, mit Schreibzugriff auf die Logging-Tools

Über den Schalter aktivieren

Filtern Sie auf der Seite Logs nach den Zeilen, die Sie messen möchten, und öffnen Sie eine davon.
Wählen Sie im Abschnitt Actions die Option Create a metric.
Benennen Sie die Metrik, wählen Sie ihren Typ und prüfen Sie die Data preview. Aktivieren Sie Drop log line after metric extraction, bestätigen Sie mit Drop log lines und wählen Sie Create metric.

Bevor Sie das Verwerfen aktivieren, nutzen Sie die Data preview, um zu bestätigen, dass die Abfrage nur die Zeilen matcht, die Sie verwerfen möchten.

Sie können die Einstellung auch für eine bestehende Metrik aktivieren:

Öffnen Sie die Seite Metrics über das Seitenmenü Logging.
Öffnen Sie das Drei-Punkte-Menü der Metrik und wählen Sie Edit.
Aktivieren Sie Drop log line after metric extraction, bestätigen Sie mit Drop log lines und wählen Sie Update metric.

Das Drei-Punkte-Menü enthält außerdem die Aktionen Add to dashboard, Create trigger und Delete. Die Metrik zeigt jetzt Drop after match in der Spalte Action der Seite Metrics an.

Über AppSignal MCP einrichten

Das MCP-Tool stellt den UI-Schalter nicht bereit. Ihr Agent erstellt stattdessen zwei unabhängige Actions: eine metrics-Action, gefolgt von einem Filter mit derselben Abfrage und denselben Log-Quellen. Da die Actions nicht verknüpft sind, aktualisieren Sie beide, wenn Sie später die Abfrage oder die Quellen ändern. AppSignal verarbeitet Log Line Actions der Reihe nach. Ein Filter verhindert, dass eine passende Zeile spätere Actions erreicht, daher muss die metrics-Action vor dem Filter laufen.

Schritt 1: Eine Metrik aus den Zeilen erfassen

Bitten Sie Ihren Agenten, eine metrics-Action hinzuzufügen. Zum Beispiel, um zu zählen, wie oft Kunden Ihren Katalog durchsuchen:

Füge auf MyStore production eine metrics Log Line Action hinzu, die Log-Zeilen zählt, die auf message:"Type your message here" matchen, als Counter mit dem Namen log.catalog_searches, beschränkt auf die Application-Log-Quelle.

Ihr Agent kann manage_log_line_action aufrufen mit:

{
  "app_name": "MyStore",
  "app_environment": "production",
  "action": "upsert",
  "name": "Catalog search rate",
  "action_type": "metrics",
  "query": "message:"\"Type your message here\"",
  "source_ids": ["<YOUR_LOG_SOURCE_ID>"],
  "log_line_metrics": [
    { "name": "log.catalog_searches", "metric_type": "counter" }
  ]
}

Eine Beschreibung dieser Felder finden Sie in der manage_log_line_action-Referenz.

Schritt 2: Prüfen Sie die Metrik, bevor Sie etwas verwerfen

Nachdem AppSignal passende Zeilen empfangen hat, lesen Sie die Metrik zurück:

Zeige mir den log.catalog_searches-Counter für MyStore production über die letzten 15 Minuten.

Bestätigen Sie, dass der Counter zählt und dass die Abfrage nur die Zeilen matcht, die Sie verwerfen möchten. AppSignal speichert verworfene Zeilen nicht, daher können Sie sie nicht aus AppSignal wiederherstellen.

Schritt 3: Die passenden Zeilen verwerfen

Fügen Sie eine filter-Action mit derselben Abfrage hinzu:

Füge auf MyStore production eine filter Log Line Action hinzu, die Log-Zeilen verwirft, die auf message:"Type your message here" matchen.

{
  "app_name": "MyStore",
  "app_environment": "production",
  "action": "upsert",
  "name": "Drop catalog search logs",
  "action_type": "filter",
  "query": "message:\"Type your message here\"",
  "source_ids": ["<YOUR_LOG_SOURCE_ID>"]
}

Schritt 4: Die metrics-Action vor dem Filter halten

Neue Actions werden am Ende der Reihenfolge hinzugefügt, sodass der Filter bereits nach der metrics-Action läuft. Bestätigen Sie die Reihenfolge:

Liste die Log Line Actions auf MyStore production auf und halte die metrics-Action vor dem Filter.

Ihr Agent kann get_app_resources verwenden, um die Reihenfolge zu lesen, und dann manage_log_line_action mit action: "reorder" aufrufen, falls der Filter vor der metrics-Action steht. Würde der Filter zuerst laufen, würde er die Zeilen verwerfen, bevor die metrics-Action sie zählt.

Überprüfen, dass es funktioniert

Nachdem AppSignal die Actions angewendet hat und neue passende Zeilen empfängt, überprüfen Sie das Ergebnis:

Lesen Sie die Metrik und bestätigen Sie, dass sie Daten aus neuen passenden Zeilen enthält.
Durchsuchen Sie Ihre Logs mit derselben Abfrage. Zeilen, die nach Inkrafttreten des Filters empfangen wurden, sollten nicht erscheinen.

Wenn die Metrik keine neuen Daten enthält oder passende Zeilen weiterhin erscheinen, prüfen Sie die Abfrage und die Reihenfolge der Actions. Versuchen Sie es dann erneut mit neuen Log-Zeilen.

Verhalten und Einschränkungen

Actions wirken nicht rückwirkend. Logs, die vor der Erstellung der Action gespeichert wurden, bleiben unverändert.
UI-Bearbeitungen halten zugehörige Actions synchron. Das Bearbeiten der Metrik in der AppSignal-UI aktualisiert den zugehörigen Filter. Das Löschen des Filters über MCP behält die Metrik bei und deaktiviert das Verwerfen.
Über MCP erstellte Actions sind unabhängig. Um dieselben Zeilen zu messen und zu verwerfen, geben Sie beiden Actions dieselbe Abfrage und dieselben Log-Quellen und aktualisieren Sie beide, wenn sich deren Konfiguration ändert.

Log-basierte Metriken, wo der Schalter zu finden ist
AppSignal MCP, die MCP-Tool-Referenz und der Log-Verarbeitungs-Workflow
Logs ignorieren, um zu verhindern, dass Zeilen von Ihrer Integration überhaupt gesendet werden

Funktionen

Anwendungszustand

Logs & Metriken

Infrastruktur

Apps optimieren

Logs verwerfen, nachdem Metriken extrahiert wurden

So funktioniert es

Bevor Sie beginnen

Über den Schalter aktivieren

Über AppSignal MCP einrichten

Schritt 1: Eine Metrik aus den Zeilen erfassen

Schritt 2: Prüfen Sie die Metrik, bevor Sie etwas verwerfen

Schritt 3: Die passenden Zeilen verwerfen

Schritt 4: Die metrics-Action vor dem Filter halten

Überprüfen, dass es funktioniert

Verhalten und Einschränkungen

​So funktioniert es

​Bevor Sie beginnen

​Über den Schalter aktivieren

​Über AppSignal MCP einrichten

​Schritt 1: Eine Metrik aus den Zeilen erfassen

​Schritt 2: Prüfen Sie die Metrik, bevor Sie etwas verwerfen

​Schritt 3: Die passenden Zeilen verwerfen

​Schritt 4: Die metrics-Action vor dem Filter halten

​Überprüfen, dass es funktioniert

​Verhalten und Einschränkungen

​Verwandt

So funktioniert es

Bevor Sie beginnen

Über den Schalter aktivieren

Über AppSignal MCP einrichten

Schritt 1: Eine Metrik aus den Zeilen erfassen

Schritt 2: Prüfen Sie die Metrik, bevor Sie etwas verwerfen

Schritt 3: Die passenden Zeilen verwerfen

Schritt 4: Die metrics-Action vor dem Filter halten

Überprüfen, dass es funktioniert

Verhalten und Einschränkungen

Verwandt