Azure Storage-analyselogboeken

Opslaganalyse registreert gedetailleerde informatie over geslaagde en mislukte aanvragen bij een opslagservice. Deze informatie kan worden gebruikt voor het bewaken van afzonderlijke aanvragen en voor het vaststellen van problemen met een opslagservice. Aanvragen worden geregistreerd op basis van best-effort. Dit betekent dat de meeste aanvragen resulteren in een logboekrecord, maar de volledigheid en tijdigheid van Storage Analytics-logboeken zijn niet gegarandeerd.

Logboekregistratie van Opslaganalyse is niet standaard ingeschakeld voor uw opslagaccount. U kunt deze inschakelen in Azure Portal of met behulp van PowerShell of Azure CLI. Zie Enable and manage Azure Storage Analytics logs (klassiek) (Inschakelen en beheren) voor stapsgewijse richtlijnen.

U kunt uw Analytics Storage logboeken ook programmatisch inschakelen via de REST API of de clientbibliotheek. Gebruik de bewerkingen Eigenschappen van Blob-service,Eigenschappen van Wachtrijserviceop halen en Eigenschappen van tabelservice op halen om Storage analytics voor elke service in te stellen. Zie Logboeken inschakelen voor een Storage Analytics-logboeken met behulp van .NET

Logboekgegevens worden alleen gemaakt als er aanvragen worden gedaan voor het service-eindpunt. Als een opslagaccount bijvoorbeeld activiteit heeft in het Blob-eindpunt, maar niet in de bijbehorende tabel- of wachtrij-eindpunten, worden alleen logboeken met betrekking tot de Blob service gemaakt.

Aanvragen die zijn geregistreerd in logboekregistratie

Geverifieerde aanvragen registreren

De volgende typen geverifieerde aanvragen worden geregistreerd:

• Geslaagde aanvragen

• Mislukte aanvragen, inclusief time-out-, beperkings-, netwerk-, autorisatiefouten en overige fouten

• Aanvragen waarvoor een SAS (Shared Access Signature) of OAuth is gebruikt, inclusief geslaagde en mislukte aanvragen

• Aanvragen voor analysegegevens

  Aanvragen die door Storage Analytics zelf worden gedaan, zoals het maken of verwijderen van logboeken, worden niet geregistreerd. Een volledige lijst met de vastgelegde gegevens wordt beschreven in de onderwerpen Storage Analytics Logged Operations and Status Messages en Storage Analytics Log Format.

Anonieme aanvragen registreren

De volgende typen anonieme aanvragen worden geregistreerd:

• Geslaagde aanvragen

• Serverfouten

• Time-outfouten voor client en server

• Mislukte GET-aanvragen met foutcode 304 (Niet gewijzigd)

  Alle andere mislukte anonieme aanvragen worden niet geregistreerd. Een volledige lijst met de vastgelegde gegevens wordt beschreven in de onderwerpen Storage Analytics Logged Operations and Status Messages en Storage Analytics Log Format.

Hoe logboeken worden opgeslagen

Alle logboeken worden opgeslagen in blok-blobs in een container met de naam , die automatisch wordt gemaakt wanneer Storage Analytics wordt ingeschakeld $logs voor een opslagaccount. De $logs container bevindt zich in de blob-naamruimte van het opslagaccount, bijvoorbeeld: http://<accountname>.blob.core.windows.net/$logs . Deze container kan niet worden verwijderd nadat Storage Analytics is ingeschakeld, maar de inhoud ervan kan wel worden verwijderd. Als u uw hulpprogramma voor het bladeren door opslag gebruikt om rechtstreeks naar de container te navigeren, ziet u alle blobs die uw logboekgegevens bevatten.

Wanneer aanvragen worden geregistreerd, uploadt Storage Analytics tussenliggende resultaten als blokken. Deze blokken worden Storage door Storage analytics en beschikbaar gemaakt als blob. Het kan een uur duren voordat logboekgegevens worden weergegeven in de blobs in de $logs-container, omdat de frequentie waarmee de opslagservice de logboekschrijvers leegt. Er kunnen dubbele records bestaan voor logboeken die in hetzelfde uur zijn gemaakt. U kunt bepalen of een record een duplicaat is door de RequestId en het Bewerkingsnummer te controleren.

Als u een groot aantal logboekgegevens met meerdere bestanden voor elk uur hebt, kunt u de blobmetagegevens gebruiken om te bepalen welke gegevens het logboek bevat door de blobmetagegevensvelden te onderzoeken. Dit is ook handig omdat er soms een vertraging kan zijn terwijl gegevens naar de logboekbestanden worden geschreven: de blobmetagegevens geven een nauwkeurigere indicatie van de blob-inhoud dan de blobnaam.

Met de meeste hulpprogramma's voor bladeren door opslag kunt u de metagegevens van blobs weergeven; U kunt deze informatie ook lezen met behulp van PowerShell of programmatisch. Het volgende PowerShell-fragment is een voorbeeld van het filteren van de lijst met logboekblobs op naam om een tijd op te geven en op metagegevens om alleen de logboeken te identificeren die schrijfbewerkingen bevatten.

Get-AzStorageBlob -Container '$logs' |  
Where-Object {  
    $_.Name -match 'blob/2014/05/21/05' -and   
    $_.ICloudBlob.Metadata.LogType -match 'write'  
} |  
ForEach-Object {  
    "{0}  {1}  {2}  {3}" –f $_.Name,   
    $_.ICloudBlob.Metadata.StartTime,   
    $_.ICloudBlob.Metadata.EndTime,   
    $_.ICloudBlob.Metadata.LogType  
}  

Zie Blob-resources opsnoemen en Eigenschappen en metagegevens ophalen voor Blob-resources voor informatie over het programmatisch weergeven van blobs.

Naamconventen voor logboeken

Elk logboek wordt geschreven in de volgende indeling:

<service-name>/YYYY/MM/DD/hhmm/<counter>.log

In de volgende tabel wordt elk kenmerk in de logboeknaam beschreven:

Hier volgt een volledig voorbeeld van een logboeknaam waarin de bovenstaande voorbeelden worden gecombineerd:

blob/2011/07/31/1800/000001.log

Hier volgt een voorbeeld-URI die kan worden gebruikt voor toegang tot het bovenstaande logboek:

https://<accountname>.blob.core.windows.net/$logs/blob/2011/07/31/1800/000001.log

Wanneer een opslagaanvraag wordt geregistreerd, correleert de resulterende logboeknaam met het uur waarop de aangevraagde bewerking is voltooid. Als een GetBlob-aanvraag bijvoorbeeld is voltooid om 18:30 uur op 31-7-2011, wordt het logboek geschreven met het volgende voorvoegsel: blob/2011/07/31/1800/

Logboekmetagegevens

Alle logboek-blobs worden opgeslagen met metagegevens die kunnen worden gebruikt om te identificeren welke logboekgegevens de blob bevat. In de volgende tabel wordt elk kenmerk voor metagegevens beschreven:

In de volgende lijst worden volledige voorbeeldmetagegevens weergegeven met behulp van de bovenstaande voorbeelden:

• LogType=write
• StartTime=2011-07-31T18:21:46Z
• EndTime=2011-07-31T18:22:09Z
• LogVersion=1.0

Volgende stappen

• Azure Opslaganalyse-logboeken inschakelen en beheren (klassiek)
• Storage Analyselogboekindeling
• Storage Analyse vastgelegde bewerkingen en statusberichten
• Storage Metrische gegevens voor analyse (klassiek)