Azure Opslaganalyse-logboeken inschakelen en beheren (klassiek)

Azure Opslaganalyse biedt logboeken voor blobs, wachtrijen en tabellen. U kunt de Azure Portal gebruiken om logboeken voor uw account te configureren. In dit artikel wordt beschreven hoe u logboeken inschakelt en beheert. Zie Metrische gegevens van Azure Opslaganalyse inschakelen en beheren (klassiek) voor meer informatie over het inschakelen van metrische gegevens. Er zijn kosten verbonden aan het onderzoeken en opslaan van bewakingsgegevens in de Azure Portal. Zie Opslaganalyse voor meer informatie.

Notitie

U wordt aangeraden Azure Storage-logboeken in Azure Monitor te gebruiken in plaats van Opslaganalyse logboeken. Zie een van de volgende artikelen:

• Bewaking van Azure Blob Storage
• Bewaking van Azure Files
• Azure Queue Storage bewaken
• Azure Table Storage bewaken

Logboeken inschakelen

U kunt Azure Storage instrueren om diagnostische logboeken op te slaan voor lees-, schrijf- en verwijderaanvragen voor de blob-, tabel- en wachtrijservices. Het beleid voor gegevensretentie dat u instelt, is ook van toepassing op deze logboeken.

Notitie

Azure Files ondersteunt momenteel Opslaganalyse metrische gegevens, maar biedt geen ondersteuning voor Opslaganalyse logboekregistratie.

Portal

1. Selecteer in de Azure PortalOpslagaccounts en vervolgens de naam van het opslagaccount om de blade opslagaccount te openen.

2. Selecteer Diagnostische instellingen (klassiek) in de sectie Bewaking (klassiek) van de menublade.

   

3. Zorg ervoor dat Status is ingesteld op Aan en selecteer de services waarvoor u logboekregistratie wilt inschakelen.

   

4. Als u logboeken wilt bewaren, moet u ervoor zorgen dat het selectievakje Gegevens verwijderen is ingeschakeld. Stel vervolgens het aantal dagen in dat logboekgegevens moeten worden bewaard door het schuifregelaarbesturingselement onder het selectievakje te plaatsen of door de waarde die wordt weergegeven in het tekstvak naast het schuifregelaarbesturingselement rechtstreeks te wijzigen. De standaardwaarde voor nieuwe opslagaccounts is zeven dagen. Als u geen bewaarbeleid wilt instellen, laat u het selectievakje Gegevens verwijderen uitgeschakeld. Als er geen bewaarbeleid is, moet u de logboekgegevens verwijderen.

   Waarschuwing

   Logboeken worden opgeslagen als gegevens in uw account. Logboekgegevens kunnen zich in de loop van de tijd in uw account verzamelen, wat de opslagkosten kan verhogen. Als u logboekgegevens slechts voor een korte periode nodig hebt, kunt u uw kosten verlagen door het beleid voor gegevensretentie te wijzigen. Verouderde logboekgegevens (gegevens die ouder zijn dan uw bewaarbeleid) worden door het systeem verwijderd. We raden u aan een bewaarbeleid in te stellen op basis van hoe lang u de logboekgegevens voor uw account wilt bewaren. Zie Facturering voor metrische opslaggegevens voor meer informatie.

5. Klik op Opslaan.

   De diagnostische logboeken worden opgeslagen in een blobcontainer met de naam $logs in uw opslagaccount. U kunt de logboekgegevens weergeven met behulp van een Storage Explorer, zoals de Microsoft Azure Storage Explorer, of programmatisch met behulp van de opslagclientbibliotheek of PowerShell.

   Zie Logboekregistratie van opslaganalyses voor informatie over het openen van de $logs-container.

   Notitie

   Voor klassieke opslagaccounts wordt de $logs container alleen weergegeven in Azure Storage Explorer. De $logs container is niet zichtbaar vanuit de opslagbrowser of de containerweergave die beschikbaar is in de Azure Portal.

PowerShell

1. Open een Windows PowerShell opdrachtvenster.

2. Meld u aan bij uw Azure-abonnement met de opdracht Connect-AzAccount en volg de instructies op het scherm.

   Connect-AzAccount
   

3. Als uw identiteit is gekoppeld aan meer dan één abonnement, stelt u uw actieve abonnement in.

   $context = Get-AzSubscription -SubscriptionId <subscription-id>
   Set-AzContext $context
   

   Vervang de waarde van de <subscription-id> tijdelijke aanduiding door de id van uw abonnement.

4. Haal de context van het opslagaccount op die het opslagaccount definieert dat u wilt gebruiken.

   $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
   $ctx = $storageAccount.Context
   

   • Vervang de waarde van de <resource-group-name> tijdelijke aanduiding door de naam van uw resourcegroep.

   • Vervang de waarde van de tijdelijke plaatsaanduiding <storage-account-name> door de naam van uw opslagaccount.

5. Gebruik de Set-AzStorageServiceLoggingProperty om de huidige logboekinstellingen te wijzigen. De cmdlets die opslaglogboekregistratie beheren, gebruiken een parameter LoggingOperations die een tekenreeks is met een door komma's gescheiden lijst met aanvraagtypen die moeten worden geregistreerd. De drie mogelijke aanvraagtypen zijn lezen, schrijven en verwijderen. Als u logboekregistratie wilt uitschakelen, gebruikt u de waarde none voor de parameter LoggingOperations .

   Met de volgende opdracht schakelt u logboekregistratie voor lees-, schrijf- en verwijderaanvragen in de Queue-service in uw standaardopslagaccount in met een retentie ingesteld op vijf dagen:

   Set-AzStorageServiceLoggingProperty -ServiceType Queue -LoggingOperations read,write,delete -RetentionDays 5 -Context $ctx
   

   Waarschuwing

   Logboeken worden opgeslagen als gegevens in uw account. logboekgegevens kunnen zich in de loop van de tijd in uw account ophopen, waardoor de opslagkosten kunnen toenemen. Als u logboekgegevens slechts voor een korte periode nodig hebt, kunt u uw kosten verlagen door het beleid voor gegevensretentie te wijzigen. Verouderde logboekgegevens (gegevens die ouder zijn dan uw bewaarbeleid) worden door het systeem verwijderd. We raden u aan een bewaarbeleid in te stellen op basis van hoe lang u de logboekgegevens voor uw account wilt bewaren. Zie Facturering voor metrische opslaggegevens voor meer informatie.

   Met de volgende opdracht schakelt u logboekregistratie uit voor de tabelservice in uw standaardopslagaccount:

   Set-AzStorageServiceLoggingProperty -ServiceType Table -LoggingOperations none -Context $ctx 
   

   Voor informatie over het configureren van de Azure PowerShell-cmdlets voor gebruik met uw Azure-abonnement en het selecteren van het standaardopslagaccount dat u wilt gebruiken, raadpleegt u: Azure PowerShell installeren en configureren.

.NET

QueueServiceClient queueServiceClient = new QueueServiceClient(connectionString);

QueueServiceProperties serviceProperties = queueServiceClient.GetProperties().Value;

serviceProperties.Logging.Delete = true;

QueueRetentionPolicy retentionPolicy = new QueueRetentionPolicy();
retentionPolicy.Enabled = true;
retentionPolicy.Days = 2;
serviceProperties.Logging.RetentionPolicy = retentionPolicy;

serviceProperties.HourMetrics = null;
serviceProperties.MinuteMetrics = null;
serviceProperties.Cors = null;

queueServiceClient.SetProperties(serviceProperties);

Retentieperiode voor logboekgegevens wijzigen

Logboekgegevens kunnen zich in de loop van de tijd in uw account verzamelen, wat de opslagkosten kan verhogen. Als u logboekgegevens slechts voor een korte periode nodig hebt, kunt u uw kosten verlagen door de bewaarperiode voor logboekgegevens te wijzigen. Als u bijvoorbeeld logboeken slechts drie dagen nodig hebt, stelt u de bewaarperiode voor logboekgegevens in op de waarde .3 Op die manier worden logboeken na 3 dagen automatisch verwijderd uit uw account. In deze sectie ziet u hoe u de huidige bewaarperiode voor logboekgegevens kunt weergeven en deze periode vervolgens kunt bijwerken als u dat wilt doen.

Portal

1. Selecteer in de Azure PortalOpslagaccounts en vervolgens de naam van het opslagaccount om de blade opslagaccount te openen.

2. Selecteer Diagnostische instellingen (klassiek) in de sectie Bewaking (klassiek) van de menublade.

   

3. Zorg ervoor dat het selectievakje Gegevens verwijderen is ingeschakeld. Stel vervolgens het aantal dagen in dat logboekgegevens moeten worden bewaard door het schuifregelaarbesturingselement onder het selectievakje te plaatsen of door de waarde die wordt weergegeven in het tekstvak naast het schuifregelaarbesturingselement rechtstreeks te wijzigen.

   

   Het standaardaantal dagen voor nieuwe opslagaccounts is zeven dagen. Als u geen bewaarbeleid wilt instellen, laat u het selectievakje Gegevens verwijderen uitgeschakeld. Als er geen bewaarbeleid is, is het aan u om de bewakingsgegevens te verwijderen.

4. Klik op Opslaan.

   De diagnostische logboeken worden opgeslagen in een blobcontainer met de naam $logs in uw opslagaccount. U kunt de logboekgegevens weergeven met behulp van een Storage Explorer, zoals de Microsoft Azure Storage Explorer, of programmatisch met behulp van de opslagclientbibliotheek of PowerShell.

   Zie Logboekregistratie van opslaganalyses voor informatie over het openen van de $logs-container.

PowerShell

1. Open een Windows PowerShell opdrachtvenster.

2. Meld u aan bij uw Azure-abonnement met de opdracht Connect-AzAccount en volg de instructies op het scherm.

   Connect-AzAccount
   

3. Als uw identiteit is gekoppeld aan meer dan één abonnement, stelt u uw actieve abonnement in.

   $context = Get-AzSubscription -SubscriptionId <subscription-id>
   Set-AzContext $context
   

   Vervang de waarde van de <subscription-id> tijdelijke aanduiding door de id van uw abonnement.

4. Haal de context van het opslagaccount op die het opslagaccount definieert.

   $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
   $ctx = $storageAccount.Context
   

   • Vervang de waarde van de <resource-group-name> tijdelijke aanduiding door de naam van uw resourcegroep.

   • Vervang de waarde van de tijdelijke plaatsaanduiding <storage-account-name> door de naam van uw opslagaccount.

5. Gebruik get-AzStorageServiceLoggingProperty om het huidige bewaarbeleid voor logboeken weer te geven. In het volgende voorbeeld wordt de retentieperiode voor blob- en wachtrijopslagservices naar de console afgedrukt.

   Get-AzStorageServiceLoggingProperty -ServiceType Blob, Queue -Context $ctx
   

   In de console-uitvoer wordt de bewaarperiode weergegeven onder de RetentionDays kolomkop.

   

6. Gebruik de Set-AzStorageServiceLoggingProperty om de retentieperiode te wijzigen. In het volgende voorbeeld wordt de retentieperiode gewijzigd in 4 dagen.

   Set-AzStorageServiceLoggingProperty -ServiceType Blob, Queue -RetentionDays 4 -Context $ctx
   

   Zie Voor informatie over het configureren van de Azure PowerShell cmdlets voor gebruik met uw Azure-abonnement en het selecteren van het standaardopslagaccount dat u wilt gebruiken: Azure PowerShell installeren en configureren.

.NET

In het volgende voorbeeld wordt de retentieperiode voor blob- en wachtrijopslagservices in de console afgedrukt.

BlobServiceClient blobServiceClient = new BlobServiceClient(connectionString);
QueueServiceClient queueServiceClient = new QueueServiceClient(connectionString);

BlobServiceProperties blobServiceProperties = blobServiceClient.GetProperties().Value;
QueueServiceProperties queueServiceProperties = queueServiceClient.GetProperties().Value;

Console.WriteLine("Retention period for logs from the blob service is: " +
    blobServiceProperties.Logging.RetentionPolicy.Days.ToString());

Console.WriteLine("Retention period for logs from the queue service is: " +
    queueServiceProperties.Logging.RetentionPolicy.Days.ToString());

In het volgende voorbeeld wordt de retentieperiode gewijzigd in 4 dagen.

BlobRetentionPolicy blobRetentionPolicy = new BlobRetentionPolicy();

blobRetentionPolicy.Enabled = true;
blobRetentionPolicy.Days = 4;

QueueRetentionPolicy queueRetentionPolicy = new QueueRetentionPolicy();

