Azure Opslaganalyse-logboeken inschakelen en beheren (klassiek)

Azure Opslaganalyse biedt logboeken voor blobs, wachtrijen en tabellen. U kunt Azure Portal gebruiken om logboeken te configureren die worden vastgelegd voor uw account. In dit artikel leest u hoe u logboeken inschakelt en beheert. Zie Overgang naar metrische gegevens in Azure Monitor voor meer informatie over het inschakelen van metrische gegevens. Er zijn kosten verbonden aan het onderzoeken en opslaan van bewakingsgegevens in Azure Portal. Zie Opslaganalyse voor meer informatie.

Notitie

U wordt aangeraden Azure Storage-logboeken te gebruiken in Azure Monitor 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 diagnostische logboeken op te slaan voor lees-, schrijf- en verwijderaanvragen voor de blob-, tabel- en wachtrijservices. Het bewaarbeleid voor gegevens 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 opslagaccounts in Azure Portal 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 behouden, moet u ervoor zorgen dat het selectievakje Gegevens verwijderen is ingeschakeld. Stel vervolgens het aantal dagen in dat u logboekgegevens wilt bewaren door het schuifregelaarbesturingselement onder het selectievakje te verplaatsen of door de waarde die in het tekstvak naast het besturingselement schuifregelaar wordt weergegeven, 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, is het aan u om de logboekgegevens te verwijderen.

   Waarschuwing

   Logboeken worden opgeslagen als gegevens in uw account. Logboekgegevens kunnen zich in uw account in de loop van de tijd verzamelen, waardoor de opslagkosten kunnen worden verhoogd. Als u slechts een korte periode logboekgegevens nodig hebt, kunt u uw kosten verlagen door het bewaarbeleid voor gegevens te wijzigen. Verouderde logboekgegevens (gegevens ouder dan uw bewaarbeleid) worden door het systeem verwijderd. U wordt aangeraden een bewaarbeleid in te stellen op basis van hoe lang u de logboekgegevens voor uw account wilt bewaren. Zie Facturering voor metrische gegevens over opslag 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 opslagverkenner, zoals Microsoft Azure Storage Explorer, of programmatisch met behulp van de opslagclientbibliotheek of PowerShell.

   Zie Logboekregistratie van Opslaganalyse 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 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 waarmee het opslagaccount wordt gedefinieerd 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 Set-AzStorageServiceLoggingProperty om de huidige logboekinstellingen te wijzigen. De cmdlets die opslaglogboekregistratie beheren, maken gebruik van een parameter LoggingOperations die een tekenreeks is die een door komma's gescheiden lijst met aanvraagtypen bevat die moeten worden geregistreerd. De drie mogelijke aanvraagtypen zijn lezen, schrijven en verwijderen. Als u logboekregistratie wilt uitschakelen, gebruikt u de waarde geen voor de parameter LoggingOperations.

   Met de volgende opdracht schakelt u logboekregistratie in voor lees-, schrijf- en verwijderaanvragen in de Queue-service in uw standaardopslagaccount met bewaarperiode 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 uw account in de loop van de tijd verzamelen, waardoor de opslagkosten kunnen worden verhoogd. Als u slechts een korte periode logboekgegevens nodig hebt, kunt u uw kosten verlagen door het bewaarbeleid voor gegevens te wijzigen. Verouderde logboekgegevens (gegevens ouder dan uw bewaarbeleid) worden door het systeem verwijderd. U wordt aangeraden een bewaarbeleid in te stellen op basis van hoe lang u de logboekgegevens voor uw account wilt bewaren. Zie Facturering voor metrische gegevens over opslag voor meer informatie.

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

   Set-AzStorageServiceLoggingProperty -ServiceType Table -LoggingOperations none -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

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 uw account in de loop van de tijd verzamelen, waardoor de opslagkosten kunnen worden verhoogd. Als u logboekgegevens slechts 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 een waarde van 3. Op die manier worden logboeken na 3 dagen automatisch uit uw account verwijderd. In deze sectie wordt beschreven hoe u de huidige bewaarperiode voor logboekgegevens kunt bekijken en deze periode vervolgens kunt bijwerken als u dat wilt doen.

Portal

1. Selecteer opslagaccounts in Azure Portal 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 u logboekgegevens wilt bewaren door het schuifregelaarbesturingselement onder het selectievakje te verplaatsen of door de waarde die in het tekstvak naast het besturingselement schuifregelaar wordt weergegeven, 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 opslagverkenner, zoals Microsoft Azure Storage Explorer, of programmatisch met behulp van de opslagclientbibliotheek of PowerShell.

   Zie Logboekregistratie van Opslaganalyse 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 waarmee het opslagaccount wordt gedefinieerd.

   $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 bewaarperiode voor blob- en wachtrijopslagservices in de console afgedrukt.

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

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

   

6. Gebruik Set-AzStorageServiceLoggingProperty om de bewaarperiode te wijzigen. In het volgende voorbeeld wordt de bewaarperiode 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 bewaarperiode 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 bewaarperiode 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 weer te geven. 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 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 bekijken en analyseren, moet u de blobs downloaden die de logboekgegevens bevatten waarin u geïnteresseerd bent op een lokale computer. Met veel hulpprogramma's voor het bladeren door opslag kunt u blobs downloaden uit uw opslagaccount; u kunt ook het Azure Storage-team gebruiken dat de opdrachtregel azure Copy Tool AzCopy biedt om uw logboekgegevens te downloaden.

Notitie

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

Om ervoor te zorgen dat u de logboekgegevens downloadt waarin u geïnteresseerd bent en om te voorkomen dat u dezelfde logboekgegevens meer dan één keer downloadt:

• Gebruik de naamconventie voor datum en tijd voor blobs die logboekgegevens bevatten om bij te houden welke blobs u al hebt gedownload voor analyse om te voorkomen dat dezelfde gegevens meer dan één keer opnieuw worden gedownload.

• Gebruik de metagegevens op de blobs die logboekgegevens bevatten om de specifieke periode te identificeren waarvoor 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 die beginnen om 09:00 uur, 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 veel hulpprogramma's voor logboeken kunnen parseren (zie de handleiding Bewaking, Diagnose en probleemoplossing van Microsoft Azure Storage) voor meer informatie. Verschillende hulpprogramma's hebben verschillende voorzieningen voor het opmaken, filteren, sorteren, advertentie doorzoeken van de inhoud van uw logboekbestanden. Zie Opslaganalyse Logboekindeling en Opslaganalyse vastgelegde bewerkingen en statusberichten voor meer informatie over de logboekindeling en -inhoud van logboekregistratie.

Volgende stappen

• Zie Opslaganalyse voor Opslaganalyse voor meer informatie over Opslaganalyse.
• Zie de naslaginformatie over opslagclientbibliotheek voor meer informatie over het gebruik van een .NET-taal voor het configureren van logboekregistratie van opslag.
• Zie Het inschakelen en configureren van Opslaganalyse voor algemene informatie over het configureren van logboekregistratie met behulp van de REST API.
• Meer informatie over de indeling van Opslaganalyse logboeken. Zie Opslaganalyse Logboekindeling.