Как собирать журналы самостоятельной диагностики для пакетов SDK Application Insights

Статья
06/24/2024

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

В этой статье описывается сбор журналов самостоятельной диагностики для следующих пакетов SDK Application Insights:

Application Insights .NET/.NET Core Framework SDK
Application Insights Java 2.x
Application Insights Java 3.x

Application Insights .NET/.NET Core Framework SDK

С версии 2.18.0-beta2 пакета SDK для Application Insights .NET/.NET Core Framework функция "самостоятельно диагностика" отправляется для записи журналов из самого пакета SDK и записи их в файл журнала в указанном каталоге.

Настройка самостоятельного диагностика

Настройте самостоятельное диагностика с помощью файла с именем ApplicationInsightsDiagnostics.json со следующим содержимым:

{
    "LogDirectory": "<LogDirectory>",
    "FileSize": <FileSize>,
    "LogLevel": "<LogLevel>"
}

Примечание.

Файл конфигурации для самостоятельного диагностика должен иметь допустимые параметры для пакета SDK для .NET/.NET Core Framework для Application Insights. Если файл недопустим или недопустим, пакет SDK будет игнорировать его и самостоятельно диагностика не будет включен. Однако это не влияет на нормальное функционирование отслеживаемого приложения.
Этот файл конфигурации не должен превышать 4 килобайта (КБ). В противном случае будет прочитано только первое 4 КБ содержимого.
Пакет SDK для .NET/.NET Core Framework Application Insights будет пытаться считывать файл конфигурации каждые 10 секунд и создавать или циклическую перезапись файла журнала.

Ниже приведены некоторые объяснения параметров конфигурации:

Параметры конфигурации	Description
`LogDirectory`	Каталог, в котором хранится файл журнала. Это может быть абсолютный путь или относительный путь к текущему рабочему каталогу веб-приложения. Этот файл журнала называется YearMonthDay-HourMinuteSecond.ExecutableName.ProcessId.log, например 20220307-193542.w3wp.exe.7692.log. Имя файла начинается с метки времени, созданной при создании файла.
`FileSize`	Положительное целое число, указывающее размер файла журнала в КБ. Это значение должно быть от 1 мегабайта (МБ) до 128 МБ (включительно), или округляется до ближайшего верхнего или нижнего предела. Файл журнала не превысит этот максимальный размер.
`LogLevel`	Уровень регистрируемых событий. Это значение должно соответствовать одному из полей объекта `EventLevel`. Более низкие уровни серьезности включают более высокие уровни серьезности (например, `Warning` включает `Error` и `Critical` уровни).

Самостоятельное диагностика для веб-приложения

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

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

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

В Windows используйте обозреватель процессов.

Откройте обозреватель процессов, выберите процесс и откройте диалоговое окно "Свойства ". Найдите текущий каталог в файле изображения.
GetCurrentDirectory Вызовите методы и AppContext.BaseDirectory методы, чтобы получить текущий рабочий каталог.

Самостоятельное диагностика для веб-приложения Служба приложений в Windows

Перейдите к веб-приложению Служба приложений из портал Azure.
Перейдите на страницу Kudu, выбрав "Дополнительные средства>Go".
На панели мониторинга Kudu выберите CMD консоли>отладки.
Перейдите в каталог, в котором находится веб-приложение Служба приложений, например D:\home\site\wwwroot.
Используйте символ "+" в верхней части панели мониторинга Kudu, чтобы создать новый файл в папке wwwroot и присвоить ему имя для ApplicationInsightsDiagnostics.json.

Файл ApplicationInsightsDiagnostics.json необходимо поместить в папку< drive>:\home\site\wwwroot. Не все Служба приложений веб-приложения находятся на одном диске. Некоторые могут находиться на диске C: и некоторые могут находиться на диске D: Чтобы найти его, проверьте поля папок сайта и временных папок на странице Kudu по умолчанию.
Измените и добавьте следующую конфигурацию в файл ApplicationInsightsDiagnostics.json :
```
{
    "LogDirectory": "<drive>:\home\site\wwwroot",
    "FileSize": 5120,
    "LogLevel": "Verbose"
}
```
Примечание.

Параметр LogDirectory должен быть указан в расположении на <диске>:\home для простого доступа, но другие расположения допустимы, если есть достаточный доступ.
Сохраните файл.

Через 10 секунд в папке wwwroot появится новый файл журнала, например 20220307-193542.w3wp.exe.7692.log.
Удалите файл конфигурации или переименуйте его в ApplicationInsightsDiagnostics.bak.

Через 10 секунд журнал остановится.

Самостоятельная диагностика для веб-приложения Служба приложений в Linux

На локальном компьютере создайте файл и присвойте ему имя для ApplicationInsightsDiagnostics.json.
Измените файл и добавьте следующее содержимое:
```
{
    "LogDirectory": ".",
    "FileSize": 5120,
    "LogLevel": "Verbose"
} 
```
Сохраните файл.
Перейдите к веб-приложению Служба приложений из портал Azure.
Перейдите на страницу Kudu, выбрав "Дополнительные средства>Go".
При запуске сеанса браузера добавьте /newui в конец URL-адреса. URL-адрес в браузере должен выглядеть следующим https://<appname>.scm.azurewebsites.net/newuiобразом.
Нажмите ВВОД. Откроется страница Kudu с новым пользовательским интерфейсом.
В меню слева выберите диспетчер файлов.
Выберите папку сайта и выберите папку wwwroot .
Перетащите файл ApplicationInsightsDiagnostics.json в папку wwwroot .

Через 10 секунд в папке wwwroot появится новый файл журнала, например 20220307-193542.w3wp.exe.7692.log.
Удалите файл конфигурации или переименуйте его в ApplicationInsightsDiagnostics.bak.

Через 10 секунд журнал остановится.

Application Insights Java 2.x

Вы можете собирать диагностика журналы для Java 2.6 Application Insights или более ранней версии. Для этого добавьте <SDKLogger> элемент под корневым узлом файла конфигурации ApplicationInsights.xml (в папке ресурсов проекта). В элементе можно указать средству ведения журнала выходные <SDKLogger> данные в файл.

Ниже приведен пример файла ApplicationInsights.xml :

<SDKLogger type="FILE"><!-- or "CONSOLE" to print to stderr -->
    <Level>TRACE</Level>
    <UniquePrefix>AI</UniquePrefix>
    <BaseFolderPath>C:/agent/AISDK</BaseFolderPath>
</SDKLogger>

Дополнительные сведения см. в разделе "Устранение неполадок приложение Azure Insights" в веб-проекте Java.

Application Insights Java 3.x

Журналы диагностика можно собирать для Application Insights Java 3.x с помощью функции "самостоятельно диагностика". Для этого см. диагностика самообслуживания.

Свяжитесь с нами для получения помощи

Если у вас есть вопросы или вам нужна помощь, создайте запрос в службу поддержки или обратитесь за поддержкой сообщества Azure. Вы также можете отправить отзыв о продукте в сообщество отзывов Azure.

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