queueRetentionPolicy.Enabled = true;
queueRetentionPolicy.Days = 4;

blobServiceProperties.Logging.RetentionPolicy = blobRetentionPolicy;
blobServiceProperties.Cors = null;

queueServiceProperties.Logging.RetentionPolicy = queueRetentionPolicy;
queueServiceProperties.Cors = null;

blobServiceClient.SetProperties(blobServiceProperties);
queueServiceClient.SetProperties(queueServiceProperties);

Console.WriteLine("Retention policy for blobs and queues is updated");

Controleren of logboekgegevens worden verwijderd

U kunt controleren of logboeken worden verwijderd door de inhoud van de $logs container van uw opslagaccount te bekijken. In de volgende afbeelding ziet u de inhoud van een map in de $logs container. De map komt overeen met januari 2021 en elke map bevat logboeken voor één dag. Als de dag van vandaag 29 januari 2021 was en uw bewaarbeleid is ingesteld op slechts één dag, moet deze map logboeken voor slechts één dag bevatten.

Logboekgegevens weergeven

Als u uw logboekgegevens wilt weergeven en analyseren, moet u de blobs met de logboekgegevens waarin u geïnteresseerd bent, downloaden naar een lokale computer. Met veel hulpprogramma's voor browsen op opslag kunt u blobs downloaden uit uw opslagaccount; u kunt ook het Azure Storage-team met de opdrachtregel Azure Copy Tool AzCopy gebruiken om uw logboekgegevens te downloaden.

Notitie

De $logs container is niet geïntegreerd met Event Grid, dus u ontvangt geen meldingen wanneer er logboekbestanden worden geschreven.

Ga als volgt te werk om ervoor te zorgen dat u de logboekgegevens downloadt waarin u geïnteresseerd bent en om te voorkomen dat dezelfde logboekgegevens meerdere keren worden gedownload:

• Gebruik de datum- en tijdnaamconventie voor blobs die logboekgegevens bevatten om bij te houden welke blobs u al hebt gedownload voor analyse om te voorkomen dat dezelfde gegevens meerdere keren opnieuw worden gedownload.

• Gebruik de metagegevens van de blobs die logboekgegevens bevatten om de specifieke periode te identificeren waarin de blob logboekgegevens bevat om de exacte blob te identificeren die u moet downloaden.

Zie Aan de slag met AzCopy om aan de slag te gaan met AzCopy.

In het volgende voorbeeld ziet u hoe u de logboekgegevens voor de wachtrijservice kunt downloaden voor de uren vanaf 09:00, 10:00 en 11:00 uur op 20 mei 2014.

azcopy copy 'https://mystorageaccount.blob.core.windows.net/$logs/queue' 'C:\Logs\Storage' --include-path '2014/05/20/09;2014/05/20/10;2014/05/20/11' --recursive

Zie Blobs downloaden uit Azure Blob Storage met behulp van AzCopy v10 voor meer informatie over het downloaden van specifieke bestanden.

Wanneer u uw logboekgegevens hebt gedownload, kunt u de logboekvermeldingen in de bestanden bekijken. Deze logboekbestanden gebruiken een tekstindeling met scheidingstekens die door veel hulpprogramma's voor het lezen van logboeken kunnen worden geparseerd (zie de handleiding Bewaking, diagnose en probleemoplossing Microsoft Azure Storage voor meer informatie). Verschillende hulpprogramma's hebben verschillende faciliteiten voor het opmaken, filteren, sorteren en zoeken naar de inhoud van uw logboekbestanden. Zie Opslaganalyse Logboekindeling en Opslaganalyse Geregistreerde bewerkingen en statusberichten voor meer informatie over de bestandsindeling en inhoud van logboekregistratie voor opslaglogboeken.

Volgende stappen

• Zie Opslaganalyse voor Opslaganalyse voor meer informatie over Opslaganalyse.
• Zie Naslaginformatie over opslagclientbibliotheek voor meer informatie over het gebruik van een .NET-taal voor het configureren van logboekregistratie voor opslag.
• Zie Enabling and Configuring Opslaganalyse (Inschakelen en configureren van Opslaganalyse) voor algemene informatie over het configureren van logboekregistratie voor opslag met behulp van de REST API.
• Meer informatie over de indeling van Opslaganalyse logboeken. Zie Opslaganalyse Logboekindeling.