Трассировка потока в приложении Облачных служб (классических) с помощью системы диагностики Azure

Мақала
06/01/2023

Важно!

Облачные службы (классическая версия) объявлены устаревшими для новых клиентов. Их поддержка будет полностью прекращена 31 августа 2024 года. Для новых развертываний следует использовать Облачные службы Azure с расширенной поддержкой . Это новая модель развертывания на основе Azure Resource Manager.

Трассировка — это мониторинг выполнения запущенного приложения. Сведения об ошибках и выполнении приложений можно записывать в журналы, текстовые файлы или на устройства для последующего анализа с помощью классов System.Diagnostics.Trace, System.Diagnostics.Debug и System.Diagnostics.TraceSource. Дополнительные сведения о трассировке см. в статье Tracing and Instrumenting Applications (Трассировка и инструментирование приложений).

Использование трассировочных операторов и переключателей

Чтобы реализовать трассировку в приложении облачных служб, добавьте класс DiagnosticMonitorTraceListener в конфигурацию приложения и вызовите метод System.Diagnostics.Trace или System.Diagnostics.Debug в коде приложения. Используйте файл конфигурации app.config для рабочих ролей и web.config для веб-ролей. Во время создания размещенной службы с помощью шаблона Visual Studio система диагностики Azure автоматически добавляется в проект. При этом класс DiagnosticMonitorTraceListener включается в соответствующий файл конфигурации для добавляемых ролей.

Дополнительные сведения о размещении трассировочных операторов см. в статье How to: Add Trace Statements to Application Code (Добавление трассировочных операторов в код приложения).

Процессом и масштабом трассировки можно управлять. Для этого добавьте в код переключатели трассировки. Так вы сможете отслеживать состояние приложения в рабочей среде. Это особенно важно в бизнес-приложениях, которые используют различные компоненты, выполняющиеся на нескольких компьютерах. Дополнительные сведения см. в статье How to: Configure Trace Switches (Настройка переключателей трассировки).

Настройка прослушивателя трассировки в приложении Azure

Использование элементов Trace, Debug и TraceSource предполагает настройку прослушивателей для сбора и записи отправляемых сообщений. Прослушиватели собирают, хранят и перенаправляют сообщения трассировки. Они направляют выходные данные трассировки в соответствующий целевой объект, например журнал, окно или текстовый файл. Система диагностики Azure использует класс DiagnosticMonitorTraceListener .

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

Обратите внимание, что при использовании шаблонов Visual Studio конфигурация прослушивателя добавляется автоматически.

Добавление прослушивателя трассировки

Откройте файл web.config или app.config для своей роли.
Добавьте в файл следующий код. Измените атрибут Version, чтобы использовать номер версии сборки, которая указана в ссылках. Версия сборки не обязательно меняется с каждым выпуском пакета SDK для Azure, а только если она обновляется.
```
<system.diagnostics>
    <trace>
        <listeners>
            <add type="Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener,
              Microsoft.WindowsAzure.Diagnostics,
              Version=2.8.0.0,
              Culture=neutral,
              PublicKeyToken=31bf3856ad364e35"
              name="AzureDiagnostics">
                <filter type="" />
            </add>
        </listeners>
    </trace>
</system.diagnostics>
```
Важно!

Убедитесь, что у вас есть ссылка проекта на сборку Microsoft.WindowsAzure.Diagnostics. Обновите номер версии в приведенном выше коде XML в соответствии с версией сборки Microsoft.WindowsAzure.Diagnostics, используемой в ссылке.
Сохраните файл конфигурации.

Дополнительные сведения о прослушивателях см. здесь.

Добавив прослушиватель, вы можете добавить в код трассировочные операторы.

Добавление трассировочного оператора в код

Откройте исходный файл приложения. Например, файл <RoleName> CS для рабочей роли или веб-роли.
Добавьте следующую директиву using, если она еще не добавлена:
```
    using System.Diagnostics;
```
Добавьте трассировочные операторы, чтобы записывать сведения о состоянии приложения. Вывод оператора трассировки можно форматировать разными способами. Дополнительные сведения об этом см. в статье How to: Add Trace Statements to Application Code (Добавление трассировочных операторов в код приложения).
Сохраните исходный файл.

Бөлісу құралы: