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

  • Статья

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

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

Примечание.

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

Агент Аналитика приложения находится в коллекция PowerShell.

PowerShell Gallery icon.

Instructions

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

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

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

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

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

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

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

Примечание.

По состоянию на апрель 2020 г. в коллекции PowerShell есть нерекомендуемые TLS версий 1.1 и 1.0.

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

Запустите 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 установку прокси-серверов?

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

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

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

Поддерживает ли агент application Аналитика ASP.NET Core?

Да. В application Аналитика Agent 2.0.0 и более поздних версий поддерживаются приложения ASP.NET Core, размещенные в СЛУЖБАх IIS.

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

  • Вы можете использовать командлет Get-Application Аналитика MonitoringStatus, чтобы убедиться, что включение выполнено успешно.

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

  • Вы также можете использовать 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 и агенты приложений Аналитика отправляют данные телеметрии для приема в качестве вызовов REST к конечным точкам приема. Вы можете проверить подключение с веб-сервера или хост-компьютера приложения к конечным точкам службы приема с помощью необработанных клиентов REST из Команд PowerShell или curl. См. раздел "Устранение неполадок с отсутствующими данными телеметрии приложения" в Аналитика приложения Azure Monitor.

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

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

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

Прочие действия с агентом Application Insights: