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

Развертывание агента 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.

значок коллекция PowerShell.

Instructions

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

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

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

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

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

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

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

Примечание.

По состоянию на апрель 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 установку прокси-серверов?

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

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

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

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

Да. В агенте Application Insights 2.0.0 и более поздних версий поддерживаются ASP.NET основные приложения, размещенные в СЛУЖБАх 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: