Zum Hauptinhalt springen
Manche Log-Zeilen sind es wert, gezählt zu werden, aber nicht, aufbewahrt zu werden. Ein Online-Shop protokolliert vielleicht jede Katalogsuche eines Kunden, jede geöffnete Produktseite und jeden Health Check seines Load Balancers. Jede Zeile für sich sagt wenig aus, aber die Rate ist entscheidend. Sie möchten wissen, wie oft etwas geschieht, ohne jede Zeile zu speichern. AppSignal kann eine Metrik aus passenden Log-Zeilen erfassen, sobald sie ankommen, und diese Zeilen anschließend verwerfen, sodass sie nie gespeichert werden. Sie behalten die Zahl für Dashboards und Trigger, und Ihr Log-Speicherverbrauch bleibt niedrig. Erst messen, dann verwerfen — wie eine Observability-Pipeline. Die AppSignal-App-UI unterstützt dies noch nicht. Sie können dies über AppSignal MCP einrichten, indem Sie Ihren AI-Agenten bitten, zwei Log Line Actions zu erstellen.

​
So funktioniert es

Log Line Actions werden ausgeführt, während AppSignal Ihre Logs ingestiert, in einer von Ihnen festgelegten Reihenfolge. Es gibt drei Typen:
  • metrics: erfasst eine Metrik aus passenden Zeilen.
  • filter: verwirft passende Zeilen, sodass sie nie gespeichert werden.
  • trigger: löst einen Alarm und ein Incident aus, wenn die Abfrage passt.
Um die Metrik zu behalten und die Zeilen zu verwerfen, verwenden Sie eine metrics-Action und eine filter-Action, wobei die metrics-Action zuerst kommt. Ein Filter verhindert, dass eine Zeile eine spätere Action erreicht — würde also der Filter zuerst ausgeführt, würde die Zeile verworfen, bevor sie gezählt wird.
Log Line Actions wirken sich nur auf Zeilen aus, die nach ihrer Erstellung ingestiert werden. Sie ändern keine Logs, die bereits gespeichert sind.

​
Die Metrik beim Eingang der Logs erfassen

Dass die Metrik beim Ingest erfasst wird, macht das Verwerfen sicher. Eine Log-basierte Metrik, die aus der Logs-Seite erstellt wird, liest gespeicherte Log-Zeilen — sobald Sie die Zeilen verwerfen, bleibt nichts mehr zu lesen. Eine metrics-Log-Line-Action erfasst den Wert aus jeder Zeile beim Eintreffen, bevor der Filter sie verwirft, sodass die Zahl erhalten bleibt.

​
Bevor Sie beginnen, benötigen Sie

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

​
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:search matchen, als Counter mit dem Namen log.catalog_searches, beschränkt auf die Application-Log-Quelle.
Dies ruft manage_log_line_action auf: 
{
  "app_name": "MyStore",
  "app_environment": "production",
  "name": "Catalog search rate",
  "action_type": "metrics",
  "query": "message:search",
  "source_ids": ["<YOUR_LOG_SOURCE_ID>"],
  "log_line_metrics": [
    { "name": "log.catalog_searches", "metric_type": "counter" }
  ]
}
Drei Dinge sind wichtig:
  • Formulieren Sie die Abfrage in der Log-Abfragesyntax von AppSignal, derselben Syntax wie auf der Logs-Seite. message:search matcht Zeilen, deren Message search enthält. Siehe Query Syntax.
  • Wählen Sie, für welche Quellen sie gilt. Listen Sie sie in source_ids auf, oder lassen Sie source_ids weg, damit die Action auf jede Quelle angewendet wird.
  • Wählen Sie den Metric-Typ. Ein counter zählt passende Zeilen und benötigt kein Feld. Ein gauge oder eine distribution liest einen Zahlenwert aus jeder Zeile und benötigt daher ein field, das angibt, welcher Wert gelesen werden soll.

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

Warten Sie einige passende Zeilen ab und lesen Sie dann 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, bevor Sie den Filter hinzufügen. Ein Filter verwirft passende Zeilen dauerhaft — wenn die Abfrage falsch ist, verlieren Sie die Zeilen, ohne die Zahl erfasst zu haben.

​
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:search matchen. 
{
  "app_name": "MyStore",
  "app_environment": "production",
  "name": "Drop catalog search logs",
  "action_type": "filter",
  "query": "message:search",
  "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.
Dies verwendet get_app_resources, um die Reihenfolge zu lesen, und reorder_log_line_actions nur dann, wenn 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

Geben Sie den Actions einige Minuten, um wirksam zu werden, und bestätigen Sie dann beide Hälften an einer kleinen Stichprobe:
  1. Lesen Sie die Metrik. Der Counter steigt weiter, während passende Zeilen eintreffen.
  2. Suchen Sie in Ihren Logs nach denselben Zeilen. Neue Zeilen erscheinen nicht mehr, weil der Filter sie verwirft.
Wenn der Counter nicht steigt oder die Zeilen weiterhin gespeichert werden, ist die Action möglicherweise noch nicht wirksam, oder die Abfrage matcht nicht. Prüfen Sie die Abfrage auf der Logs-Seite und versuchen Sie es dann mit neuen Zeilen erneut.

​
Verhalten und Einschränkungen

  • Actions wirken nicht rückwirkend. Sie wirken nur auf neue Zeilen. Logs, die vor der Erstellung der Action gespeichert wurden, bleiben unverändert.
  • Planen Sie einige Minuten ein. Eine neue oder geänderte Action braucht kurze Zeit, um wirksam zu werden. Zeilen, die in den ersten Momenten eintreffen, werden möglicherweise nicht von ihr verarbeitet.
  • Verworfene Zeilen können nicht wiederhergestellt werden. Behalten Sie die Metrik — und eine trigger-Action, wenn Sie Alarme möchten — damit der Filter niemals die einzige Aufzeichnung eines Ereignisses entfernt.
  • Die beiden Abfragen sind unabhängig. Zählen Sie eine Menge Zeilen und verwerfen Sie eine andere, wenn das zu Ihrem Ziel passt. Um dieselben Zeilen zu zählen und zu verwerfen, verwenden Sie für beide dieselbe Abfrage.

​
Verwandt