Compartir a través de


Implementación de Azure Application Insights Agent para servidores locales

Application Insights Agent (anteriormente conocido como Monitor de estado V2) es un módulo de PowerShell publicado en la Galería de PowerShell. Reemplaza al Monitor de estado. Se envía telemetría a Azure Portal, donde puede supervisar la aplicación.

Para obtener una lista completa de escenarios de instrumentación automática compatibles, consulte Entornos, lenguajes y proveedores de recursos admitidos.

Nota:

El módulo admite actualmente la instrumentación sin código de aplicaciones web ASP.NET y ASP.NET Core hospedadas con IIS. Use un SDK para instrumentar las aplicaciones Java y Node.js.

Application Insights Agent se encuentra en la Galería de PowerShell.

Icono de la Galería de PowerShell.

Instrucciones

  • Para empezar a trabajar con ejemplos de código concisos, vea la pestaña Introducción.
  • Para obtener información más precisa sobre cómo empezar, consulte la pestaña instrucciones detalladas.
  • Para obtener referencia de la API de PowerShell, consulte la pestaña Referencia de API.
  • Para obtener actualizaciones de notas de la versión, consulte la pestaña Notas de la versión.

Esta pestaña contiene los comandos de inicio rápido que se espera que funcionen para la mayoría de los entornos. Las instrucciones dependen de Galería de PowerShell para distribuir las actualizaciones. Estos comandos admiten el parámetro de PowerShell -Proxy.

Para obtener una explicación de estos comandos, las instrucciones de personalización e información sobre cómo solucionar problemas, consulte las instrucciones detalladas.

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

Use Galería de PowerShell para la descarga y la instalación.

Requisitos previos de instalación

Para habilitar la supervisión, deberá tener una cadena de conexión. La cadena de conexión se muestra en el panel Información general del recurso de Application Insights. Para obtener más información, consulte Cadenas de conexión.

Nota

Desde abril de 2020, TLS 1.1 y 1.0 están en desuso para Galería de PowerShell.

Para consultar los requisitos previos adicionales que puede necesitar, vea el artículo sobre la compatibilidad de TLS con Galería de PowerShell.

Ejecute PowerShell como administrador.

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

Cierre PowerShell.

Instalación de Application Insights Agent

Ejecute PowerShell como administrador.

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

Nota

El conmutador AllowPrerelease del cmdlet Install-Module permite la instalación de la versión beta.

Para obtener más información, vea Install-Module.

Habilitar supervisión

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

Descarga e instalación manual (opción sin conexión)

También puede realizar la descarga e instalación manualmente.

Descara del módulo

Descargue manualmente la versión más reciente del módulo desde la Galería de PowerShell.

Descompresión e instalación de Application Insights Agent

$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

Habilitar supervisión

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

Preguntas más frecuentes

Esta sección proporciona respuestas a preguntas comunes.

¿Application Insights Agent admite instalaciones de proxy?

Sí. Hay varias formas de descargar Application Insights Agent:

  • Si el equipo tiene acceso a internet, puede incorporarlo en la Galería de PowerShell mediante los parámetros -Proxy.
  • Puede descargar manualmente el módulo e instalarlo en el equipo o usarlo directamente.

Cada una de estas opciones se describe en las instrucciones detalladas.

¿El agente de Application Insights admite aplicaciones ASP.NET Core?

Sí. En Application Insights Agent 2.0.0 y versiones posteriores, se admiten aplicaciones de ASP.NET Core hospedadas en IIS.

¿Cómo se puede comprobar que la habilitación se realizó correctamente?

  • Puede usar el cmdlet Get-ApplicationInsightsMonitoringStatus para comprobar que se ha habilitado correctamente.
    • Use Live Metrics para determinar rápidamente si la aplicación está enviando telemetría.

    • También puede usar Log Analytics para enumerar todos los roles en la nube que están enviando actualmente telemetría:

      union * | summarize count() by cloud_RoleName, cloud_RoleInstance
      

¿Cómo puedo lograr el acceso directo de proxy?

Para lograr el acceso directo del proxy, configure un proxy de nivel de máquina o un proxy de nivel de aplicación. Consulte DefaultProxy.

Ejemplo de Web.config:

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

Solución de problemas

Consulte el artículo de solución de problemas dedicado.

Prueba de la conectividad entre el host de la aplicación y el servicio de ingesta

Los SDK y agentes de Application Insights envían telemetría para ingerirse como llamadas REST a nuestros puntos de conexión de ingesta. Puede probar la conectividad desde el servidor web o la máquina host de la aplicación a los puntos de conexión del servicio de ingesta mediante clientes REST sin procesar con comandos de PowerShell o curl. Consulte Solución de problemas de telemetría de aplicaciones que faltan en Azure Monitor Application Insights.

Pasos siguientes

Vea la telemetría:

Agregue más telemetría:

Haga mucho más con Application Insights Agent: