Aggregieren von Daten in einem Log Analytics-Arbeitsbereich mit Hilfe von Zusammenfassungsregeln (Preview)

Mit einer Zusammenfassungsregel können Sie Protokolldaten in regelmäßigen Abständen aggregieren und die aggregierten Ergebnisse an eine benutzerdefinierte Protokolltabelle in Ihrem Log Analytics-Arbeitsbereich senden. Verwenden Sie Zusammenfassungsregeln, um Ihre Daten für Folgendes zu optimieren:

  • Analyse und Berichte, insbesondere über große Datensätze und Zeiträume, wie sie für Sicherheits- und Incident-Analysen, monatliche oder jährliche Geschäftsberichte usw. benötigt werden. Komplexe Abfragen auf ein großes Dataset führen häufig zu Zeitüberschreitungen. Es ist einfacher und effizienter, bereinigte und aggregierte zusammengefasste Daten zu analysieren und darüber zu berichten.

  • Kosteneinsparungen bei ausführlichen Protokollen, die Sie so lange oder so wenig wie nötig in einer günstigen Basic-Protokolltabelle aufbewahren und zusammengefasste Daten für Analysen und Berichte an eine Analysetabelle senden können.

  • Sicherheit und Datenschutz durch Entfernen oder Verschleiern von Datenschutzdetails in zusammengefassten, gemeinsam nutzbaren Daten und Einschränkung des Zugriffs auf Tabellen mit Rohdaten.

In diesem Artikel wird beschrieben, wie Zusammenfassungsregeln funktionieren und wie Sie Zusammenfassungsregeln definieren und anzeigen können. Außerdem finden Sie einige Beispiele für die Verwendung und die Vorteile von Zusammenfassungsregeln.

Dieses Video zeigt einen Überblick über einige Vorteile von Zusammenfassungsregeln:

Funktionsweise von Zusammenfassungsregeln

Zusammenfassungsregeln führen Batchverarbeitung direkt in Ihrem Log Analytics-Arbeitsbereich durch. Die Zusammenfassungsregel aggregiert Datenblöcke, die anhand einer KQL-Abfrage definiert sind, und erfasst die zusammengefassten Ergebnisse in einer benutzerdefinierten Tabelle mit einem Analyseprotokollplan in Ihrem Log Analytics-Arbeitsbereich.

Eine Abbildung, die zeigt, wie Daten in einen Log Analytics-Arbeitsbereich aufgenommen und mithilfe einer Zusammenfassungsregel in den Arbeitsbereich aggregiert und erneut aufgenommen werden.

Sie können Daten aus einer beliebigen Tabelle aggregieren, unabhängig davon, ob die Tabelle über einen Analyse- oder Basisdatentarif verfügt. Azure Monitor erstellt das Zieltabellenschema basierend auf der von Ihnen definierten Abfrage. Wenn die Zieltabelle bereits vorhanden ist, fügt Azure Monitor alle Spalten hinzu, die für die Abfrageergebnisse erforderlich sind. Alle Zieltabellen enthalten auch eine Reihe von Standardfeldern mit Informationen zu Zusammenfassungsregeln, einschließlich:

  • _RuleName: Die Zusammenfassungsregel, die den aggregierten Protokolleintrag generiert hat.
  • _RuleLastModifiedTime: Der Zeitpunkt der letzten Änderung der Regel.
  • _BinSize: Das Aggregationsintervall.
  • _BinStartTime Die Startzeit der Aggregation.

Sie können bis zu 30 aktive Regeln konfigurieren, um Daten aus mehreren Tabellen zu aggregieren und die aggregierten Daten an separate Zieltabellen oder dieselbe Tabelle zu senden.

Sie können zusammengefasste Daten aus einer benutzerdefinierten Protokolltabelle in ein Speicherkonto oder Event Hubs exportieren, um weitere Integrationen zu ermöglichen, indem Sie eine Datenexportregel definieren.

Beispiel: Zusammenfassen von ContainerLogsV2-Daten

Wenn Sie Container überwachen, erfassen Sie eine große Menge ausführlicher Protokolle in der Tabelle ContainerLogsV2.

