Включение журналов azure Storage Analytics и управление ими (классическая модель)

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

Примечание.

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

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

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

Примечание.

Azure Files в настоящее время поддерживает метрики Storage Analytics, но не поддерживает ведение журнала Storage Analytics.

На портале Azure выберите учетные записи хранения, а затем имя учетной записи, чтобы открыть панель учетной записи хранения.
Выберите Параметры диагностики (классические) в разделе Мониторинг (классический) в колонке меню.
Убедитесь, что параметр Состояние имеет значение Вкл., и выберите службы, для которых нужно включить ведение журнала.
Чтобы сохранить журналы, установите флажок "Удалить данные ". Затем задайте количество дней, в течение которых данные журнала будут храниться, переместив ползунок под флажком или напрямую изменив значение, которое отображается в текстовом поле рядом с ползунком. Значение по умолчанию для новых учетных записей хранения составляет семь дней. Если вы не хотите задать политику хранения, оставьте флажок "Удалить данные " без флажка. Если политика хранения отсутствует, удаление данных журнала выполняется вручную.

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

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

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

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

Примечание.

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

Откройте командное окно PowerShell Windows.
Войдите в подписку Azure с помощью команды Connect-AzAccount и следуйте инструкциям на экране.
```
Connect-AzAccount
```
Если ваш идентификатор связан с несколькими подписками, установите активную подписку.
```
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
```
Замените значение заполнителя <subscription-id> идентификатором своей подписки.
Получите контекст учетной записи хранения, который определяет используемую учетную запись хранения.
```
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context
```
- Замените значение заполнителя <resource-group-name> именем своей группы ресурсов.
- Замените значение заполнителя <storage-account-name> именем вашей учетной записи хранения.
Используйте командлет 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 и выборе используемой учетной записи хранения по умолчанию см. в статье :How to install and configure Azure PowerShell.

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 дня. В этом разделе показано, как просмотреть текущий период хранения данных журнала, а затем при необходимости обновить этот период.

Примечание.

Версия ведения журнала для Azure Storage Analytics (классическая) устанавливается автоматически Azure и не настраивается. На портале Azure значение по умолчанию может отображаться как Logging Version = 2.0.

На портале Azure выберите учетные записи хранилища, а затем имя учетной записи хранения, чтобы открыть панель учетной записи хранения.
Выберите Параметры диагностики (классические) в разделе Мониторинг (классический) в колонке меню.
Установите флажок Удалить данные. Затем задайте количество дней, в течение которых данные журнала будут храниться, переместив ползунок под флажком или напрямую изменив значение, которое отображается в текстовом поле рядом с ползунком.

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

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

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

Откройте командное окно PowerShell Windows.
Войдите в подписку Azure с помощью команды Connect-AzAccount и следуйте инструкциям на экране.
```
Connect-AzAccount
```
Если ваш идентификатор связан с несколькими подписками, установите активную подписку.
```
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
```
Замените значение заполнителя <subscription-id> идентификатором своей подписки.
Получите контекст учетной записи хранилища, который определяет эту учетную запись.
```
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context
```
- Замените значение заполнителя <resource-group-name> именем своей группы ресурсов.
- Замените значение заполнителя <storage-account-name> именем вашей учетной записи хранения.
Используйте командлет Get-AzStorageServiceLoggingProperty для просмотра текущей политики хранения логов. В следующем примере на консоль выводится срок хранения для служб хранилища BLOB-объектов и очередей.
```
Get-AzStorageServiceLoggingProperty -ServiceType Blob, Queue -Context $ctx
```
В выходных данных консоли срок хранения отображается под заголовком столбца RetentionDays.
Чтобы изменить период хранения, используйте командлет Set-AzStorageServiceLoggingProperty. В следующем примере количество дней хранения изменяется на 4 дня.
```
Set-AzStorageServiceLoggingProperty -ServiceType Blob, Queue -RetentionDays 4 -Context $ctx
```
Сведения о настройке командлетов Azure PowerShell для работы с подпиской Azure и выборе используемой учетной записи хранения по умолчанию см. в статье :How to install and configure Azure PowerShell.

В следующем примере на консоль выводится срок хранения для служб хранилища 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 года, а ваша политика хранения настроена только на один день, тогда эта папка содержала бы журналы только за один этот день.

Список папок журнала на портале Microsoft Azure

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

Для просмотра и анализа данных журнала необходимо скачать объекты BLOB, содержащие требуемые данные журнала, на локальный компьютер. Многие средства просмотра хранилища позволяют загрузить большие двоичные объекты из учетной записи хранилища; вы также можете использовать средство командной строки Azure Storage команды Azure AzCopy для загрузки данных журнала.

Примечание.

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

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

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

Чтобы начать работать с AzCopy, см. Get started with AzCopy

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

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

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

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

Дополнительные сведения о Storage Analytics см. в разделе Storage Analytics для Storage Analytics.
Дополнительные сведения об использовании языка .NET для настройки ведения журнала хранилища см. в статье Storage Client Library Reference.
Для получения общей информации о настройке ведения журнала хранилища с помощью REST API см. раздел Включение и настройка Storage Analytics.
Дополнительные сведения о формате журналов Storage Analytics. См. раздел Формат журнала Storage Analytics.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-03-11

Поделиться через

Включение журналов azure Storage Analytics и управление ими (классическая модель)