Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Azure Monitor registreert beheerbewerkingen voor uw Azure resources via de functie activiteitenlogboek. In het activiteitenlogboek worden bewerkingen vastgelegd, zoals het maken van een virtuele machine, het wijzigen van een toegangsbeleid voor een sleutelkluis of Resource Manager implementatiefouten. Deze beheerbewerkingen worden ook wel besturingsvlakbewerkingen genoemd. Gebruik het activiteitenlogboek om deze informatie te bekijken of te controleren, of stel een waarschuwing in om proactief op de hoogte te worden gesteld wanneer er een gebeurtenis plaatsvindt.
In tegenstelling tot het activiteitenlogboek leggen Azure resourcelogboeken operaties op het gegevensvlak vast die binnen een resource worden uitgevoerd. Deze bewerkingen omvatten bijvoorbeeld het ophalen van een geheim uit een sleutelkluis of het indienen van een aanvraag bij een database. Resourcelogboeken worden niet standaard verzameld en vereisen configuratie met een diagnostische instelling.
Hint
Als een implementatiebewerkingsfout u naar dit artikel leidt, raadpleegt u Veelvoorkomende Azure-implementatiefouten oplossen.
Vermeldingen in activiteitenlogboek
Azure Monitor verzamelt standaard vermeldingen in activiteitenlogboeken zonder vereiste configuratie. Het systeem genereert deze vermeldingen en u kunt ze niet wijzigen of verwijderen. Vermeldingen zijn doorgaans het gevolg van wijzigingen (bewerkingen voor maken, bijwerken en verwijderen) of een actie die wordt gestart. In het activiteitenlogboek worden doorgaans geen leesbewerkingen vastgelegd.
Vermeldingen in het activiteitenlogboek zijn meestal beschikbaar voor analyse en waarschuwingen binnen 3 tot 20 minuten na de gebeurtenis. Zie Azure gebeurtenisschema voor activiteitenlogboeken voor een beschrijving van categorieën activiteitenlogboeken.
Bewaarperiode
Azure bewaart gebeurtenissen in het activiteitenlogboek gedurende 90 dagen en verwijdert ze. Er worden gedurende deze periode geen kosten in rekening gebracht voor invoer, ongeacht het volume. Voor meer functionaliteit, zoals langere retentie, maakt u een diagnostische instelling en verzamelt u de vermeldingen op een andere locatie op basis van uw behoeften. Een van de meest voorkomende redenen om de bewaarperiode uit te breiden, is het behouden van informatie over de maker van resources, die alleen beschikbaar is in het activiteitenlogboek.
Het activiteitenlogboek weergeven en ophalen
Activiteitenlogboeken weergeven voor een abonnement, resourcegroep of een afzonderlijke resource. Gebruik de Azure-portal of voer programmatisch een query uit met behulp van de Activity Log REST API.
De Azure-portal biedt vanuit de meeste servicemenu's het scherm Activiteitlogboek. Elk van deze gebieden biedt ook ondersteuning voor programmatische toegang met REST of via specifieke Azure CLI en Azure PowerShell opdrachten.
Geef een tijdsinterval op van gebeurtenissen die moeten worden opgehaald. Als u gebeurtenissen wilt ophalen met behulp van de REST API, moet u de $filter parameter samen met ten minste een eventTimestamp beginwaarde opnemen. In het activiteitenlogboek worden standaard gebeurtenissen gedurende 90 dagen bewaard. Zorg ervoor dat zowel het begin als het einde van uw tijdsbereik binnen dat periode van 90 dagen valt.
Scenario's voor toegang tot activiteitenlogboeken
De volgende secties bevatten veelvoorkomende scenario's met verschillende manieren om activiteitenlogboeken te openen en op te halen via de Azure-portal, programmatisch met behulp van Azure CLI en Azure PowerShell, of met REST-aanroepen:
Azure portalvoorbeelden bieden extra context over wat voor soort gebeurtenissen u in die weergave kunt verwachten.
Azure CLI-voorbeelden tonen de specifieke opdrachten die beschikbaar zijn via de opdracht az monitor activity-log list.
Azure PowerShell voorbeelden markeren de specifieke cmdlets die beschikbaar zijn via de Get-AzActivityLog-cmdlet.
REST API-voorbeelden laten zien hoe u gebeurtenissen ophaalt met behulp van de vereiste
$filterparameter met de REST API voor activiteitenlogboeken.Het voorbeeld Activiteitenlogboekgebeurtenissen voor een resourcegroep weergeven laat ook zien hoe u expliciet een time-out voor uw client instelt zodat deze overeenkomt met de maximale time-out van 75 seconden voor de REST API van het activiteitenlogboek, met behulp van de
Prefer-header.Ondersteunde $filterpatronenDetails standaardabonnement met een tijdsbereik $filter=eventTimestamp ge '{startTime}' and eventTimestamp le '{endTime}'resourcegroep $filter=eventTimestamp ge '{startTime}' and eventTimestamp le '{endTime}' and resourceGroupName eq '{resourceGroupName}'specifieke resource $filter=eventTimestamp ge '{startTime}' and eventTimestamp le '{endTime}' and resourceUri eq '{resourceURI}'bronleverancier $filter=eventTimestamp ge '{startTime}' and eventTimestamp le '{endTime}' and resourceProvider eq '{resourceProviderName}'correlatie-id $filter=eventTimestamp ge '{startTime}' and eventTimestamp le '{endTime}' and correlationId eq '{correlationID}'
Gebeurtenissen in activiteitenlogboeken voor een abonnement weergeven
Gebeurtenissen op abonnementsniveau leggen gebeurtenissen vast die rechtstreeks door resourceproviders zijn gemaakt en is het standaardbereik voor het weergeven van gebeurtenissen in activiteitenlogboeken. Gebeurtenissen op tenant- en beheergroepsniveau registreren alleen Azure Resource Manager-gebeurtenissen in deze hiërarchieën. Deze hogere scopes bevatten geen gebeurtenissen die rechtstreeks worden gegenereerd door resourceproviders, buiten de bewerkingen van Azure Resource Manager om.
In het volgende voorbeeld worden gebeurtenissen in het activiteitenlogboek voor een abonnement opgehaald tijdens een specifiek tijdsbereik.
Het menu waarin u het activiteitenlogboek opent, bepaalt het oorspronkelijke filter. Als u het opent vanuit het menu Monitor , is het abonnement het enige filter dat standaard is geselecteerd. Dit is hetzelfde als openen vanuit Abonnementen>, selecteer het abonnement >Activiteitenlogboek.
Gebeurtenissen in activiteitenlogboeken voor een resourcegroep weergeven
Voeg resourceGroupName toe aan de $filter om de resultaten van het activiteitenlogboek in Azure Monitor te beperken tot een specifieke resourcegroep.
Het menu waarin u het activiteitenlogboek opent, bepaalt het oorspronkelijke filter. Als u het opent vanuit het menu van een resource, wordt het filter ingesteld op die resource. Selecteer Filter toevoegen om aanvullende eigenschappen aan het filter toe te voegen. Hier volgen de andere eigenschappen waarop u kunt filteren in de portal:
- Resource - Items die deel uitmaken van uw Azure oplossing, zoals een database of virtuele machine.
- Resourcetype : de categorie waartoe een resource behoort, zoals virtuele machines, web-apps of databases.
- Operation : een actie of opdracht, zoals maken, verwijderen en schrijven, die van invloed is op Azure Resource Manager resources.
- Gebeurtenis geïnitieerd door – Filter gebeurtenissen op de identiteit die de gebeurtenis heeft gestart.
- Gebeurteniscategorie : filter de gebeurtenistypen voor bepaalde bewerkingen.
Specifieke eigenschappen van activiteitenlogboeken retourneren
Gebruik een parameter om alleen opgegeven eigenschappen te retourneren, waardoor de nettolading van het antwoord kleiner wordt. Zie beschrijvingen van schema-eigenschappen voor activiteitenlogboeken voor meer informatie.
De Azure-portal biedt geen manier om de eigenschappen die rechtstreeks worden geretourneerd door gebeurtenissen in het activiteitenlogboek te beperken. Als u de hoeveelheid weergegeven gegevens wilt verminderen, gebruikt u de optie Kolommen bewerken op de blade Activiteitenlogboek om te selecteren welke kolommen worden weergegeven in de portalweergave.
Activiteitenlogboekgebeurtenissen op tenantniveau vermelden
Activiteitenlogboekgebeurtenissen op tenantniveau hebben doorgaans beperkte vermeldingen, maar kunnen belangrijke gebeurtenissen bevatten, zoals het maken van beheergroepen of abonnementen. Deze gebeurtenissen staan los van activiteitenlogboekgebeurtenissen op abonnementsniveau, maar kunnen dubbele resourcebeheergebeurtenissen bevatten.
Bij het uitvoeren van query's op dit bereik wordt een andere REST API gebruikt dan de gebeurtenis-API voor activiteitenlogboeken op abonnementsniveau. Azure CLI en Azure PowerShell bieden geen toegewezen opdrachten.
Ga naar Monitor>Activity log in de Azure-portal. Wijzig het vervolgkeuzemenu Activiteit en selecteer Directoryactiviteit.
Activiteitenlogboekgebeurtenissen op groepsniveau voor lijstbeheer weergeven
Activiteitenlogboekgebeurtenissen op beheergroepsniveau leggen gebeurtenissen vast die zijn afgestemd op een specifieke beheergroep, zoals beleidstoewijzingen en wijzigingen in het lidmaatschap van beheergroepen.
Opmerking
- In de volgende voorbeelden wordt de
2017-03-01-previewAPI-versie gebruikt. Deze is vereist voor activiteitenlogboekquery's op beheergroepsniveau.
Als u activiteitenlogboekgebeurtenissen op beheergroepsniveau wilt weergeven in de Azure-portal, gaat u naar Managementgroepen> selecteert u een beheergroep >Activiteitslogboek.
Schermafbeelding van het blade Activiteitenlogboek voor een beheergroep in de Azure portal.
In de volgende tabel worden de parameters beschreven die in de voorgaande voorbeelden worden gebruikt.
| Variable | Voorbeeldwaarde | Purpose |
|---|---|---|
| host | management.azure.com | Impliciet ARM-eindpunt |
| subscriptionId | aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e | Gebruikersinvoer |
| resourceGroupName | myResourceGroup | Gebruikersinvoer |
| beheerGroepId | myManagementGroup | Gebruikersinvoer |
| apiVersion | • 2015-04-01 • 2017-03-01-preview (voor gebruik op het niveau van de beheergroep) |
Verwijzing |
Wijzigingsoverzicht weergeven
Voor sommige gebeurtenissen kunt u de wijzigingsgeschiedenis bekijken, waarin wordt weergegeven welke wijzigingen er zijn aangebracht tijdens die gebeurtenis. Selecteer een gebeurtenis in het activiteitenlogboek die u dieper wilt bekijken. Selecteer het tabblad Geschiedenis wijzigen om wijzigingen in de resource tot 30 minuten vóór en na de tijd van de bewerking weer te geven.
Als er wijzigingen aan de gebeurtenis zijn gekoppeld, ziet u in de portal een selecteerbare lijst met wijzigingen. Als u een wijziging selecteert, wordt de pagina Wijzigingsgeschiedenis geopend. Op deze pagina worden de wijzigingen in de resource weergegeven.
In het volgende voorbeeld ziet u dat de VM grootten heeft gewijzigd. Op de pagina wordt de VM-grootte weergegeven vóór de wijziging en na de wijziging. Zie Resourcewijzigingen ophalen voor meer informatie over wijzigingsgeschiedenis.
Inzichten in activiteitenlogboeken
Inzicht in het activiteitlogboek is een Azure Monitor-werkboek dat een reeks dashboards biedt waarmee de veranderingen in resources en resourcegroepen binnen een abonnement worden gemonitord. De dashboards bevatten ook gegevens over welke gebruikers of services activiteiten hebben uitgevoerd in het abonnement en de status van de activiteiten.
Als u inzichten in activiteitenlogboeken wilt inschakelen, exporteert u het activiteitenlogboek naar een Log Analytics werkruimte, zoals beschreven in Activiteitenlogboek exporteren. Met dit proces worden gebeurtenissen verzonden naar de AzureActivity tabel, die door inzichten in activiteitenlogboeken worden gebruikt.
U kunt inzichten in activiteitenlogboeken openen op abonnements- of resourceniveau. Voor het abonnement selecteert u Inzichten in activiteitenlogboeken in de sectie Werkmappen van het menu Monitor .
Voor een afzonderlijke resource selecteert u Inzichten in activiteitenlogboeken in de sectie Werkmappen van het menu van de resource.
Activiteitenlogboek exporteren
Maak een diagnostische instelling om vermeldingen in het activiteitenlogboek naar andere bestemmingen te verzenden voor extra bewaartijd en functionaliteit.
Selecteer in de Azure-portal Logboek van activiteit in het menu Azure Monitor en selecteer vervolgens Activiteitenlogboeken exporteren. Zie Diagnostische instellingen in Azure Monitor voor meer informatie en andere methoden voor het maken van diagnostische instellingen. Zorg ervoor dat u een verouderde configuratie voor het activiteitenlogboek uitschakelt.
De volgende secties bevatten details over elke configureerbare bestemming voor resourcelogboeken.
Opmerking
De verouderde methode voor het exporteren van het activiteitenlogboek is logboekprofielen. Zie Verouderde verzamelingsmethoden.
Verzend het activiteitenlogboek naar een Log Analytics werkruimte voor de volgende functionaliteit:
- Correleren van activiteitenlogboeken met andere logboekgegevens met behulp van logboekquery's.
- Logboekwaarschuwingen maken, die complexere logica kunnen gebruiken dan waarschuwingen voor activiteitenlogboeken.
- Toegang tot activiteitenlogboekgegevens met Power BI.
- Bewaar activiteitenlogboekgegevens langer dan 90 dagen.
Er zijn geen kosten voor gegevensopname voor activiteitenlogboeken. Bewaarkosten voor activiteitenlogboeken zijn alleen van toepassing op de periode die langer is dan de standaardretentieperiode van 90 dagen. U kunt de bewaarperiode verhogen tot maximaal 12 jaar.
Activiteitenlogboekgegevens in een Log Analytics werkruimte worden opgeslagen in een tabel met de naam AzureActivity. De structuur van deze tabel is afhankelijk van de categorie van de logboekvermelding.
Als u bijvoorbeeld het aantal records voor activiteitenlogboeken voor elke categorie wilt weergeven, gebruikt u de volgende query:
AzureActivity
| summarize count() by CategoryValue
Als u alle records in de beheercategorie wilt ophalen, gebruikt u de volgende query:
AzureActivity
| where CategoryValue == "Administrative"
Belangrijk
In sommige scenario's kunnen waarden in velden van AzureActivity andere equivalente waarden afwijken van andere equivalente waarden. Wanneer u gegevens opvraagt in AzureActivity, gebruikt u hoofdletterongevoelige operatoren voor tekenreeksvergelijkingen, of gebruikt u een scalaire functie om een veld te dwingen tot uniform hoofdlettergebruik voordat er vergelijkingen worden gemaakt. Gebruik bijvoorbeeld de functie tolower() op een veld om ervoor te zorgen dat het altijd uit kleine letters bestaat, of de =~ operator te gebruiken voor het uitvoeren van een tekenreeksvergelijking.
Activiteitenlogboeken van beheergroepen exporteren
Wanneer u een diagnostische instelling voor een beheergroep maakt, exporteert deze Azure Monitor activiteitenlogboekgebeurtenissen voor die beheergroep naast alle beheergroepen eronder in de hiërarchie. Als meerdere beheergroepen in de hiërarchie diagnostische instellingen hebben, ontvangt u dubbele gebeurtenissen. U hebt slechts een diagnostische instelling nodig op het hoogste niveau van de managementgroep om alle gebeurtenissen binnen de hiërarchie vast te leggen.
De beheergroep verzamelt ook veel van dezelfde gebeurtenissen als alle abonnementen eronder. Als het abonnement en de beheergroep beide diagnostische instellingen hebben, ontvangt u dubbele gebeurtenissen. Azure Resource Manager bevat een hiërarchie-eigenschap bij het schrijven van gebeurtenissen, maar dit is geen vereist veld. Resource-providers buiten Azure Resource Manager vullen het niet in, zodat hun gebeurtenissen niet door de hiërarchie worden doorgegeven. Als gevolg hiervan is het ophalen van dubbele gebeurtenissen beter dan ontbrekende gebeurtenissen.
Als u bijvoorbeeld MG1 hebt die MG2 bevat die Abonnement1 bevat, worden met een diagnostische instelling voor MG1 alle gebeurtenissen in het activiteitenlogboek vastgelegd voor MG1, MG2 en veel van de gebeurtenissen die zijn verzameld door een diagnostische instelling voor Abonnement1. In dit geval is er geen diagnostische instelling nodig voor MG2, omdat er alleen dubbele gebeurtenissen worden verzameld.
Als u dubbele gebeurtenissen hebt, combineert u deze met behulp van een query die gebruikmaakt van een hash van alle velden om unieke records te identificeren. In de volgende Kusto-query ziet u een voorbeeld voor logboeken die zijn verzameld in een Log Analytics werkruimte:
AzureActivity
| extend Hash = hash(dynamic_to_json(pack_all()))
| summarize arg_max(TimeGenerated, *) by Hash
Het activiteitenlogboek exporteren naar een bestand
Selecteer Downloaden als CSV om het activiteitenlogboek te exporteren naar een CSV-bestand in Azure Portal.
Belangrijk
Het exporteren van een groot aantal logboekvermeldingen kan lang duren. Verminder het tijdsbereik van de export om de prestaties te verbeteren. Stel in Azure Portal de instelling Tijdspanne in.
Resourcecreatie identificeren
Gebruik het activiteitenlogboek om erachter te komen wanneer het systeem een resource heeft gemaakt en wie het heeft gemaakt. Het activiteitenlogboek is de enige plaats waar de maker van een resource wordt opgeslagen. Omdat in het activiteitenlogboek alleen gegevens gedurende 90 dagen worden bewaard, moet u de logboeken exporteren naar een locatie waarmee u de bewaarperiode kunt verlengen, zoals een Log Analytics-werkruimte. Zoek vervolgens de maker van een resource door een query uit te voeren op de AzureActivity tabel. De gegevens worden bewaard voor de duur die u hebt opgegeven in de bewaarperiode voor deze tabel.