Sie könnten diese Abfrage in Ihrer Zusammenfassungsregel verwenden, um alle eindeutigen Protokolleinträge innerhalb von 60 Minuten zu aggregieren, wobei Sie die Daten behalten, die für die Analyse nützlich sind, und die Daten weglassen, die Sie nicht benötigen:

ContainerLogV2 | summarize Count = count() by  Computer, ContainerName, PodName, PodNamespace, LogSource, LogLevel, Message = tostring(LogMessage.Message)

Dies sind die Rohdaten in der Tabelle ContainerLogsV2:

Screenshot der unformatierten Protokolldaten in der Tabelle „ContainerLogsV2“.

Hier sind die aggregierten Daten, die die Zusammenfassungsregel an die Zieltabelle sendet:

Screenshot der aggregierten Daten, die die Zusammenfassungsregel an die Zieltabelle sendet.

Anstatt Hunderte ähnlicher Einträge innerhalb einer Stunde zu protokollieren, zeigt die Zieltabelle die Anzahl der einzelnen eindeutigen Einträge an, wie in der KQL-Abfrage definiert. Legen Sie den Basisdatentarif für die Tabelle ContainerLogsV2 für die günstige Aufbewahrung der Rohdaten fest, und verwenden Sie die zusammengefassten Daten in der Zieltabelle für Ihre Analyseanforderungen.

Erforderliche Berechtigungen

