Aktivera och hantera Azure-lagringsanalysloggar (klassisk)

Azure Lagringsanalys tillhandahåller loggar för blobar, köer och tabeller. Du kan använda Azure Portal för att konfigurera att loggar registreras för ditt konto. Den här artikeln visar hur du aktiverar och hanterar loggar. Information om hur du aktiverar mått finns i Övergång till mått i Azure Monitor. Det finns kostnader för att undersöka och lagra övervakningsdata i Azure Portal. Mer information finns i Lagringsanalys.

Kommentar

Vi rekommenderar att du använder Azure Storage-loggar i Azure Monitor i stället för Lagringsanalys loggar. Se någon av följande artiklar:

• Övervaka Azure Blob Storage
• Övervaka Azure Files
• Övervaka Azure Queue Storage
• Övervaka Azure Table Storage

Aktivera loggar

Du kan instruera Azure Storage att spara diagnostikloggar för läs-, skriv- och borttagningsbegäranden för blob-, tabell- och kötjänsterna. Den datakvarhållningsprincip som du anger gäller även för dessa loggar.

Kommentar

Azure Files stöder för närvarande Lagringsanalys mått, men stöder inte Lagringsanalys loggning.

Portal

1. I Azure Portal väljer du Lagringskonton och sedan namnet på lagringskontot för att öppna bladet för lagringskontot.

2. Välj Diagnostikinställningar (klassisk) i avsnittet Övervakning (klassisk) på menybladet.

   

3. Se till att Status är inställt på På och välj de tjänster som du vill aktivera loggning för.

   

4. Om du vill behålla loggar kontrollerar du att kryssrutan Ta bort data är markerad. Ange sedan det antal dagar som du vill att loggdata ska behållas genom att flytta skjutreglagekontrollen under kryssrutan, eller genom att direkt ändra värdet som visas i textrutan bredvid skjutreglagekontrollen. Standardvärdet för nya lagringskonton är sju dagar. Om du inte vill ange en kvarhållningsprincip lämnar du kryssrutan Ta bort data avmarkerad. Om det inte finns någon kvarhållningsprincip är det upp till dig att ta bort loggdata.

   Varning

   Loggar lagras som data i ditt konto. Loggdata kan ackumuleras på ditt konto över tid, vilket kan öka lagringskostnaden. Om du bara behöver loggdata under en liten tidsperiod kan du minska kostnaderna genom att ändra principen för datakvarhållning. Inaktuella loggdata (data som är äldre än din kvarhållningsprincip) tas bort av systemet. Vi rekommenderar att du anger en kvarhållningsprincip baserat på hur länge du vill behålla loggdata för ditt konto. Mer information finns i Fakturering för lagringsmått .

5. Klicka på Spara.

   Diagnostikloggarna sparas i en blobcontainer med namnet $logs i ditt lagringskonto. Du kan visa loggdata med hjälp av en lagringsutforskare som Microsoft Azure Storage Explorer eller programmatiskt med hjälp av lagringsklientbiblioteket eller PowerShell.

   Information om hur du kommer åt $logs-containern finns i Loggning av lagringsanalys.

   Kommentar

   För klassiska lagringskonton visas $logs-containern endast i Azure Storage Explorer. Den $logs containern visas inte från lagringswebbläsaren eller containervyn som är tillgänglig i Azure Portal.

PowerShell

1. Öppna ett Windows PowerShell-kommandofönster.

2. Logga in på din Azure-prenumeration med kommandot Connect-AzAccount och följ anvisningarna på skärmen.

   Connect-AzAccount
   

3. Om din identitet är associerad med mer än en prenumeration anger du din aktiva prenumeration.

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

   <subscription-id> Ersätt platshållarvärdet med ID:t för din prenumeration.

4. Hämta kontexten för lagringskontot som definierar det lagringskonto som du vill använda.

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

   • <resource-group-name> Ersätt platshållarvärdet med namnet på resursgruppen.

   • Ersätt platshållarvärdet <storage-account-name> med namnet på ditt lagringskonto.

5. Använd Set-AzStorageServiceLoggingProperty för att ändra de aktuella logginställningarna. De cmdletar som styr lagringsloggning använder en LoggingOperations-parameter som är en sträng som innehåller en kommaavgränsad lista över begärandetyper som ska loggas. De tre möjliga typerna av begäranden är läsning, skrivning och borttagning. Om du vill stänga av loggning använder du värdet none för parametern LoggingOperations .

   Följande kommando växlar vid loggning för läs-, skriv- och borttagningsbegäranden i kötjänsten i ditt standardlagringskonto med kvarhållning inställt på fem dagar:

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

   Varning

   Loggar lagras som data i ditt konto. loggdata kan ackumuleras på ditt konto över tid, vilket kan öka lagringskostnaden. Om du bara behöver loggdata under en liten tidsperiod kan du minska kostnaderna genom att ändra principen för datakvarhållning. Inaktuella loggdata (data som är äldre än din kvarhållningsprincip) tas bort av systemet. Vi rekommenderar att du anger en kvarhållningsprincip baserat på hur länge du vill behålla loggdata för ditt konto. Mer information finns i Fakturering för lagringsmått .

   Följande kommando inaktiverar loggning för tabelltjänsten i ditt standardlagringskonto:

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

   Information om hur du konfigurerar Azure PowerShell-cmdletar så att de fungerar med din Azure-prenumeration och hur du väljer det standardlagringskonto som ska användas finns i: Så här installerar och konfigurerar du Azure PowerShell.

.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);

Ändra kvarhållningsperioden för loggdata

Loggdata kan ackumuleras på ditt konto över tid, vilket kan öka lagringskostnaden. Om du bara behöver loggdata under en liten tidsperiod kan du minska kostnaderna genom att ändra kvarhållningsperioden för loggdata. Om du till exempel bara behöver loggar i tre dagar anger du kvarhållningsperioden för loggdata till värdet 3. På så sätt tas loggar bort automatiskt från ditt konto efter 3 dagar. Det här avsnittet visar hur du visar din aktuella kvarhållningsperiod för loggdata och sedan uppdaterar den perioden om det är vad du vill göra.

Portal

1. I Azure Portal väljer du Lagringskonton och sedan namnet på lagringskontot för att öppna bladet för lagringskontot.

2. Välj Diagnostikinställningar (klassisk) i avsnittet Övervakning (klassisk) på menybladet.

   

3. Kontrollera att kryssrutan Ta bort data är markerad. Ange sedan det antal dagar som du vill att loggdata ska behållas genom att flytta skjutreglagekontrollen under kryssrutan, eller genom att direkt ändra värdet som visas i textrutan bredvid skjutreglagekontrollen.

   

   Standardantalet dagar för nya lagringskonton är sju dagar. Om du inte vill ange en kvarhållningsprincip lämnar du kryssrutan Ta bort data avmarkerad. Om det inte finns någon kvarhållningsprincip är det upp till dig att ta bort övervakningsdata.

4. Klicka på Spara.

   Diagnostikloggarna sparas i en blobcontainer med namnet $logs i ditt lagringskonto. Du kan visa loggdata med hjälp av en lagringsutforskare som Microsoft Azure Storage Explorer eller programmatiskt med hjälp av lagringsklientbiblioteket eller PowerShell.

   Information om hur du kommer åt $logs-containern finns i Loggning av lagringsanalys.

PowerShell

1. Öppna ett Windows PowerShell-kommandofönster.

2. Logga in på din Azure-prenumeration med kommandot Connect-AzAccount och följ anvisningarna på skärmen.

   Connect-AzAccount
   

3. Om din identitet är associerad med mer än en prenumeration anger du din aktiva prenumeration.

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

   <subscription-id> Ersätt platshållarvärdet med ID:t för din prenumeration.

4. Hämta lagringskontokontexten som definierar lagringskontot.

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

   • <resource-group-name> Ersätt platshållarvärdet med namnet på resursgruppen.

   • Ersätt platshållarvärdet <storage-account-name> med namnet på ditt lagringskonto.

5. Använd Get-AzStorageServiceLoggingProperty för att visa den aktuella kvarhållningsprincipen för loggar. I följande exempel skrivs kvarhållningsperioden för blob- och kölagringstjänster ut till konsolen.

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

   I konsolens utdata visas kvarhållningsperioden under kolumnrubriken RetentionDays .

   

6. Använd Set-AzStorageServiceLoggingProperty för att ändra kvarhållningsperioden. I följande exempel ändras kvarhållningsperioden till 4 dagar.

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

   Information om hur du konfigurerar Azure PowerShell-cmdletar så att de fungerar med din Azure-prenumeration och hur du väljer det standardlagringskonto som ska användas finns i: Så här installerar och konfigurerar du Azure PowerShell.

.NET

I följande exempel skrivs kvarhållningsperioden för blob- och kölagringstjänster ut till konsolen.

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());

I följande exempel ändras kvarhållningsperioden till 4 dagar.

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");

Kontrollera att loggdata tas bort

Du kan kontrollera att loggar tas bort genom att visa innehållet i containern för $logs ditt lagringskonto. Följande bild visar innehållet i en mapp i containern $logs . Mappen motsvarar januari 2021 och varje mapp innehåller loggar för en dag. Om dagen i dag var den 29 januari 2021 och kvarhållningsprincipen är inställd på bara en dag, bör den här mappen bara innehålla loggar för en dag.

Visa loggdata

Om du vill visa och analysera dina loggdata bör du ladda ned de blobar som innehåller loggdata som du är intresserad av till en lokal dator. Med många verktyg för lagringsbläddring kan du ladda ned blobar från ditt lagringskonto. Du kan också använda Azure Storage-teamet med kommandoraden Azure Copy Tool AzCopy för att ladda ned dina loggdata.

Kommentar

Containern $logs är inte integrerad med Event Grid, så du får inte meddelanden när loggfiler skrivs.

För att se till att du laddar ned loggdata som du är intresserad av och för att undvika att ladda ned samma loggdata mer än en gång:

• Använd namngivningskonventionen för datum och tid för blobar som innehåller loggdata för att spåra vilka blobar som du redan har laddat ned för analys för att undvika att ladda ned samma data igen mer än en gång.

• Använd metadata på blobarna som innehåller loggdata för att identifiera den specifika period för vilken blobben innehåller loggdata för att identifiera den exakta blob som du behöver ladda ned.

Information om hur du kommer igång med AzCopy finns i Kom igång med AzCopy

I följande exempel visas hur du kan ladda ned loggdata för kötjänsten för timmarna från kl. 09.00, 10.00 och 11.00 den 20 maj 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

Mer information om hur du laddar ned specifika filer finns i Ladda ned blobar från Azure Blob Storage med hjälp av AzCopy v10.

När du har laddat ned loggdata kan du visa loggposterna i filerna. Dessa loggfiler använder ett avgränsat textformat som många loggläsningsverktyg kan parsa (mer information finns i guiden Övervakning, diagnostisering och felsökning av Microsoft Azure Storage). Olika verktyg har olika funktioner för formatering, filtrering, sortering, annonssökning av innehållet i dina loggfiler. Mer information om filformatet och innehållet i loggloggen för lagringsloggar finns i Lagringsanalys Loggformat och Lagringsanalys Loggade åtgärder och statusmeddelanden.

Nästa steg

• Mer information om Lagringsanalys finns i Lagringsanalys för Lagringsanalys.
• Mer information om hur du använder ett .NET-språk för att konfigurera lagringsloggning finns i Referens för lagringsklientbibliotek.
• Allmän information om hur du konfigurerar lagringsloggning med hjälp av REST-API:et finns i Aktivera och konfigurera Lagringsanalys.
• Läs mer om formatet för Lagringsanalys loggar. Se Lagringsanalys loggformat.