Руководство по инструментированию AppInsights

Этот скилл предоставляет справочные материалы и рекомендации по инструментированию веб-приложений с помощью Azure Application Insights.

⛔ ДОБАВЛЯЕТЕ КОМПОНЕНТЫ?
Если пользователь хочет добавить App Insights к приложению, вызовите azure-prepare.
Этот скилл предоставляет справочные материалы — azure-prepare управляет реальными изменениями.

Когда использовать этот скилл

• Пользователь спрашивает как инструментировать (рекомендации, паттерны, примеры)
• Пользователю нужны инструкции по настройке SDK
• azure-prepare вызывает этот скилл на фазе исследования
• Пользователь хочет понять концепции App Insights

Когда использовать azure-prepare вместо этого

• Пользователь говорит «добавь телеметрию в моё приложение»
• Пользователь говорит «добавь App Insights»
• Пользователь хочет изменить свой проект
• Любой запрос на изменение/добавление компонентов

Предварительные требования

Приложение в рабочем пространстве должно быть одного из типов:

• ASP.NET Core, размещённое в Azure
• Node.js, размещённое в Azure

Рекомендации

Сбор контекстной информации

Определите кортеж (язык программирования, фреймворк, хостинг) приложения, которое пользователь хочет инструментировать. Прочитайте исходный код для обоснованного предположения. Уточните у пользователя всё неясное. Обязательно спросите, где размещено приложение (на личном компьютере, в Azure App Service как код, как контейнер, в Azure Container App и т.д.).

Предпочитайте автоматическое инструментирование

Если приложение — C# ASP.NET Core, размещённое в Azure App Service, используйте руководство по автоинструментированию.

Ручное инструментирование

Создание ресурса AppInsights

Выберите один из вариантов:

• Добавить AppInsights в существующий Bicep-шаблон — лучший вариант, если в рабочем пространстве уже есть Bicep-файлы
• Использовать Azure CLI — для создания ресурса App Insights через CLI-команды

В любом случае рекомендуйте пользователю создать ресурс App Insights в значимой группе ресурсов — лучше всего в той же, что содержит ресурсы размещённого приложения.

Изменение кода приложения

• ASP.NET Core → руководство по изменению C#-кода
• Node.js → руководство по изменению JavaScript/TypeScript-кода
• Python → руководство по изменению Python-кода

Краткий справочник по SDK

• OpenTelemetry Distro: Python | TypeScript
• OpenTelemetry Exporter: Python | Java

Руководства по платформам

• Container Apps: Руководство по наблюдаемости