Aktion Erforderliche Berechtigungen
Erstellen oder Aktualisieren der Zusammenfassungsregel Microsoft.Operationalinsights/workspaces/summarylogs/write-Berechtigungen für den Log Analytics-Arbeitsbereich, wie sie beispielsweise von der integrierten Rolle „Log Analytics-Mitwirkender“ bereitgestellt werden
Erstellen oder Aktualisieren der Zieltabelle Microsoft.OperationalInsights/workspaces/tables/write-Berechtigungen für den Log Analytics-Arbeitsbereich, wie sie beispielsweise von der integrierten Rolle „Log Analytics-Mitwirkender“ bereitgestellt werden
Aktivieren der Abfrage im Arbeitsbereich Microsoft.OperationalInsights/workspaces/query/read-Berechtigungen für den Log Analytics-Arbeitsbereich, wie sie z. B. von der integrierten Rolle „Log Analytics-Leser“ bereitgestellt werden
Abfragen aller Protokolle im Arbeitsbereich Microsoft.OperationalInsights/workspaces/query/*/read-Berechtigungen für den Log Analytics-Arbeitsbereich, wie sie z. B. von der integrierten Rolle „Log Analytics-Leser“ bereitgestellt werden
Abfragen von Protokollen in Tabellen Microsoft.OperationalInsights/workspaces/query/<table>/read-Berechtigungen für den Log Analytics-Arbeitsbereich, wie sie z. B. von der integrierten Rolle „Log Analytics-Leser“ bereitgestellt werden
Abfragen von Protokollen in Tabellen (Tabellenaktion) Microsoft.OperationalInsights/workspaces/tables/query/read-Berechtigungen für den Log Analytics-Arbeitsbereich, wie sie z. B. von der integrierten Rolle „Log Analytics-Leser“ bereitgestellt werden
Verwenden von Abfragen, die in einem kundenseitig verwalteten Speicherkonto verschlüsselt sind Microsoft.Storage/storageAccounts/*-Berechtigungen für das Speicherkonto, wie von der integrierten Rolle Speicherkontomitwirkende bereitgestellt, z. B.

Einschränkungen

Kategorie Begrenzung
Maximale Anzahl aktiver Regeln in einem Arbeitsbereich 30
Maximale Anzahl der Ergebnisse pro Intervall 500.000
Maximale Ergebnismenge 100 MB
Abfragetimeout für die Intervallverarbeitung 10 Minuten
  • Zusammenfassungsregeln sind derzeit nur in der öffentlichen Cloud verfügbar.

  • Die Zusammenfassungsregel verarbeitet eingehende Daten und kann nicht für einen historischen Zeitraum konfiguriert werden.

  • Wenn die Wiederholungsversuche für die Intervallausführung aufgebraucht sind, wird die Intervallausführung übersprungen und kann nicht erneut ausgeführt werden.

  • Die Abfrage eines Log Analytics-Arbeitsbereichs in einem anderen Mandanten mit Lighthouse wird nicht unterstützt.

  • KQL-Grenzwerte hängen vom Tabellentarif der Quelltabelle ab.

    • Analyse: Unterstützt alle KQL-Befehle mit Ausnahme von:

    • Basic: Unterstützt alle KQL-Befehle in einer einzelnen Tabelle. Sie können bis zu fünf Analysetabellen mithilfe des Operators Lookup verknüpfen.

    • Funktionen: Benutzerdefinierte Funktionen werden nicht unterstützt. Systemfunktionen, die von Microsoft bereitgestellt werden, werden unterstützt.

Preismodell

Für Zusammenfassungsregeln entstehen keine zusätzlichen Kosten. Sie zahlen nur für die Abfrage und die Erfassung von Ergebnissen in der Zieltabelle, basierend auf dem Tabellenplan der Quelltabelle, auf der Sie die Abfrage ausführen:

Quelltabellentarif Abfragekosten Kosten für die Erfassung der Sammelergebnisse
Analyse Kostenlos Von der Analyse aufgenommene GB
Basic- und Hilfspläne Gescannte GB Von der Analyse aufgenommene GB

Beispielsweise wäre die Kostenberechnung für eine stündlich ausgeführte Regel, die pro Intervall 100 Datensätze zurückgibt, wie folgt:

Quelltabellentarif Monatliche Preisberechnung
Analyse Erfassungspreis x Datensatzgröße x Anzahl von Datensätzen x 24 Stunden x 30 Tage
Basic- und Hilfspläne Preis für gescannte GB x gescannte Größe + Erfassungspreis x Datensatzgröße x Anzahl von Datensätzen x 24 Stunden x 30 Tage

Weitere Informationen finden Sie unter Azure Monitor-Preise.

Erstellen oder Aktualisieren einer Zusammenfassungsregel

Experimentieren Sie vor dem Erstellen einer Regel mit der Abfrage in Log Analytics. Stellen Sie sicher, dass die Abfrage das Abfragelimit nicht erreicht und nicht in die Nähe des Abfragelimits kommt. Überprüfen Sie, ob die Abfrage das beabsichtigte Schema und die erwarteten Ergebnisse erzeugt. Wenn die Abfrage nahe an den Abfragegrenzwerten liegt, sollten Sie die Verwendung eines kleineren binSize-Vorgangs in Betracht ziehen, um weniger Daten pro Intervall zu verarbeiten. Sie können die Abfrage auch anpassen, dass sie weniger Datensätze zurückgibt, oder Felder mit höherem Volumen entfernen.

Hinweis

Zusammenfassungsregeln sind im Hinblick auf Kosten und Ergebnisverbrauch am vorteilhaftesten, wenn sie erheblich reduziert werden. Die Ergebnisse enthalten 0,01 % oder weniger als die Quelle.

Wenn Sie eine Abfrage aktualisieren und Ausgabefelder aus der Ergebnismenge entfernen, entfernt Azure Monitor die Spalten nicht automatisch aus der Zieltabelle. Sie müssen Spalten manuell aus der Tabelle löschen.

Um eine Zusammenfassungsregel zu erstellen oder zu aktualisieren, führen Sie diesen PUT API-Aufruf aus:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourcegroup}/providers/Microsoft.OperationalInsights/workspaces/{workspace}/summarylogs/{ruleName}?api-version=2023-01-01-preview
Authorization: {credential}

{
  "properties": {
      "ruleType": "User",
      "description": "My test rule",
      "ruleDefinition": {
          "query": "StorageBlobLogs | summarize count() by AccountName",
          "binSize": 30,
          "destinationTable": "MySummaryLogs_CL"
      }
  }
}

In dieser Tabelle werden die Parameter der Zusammenfassungsregel beschrieben:

Parameter Gültige Werte Beschreibung
ruleType User oder System Gibt den Typ der Regel an.
- User: Regeln, die Sie definieren.
- System: Vordefinierte Regeln, die von Azure-Diensten verwaltet werden.
description String Beschreibt die Regel und ihre Funktion. Dieser Parameter ist hilfreich, wenn Sie über mehrere Regeln verfügen und bei der Regelverwaltung helfen können.
binSize 20, 30, 60, 120, 180, 360, 720 oder 1440 (Minuten) Definiert das Aggregationsintervall und den Nachschlagezeitbereich. Wenn Sie z. B. "binSize": 120 festlegen, erhalten Sie möglicherweise Einträge für 02:00 to 04:00 und 04:00 to 06:00.
query Kusto Query Language (KQL)-Abfrage Definiert die Abfrage, die in der Regel ausgeführt werden soll. Sie müssen keinen Zeitraum angeben, da der Parameter binSize das Aggregationsintervall bestimmt, z. B. 02:00 to 03:00 wenn "binSize": 60. Wenn Sie in der Abfrage einen Zeitfilter hinzufügen, ist der in der Abfrage verwendete Zeitraum die Schnittmenge zwischen dem Filter und der Containergröße.
destinationTable tablename_CL Gibt den Namen der benutzerdefinierten Zielprotokolltabelle an. Der Namenswert muss das Suffix _CL aufweisen. Azure Monitor erstellt die Tabelle im Arbeitsbereich, sofern sie noch nicht vorhanden ist, basierend auf der Abfrage, die Sie in der Regel festgelegt haben. Wenn die Tabelle bereits im Arbeitsbereich vorhanden ist, fügt Azure Monitor alle neuen Spalten hinzu, die in der Abfrage eingeführt wurden.

Wenn die Zusammenfassungsergebnisse einen reservierten Spaltennamen enthalten, z. B. TimeGenerated, _IsBillable, _ResourceId, TenantId oder Type, fügt Azure Monitor das Präfix _Original an die ursprünglichen Felder an, um ihre ursprünglichen Werte beizubehalten.
binDelay (optional) Integer (Minuten) Damit wird eine Zeit festgelegt, auch als Erfassungslatenz bezeichnet, die vor der Intervallausführung gewartet werden soll. Dies ist in der Regel bei verspätet eingehenden Daten nützlich und ermöglicht, dass möglichst viele Daten eintreffen. Die Standardverzögerung liegt zwischen dreieinhalb Minuten und 10 % des Werts binSize.

Wenn Sie wissen, dass die von Ihnen abgefragten Daten in der Regel mit Verzögerung erfasst werden, legen Sie den Parameter binDelay auf den bekannten Verzögerungswert oder höher fest – bis zu 1.440 Minuten. Weitere Informationen finden Sie unter Konfigurieren des Aggregatortimings.
In einigen Fällen kann Azure Monitor die Intervallausführung geringfügig nach der Verschiebung des Intervalls starten, um die Zuverlässigkeit und den Erfolg der Abfrage sicherzustellen.
binStartTime (optional) Datetime in
%Y-%n-%eT%H:%M %Z-Format
Gibt das Datum und die Uhrzeit der ersten Intervallausführung an. Der Wert kann mit der Erstellungsdatum der Regel beginnen, abzüglich des Werts binSize oder später und in ganzen Stunden. Wenn beispielsweise „datetime“ 2023-12-03T12:13Z und binSize 1.440 ist, lautet der früheste gültige binStartTime-Wert 2023-12-02T13:00Z, und die Aggregation enthält Daten, die zwischen 02T13:00 und 03T13:00 protokolliert werden. In diesem Szenario beginnen die Regeln mit der Aggregation eines 03T13:00 plus der Standard- oder angegebenen Verzögerung.

Der Parameter binStartTime ist in täglich ausgeführten Zusammenfassungsszenarien nützlich. Angenommen, Sie befinden sich in der Zeitzone UTC-8 und erstellen eine tägliche Regel um 2023-12-03T12:13Z. Sie möchten, dass die Regel abgeschlossen werden soll, bevor Sie Ihren Tag um 8:00 Uhr (00:00 UTC) beginnen. Setzen Sie den binStartTime-Parameter auf 2023-12-02T22:00Z. Die erste Aggregation umfasst alle Daten, die zwischen 02T:06:00 und 03T:06:00 Ortszeit aufgezeichnet wurden, und die Regel läuft täglich zur gleichen Zeit. Weitere Informationen finden Sie unter Konfigurieren des Aggregatortimings.

Wenn Sie Regeln aktualisieren, können Sie eine der folgenden Aktionen ausführen:
– Verwenden Sie den vorhandenen Wert binStartTime oder entfernen Sie den Parameter binStartTime. In diesem Fall wird die Ausführung auf der Grundlage der ursprünglichen Definition fortgesetzt.
– Aktualisieren Sie die Regel mit einem neuen binStartTime-Wert, um einen neuen Datetime-Wert festzulegen.
timeSelector (optional) TimeGenerated Definiert das Zeitstempelfeld, das Azure Monitor zum Aggregieren von Daten verwendet. Wenn Sie beispielsweise "binSize": 120 festlegen, können Sie Einträge mit einem TimeGenerated-Wert zwischen 02:00 und 04:00 erhalten.

Konfigurieren des Aggregationszeitpunkts

Standardmäßig erstellt die Zusammenfassungsregel die erste Aggregation kurz nach der nächsten vollen Stunde.

Die kurze Verzögerung, die Azure Monitor hinzufügt, berücksichtigt die Erfassungslatenz – oder die Zeit zwischen dem Zeitpunkt, an dem die Daten im überwachten System erstellt werden, und dem Zeitpunkt, an dem sie für die Analyse in Azure Monitor verfügbar sind. Diese Verzögerung liegt standardmäßig zwischen dreieinhalb Minuten bis 10 % des Werts binSize, bevor jeder Datenblock aggregiert wird. In den meisten Fällen stellt diese Verzögerung sicher, dass Azure Monitor alle innerhalb jedes Intervallzeitraums protokollierten Daten aggregiert.

Zum Beispiel:

  • Sie erstellen eine Zusammenfassungsregel mit einer Containergröße von 30 Minuten bei 14:44.

    Die Regel erstellt die erste Aggregation kurz nach 15:00 Uhr – z. B. um 15:04 Uhr – für Daten, die zwischen 14:30 Uhr und 15:00 Uhr protokolliert wurden.

  • Sie erstellen eine Zusammenfassungsregel mit einer Länge von 720 Minuten (12 Stunden) um 14:44 Uhr.

    Die Regel erstellt die erste Aggregation bei 16:12 Uhr – 72 Minuten (10 % der Größe von 720 Intervallen) nach 13:00 Uhr – für Daten, die zwischen 03:00 Uhr und 15:00 Uhr protokolliert werden.

Verwenden Sie die Parameter binStartTime und binDelay, um die Anzeigedauer der ersten Aggregation und die Verzögerung, die Azure Monitor vor jeder Aggregation hinzufügt, zu ändern.

Die nächsten Abschnitte enthalten Beispiele für die Standardaggregationszeit und die erweiterten Aggregationsanzeigeoptionen.

Verwenden der standardmäßigen Aggregationszeit

In diesem Beispiel wird die Zusammenfassungsregel am 07.06.2023 um 14:44 Uhr (2023-06-07 14:44) erstellt, und Azure Monitor fügt eine Standardverzögerung von vier Minuten hinzu.

binSize (Minuten) Anfängliche Regelausführung Erste Aggregation Zweite Aggregation
1440 2023-06-07 15:04 2023-06-06 15:00–2023-06-07 15:00 2023-06-07 15:00–2023-06-08 15:00
720 2023-06-07 15:04 2023-06-07 03:00–2023-06-07 15:00 2023-06-07 15:00–2023-06-08 03:00
360 2023-06-07 15:04 2023-06-07 09:00–2023-06-07 15:00 2023-06-07 15:00–2023-06-07 21:00
180 2023-06-07 15:04 2023-06-07 12:00–2023-06-07 15:00 2023-06-07 15:00–2023-06-07 18:00
120 2023-06-07 15:04 2023-06-07 13:00–2023-06-07 15:00 2023-06-07 15:00–2023-06-07 17:00
60 2023-06-07 15:04 2023-06-07 14:00–2023-06-07 15:00 2023-06-07 15:00–2023-06-07 16:00
30 2023-06-07 15:04 2023-06-07 14:30–2023-06-07 15:00 2023-06-07 15:00–2023-06-07 15:30
20 2023-06-07 15:04 2023-06-07 14:40–2023-06-07 15:00 2023-06-07 15:00–2023-06-07 15:20

Festlegen optionaler Aggregationszeitparameter

In diesem Beispiel wird die Zusammenfassungsregel am 07.06.2023 um 14:44 Uhr (2023-06-07 14:44) erstellt, und die Regel enthält diese erweiterten Konfigurationseinstellungen:

  • binStartTime: 2023-06-08 07:00
  • binDelay: 8 Minuten
binSize (Minuten) Anfängliche Regelausführung Erste Aggregation Zweite Aggregation
1440 2023-06-09 07:08 2023-06-08 07:00–2023-06-09 07:00 2023-06-09 07:00–2023-06-10 07:00
720 2023-06-08 19:08 2023-06-08 07:00–2023-06-08 19:00 2023-06-08 19:00–2023-06-09 07:00
360 2023-06-08 13:08 2023-06-08 07:00–2023-06-08 13:00 2023-06-08 13:00–2023-06-08 19:00
180 2023-06-08 10:08 2023-06-08 07:00–2023-06-08 10:00 2023-06-08 10:00–2023-06-08 13:00
120 2023-06-08 09:08 2023-06-08 07:00–2023-06-08 09:00 2023-06-08 09:00–2023-06-08 11:00
60 2023-06-08 08:08 2023-06-08 07:00–2023-06-08 08:00 2023-06-08 08:00–2023-06-08 09:00
30 2023-06-08 07:38 2023-06-08 07:00–2023-06-08 07:30 2023-06-08 07:30–2023-06-08 08:00
20 2023-06-08 07:28 2023-06-08 07:00–2023-06-08 07:20 2023-06-08 07:20–2023-06-08 07:40

Zusammenfassungsregeln anzeigen

Verwenden Sie diesen GET API-Aufruf, um die Konfiguration für eine bestimmte Zusammenfassungsregel anzuzeigen:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourcegroup}/providers/Microsoft.OperationalInsights/workspaces/{workspace}/summarylogs/{ruleName1}?api-version=2023-01-01-preview
Authorization: {credential}

Verwenden Sie diesen GET API-Aufruf, um die Konfiguration aller Zusammenfassungsregeln in Ihrem Log Analytics-Arbeitsbereich anzuzeigen:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourcegroup}/providers/Microsoft.OperationalInsights/workspaces/{workspace}/summarylogs?api-version=2023-01-01-preview
Authorization: {credential}

Beenden und erneutes Starten einer Zusammenfassungsregel

Sie können eine Regel für einen bestimmten Zeitraum anhalten – zum Beispiel, wenn Sie überprüfen möchten, ob Daten in eine Tabelle aufgenommen wurden und Sie die zusammengefasste Tabelle und die Berichte nicht beeinträchtigen möchten. Wenn Sie die Regel neu starten, beginnt Azure Monitor mit der Verarbeitung von Daten ab der nächsten vollen Stunde oder basierend auf dem definierten (optionalen) Parameter binStartTime.

Verwenden Sie diesen POST API-Aufruf, um eine Regel zu beenden:

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourcegroup}/providers/Microsoft.OperationalInsights/workspaces/{workspace}/summarylogs/{ruleName}/stop?api-version=2023-01-01-preview
Authorization: {credential}

Verwenden Sie diesen POST API-Aufruf, um die Regel neu zu starten:

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourcegroup}/providers/Microsoft.OperationalInsights/workspaces/{workspace}/summarylogs/{ruleName}/start?api-version=2023-01-01-preview
Authorization: {credential}

Löschen einer Zusammenfassungsregel

In Ihrem Log Analytics-Arbeitsbereich können bis zu 30 aktive Zusammenfassungsregeln vorhanden sein. Wenn Sie eine neue Regel erstellen möchten, aber bereits über 30 aktive Regeln verfügen, müssen Sie eine aktive Zusammenfassungsregel beenden oder löschen.

Verwenden Sie diesen DELETE API-Aufruf, um eine Regel zu löschen:

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourcegroup}/providers/Microsoft.OperationalInsights/workspaces/{workspace}/summarylogs/{ruleName}?api-version=2023-01-01-preview
Authorization: {credential}

Überwachen von Zusammenfassungsregeln

Um Zusammenfassungsregeln zu überwachen, aktivieren Sie die Kategorie Zusammenfassungsprotokolle in den Diagnoseeinstellungen Ihres Log Analytics-Arbeitsbereichs. Azure Monitor sendet Ausführungsdetails zu Zusammenfassungsregeln, einschließlich der Informationen „Ausführung der Zusammenfassungsregel gestartet“, „erfolgreich“ und „fehlgeschlagen“ an die Tabelle LASummaryLogs in Ihrem Arbeitsbereich.

Sie sollten, Protokollwarnungsregeln einrichten, um Benachrichtigungen über Intervallfehler zu erhalten, oder wenn die Intervallausführung kurz vor dem Timeout steht, wie unten gezeigt. Je nach Fehlergrund können Sie entweder die Größe des Intervalls reduzieren, um weniger Daten für jede Ausführung zu verarbeiten, oder die Abfrage so ändern, dass weniger Datensätze oder Felder mit höherem Volume zurückgegeben werden.

Diese Abfrage gibt fehlgeschlagene Ausführungen zurück:

LASummaryLogs | where Status == "Failed"

Diese Abfrage gibt Intervallausführungen zurück, bei der der Wert QueryDurationMs größer als 0,9 x 600.000 Millisekunden ist:

LASummaryLogs | where QueryDurationMs > 0.9 * 600000

Überprüfen der Vollständigkeit der Daten

Zusammenfassungsregeln sind für die Skalierung konzipiert und enthalten einen Wiederholungsmechanismus, um beispielsweise vorübergehende Dienst- oder Abfragefehler im Zusammenhang mit Abfragegrenzwerten zu überwinden. Der Wiederholungsmechanismus macht 10 Versuche, ein fehlgeschlagenes Intervall innerhalb von acht Stunden zu aggregieren, und überspringt ein Intervall, wenn er ausgelastet ist. Die Regel wird auf isActive: false gesetzt und nach acht aufeinanderfolgenden Intervall-Wiederholungsversuchen pausiert. Wenn Sie Zusammenfassungsregeln überwachen aktivieren, protokolliert Azure Monitor ein Ereignis in der Tabelle LASummaryLogs in Ihrem Arbeitsbereich.

Sie können einen fehlgeschlagenen Intervallvorgang nicht erneut ausführen, aber Sie können die folgende Abfrage verwenden, um fehlgeschlagene Ausführungen anzuzeigen:

let startTime = datetime("2024-02-16");
let endtTime = datetime("2024-03-03");
let ruleName = "myRuleName";
let stepSize = 20m; // The stepSize value is equal to the bin size defined in the rule
LASummaryLogs
| where RuleName == ruleName
| where Status == 'Succeeded'
| make-series dcount(BinStartTime) default=0 on BinStartTime from startTime to endtTime step stepSize
| render timechart

Diese Abfrage rendert die Ergebnisse als Zeitdiagramm:

Screenshot eines Diagramms, in dem die Abfrageergebnisse für fehlerhafte Intervalle in Zusammenfassungsregeln dargestellt werden.

Informationen zu Regelkorrekturoptionen und proaktiven Warnungen finden Sie im Abschnitt Zusammenfassungsregeln überwachen.

Verschlüsseln von Zusammenfassungsregelabfragen mithilfe von kundenseitig verwalteten Schlüsseln

Eine KQL-Abfrage kann in Kommentaren oder in der Abfragesyntax vertrauliche Informationen enthalten. Um Zusammenfassungsregelabfragen zu verschlüsseln, verknüpfen Sie ein Speicherkonto mit Ihrem Log Analytics-Arbeitsbereich, und verwenden Sie kundenseitig verwaltete Schlüssel.

Überlegungen beim Arbeiten mit verschlüsselten Abfragen:

  • Das Verknüpfen eines Speicherkontos zum Verschlüsseln Ihrer Abfragen unterbricht vorhandene Regeln nicht.
  • Standardmäßig speichert Azure Monitor Zusammenfassungsregelabfragen im Log Analytics-Speicher. Wenn Sie bereits über Zusammenfassungsregeln verfügen, bevor Sie ein Speicherkonto mit Ihrem Log Analytics-Arbeitsbereich verknüpfen, aktualisieren Sie Ihre Zusammenfassungsregeln, sodass die Abfragen die vorhandenen Abfragen im Speicherkonto speichern.
  • Abfragen, die Sie in einem Speicherkonto speichern, befinden sich in der Tabelle CustomerConfigurationStoreTable. Diese Abfragen gelten als Dienstartefakte, und ihr Format kann sich ändern.
  • Sie können dasselbe Speicherkonto für Zusammenfassungsregelabfragen, gespeicherte Abfragen in Log Analytics und Protokollbenachrichtigungen verwenden.

Problembehandlung für Zusammenfassungsregeln

Dieser Abschnitt enthält Tipps für die Problembehandlung von Zusammenfassungsregeln.

Die Zieltabelle für Zusammenfassungsregeln wurde versehentlich gelöscht

Wenn Sie die Zieltabelle löschen, während die Zusammenfassungsregel aktiv ist, wird die Regel angehalten, und Azure Monitor sendet ein Ereignis an die Tabelle LASummaryLogs mit einer Meldung, die angibt, dass die Regel angehalten wurde.

Wenn Sie die Zusammenfassungsergebnisse nicht in der Zieltabelle benötigen, löschen Sie die Regel und die Tabelle. Wenn Sie Zusammenfassungsergebnisse wiederherstellen müssen, führen Sie die Schritte im Abschnitt „Erstellen oder Aktualisieren von Zusammenfassungsregeln“ aus, um die Tabelle neu zu erstellen. Die Zieltabelle wird abhängig von der Aufbewahrungsrichtlinie in der Tabelle wiederhergestellt, einschließlich der vor dem Löschen aufgenommenen Daten.

Wenn Sie die Zusammenfassungsergebnisse nicht in der Zieltabelle benötigen, löschen Sie die Regel und die Tabelle. Wenn Sie die Zusammenfassungsergebnisse benötigen, führen Sie die Schritte im Abschnitt Erstellen oder Aktualisieren von Zusammenfassungsregeln aus, um die Zieltabelle abhängig von der Aufbewahrungsrichtlinie in der Tabelle neu zu erstellen und alle Daten wiederherzustellen, einschließlich der vor dem Löschen erfassten Daten.

Die Abfrage verwendet Operatoren, die neue Spalten in der Zieltabelle erstellen

Das Schema der Zieltabelle wird definiert, wenn Sie eine Zusammenfassungsregel erstellen oder aktualisieren. Wenn die Abfrage in der Zusammenfassungsregel Operatoren enthält, die eine Erweiterung des Ausgabeschemas auf der Grundlage der eingehenden Daten ermöglichen – wenn die Abfrage z. B. die Funktion arg_max(expression, *) verwendet – fügt Azure Monitor der Zieltabelle keine neuen Spalten hinzu, nachdem Sie die Zusammenfassungsregel erstellt oder aktualisiert haben, und die Ausgabedaten, die diese Spalten erfordern, werden gelöscht. Um die neuen Felder zur Zieltabelle hinzuzufügen, aktualisieren Sie die Zusammenfassungsregel oder fügen Sie manuell eine Spalte zu Ihrer Tabelle hinzu.

Daten in entfernten Spalten verbleiben basierend auf den Aufbewahrungseinstellungen der Tabelle im Arbeitsbereich.

Wenn Sie Spalten in der Abfrage entfernen, verbleiben die Spalten und Daten im Ziel und basieren auf dem in der Tabelle oder dem Arbeitsbereich definierten Aufbewahrungszeitraum. Wenn Sie die entfernte Zieltabelle nicht benötigen, löschen Sie die Spalten aus dem Tabellenschema. Wenn Sie dann Spalten mit demselben Namen hinzufügen, werden alle Daten, die nicht älter als der Aufbewahrungszeitraum sind, erneut angezeigt.