Включение ведения журнала диагностики для приложений в Службе приложений Azure

Azure предоставляет встроенную диагностику для отладки приложения Службы приложений Azure. Из этой статьи вы узнаете, как включить ведение журнала диагностики и добавить инструментирование в приложение. Вы также узнаете, как получить доступ к информации из журналов Azure.

В этой статье используется портал Azure и Azure CLI для работы с журналами диагностики. Сведения о работе с журналами диагностики с помощью Visual Studio см. в статье "Устранение неполадок приложения в службе приложений Azure" с помощью Visual Studio.

Помимо инструкций по ведению журнала в этой статье, можно использовать встроенную функцию ведения журнала Azure Monitor. Дополнительные сведения см. в статье "Отправка журналов в Azure Monitor".

Обзор типов логирования

Если журналы хранятся в файловой системе службы приложений, их объем ограничен доступным хранилищем, предусмотренным для вашего уровня тарифа. Более подробную информацию см. в разделе ограничения Службы приложений.

Включение логирования приложений (Windows)

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

1. Перейдите к вашему приложению и выберите мониторинг>журналы службы приложений.

2. Выберите "Вкл." для обоих из следующих параметров:

   • Ведение журнала приложений (файловая система): этот параметр предназначен для временного отладки. Она отключается через 12 часов.

   • Ведение журнала приложений (Blob): этот параметр предназначен для долговременного ведения журнала. Для записи журналов в него требуется контейнер блоб-хранилища.

     Параметр Blob включает дополнительные сведения в сообщения журнала, такие как идентификатор исходного виртуального экземпляра машины сообщения журнала (InstanceId), идентификатор потока (Tid) и более точную временную метку (EventTickCount).

3. Для Уровня выберите уровень детализации для ведения журнала. В следующей таблице приведены категории ведения журналов, входящие в каждый из уровней.

   Уровень	Включенные категории
   Отключен	нет
   Ошибка	Ошибка, критическое
   Предупреждения	Предупреждение, ошибка, критическое
   Информация	Сведения, предупреждение, ошибка, критически важные
   Подробный	Трассировка, отладка, информация, предупреждение, ошибка, критические (все категории)

4. Выберите Сохранить.

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

В настоящее время в хранилище BLOB-объектов можно записывать только журналы приложений .NET. Журналы приложений Java, PHP, Node.jsи Python можно хранить только в файловой системе службы приложений без изменений кода для записи журналов во внешнее хранилище.

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

1. На вкладке "Настройка" установите для соответствующей функции ведения журнала значение Off. Сохраните вашу настройку.

2. Снова включите ведение журнала в блоб хранилища. Сохраните вашу настройку.

Включение ведения журнала приложений (Linux или контейнера)

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

1. Перейдите к вашему приложению и выберите мониторинг>журналы службы приложений.

2. В поле Ведение журнала приложений выберите Файловая система.

3. В поле Квота (МБ) укажите квоту диска для журналов приложений.

4. В период хранения (дни) задайте количество дней для хранения журналов.

5. Выберите Сохранить.

Включение ведения журналов веб-сервера

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

1. Перейдите к вашему приложению и выберите мониторинг>журналы службы приложений.

2. Для ведения журнала веб-сервера выберите хранилище для записи журналов в объектное хранилище BLOB или выберите файловую систему для сохранения журналов в файловой системе Службы приложений.

3. В период хранения (дни) задайте количество дней для хранения журналов.

4. Выберите Сохранить.

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

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

1. На вкладке "Настройка" установите для соответствующей функции ведения журнала значение Off. Сохраните вашу настройку.

2. Снова включите ведение журнала в блоб хранилища. Сохраните вашу настройку.

Логировать подробные ошибки

Чтобы сохранить страницу ошибки или трассировки неудачных запросов для приложений Windows на портале Azure:

1. Перейдите к вашему приложению и выберите мониторинг>журналы службы приложений.

2. В разделе "Подробные сообщения об ошибках " или "Трассировка неудачных запросов" нажмите кнопку "Вкл.".

3. Выберите Сохранить.

Оба типа журналов хранятся в файловой системе Службы приложений. Он сохраняет до 50 ошибок (файлов или папок). Если число HTML-файлов превышает 50, служба приложений удаляет самые старые файлы ошибок.

По умолчанию трассировка неудачных запросов ведет запись запросов, завершившихся неудачей с кодами состояния HTTP в диапазоне от 400 до 600. Чтобы указать пользовательские правила, переопределите раздел <traceFailedRequests> в файле Web.config.

Добавление сообщений журнала в код

В коде приложения можно использовать обычные средства ведения журнала для отправки сообщений журнала в журналы приложений. Например:

• ASP.NET приложения могут использовать класс System.Diagnostics.Trace для регистрации сведений в журнал диагностики приложения. Например:

  System.Diagnostics.Trace.TraceError("If you're seeing this, something bad happened");
  

  По умолчанию ASP.NET Core использует поставщик ведения журналов Microsoft.Extensions.Logging.AzureAppServices. Дополнительные сведения см. в разделе о ведении журнала ASP.NET Core в Azure. Сведения о ведении журнала пакета SDK для веб-заданий см. в статье "Начало работы с пакетом SDK для веб-заданий Azure".

• Приложения Python могут использовать OpenTelemetry для отправки журналов в журнал диагностики приложения. Дополнительные сведения см. в разделе "Включить Azure Monitor OpenTelemetry".

Логи потока

Прежде чем выполнять потоковую передачу журналов в режиме реального времени, включите нужный тип журнала. Служба приложений передает все данные, записанные в выходные данные консоли или файлы, заканчивающиеся .txt, .log или .htm, хранящиеся в каталоге /home/LogFiles (D:\home\LogFiles).

Портал Azure

Чтобы передавать журналы на портале Azure, перейдите в приложение и выберите Мониторинг>Поток журналов.

Cloud Shell

Для потоковой передачи журналов в Azure Cloud Shell используйте следующую команду.

az webapp log tail --name appname --resource-group myResourceGroup

Чтобы отфильтровать определенные типы журналов, например HTTP, используйте --provider этот параметр. Например:

az webapp log tail --name appname --resource-group myResourceGroup --provider http

Локальный терминал

Чтобы передавать журналы в локальной консоли, установите Azure CLI и войдите в учетную запись. После входа выполните инструкции по Cloud Shell.

Файлы журнала доступа

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

Для журналов, хранящихся в файловой системе Служба приложений, проще всего скачать ZIP-файл в браузере по адресу:

• Linux или пользовательские контейнеры: https://<app-name>.scm.azurewebsites.net/api/logs/docker/zip
• Приложения для Windows:https://<app-name>.scm.azurewebsites.net/api/dump

Для Linux или пользовательских контейнеров ZIP-файл содержит журналы выходных данных консоли как для узла Docker, так и для контейнера Docker. Для масштабируемого приложения ZIP-файл содержит по одному набору журналов для каждого из экземпляров. В файловой системе службы приложений эти файлы журналов /home/LogFiles являются содержимым каталога. Журналы развертывания хранятся в /site/deployments/.

Для приложений Windows ZIP-файл содержит содержимое D:\Home\LogFiles каталога в файловой системе службы приложений. Он имеет следующую структуру:

Отправка журналов в Azure Monitor

Интеграция Azure Monitor позволяет создавать параметры диагностики для отправки журналов в учетные записи хранения, центры событий и рабочие области Log Analytics. При добавлении параметра диагностики Служба приложений добавляет параметры приложения в приложение, которое активирует перезапуск приложения.

Поддерживаемые типы журналов

Список поддерживаемых типов журналов и их описания см. в разделе "Поддерживаемые журналы ресурсов" для Microsoft.Web.

Рекомендации по сети

Сведения об ограничениях для параметров диагностики см. в разделе "Ограничения назначения".

Связанный контент

• Запросы логов в Azure Monitor
• Квоты и оповещения службы приложений Azure
• Устранение неполадок приложения в Службе приложений Azure с помощью Visual Studio
• Учебник. Выполнение нагрузочного теста для выявления узких мест производительности в веб-приложении