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

Развертывание агента Azure Monitor Application Insights для локальных серверов

  • Статья

Агент Application Insights (ранее — монитор состояния версии 2) — это модуль PowerShell, опубликованный в коллекции PowerShell. Он заменяет собой монитор состояния. Данные телеметрии отправляются в портал Azure, где вы можете отслеживать приложение.

Полный список поддерживаемых сценариев автоинструментации см. в статье "Поддерживаемые среды", "Языки" и поставщики ресурсов.

Примечание.

Модуль сейчас поддерживает инструментирование без написания кода для веб-приложений ASP.NET и ASP.NET Core, размещенных в IIS. Для инструментирования приложений Java и Node.js используйте пакет SDK.

Примечание.

Мониторинг на стороне клиента включен по умолчанию для приложений ASP.NET Core. Если вы хотите отключить мониторинг на стороне клиента, определите переменную среды на сервере со следующими сведениями:

  • Имя: APPINSIGHTS_JAVASCRIPT_ENABLED
  • Значение: false

Агент Application Insights находится в PowerShell Gallery.

значок PowerShell Gallery.

Инструкции

  • Чтобы приступить к работе с краткими примерами кода, перейдите на вкладку "Начало работы ".
  • Подробные сведения о начале работы см. на вкладке "Подробные инструкции ".
  • Для справки по API PowerShell см. вкладку API reference.
  • Сведения об обновлениях заметки о выпуске см. на вкладке "Заметки о выпуске".

Эта вкладка содержит команды быстрого запуска, которые, как ожидается, будут работать для большинства сред. Инструкции зависят от коллекции PowerShell для распространения обновлений. Эти команды поддерживают параметр PowerShell -Proxy.

Описание этих команд, инструкции по настройке и сведения об устранении неполадок см. в разделе Подробные инструкции.

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

Используйте галерею PowerShell для скачивания и установки.

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

Чтобы включить мониторинг, необходимо иметь строку подключения. В области Обзор вашего ресурса Application Insights отображается строка подключения. Дополнительные сведения см. в разделе Строки подключения.

Примечание.

По состоянию на апрель 2020 г. в коллекции PowerShell версии TLS 1.1 и 1.0 больше не поддерживаются.

Для получения дополнительных предварительных требований, которые могут понадобиться, см. поддержка TLS в галерее PowerShell.

Запустите PowerShell от имени администратора.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force
Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted
Install-Module -Name PowerShellGet -Force

Закройте PowerShell.

Установите агента Application Insights

Запустите PowerShell от имени администратора.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Install-Module -Name Az.ApplicationMonitor -AllowPrerelease -AcceptLicense

Примечание.

Переключатель AllowPrerelease в командлете Install-Module позволяет установить бета-релиз.

Дополнительные сведения см. в разделе Install-Module.

Включение мониторинга

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'

Скачивание и установка вручную (автономный режим)

Вы также можете скачать и установить вручную.

Скачивание модуля

Вручную скачайте последнюю версию модуля из Коллекции PowerShell.

Распакуйте и установите агента Application Insights

$pathToNupkg = "C:\Users\t\Desktop\Az.ApplicationMonitor.0.3.0-alpha.nupkg"
$pathToZip = ([io.path]::ChangeExtension($pathToNupkg, "zip"))
$pathToNupkg | rename-item -newname $pathToZip
$pathInstalledModule = "$Env:ProgramFiles\WindowsPowerShell\Modules\Az.ApplicationMonitor"
Expand-Archive -LiteralPath $pathToZip -DestinationPath $pathInstalledModule

Включение мониторинга

Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'

Часто задаваемые вопросы

В этом разделы приводятся ответы на часто задаваемые вопросы.

Поддерживает ли агент Application Insights установку прокси-серверов?

Да. Существует несколько способов скачивания агента Application Insights:

  • Если у вашего компьютера есть доступ к Интернету, вы можете подключиться к коллекции PowerShell с помощью параметров -Proxy.
  • Вы также можете вручную скачать модуль и либо установить его на компьютер, либо использовать напрямую.

Каждый из этих вариантов описан в подробных инструкциях.

Поддерживает ли агент Application Insights приложения ASP.NET Core?

Да. В агенте Application Insights 2.0.0 и более поздних версий поддерживаются ASP.NET Core-приложения, размещенные в службах IIS.

Как проверить, что включение прошло успешно?

  • Можно использовать командлет Get-ApplicationInsightsMonitoringStatus для проверки успешного включения.

  • Используйте динамические метрики, чтобы быстро определить, отправляет ли ваше приложение данные телеметрии.

  • Вы также можете использовать log Analytics для получения списка всех облачных ролей, отправляющих данные телеметрии:

    union * | summarize count() by cloud_RoleName, cloud_RoleInstance

Как я могу достичь сквозного прокси?

Для обеспечения сквозного прохождения через прокси, настройте прокси на машинном уровне или на уровне приложения. См. раздел DefaultProxy.

Пример файла Web.config:

<system.net>
    <defaultProxy>
    <proxy proxyaddress="http://xx.xx.xx.xx:yyyy" bypassonlocal="true"/>
    </defaultProxy>
</system.net>

Устранение неполадок

См. специальные инструкции по устранению неполадок.

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

Пакеты SDK и агенты Application Insights отправляют данные телеметрии, которые затем обрабатываются как REST-вызовы в наших конечных точках приема. Вы можете проверить подключение с веб-сервера или серверного хоста приложения к конечным точкам службы приема, используя REST-клиенты в PowerShell или команды curl. Смотрите Устранение неполадок с отсутствующими данными телеметрии приложений в Azure Monitor Application Insights.

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

Просмотр телеметрии:

Добавление данных телеметрии:

Дополнительные возможности с агентом Application Insights: