Включение журналов Аналитики Службы хранилища Azure и управление ими (классическая модель)

Аналитика Службы хранилища обеспечивает журналы для хранилищ BLOB-объектов, очередей и таблиц. Для настройки журналов для своей учетной записи можно использовать портал Azure. В этой статье будет показано, как включить журналы и управлять ими. Сведения о включении метрик см. в статье "Переход на метрики" в Azure Monitor. За изучение и хранение данных мониторинга на портале Azure взимается плата. Дополнительные сведения см. в этой статье.

Примечание.

Рекомендуется использовать журналы службы хранилища Azure в Azure Monitor вместо метрик Аналитики Службы хранилища. Дополнительные сведения см. в следующих статьях:

• Мониторинг Хранилища BLOB-объектов Azure
• Мониторинг Файлов Azure
• Мониторинг Хранилища очередей Azure
• Мониторинг Хранилища таблиц Azure

Включение журналов

Можно указать службе хранилища Azure сохранять журналы диагностики для запросов на чтение, запись и удаление, отправляемых к службам BLOB-объектов, таблиц и очередей. Заданная политика хранения данных также применяется к этим журналам.

Примечание.

Сейчас служба "Файлы Azure" поддерживает метрики решения "Аналитика Службы хранилища", но не поддерживает ведение журналов Аналитики Службы хранилища Azure.

Портал

1. На портале Azure выберите Учетные записи хранения, а затем щелкните имя учетной записи хранения, чтобы открыть ее колонку.

2. Выберите Параметры диагностики (классические) в разделе Мониторинг (классический) в колонке меню.

   

3. Убедитесь, что параметр Состояние имеет значение Вкл., и выберите службы, для которых нужно включить ведение журнала.

   

4. Чтобы сохранить журналы, установите флажок "Удалить данные ". Затем задайте количество дней, в течение которых данные журнала будут храниться, переместив ползунок под флажком или напрямую изменив значение, которое отображается в текстовом поле рядом с ползунком. Значение по умолчанию для новых учетных записей хранения составляет семь дней. Если вы не хотите задать политику хранения, оставьте флажок "Удалить данные " без флажка. Если политика хранения отсутствует, удаление данных журнала выполняется вручную.

   Предупреждение

   Журналы хранятся как данные в вашей учетной записи. Данные журнала со временем могут накапливаться в вашей учетной записи, что может увеличить стоимость хранения. Если вам нужны данные журнала только на небольшой период времени, вы можете сократить свои расходы, изменив политику хранения данных. Устаревшие данные журнала (старше срока, предусмотренного вашей политикой хранения) удаляются системой. Рекомендуется устанавливать политику хранения в зависимости от того, как долго нужно хранить данные журнала для вашей учетной записи. Дополнительные сведения см. в разделе Выставление счетов за метрики хранилища.

5. Нажмите кнопку Сохранить.

   Журналы диагностики сохраняются в контейнере BLOB-объектов с именем $logs в вашей учетной записи хранения. Можно просмотреть данные журнала с помощью обозревателя хранилищ, например Обозревателя службы хранилища Microsoft Azure, или программно, с помощью клиентской библиотеки службы хранилища или PowerShell.

   Дополнительные сведения о доступе к контейнеру $logs см. в статье Ведение журнала аналитики службы хранилища Azure.

   Примечание.

   Для классических учетных записей хранения контейнер $logs отображается только в обозревателе служба хранилища Azure. Контейнер $logs не отображается в браузере хранилища или представлении контейнера, доступном в портал Azure.

PowerShell

1. Откройте командное окно Windows PowerShell.

2. Войдите в подписку Azure с помощью команды Connect-AzAccount и следуйте инструкциям на экране.

   Connect-AzAccount
   

3. Если ваш идентификатор связан с несколькими подписками, установите активную подписку.

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

   Замените значение заполнителя <subscription-id> идентификатором своей подписки.

4. Получите контекст учетной записи хранения, определяющий необходимую учетную запись хранения.

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

   • Замените значение заполнителя <resource-group-name> именем своей группы ресурсов.

   • Замените значение заполнителя <storage-account-name> именем вашей учетной записи хранения.

5. Используйте командлет Set-AzStorageServiceLoggingProperty, чтобы изменить настройки текущего журнала. В командлетах, позволяющих управлять ведением журнала службы хранилища, используется параметр LoggingOperations, представляющий собой строку, содержащую разделенный запятыми список типов запросов, подлежащих занесению в журнал. Всего используются запросы трех типов — чтение, запись и удаление. Чтобы отключить ведение журнала, укажите для параметра LoggingOperations значение none.

   Следующая команда включает занесение в журнал записей о запросах на чтение, запись и удаление службой очередей в учетной записи хранения по умолчанию, при этом устанавливается время хранения, равное пяти дням:

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

   Предупреждение

   Журналы хранятся как данные в вашей учетной записи. Данные журнала со временем могут накапливаться в вашей учетной записи, что может увеличить стоимость хранения. Если вам нужны данные журнала только на небольшой период времени, вы можете сократить свои расходы, изменив политику хранения данных. Устаревшие данные журнала (старше срока, предусмотренного вашей политикой хранения) удаляются системой. Рекомендуется устанавливать политику хранения в зависимости от того, как долго нужно хранить данные журнала для вашей учетной записи. Дополнительные сведения см. в разделе Выставление счетов за метрики хранилища.

   Следующая команда отключает ведение журнала для службы таблиц в учетной записи по умолчанию:

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

   Дополнительные сведения о настройке командлетов Azure PowerShell для работы с подпиской Azure и о выборе учетной записи хранения по умолчанию см. в разделе Установка и настройка 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);

Изменение периода хранения данных журнала

Данные журнала со временем могут накапливаться в вашей учетной записи, что может увеличить стоимость хранения. Если вам нужны данные журнала только на небольшой период времени, вы можете сократить свои расходы, изменив период хранения данных журнала. Например, если вам нужны журналы только за три дня, задайте для параметра периода хранения данных журнала значение 3. В этом случае журналы будут автоматически удаляться из вашей учетной записи через 3 дня. В этом разделе показано, как просмотреть текущий период хранения данных журнала, а затем при необходимости обновить этот период.

Портал

1. На портале Azure выберите Учетные записи хранения, а затем щелкните имя учетной записи хранения, чтобы открыть ее колонку.

2. Выберите Параметры диагностики (классические) в разделе Мониторинг (классический) в колонке меню.

   

3. Установите флажок Удалить данные. Затем задайте количество дней, в течение которых данные журнала будут храниться, переместив ползунок под флажком или напрямую изменив значение, которое отображается в текстовом поле рядом с ползунком.

   

   По умолчанию количество дней для новых учетных записей хранения составляет семь дней. Если вы не хотите задать политику хранения, оставьте флажок "Удалить данные " без флажка. Если политика хранения отсутствует, удаление данных мониторинга выполняется вручную.

4. Нажмите кнопку Сохранить.

   Журналы диагностики сохраняются в контейнере BLOB-объектов с именем $logs в вашей учетной записи хранения. Можно просмотреть данные журнала с помощью обозревателя хранилищ, например Обозревателя службы хранилища Microsoft Azure, или программно, с помощью клиентской библиотеки службы хранилища или PowerShell.

   Дополнительные сведения о доступе к контейнеру $logs см. в статье Ведение журнала аналитики службы хранилища Azure.

PowerShell

1. Откройте командное окно Windows PowerShell.

2. Войдите в подписку Azure с помощью команды Connect-AzAccount и следуйте инструкциям на экране.

   Connect-AzAccount
   

3. Если ваш идентификатор связан с несколькими подписками, установите активную подписку.

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

   Замените значение заполнителя <subscription-id> идентификатором своей подписки.

4. Получите контекст учетной записи хранения, определяющий учетную запись хранения.

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

   • Замените значение заполнителя <resource-group-name> именем своей группы ресурсов.

   • Замените значение заполнителя <storage-account-name> именем вашей учетной записи хранения.

5. Используйте командлет Get-AzStorageServiceLoggingProperty для просмотра текущей политики хранения журнала. В следующем примере на консоли выводится период хранения для служб Хранилища BLOB-объектов и очередей.

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

   В выходных данных консоли период хранения отображается под заголовком столбца RetentionDays.

   

6. Чтобы изменить период хранения, используйте командлет Set-AzStorageServiceLoggingProperty. В следующем примере количество дней хранения изменяется на 4 дня.

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

   Дополнительные сведения о настройке командлетов Azure PowerShell для работы с подпиской Azure и о выборе учетной записи хранения по умолчанию см. в разделе Установка и настройка Azure PowerShell.

.NET

В следующем примере на консоли выводится период хранения для служб Хранилища BLOB-объектов и очередей.

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

В следующем примере количество дней хранения изменяется на 4 дня.

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

Проверка удаления данных журнала

Чтобы убедиться, что журналы удаляются, просмотрите содержимое контейнера $logs учетной записи хранения. На следующем рисунке показано содержимое папки в контейнере $logs. Папка соответствует январю 2021 года, и каждая такая папка содержит журналы за один день. Если сегодня было 29 января 2021 года, а ваша политика хранения настроена только на один день, тогда эта папка содержала бы журналы только за один этот день.

Просмотр данных журналов

Для просмотра и анализа данных журнала необходимо скачать BLOB-объекты, содержащие требуемые данные журнала, на локальный компьютер. Многие средства обзора хранилища позволяют скачивать BLOB-объекты из учетной записи хранения. Кроме того, для скачивания данных журнала можно использовать средство командной строки Azure Copy Tool (AzCopy), предоставляемое группой службы хранилища Azure.

Примечание.

Контейнер $logs не интегрирован в Сетку событий, поэтому вы не будете получать уведомления при записи файлов журнала.

Чтобы скачать только нужные данные и избежать повторного скачивания тех же данных журнала, сделайте следующее.

• Примените соглашение об именовании по дате и времени к BLOB-объектам, чтобы отслеживать, какие из них уже были скачаны для анализа, и предотвратить их повторное скачивание.

• С помощью метаданных в BLOB-объектах, содержащих данные журнала, определите конкретный период, которому соответствуют содержащиеся в BLOB-объекте данные журнала. Это позволяет найти требуемый для скачивания BLOB-объект.

Чтобы приступить к работе с AzCopy, см. сведения в статье Начало работы с AzCopy.

В следующем примере показано, как можно скачать данные журнала для службы очереди, время начала которых соответствует 9:00, 10:00 и 11:00 20 мая 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

Дополнительные сведения о загрузке конкретных файлов см. в статье Скачивание больших двоичных объектов из хранилища BLOB-объектов Azure с помощью AzCopy V10.

После скачивания данных журнала можно просматривать записи журнала в файлах. Эти файлы имеют текстовый формат с разделителями-запятыми, совместимый со многими средствами чтения журналов (подробные сведения см. в руководстве Мониторинг, диагностика и устранение неполадок службы хранилища Microsoft Azure). Такие средства предоставляют различные возможности форматирования, фильтрации, сортировки и поиска содержимого файлов журнала. Дополнительные сведения о формате и содержимом файлов журнала службы хранилища см. в статьях Формат журнала Аналитики Службы хранилища и Операции и сообщения о состоянии, заносимые в журнал Аналитики Службы хранилища.

Следующие шаги

• Дополнительные сведения об Аналитике Службы Azure см. в разделе Аналитика Службы хранилища.
• Дополнительные сведения о настройке ведения журнала службы хранилища с помощью языка .NET см. в справочнике по клиентской библиотеке хранилища.
• Общие сведения о настройке ведения журнала службы хранилища с использованием REST API см. в статье Включение и настройка Аналитики Службы хранилища.
• Дополнительные сведения о формате журналов Аналитики Службы хранилища. Формат журналов Аналитики Службы хранилища.