Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Azure Monitor zeichnet Verwaltungsvorgänge für Ihre Azure-Ressourcen im Aktivitätsprotokoll auf. Im Aktivitätsprotokoll werden Vorgänge wie das Erstellen eines virtuellen Computers, das Ändern einer Zugriffsrichtlinie für den Schlüsseltresor oder Resource Manager Bereitstellungsfehler aufgezeichnet. Diese Verwaltungsvorgänge werden auch als Steuerungsebenenvorgänge bezeichnet. Verwenden Sie das Aktivitätsprotokoll, um diese Informationen zu überprüfen oder zu überwachen, oder erstellen Sie eine Warnung, die proaktiv benachrichtigt werden soll, wenn ein Ereignis auftritt.
Im Gegensatz zum Aktivitätsprotokoll erfassen Azure-Ressourcenprotokolle Vorgänge der datenebene, die innerhalb einer Ressource ausgeführt werden. Diese Vorgänge umfassen beispielsweise das Abrufen eines Geheimschlüssels aus einem Schlüsseltresor oder das Senden einer Anforderung an eine Datenbank. Ressourcenprotokolle werden nicht standardmäßig erfasst und erfordern eine Konfiguration mit einer Diagnoseeinstellung.
Tipp
Wenn ein Bereitstellungsvorgangsfehler Sie zu diesem Artikel leitet, lesen Sie die Problembehandlung allgemeiner Azure-Bereitstellungsfehler.
Aktivitätsprotokolleinträge
Azure Monitor erfasst Standardmäßig Aktivitätsprotokolleinträge ohne erforderliche Konfiguration. Das System generiert diese Einträge, und Sie können sie nicht ändern oder löschen. Einträge ergeben sich in der Regel aus Änderungen (Erstellungs-, Aktualisierungs- und Löschvorgängen) oder einer initiierten Aktion. Das Aktivitätsprotokoll erfasst in der Regel keine Lesevorgänge.
Aktivitätsprotokolleinträge sind in der Regel für die Analyse und Warnung innerhalb von 3 bis 20 Minuten nach dem Auftreten des Ereignisses verfügbar. Eine Beschreibung der Aktivitätsprotokollkategorien finden Sie unter Azure Aktivitätsprotokollereignisschema.
Aufbewahrungszeitraum
Azure behält Aktivitätsprotokollereignisse 90 Tage lang bei und löscht sie dann. Sie werden während dieses Zeitraums nicht für Einträge berechnet, unabhängig vom Volumen. Für weitere Funktionen, z. B. längere Aufbewahrung, erstellen Sie eine Diagnoseeinstellung, und sammeln Sie die Einträge an einem anderen Ort basierend auf Ihren Anforderungen. Einer der häufigsten Gründe, den Aufbewahrungszeitraum zu verlängern, besteht darin, Ressourcenerstellerinformationen beizubehalten, die nur im Aktivitätsprotokoll verfügbar sind.
Anzeigen und Abrufen des Aktivitätsprotokolls
Anzeigen von Aktivitätsprotokollereignissen für ein Abonnement, eine Ressourcengruppe oder eine einzelne Ressource. Verwenden Sie das Azure Portal, oder fragen Sie sie programmgesteuert mithilfe der REST-API Activity Log ab.
Das Azure-Portal stellt das Blatt Aktivitätsprotokoll in den meisten Dienstmenüs bereit. Jeder dieser Bereiche unterstützt auch den programmgesteuerten Zugriff mit REST oder über bestimmte Azure CLI und Azure PowerShell Befehle.
Geben Sie ein Zeitintervall von Ereignissen an, die abgerufen werden sollen. Um Ereignisse mithilfe der REST-API abzurufen, müssen Sie den $filter Parameter zusammen mit mindestens einem eventTimestamp Startwert einschließen. Standardmäßig behält das Aktivitätsprotokoll Ereignisse für 90 Tage bei. Stellen Sie sicher, dass sowohl der Anfang als auch das Ende des Zeitraums innerhalb dieses 90-Tage-Fensters liegen.
Zugriffsszenarien für das Aktivitätsprotokoll
In den folgenden Abschnitten werden gängige Szenarien vorgestellt, die verschiedene Möglichkeiten für den Zugriff auf und das Abrufen von Aktivitätsprotokollereignissen über das Azure-Portal, programmgesteuert mit Azure CLI und Azure PowerShell oder mithilfe von REST-Aufrufen zeigen:
Azure Portalbeispiele bieten zusätzlichen Kontext darüber, welche Art von Ereignissen in dieser Ansicht erwartet werden soll.
Azure CLI Beispiele heben die spezifischen Befehle hervor, die über den Befehl az monitor activity-log list verfügbar sind.
Azure PowerShell Beispiele heben die spezifischen Cmdlets hervor, die über das Cmdlet "Get-AzActivityLog" verfügbar sind.
REST-API-Beispiele zeigen, wie Ereignisse mithilfe des erforderlichen
$filterParameters mit der REST-API des Aktivitätsprotokolls abgerufen werden.Das Beispiel für das Listenaktivitätsprotokoll für eine Ressourcengruppe veranschaulicht außerdem, wie Sie explizit ein Timeout für Ihren Client festlegen, um den maximalen Timeoutzeitraum für die REST-API des Aktivitätsprotokolls von 75 Sekunden mithilfe des
PreferHeaders abzugleichen.Unterstützte $filterMusterEinzelheiten Standardmäßiges Abonnement mit einem Zeitrahmen $filter=eventTimestamp ge '{startTime}' and eventTimestamp le '{endTime}'Ressourcengruppe $filter=eventTimestamp ge '{startTime}' and eventTimestamp le '{endTime}' and resourceGroupName eq '{resourceGroupName}'spezifische Ressource $filter=eventTimestamp ge '{startTime}' and eventTimestamp le '{endTime}' and resourceUri eq '{resourceURI}'Ressourcenanbieter $filter=eventTimestamp ge '{startTime}' and eventTimestamp le '{endTime}' and resourceProvider eq '{resourceProviderName}'Korrelations-ID $filter=eventTimestamp ge '{startTime}' and eventTimestamp le '{endTime}' and correlationId eq '{correlationID}'
Aktivitätsprotokoll-Ereignisse für ein Abonnement auflisten
Ereignisse auf Abonnementebene erfassen Ereignisse, die direkt von Ressourcenanbietern erstellt wurden, und ist der Standardbereich für die Auflistung von Aktivitätsprotokollereignissen. Ereignisse auf Mandantenebene und Managementgruppenebene erfassen nur Azure Resource Manager-Ereignisse innerhalb dieser Hierarchien. Diese Bereiche auf höherer Ebene enthalten keine Ereignisse, die direkt von Ressourcenanbietern außerhalb von Azure Resource Manager Vorgängen generiert werden.
Im folgenden Beispiel werden Aktivitätsprotokollereignisse für ein Abonnement während eines bestimmten Zeitraums abgerufen.
Das Menü, aus dem Sie das Aktivitätsprotokoll öffnen, bestimmt den ursprünglichen Filter. Wenn Sie es über das Menü "Monitor " öffnen, ist der einzige standardmäßig ausgewählte Filter das Abonnement. Das entspricht dem Vorgang: Unter Abonnements> Abonnement auswählen >Aktivitätsprotokoll.
Ereignisse im Aktivitätsprotokoll für eine Ressourcengruppe auflisten
Fügen Sie resourceGroupName zum $filter hinzu, um die Azure Monitor Aktivitätsprotokoll-Ergebnisse auf eine bestimmte Ressourcengruppe einzugrenzen.
Das Menü, aus dem Sie das Aktivitätsprotokoll öffnen, bestimmt den ursprünglichen Filter. Wenn Sie es im Menü einer Ressource öffnen, wird der Filter auf die betreffende Ressource festgelegt. Wählen Sie "Filter hinzufügen" , um dem Filter weitere Eigenschaften hinzuzufügen. Hier sind die anderen Eigenschaften, nach denen Sie im Portal filtern können:
- Resource – Elemente, die Teil Ihrer Azure Lösung sind, z. B. eine Datenbank oder einen virtuellen Computer.
- Ressourcentyp – Die Kategorie, zu der eine Ressource gehört, z. B. virtuelle Computer, Web-Apps oder Datenbanken.
- Operation – Eine Aktion oder ein Befehl, z. B. Erstellen, Löschen und Schreiben, die sich auf Azure Resource Manager Ressourcen auswirken.
- Ereignis initiiert von – Filterereignisse nach der Identität, die das Ereignis initiiert hat.
- Ereigniskategorie – Filtern Sie die Ereignistypen nach bestimmten Vorgängen.
Zurückgeben bestimmter Aktivitätsprotokolleigenschaften
Verwenden Sie einen Parameter, um nur angegebene Eigenschaften zurückzugeben, wodurch die Größe der Antwortnutzlast reduziert wird. Weitere Informationen finden Sie unter Beschreibungen der Schemaeigenschaften des Aktivitätsprotokolls.
Das Azure Portal bietet keine Möglichkeit, die von Aktivitätsprotokollereignissen zurückgegebenen Eigenschaften direkt einzuschränken. Verwenden Sie zum Verringern der angezeigten Datenmenge die Option "Spalten bearbeiten " im Blatt " Aktivitätsprotokoll ", um auszuwählen, welche Spalten in der Portalansicht angezeigt werden.
Auflistung von Aktivitätsprotokoll-Ereignissen auf Mandantenebene
Aktivitätsprotokollereignisse auf Mandantenebene weisen in der Regel begrenzte Einträge auf, können aber wichtige Ereignisse wie die Erstellung von Verwaltungsgruppen oder Abonnements umfassen. Diese Ereignisse sind von Aktivitätsprotokollereignissen auf Abonnementebene getrennt, können jedoch doppelte Ressourcenverwaltungsereignisse enthalten.
Die Abfrage in diesem Bereich verwendet eine andere REST-API als die Api für Aktivitätsprotokollereignisse auf Abonnementebene. Azure CLI und Azure PowerShell bieten keine dedizierten Befehle.
Wechseln Sie zum Monitor>Aktivitätsprotokoll im Azure-Portal. Ändern Sie das Dropdownmenü "Aktivität ", und wählen Sie "Verzeichnisaktivität" aus.
Aktivitätsprotokollereignisse auf Gruppenebene der Listenverwaltung
Aktivitätsprotokollereignisse auf Verwaltungsebene erfassen Ereignisse, die auf eine bestimmte Verwaltungsgruppe ausgerichtet sind, z. B. Richtlinienzuweisungen und Änderungen der Verwaltungsgruppenmitgliedschaft.
Hinweis
- In den folgenden Beispielen wird die
2017-03-01-previewAPI-Version verwendet, die für Aktivitätsprotokollabfragen auf Gruppenebene erforderlich ist.
Um Aktivitätsprotokollereignisse auf Verwaltungsebene im Azure Portal anzuzeigen, wechseln Sie zu Management-Gruppen> wählen Sie eine Verwaltungsgruppe >Activity log aus.
In der folgenden Tabelle werden die in den vorherigen Beispielen verwendeten Parameter beschrieben.
| Variable | Beispielwert | Purpose |
|---|---|---|
| host | management.azure.com | Impliziter ARM-Endpunkt |
| subscriptionId | aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e | Benutzereingabe |
| resourceGroupName | myResourceGroup | Benutzereingabe |
| managementGroupId | myManagementGroup | Benutzereingabe |
| apiVersion | • 2015-04-01 • 2017-03-01-preview (für die Managementgruppenebene) |
Referenz |
Anzeigen des Änderungsverlaufs
Bei einigen Ereignissen können Sie den Änderungsverlauf anzeigen, in dem ersichtlich wird, welche Änderungen während dieses Ereignisses aufgetreten sind. Wählen Sie ein Ereignis aus dem Aktivitätsprotokoll aus, das Sie genauer betrachten möchten. Wählen Sie die Registerkarte " Änderungsverlauf " aus, um alle Änderungen der Ressource bis zu 30 Minuten vor und nach dem Zeitpunkt des Vorgangs anzuzeigen.
Wenn Änderungen mit dem Ereignis verknüpft sind, zeigt ihnen das Portal eine auswählbare Liste mit Änderungen an. Wenn Sie eine Änderung auswählen, wird die Seite " Änderungsverlauf" geöffnet. Auf dieser Seite werden die Änderungen an der Ressource angezeigt.
Das folgende Beispiel zeigt, dass die Größe des virtuellen Computers geändert wurde. Auf der Seite wird die VM-Größe vor der Änderung und nach der Änderung angezeigt. Um mehr über den Änderungsverlauf zu erfahren, sehen Sie Ressourcenänderungen abrufen.
Einblicke in das Aktivitätsprotokoll
„Aktivitätsprotokollerkenntnisse” sind eine Azure Monitor-Arbeitsmappe mit einer Reihe von Dashboards, die die Änderungen an Ressourcen und Ressourcengruppen in einem Abonnement überwachen. Die Dashboards enthalten auch Daten darüber, welche Benutzer oder Dienste Aktivitäten im Abonnement und den Status der Aktivitäten ausgeführt haben.
Um Aktivitätsprotokollerkenntnisse zu aktivieren, exportieren Sie das Aktivitätsprotokoll in einen Log Analytics Arbeitsbereich, wie in Exportieren von Aktivitätsprotokoll beschrieben. Dieser Prozess sendet Ereignisse an die AzureActivity Tabelle, die Aktivitätsprotokoll-Einblicke verwendet.
Sie können Erkenntnisse aus dem Aktivitätsprotokoll auf Abonnement- oder Ressourcenebene öffnen. Wählen Sie für das Abonnement unter dem Menü Monitor im Abschnitt Arbeitsmappen die Option Erkenntnisse aus Aktivitätsprotokollen aus.
Wählen Sie für eine einzelne Ressource Einsicht in Aktivitätsprotokolle im Abschnitt Arbeitsmappen des Menüs der Ressource aus.
Aktivitätsprotokoll exportieren
Erstellen Sie eine Diagnoseeinstellung, um Aktivitätsprotokolleinträge für zusätzliche Aufbewahrungszeit und Funktionalität an andere Ziele zu senden.
Wählen Sie im Azure-Portal Aktivitätsprotokoll im Menü Azure Monitor aus, und wählen Sie dann Exportieren von Aktivitätsprotokollen aus. Weitere Informationen und andere Methoden zum Erstellen von Diagnoseeinstellungen finden Sie unter "Diagnoseeinstellungen" in Azure Monitor. Stellen Sie sicher, dass Sie alle Legacy-Konfigurationen für das Aktivitätsprotokoll deaktivieren.
Die folgenden Abschnitte enthalten Details zu jedem konfigurierbaren Ziel für Ressourcenprotokolle.
Hinweis
Die Vorgängermethode zum Exportieren des Aktivitätsprotokolls ist Protokollprofile. Weitere Informationen finden Sie unter Vorgängererfassungsmethoden.
Senden Sie das Aktivitätsprotokoll an einen Log Analytics-Arbeitsbereich für die folgenden Funktionen:
- Korrelieren Sie Aktivitätsprotokolle mit anderen Protokolldaten mithilfe von Protokollabfragen.
- Erstellen Sie Protokollwarnungen, die komplexere Logik als Aktivitätsprotokollwarnungen verwenden können.
- Zugreifen auf Aktivitätsprotokolldaten mit Power BI.
- Bewahren Sie Aktivitätsprotokolldaten länger als 90 Tage auf.
Es gibt keine Datenaufnahmegebühren für Aktivitätsprotokolle. Aufbewahrungsgebühren für Aktivitätsprotokolle gelten nur für den Zeitraum, der über den Standardaufbewahrungszeitraum von 90 Tagen verlängert wurde. Sie können den Aufbewahrungszeitraum auf bis zu 12 Jahre erhöhen.
Aktivitätsprotokolldaten in einem Log Analytics Arbeitsbereich werden in einer Tabelle mit dem Namen AzureActivity gespeichert. Die Struktur dieser Tabelle variiert je nach Kategorie des Protokolleintrags.
Zeigen Sie z. B. mit der folgenden Abfrage die Anzahl der Aktivitätsprotokoll-Datensätze für jede Kategorie an:
AzureActivity
| summarize count() by CategoryValue
Verwenden Sie die folgende Abfrage, um alle Datensätze in der Kategorie „Administrativ“ abzurufen:
AzureActivity
| where CategoryValue == "Administrative"
Von Bedeutung
In einigen Szenarien können die Werte in den Feldern von AzureActivity eine andere Groß-/Kleinschreibung haben als die sonst gleichwertigen Werte. Verwenden Sie beim Abfragen von Daten in AzureActivity Operatoren ohne Berücksichtigung der Groß-/Kleinschreibung für Zeichenfolgenvergleiche, oder verwenden Sie eine Skalarfunktion, um für ein Feld vor allen Vergleichen eine einheitliche Groß-/Kleinschreibung zu erzwingen. Verwenden Sie z. B. die tolower()-Funktion in einem Feld, um zu erzwingen, dass es immer in Kleinbuchstaben geschrieben wird, und den =~ Operator, wenn Sie einen Zeichenfolgenvergleich durchführen.
Exportieren von Verwaltungsgruppen-Aktivitätsprotokollen
Wenn Sie eine Diagnoseeinstellung für eine Verwaltungsgruppe erstellen, werden Azure Monitor-Aktivitätsprotokollereignisse für diese Verwaltungsgruppe zusammen mit allen Verwaltungsgruppen in der Hierarchie exportiert. Wenn mehrere Verwaltungsgruppen in der Hierarchie Diagnoseeinstellungen aufweisen, erhalten Sie doppelte Ereignisse. Sie benötigen nur eine Diagnoseeinstellung für die Verwaltungsgruppe der höchsten Ebene, um alle Ereignisse für die Hierarchie zu erfassen.
Die Verwaltungsgruppe sammelt auch viele der gleichen Ereignisse wie alle ihr untergeordneten Abonnements. Wenn sowohl die Abonnement- als auch die Verwaltungsgruppe über Diagnoseeinstellungen verfügen, erhalten Sie duplizierte Ereignisse. Azure Resource Manager enthält eine Hierarchieeigenschaft beim Schreiben von Ereignissen, aber es ist kein erforderliches Feld. Ressourcenanbieter außerhalb des Azure Resource Managers füllen diese nicht aus, sodass ihre Ereignisse nicht in der Hierarchie nach oben weitergeleitet werden. Aus diesem Grund ist das Abrufen doppelter Ereignisse besser als fehlende Ereignisse.
Wenn Sie beispielsweise MG1 haben, das MG2 enthält, das wiederum Subscription1 enthält, erfasst eine Diagnoseeinstellung auf MG1 alle Aktivitätsprotokollereignisse für MG1, MG2 und viele der Ereignisse, die von einer Diagnoseeinstellung auf Subscription1 gesammelt werden. In diesem Fall ist keine Diagnoseeinstellung für MG2 erforderlich, da sie nur doppelte Ereignisse sammeln würde.
Wenn Sie doppelte Ereignisse haben, kombinieren Sie sie mithilfe einer Abfrage, die einen Hash aller Felder verwendet, um eindeutige Datensätze zu identifizieren. Das folgende Beispiel einer Kusto-Abfrage zeigt ein Beispiel für Protokolle, die in einem Log Analytics Arbeitsbereich gesammelt wurden:
AzureActivity
| extend Hash = hash(dynamic_to_json(pack_all()))
| summarize arg_max(TimeGenerated, *) by Hash
Exportieren des Aktivitätsprotokolls in eine Datei
Wählen Sie "Als CSV herunterladen" aus, um das Aktivitätsprotokoll in eine CSV-Datei im Azure-Portal zu exportieren.
Von Bedeutung
Das Exportieren einer großen Anzahl von Protokolleinträgen kann eine lange Zeit dauern. Um die Leistung zu verbessern, verringern Sie den Zeitraum des Exports. Legen Sie im Azure-Portal die Einstellung "Timespan " fest.
Identifizierung der Ressourcenerstellung
Verwenden Sie das Aktivitätsprotokoll, um herauszufinden, wann das System eine Ressource erstellt hat und wer sie erstellt hat. Das Aktivitätsprotokoll ist der einzige Ort, an dem der Ersteller einer Ressource gespeichert wird. Da das Aktivitätsprotokoll daten standardmäßig nur 90 Tage lang aufbewahrt, müssen Sie die Protokolle an einen Speicherort exportieren, mit dem Sie den Aufbewahrungszeitraum wie einen Log Analytics-Arbeitsbereich verlängern können. Suchen Sie dann den Ersteller einer Ressource, indem Sie die AzureActivity Tabelle abfragen. Die Daten werden für die Dauer aufbewahrt, die Sie im Aufbewahrungszeitraum für diese Tabelle angegeben haben.