Włączanie dzienników usługi Azure Storage Analytics (klasycznych) i zarządzanie nimi

Usługa Azure analityka magazynu udostępnia dzienniki dla obiektów blob, kolejek i tabel. Możesz użyć witryny Azure Portal , aby skonfigurować dzienniki są rejestrowane dla konta. W tym artykule przedstawiono sposób włączania dzienników i zarządzania nimi. Aby dowiedzieć się, jak włączyć metryki, zobacz Przechodzenie do metryk w usłudze Azure Monitor. Istnieją koszty związane z badaniem i przechowywaniem danych monitorowania w witrynie Azure Portal. Aby uzyskać więcej informacji, zobacz Usługa Storage Analytics.

Uwaga

Zalecamy używanie dzienników usługi Azure Storage w usłudze Azure Monitor zamiast dzienników analityka magazynu. Zobacz dowolny z następujących artykułów:

• Monitorowanie usługi Azure Blob Storage
• Monitorowanie usługi Azure Files
• Monitorowanie usługi Azure Queue Storage
• Monitorowanie usługi Azure Table Storage

Włączanie dzienników

Możesz poinstruować usługę Azure Storage, aby zapisywała dzienniki diagnostyczne dla żądań odczytu, zapisu i usuwania dla usług obiektów blob, tabel i kolejek. Ustawione zasady przechowywania danych dotyczą również tych dzienników.

Uwaga

Usługa Azure Files obecnie obsługuje metryki analityka magazynu, ale nie obsługuje rejestrowania analityka magazynu.

Portal

1. W witrynie Azure Portal wybierz pozycję Konta magazynu, a następnie nazwę konta magazynu, aby otworzyć blok konta magazynu.

2. Wybierz pozycję Ustawienia diagnostyczne (klasyczne) w sekcji Monitorowanie (klasyczne) bloku menu.

   

3. Upewnij się, że ustawienie Stan ma wartość Włączone, a następnie wybierz usługi , dla których chcesz włączyć rejestrowanie.

   

4. Aby zachować dzienniki, upewnij się, że zaznaczono pole wyboru Usuń dane . Następnie ustaw liczbę dni, przez które mają być przechowywane dane dziennika, przesuwając kontrolkę suwaka pod polem wyboru lub bezpośrednio modyfikując wartość wyświetlaną w polu tekstowym obok kontrolki suwaka. Wartość domyślna dla nowych kont magazynu to siedem dni. Jeśli nie chcesz ustawiać zasad przechowywania, pozostaw niezaznaczone pole wyboru Usuń dane . Jeśli nie ma żadnych zasad przechowywania, należy usunąć dane dziennika.

   Ostrzeżenie

   Dzienniki są przechowywane jako dane na koncie. Dane dziennika mogą gromadzić się na koncie wraz z upływem czasu, co może zwiększyć koszt magazynu. Jeśli potrzebujesz danych dziennika tylko przez krótki czas, możesz zmniejszyć koszty, modyfikując zasady przechowywania danych. Nieaktualne dane dziennika (dane starsze niż zasady przechowywania) są usuwane przez system. Zalecamy ustawienie zasad przechowywania na podstawie czasu przechowywania danych dziennika dla twojego konta. Aby uzyskać więcej informacji, zobacz Rozliczenia dotyczące metryk magazynu.

5. Kliknij przycisk Zapisz.

   Dzienniki diagnostyczne są zapisywane w kontenerze obiektów blob o nazwie $logs na koncie magazynu. Dane dziennika można wyświetlić przy użyciu eksploratora magazynu, takiego jak Eksplorator usługi Microsoft Azure Storage, lub programowo przy użyciu biblioteki klienta magazynu lub programu PowerShell.

   Aby uzyskać informacje na temat uzyskiwania dostępu do kontenera $logs, zobacz Rejestrowanie analizy magazynu.

   Uwaga

   W przypadku klasycznych kont magazynu kontener $logs jest wyświetlany tylko w Eksplorator usługi Azure Storage. Kontener $logs nie jest widoczny w przeglądarce magazynu ani w widoku kontenera dostępnym w witrynie Azure Portal.

Program PowerShell

1. Otwórz okno polecenia programu Windows PowerShell.

2. Zaloguj się do subskrypcji platformy Azure za pomocą polecenia Connect-AzAccount i postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

   Connect-AzAccount
   

3. Jeśli tożsamość jest skojarzona z więcej niż jedną subskrypcją, ustaw aktywną subskrypcję.

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

   Zastąp wartość symbolu <subscription-id> zastępczego identyfikatorem subskrypcji.

4. Pobierz kontekst konta magazynu, który definiuje konto magazynu, którego chcesz użyć.

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

   • Zastąp wartość symbolu <resource-group-name> zastępczego nazwą grupy zasobów.

   • Zastąp wartość symbolu zastępczego <storage-account-name> nazwą konta magazynu.

5. Użyj właściwości Set-AzStorageServiceLoggingProperty, aby zmienić bieżące ustawienia dziennika. Polecenia cmdlet kontrolujące rejestrowanie magazynu używają parametru LoggingOperations , który jest ciągiem zawierającym rozdzielaną przecinkami listę typów żądań do rejestrowania. Trzy możliwe typy żądań to odczyt, zapis i usuwanie. Aby wyłączyć rejestrowanie, użyj wartości none dla parametru LoggingOperations .

   Następujące polecenie włącza rejestrowanie żądań odczytu, zapisu i usuwania w usłudze Queue w domyślnym koncie magazynu z przechowywaniem ustawionym na pięć dni:

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

   Ostrzeżenie

   Dzienniki są przechowywane jako dane na koncie. dane dziennika mogą gromadzić się na koncie w czasie, co może zwiększyć koszty magazynowania. Jeśli potrzebujesz danych dziennika tylko przez krótki czas, możesz zmniejszyć koszty, modyfikując zasady przechowywania danych. Nieaktualne dane dziennika (dane starsze niż zasady przechowywania) są usuwane przez system. Zalecamy ustawienie zasad przechowywania na podstawie czasu przechowywania danych dziennika dla twojego konta. Aby uzyskać więcej informacji, zobacz Rozliczenia dotyczące metryk magazynu.

   Następujące polecenie wyłącza rejestrowanie dla usługi table w domyślnym koncie magazynu:

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

   Aby uzyskać informacje o sposobie konfigurowania poleceń cmdlet programu Azure PowerShell do pracy z subskrypcją platformy Azure i sposobu wybierania domyślnego konta magazynu do użycia, zobacz: How to install and configure Azure PowerShell (Jak zainstalować i skonfigurować program 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);

Modyfikowanie okresu przechowywania danych dziennika

Dane dziennika mogą gromadzić się na koncie wraz z upływem czasu, co może zwiększyć koszt magazynu. Jeśli potrzebujesz danych dziennika tylko przez krótki czas, możesz zmniejszyć koszty, modyfikując okres przechowywania danych dziennika. Jeśli na przykład potrzebujesz dzienników tylko przez trzy dni, ustaw okres przechowywania danych dziennika na wartość 3. Dzięki temu dzienniki zostaną automatycznie usunięte z konta po upływie 3 dni. W tej sekcji pokazano, jak wyświetlić bieżący okres przechowywania danych dziennika, a następnie zaktualizować ten okres, jeśli chcesz to zrobić.

Portal

1. W witrynie Azure Portal wybierz pozycję Konta magazynu, a następnie nazwę konta magazynu, aby otworzyć blok konta magazynu.

2. Wybierz pozycję Ustawienia diagnostyczne (klasyczne) w sekcji Monitorowanie (klasyczne) bloku menu.

   

3. Upewnij się, że pole wyboru Usuń dane jest zaznaczone. Następnie ustaw liczbę dni, przez które mają być przechowywane dane dziennika, przesuwając kontrolkę suwaka pod polem wyboru lub bezpośrednio modyfikując wartość wyświetlaną w polu tekstowym obok kontrolki suwaka.

   

   Domyślna liczba dni dla nowych kont magazynu wynosi siedem dni. Jeśli nie chcesz ustawiać zasad przechowywania, pozostaw niezaznaczone pole wyboru Usuń dane . Jeśli nie ma żadnych zasad przechowywania, należy usunąć dane monitorowania.

4. Kliknij przycisk Zapisz.

   Dzienniki diagnostyczne są zapisywane w kontenerze obiektów blob o nazwie $logs na koncie magazynu. Dane dziennika można wyświetlić przy użyciu eksploratora magazynu, takiego jak Eksplorator usługi Microsoft Azure Storage, lub programowo przy użyciu biblioteki klienta magazynu lub programu PowerShell.

   Aby uzyskać informacje na temat uzyskiwania dostępu do kontenera $logs, zobacz Rejestrowanie analizy magazynu.

Program PowerShell

1. Otwórz okno polecenia programu Windows PowerShell.

2. Zaloguj się do subskrypcji platformy Azure za pomocą polecenia Connect-AzAccount i postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

   Connect-AzAccount
   

3. Jeśli tożsamość jest skojarzona z więcej niż jedną subskrypcją, ustaw aktywną subskrypcję.

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

   Zastąp wartość symbolu <subscription-id> zastępczego identyfikatorem subskrypcji.

4. Pobierz kontekst konta magazynu, który definiuje konto magazynu.

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

   • Zastąp wartość symbolu <resource-group-name> zastępczego nazwą grupy zasobów.

   • Zastąp wartość symbolu zastępczego <storage-account-name> nazwą konta magazynu.

5. Użyj właściwości Get-AzStorageServiceLoggingProperty , aby wyświetlić bieżące zasady przechowywania dzienników. Poniższy przykład wyświetla w konsoli okres przechowywania usług blob i queue storage.

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

   W danych wyjściowych konsoli okres przechowywania jest wyświetlany pod nagłówkiem RetentionDays kolumny.

   

6. Użyj właściwości Set-AzStorageServiceLoggingProperty , aby zmienić okres przechowywania. Poniższy przykład zmienia okres przechowywania na 4 dni.

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

   Aby uzyskać informacje o sposobie konfigurowania poleceń cmdlet programu Azure PowerShell do pracy z subskrypcją platformy Azure i sposobu wybierania domyślnego konta magazynu do użycia, zobacz: How to install and configure Azure PowerShell (Jak zainstalować i skonfigurować program Azure PowerShell).

.NET

Poniższy przykład wyświetla w konsoli okres przechowywania usług blob i queue storage.

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

Poniższy przykład zmienia okres przechowywania na 4 dni.

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

Sprawdź, czy dane dziennika są usuwane

Możesz sprawdzić, czy dzienniki są usuwane, wyświetlając zawartość $logs kontenera konta magazynu. Na poniższej ilustracji przedstawiono zawartość folderu w kontenerze $logs . Folder odpowiada styczniu 2021 r., a każdy folder zawiera dzienniki na jeden dzień. Jeśli dzień dzisiejszy był 29 stycznia 2021 r., a zasady przechowywania są ustawione na tylko jeden dzień, ten folder powinien zawierać dzienniki tylko jeden dzień.

Wyświetlanie danych dziennika

Aby wyświetlić i przeanalizować dane dziennika, należy pobrać obiekty blob zawierające dane dziennika, które cię interesują, na maszynie lokalnej. Wiele narzędzi do przeglądania magazynu umożliwia pobieranie obiektów blob z konta magazynu; Możesz również użyć udostępnionego przez zespół usługi Azure Storage wiersza polecenia narzędzia Azure Copy Tool AzCopy , aby pobrać dane dziennika.

Uwaga

Kontener $logs nie jest zintegrowany z usługą Event Grid, więc nie będziesz otrzymywać powiadomień podczas zapisywania plików dziennika.

Aby upewnić się, że pobierasz interesujące Cię dane dziennika i unikasz pobierania tych samych danych dziennika więcej niż raz:

• Użyj konwencji nazewnictwa daty i godziny dla obiektów blob zawierających dane dziennika, aby śledzić, które obiekty blob zostały już pobrane do analizy, aby uniknąć ponownego pobierania tych samych danych więcej niż raz.

• Użyj metadanych obiektów blob zawierających dane dziennika, aby zidentyfikować określony okres, dla którego obiekt blob przechowuje dane dziennika, aby zidentyfikować dokładny obiekt blob, który należy pobrać.

Aby rozpocząć pracę z narzędziem AzCopy, zobacz Rozpoczynanie pracy z narzędziem AzCopy

W poniższym przykładzie pokazano, jak pobrać dane dziennika dla usługi kolejki przez godziny rozpoczynające się od 09:00, 10:00 i 11:00 w dniu 20 maja 2014 r.

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

Aby dowiedzieć się więcej na temat pobierania określonych plików, zobacz Pobieranie obiektów blob z usługi Azure Blob Storage przy użyciu narzędzia AzCopy w wersji 10.

Po pobraniu danych dziennika można wyświetlić wpisy dziennika w plikach. Te pliki dziennika używają rozdzielanego formatu tekstu, który umożliwia analizowanie wielu narzędzi do odczytywania dzienników (aby uzyskać więcej informacji, zobacz przewodnik Monitorowanie, diagnozowanie i rozwiązywanie problemów z usługą Microsoft Azure Storage). Różne narzędzia mają różne narzędzia do formatowania, filtrowania, sortowania, wyszukiwania reklam w zawartości plików dziennika. Aby uzyskać więcej informacji na temat formatu i zawartości pliku dziennika rejestrowania magazynu, zobacz analityka magazynu format dziennika i analityka magazynu zarejestrowane operacje i komunikaty o stanie.

Następne kroki

• Aby dowiedzieć się więcej na temat analityka magazynu, zobacz analityka magazynu dla analityka magazynu.
• Aby uzyskać więcej informacji na temat konfigurowania rejestrowania magazynu przy użyciu języka .NET, zobacz Storage Client Library Reference (Dokumentacja biblioteki klienta usługi Storage).
• Aby uzyskać ogólne informacje na temat konfigurowania rejestrowania magazynu przy użyciu interfejsu API REST, zobacz Włączanie i konfigurowanie analityka magazynu.
• Dowiedz się więcej o formacie dzienników analityka magazynu. Zobacz format dziennika analityka magazynu.