Solución de administración de Application Insights Connector (en desuso)
Nota
Con el soporte técnico de consultas entre recursos, la solución de administración Application Insights Connector ya no es necesaria. Está en desuso y se ha eliminado de Azure Marketplace junto con el portal de OMS que dejó de usarse oficialmente el 15 de enero de 2019 para la nube comercial de Azure. Se retirará el 30 de marzo de 2019 para la nube de US Government de Azure.
Las conexiones existentes continuarán funcionando hasta el 30 de junio de 2019. Con el desuso del portal de OMS, no hay manera de configurar y quitar las conexiones existentes del portal. Consulte Eliminación del conector con PowerShell que aparece a continuación para obtener un script que usa PowerShell para eliminar las conexiones existentes.
Para obtener instrucciones sobre la realización de consultas en datos de registro de Application Insights, consulte Unificación de varios recursos de Application Insights de Azure Monitor. Para más información sobre el abandono del portal de OMS, consulte Traslado del portal de OMS a Azure.
La solución Applications Insights Connector le permite diagnosticar problemas de rendimiento y comprender lo que los usuarios hacen con su aplicación cuando se supervisa mediante Application Insights. En Log Analytics, hay disponibles vistas de la misma telemetría de aplicación que los desarrolladores ven en Application Insights. Sin embargo, cuando se integran las aplicaciones de Application Insights con Log Analytics, la visibilidad de las aplicaciones aumenta debido a que los datos de operación y de aplicación están en el mismo lugar. Tener las mismas vistas le permite colaborar con los desarrolladores de aplicaciones. Las vistas comunes pueden ayudar a disminuir el tiempo para detectar y resolver problemas tanto de aplicaciones como de plataformas.
Cuando usa la solución, puede:
- Ver todas las aplicaciones de Application Insights en un solo lugar, incluso si se encuentran en suscripciones de Azure distintas.
- Correlacionar datos de infraestructura con datos de aplicación.
- Visualizar datos de aplicación con perspectivas en la búsqueda de registros.
- Pasar de los datos de Log Analytics a la aplicación de Application Insights en Azure Portal.
Nota:
Se recomienda usar el módulo Azure Az de PowerShell para interactuar con Azure. Consulte Instalación de Azure PowerShell para empezar. Para más información sobre cómo migrar al módulo Az de PowerShell, consulte Migración de Azure PowerShell de AzureRM a Az.
Orígenes conectados
A diferencia de la mayoría de las demás soluciones de Log Analytics, los agentes no recopilan datos para Application Insights Connector. Todos los datos usados por la solución proceden directamente de Azure.
| Origen conectado | Compatible | Descripción |
|---|---|---|
| Agentes de Windows | No | La solución no recopila información de los agentes de Windows. |
| Agentes de Linux | No | La solución no recopila información de los agentes de Linux. |
| Grupo de administración de SCOM | No | La solución no recopila información de los agentes de un grupo de administración SCOM conectado. |
| Cuenta de Almacenamiento de Azure | No | La solución no recopila información de Azure Storage. |
Prerrequisitos
- Para obtener acceso a la información sobre Application Insights Connector, debe tener una suscripción de Azure
- Debe tener como mínimo un recurso de Application Insights configurado.
- Debe ser propietario o colaborador del recurso de Application Insights.
Configuración
- Habilite la solución Azure Web Apps Analytics desde Azure Marketplace o mediante el proceso descrito en Incorporación de soluciones de Log Analytics desde la galería de soluciones.
- Vaya a Azure Portal. Seleccione Todos los servicios para abrir Application Insights. Después, busque “Application Insights”.
- En Seleccionar una suscripción, seleccione una suscripción que tenga recursos de Application Insights y, después, en Nombre, seleccione una o más aplicaciones.
- Haga clic en Save(Guardar).
Aproximadamente en 30 minutos, los datos quedan disponibles y el icono de Application Insights se actualiza con los datos, como se ve en la imagen siguiente:
Otros puntos que se deben considerar:
- Solo puede vincular aplicaciones de Application Insights a un área de trabajo de Log Analytics.
- Solo puede vincular recursos del nivel Básico o Enterprise de Application Insights a Log Analytics. Sin embargo, puede usar el nivel Gratis de Log Analytics.
Módulos de administración
Esta solución no instala ningún módulo de administración en grupos de administración conectados.
Uso de la solución
En las secciones siguientes se describe cómo puede usar las hojas que aparecen en el panel de Application Insights para ver los datos de las aplicaciones e interactuar con ellos.
Visualización de la información de Application Insights Connector
Haga clic en el icono Application Insights para abrir el panel Application Insights y ver las secciones siguientes.
El panel incluye las secciones que aparecen en la tabla. Cada sección muestra hasta diez elementos que coinciden con los criterios de esa sección para el ámbito e intervalo de tiempo especificados. Puede ejecutar una búsqueda de registros que devuelva todos los registros cuando haga clic en Ver todo en la parte inferior de la sección o cuando haga clic en el encabezado de esta.
| Columna | Descripción |
|---|---|
| Aplicaciones: número de aplicaciones | Muestra el número de aplicaciones en los recursos de aplicación. También muestra los nombres de aplicación y la cantidad de registros de aplicación para cada uno. Haga clic en el número para ejecutar una búsqueda de registros de ApplicationInsights | summarize AggregatedValue = sum(SampledCount) by ApplicationName Haga clic en un nombre de aplicación para ejecutar una búsqueda de registros de la aplicación que muestre registros de aplicación por host, registros por tipo de telemetría y todos los datos por tipo (según el último día). |
| Volumen de datos: hosts que envían datos | Muestra el número de hosts de equipos que envían datos. También muestra los hosts de equipos y números de registros para cada host. Haga clic en el número para ejecutar una búsqueda de registros de ApplicationInsights | summarize AggregatedValue = sum(SampledCount) by Host Haga clic en un nombre de equipo para ejecutar una búsqueda de registros del host que muestre registros de aplicación por host, registros por tipo de telemetría y todos los datos por tipo (según el último día). |
| Disponibilidad: resultados de WebTest | Muestra un gráfico de anillos para los resultados de pruebas web, que indican una prueba correcta o errónea. Haga clic en el gráfico para ejecutar una búsqueda de registros de ApplicationInsights | where TelemetryType == "Availability" | summarize AggregatedValue = sum(SampledCount) by AvailabilityResult Los resultados muestran el número de pruebas correctas y erróneas en todas las pruebas. Muestra todas las instancias de Web Apps con tráfico durante el último minuto. Haga clic en un nombre de aplicación para ver una búsqueda de registros con los detalles de las pruebas web erróneas. |
| Solicitudes de servidor: solicitudes por hora | Muestra un gráfico de líneas de las solicitudes de servidor por hora para diversas aplicaciones. Mantenga el mouse sobre una línea del gráfico para ver las tres aplicaciones principales que reciben solicitudes en un momento específico. También muestra una lista de las aplicaciones que reciben solicitudes y el número de solicitudes para el período seleccionado. Haga clic en el gráfico para ejecutar una búsqueda de registros de ApplicationInsights | where TelemetryType == "Request" | summarize AggregatedValue = sum(SampledCount) by ApplicationName, bin(TimeGenerated, 1h) que muestre un gráfico de líneas más detallado de las solicitudes de servidor por hora para las diversas aplicaciones. Haga clic en una aplicación de la lista para ejecutar una búsqueda de registros de ApplicationInsights | where ApplicationName == "yourapplicationname" and TelemetryType == "Request" and iff(isnotnull(toint(RequestSuccess)), RequestSuccess == false, RequestSuccess == "false") == true que muestre una lista de solicitudes, gráficos de las solicitudes en el tiempo y la duración de las solicitudes, y una lista de los códigos de respuestas de las solicitudes. |
| Errores: solicitudes erróneas por hora | Muestra un gráfico de líneas de las solicitudes de aplicación erróneas por hora. Mantenga el mouse sobre el gráfico para ver las tres aplicaciones principales con solicitudes erróneas en un momento específico. También muestra una lista de aplicaciones con el número de solicitudes erróneas para cada una de ellas. Haga clic en el gráfico para ejecutar una búsqueda de registros de ApplicationInsights | where TelemetryType == "Request" and iff(isnotnull(toint(RequestSuccess)), RequestSuccess == false, RequestSuccess == "false") == true | summarize AggregatedValue = sum(SampledCount) by ApplicationName, bin(TimeGenerated, 1h) que muestre un gráfico de líneas más detallado con las solicitudes de aplicación erróneas. Haga clic en un elemento de la lista para ejecutar una búsqueda de registros de ApplicationInsights | where ApplicationName == "yourapplicationname" and TelemetryType == "Request" and iff(isnotnull(toint(RequestSuccess)), RequestSuccess == false, RequestSuccess == "false") == true que muestre solicitudes erróneas, gráficos de las solicitudes erróneas en el tiempo y la duración de las solicitudes, y una lista de los códigos de respuestas de las solicitudes erróneas. |
| Excepciones: excepciones por hora | Muestra un gráfico de líneas de las excepciones por hora. Mantenga el mouse sobre el gráfico para ver las tres aplicaciones principales con excepciones en un momento específico. También muestra una lista de aplicaciones con el número de excepciones para cada una de ellas. Haga clic en el gráfico para ejecutar una búsqueda de registros de ApplicationInsights | where TelemetryType == "Exception" | summarize AggregatedValue = sum(SampledCount) by ApplicationName, bin(TimeGenerated, 1h) que muestre un gráfico de líneas más detallado de excepciones. Haga clic en un elemento de la lista para ejecutar una búsqueda de registros de ApplicationInsights | where ApplicationName == "yourapplicationname" and TelemetryType == "Exception" que muestre una lista de excepciones, gráficos de las excepciones en el tiempo y las solicitudes erróneas, y una lista de los tipos de excepción. |
Visualización de la perspectiva de Application Insights con la búsqueda de registros
Cuando haga clic en cualquier elemento del panel, verá que aparece una perspectiva de Application Insights en la búsqueda. La perspectiva proporciona una visualización extendida, según el tipo de telemetría que seleccione. Por lo tanto, el contenido de la visualización cambia según los distintos tipos de telemetría.
Cuando hace clic en cualquier parte de la sección Aplicaciones, ve la perspectiva Aplicaciones predeterminada.
La perspectiva muestra información general de la aplicación que seleccionó.
La sección Disponibilidad muestra una vista de perspectiva distinta en la que puede ver los resultados de las pruebas web y las solicitudes erróneas relacionadas.
Cuando hace clic en cualquier parte de las secciones Solicitudes de servidor o Errores, los componentes de la perspectiva cambian para ofrecer una visualización relacionada con las solicitudes.
Cuando hace clic en cualquier parte de la sección Excepciones, ve una visualización adaptada a las excepciones.
Independientemente de si hace clic en algún elemento del panel Application Insights Connector, en la página Búsqueda misma, cualquier consulta que devuelva datos de Application Insights muestra la perspectiva de Application Insights. Por ejemplo, si ve los datos de Application Insights, una consulta * también muestra la pestaña de perspectivas, como se muestra en la imagen siguiente:
Los componentes de perspectiva se actualizan según la consulta de búsqueda. Esto significa que puede filtrar los resultados mediante cualquier campo de búsqueda que le permita ver los datos desde:
- Todas las aplicaciones
- Una sola aplicación seleccionada
- Un grupo de aplicaciones
Paso a una aplicación en Azure Portal
Las secciones de Application Insights Connector se han diseñado para permitirle cambiar a la aplicación seleccionada de Application Insights cuando usa Azure Portal. Puede usar la solución como una plataforma de supervisión de alto nivel que le ayuda a solucionar los problemas de una aplicación. Cuando vea un posible problema en cualquiera de las aplicaciones conectadas, puede profundizar en él en la búsqueda de Log Analytics o puede cambiar directamente a la aplicación de Application Insights.
Para hacer lo último, haga clic en los tres puntos suspensivos ( … ) que aparecen al final de cada línea y seleccione Abrir en Application Insights.
Nota
Abrir en Application Insights no está disponible en Azure Portal.
Datos de ejemplo corregidos
Application Insights proporciona corrección de muestreo para ayudar a disminuir el tráfico de telemetría. Cuando se habilita el muestreo en la aplicación de Application Insights, obtiene un número reducido de entradas almacenadas en Application Insights y en Log Analytics. Si bien la coherencia de los datos se conserva en las perspectivas y en la página Application Insights Connector, debe corregir manualmente los datos muestreados para las consultas personalizadas.
A continuación, se muestra un ejemplo de una corrección de muestreo en una consulta de búsqueda de registros:
ApplicationInsights | summarize AggregatedValue = sum(SampledCount) by TelemetryType
El campo Sampled Count aparece en todas las entradas y muestra el número de puntos de datos que representa la entrada. Si activa el muestreo para la aplicación de Application Insights, el campo Sampled Count es mayor que 1. Para registrar el número real de entradas que genera la aplicación, sume los campos Sampled Count.
El muestreo afecta solo el número total de entradas que la aplicación genera. No necesita corregir el muestreo para campos de métrica como RequestDuration o AvailabilityDuration, porque esos campos muestran el promedio de las entradas representadas.
Datos de entrada
La solución recibe los siguientes tipos de telemetría de datos desde las aplicaciones conectadas de Application Insights:
- Disponibilidad
- Excepciones
- Requests
- Vistas de página: para que el área de trabajo reciba vistas de página, se deben configurar las aplicaciones para que recopilen esa información. Para más información, consulte PageViews.
- Eventos personalizados: para que el área de trabajo reciba eventos personalizados, se deben configurar las aplicaciones para que recopilen esa información. Para más información, consulte TrackEvent.
Log Analytics recibe los datos desde Application Insights en cuanto están disponibles.
Datos de salida
Se crea un registro con un tipo de ApplicationInsights para cada tipo de datos de entrada. Los registros de ApplicationInsights tienen propiedades que se muestran en las secciones siguientes:
Campos genéricos
| Propiedad | Descripción |
|---|---|
| Tipo | ApplicationInsights |
| ClientIP | |
| TimeGenerated | Hora del registro |
| ApplicationId | Clave de instrumentación de la aplicación de Application Insights |
| ApplicationName | Nombre de la aplicación de Application Insights |
| RoleInstance | Identificador del host del servidor |
| DeviceType | Dispositivo de cliente |
| ScreenResolution | |
| Continent | El continente donde se originó la solicitud |
| Country | País o región donde se originó la solicitud |
| Province | La provincia, el estado o la localidad donde se originó la solicitud |
| City | La ciudad o el pueblo donde se originó la solicitud |
| isSynthetic | Indica si la solicitud la creó un usuario o un método automatizado. True = método automatizado o false = generado por el usuario |
| SamplingRate | Porcentaje de telemetría generado por el SDK que se envía al portal. Intervalo 0,0 a 100,0. |
| SampledCount | 100/(SamplingRate). Por ejemplo, 4 => 25 % |
| IsAuthenticated | Verdadero o falso |
| OperationID | Los elementos que tienen el mismo identificador de operación se muestran como elementos relacionados en el portal. Normalmente, el identificador de solicitud |
| ParentOperationID | El identificador de la operación principal |
| OperationName | |
| SessionId | GUID para identificar de forma única la sesión en que se creó la solicitud |
| SourceSystem | ApplicationInsights |
Campos específicos de disponibilidad
| Propiedad | Descripción |
|---|---|
| TelemetryType | Disponibilidad |
| AvailabilityTestName | Nombre de la prueba web |
| AvailabilityRunLocation | Origen geográfico de la solicitud HTTP |
| AvailabilityResult | Indica el resultado correcto de la prueba web |
| AvailabilityMessage | El mensaje adjunto a la prueba web |
| AvailabilityCount | 100/(velocidad de muestreo). Por ejemplo, 4 => 25 % |
| DataSizeMetricValue | 1,0 o 0,0 |
| DataSizeMetricCount | 100/(velocidad de muestreo). Por ejemplo, 4 => 25 % |
| AvailabilityDuration | Tiempo, en milisegundos, de la duración de la prueba web |
| AvailabilityDurationCount | 100/(velocidad de muestreo). Por ejemplo, 4 => 25 % |
| AvailabilityValue | |
| AvailabilityMetricCount | |
| AvailabilityTestId | GUID único de la prueba web |
| AvailabilityTimestamp | Marca de tiempo precisa de la prueba de disponibilidad |
| AvailabilityDurationMin | En el caso de los registros muestreados, este campo muestra la duración mínima de la prueba web (en milisegundos) para los puntos de datos representados |
| AvailabilityDurationMax | En el caso de los registros muestreados, este campo muestra la duración máxima de la prueba web (en milisegundos) para los puntos de datos representados |
| AvailabilityDurationStdDev | En el caso de los registros muestreados, este campo muestra la desviación estándar entre las duraciones de todas las pruebas web (en milisegundos) para los puntos de datos representados |
| AvailabilityMin | |
| AvailabilityMax | |
| AvailabilityStdDev |
Campos específicos de excepción
| Tipo | ApplicationInsights |
|---|---|
| TelemetryType | Excepción |
| ExceptionType | Tipo de la excepción |
| ExceptionMethod | El método que crea la excepción |
| ExceptionAssembly | El ensamblado incluye el marco y la versión, además del token de clave pública |
| ExceptionGroup | Tipo de la excepción |
| ExceptionHandledAt | Indica el nivel que controló la excepción |
| ExceptionCount | 100/(velocidad de muestreo). Por ejemplo, 4 => 25 % |
| ExceptionMessage | Mensaje de la excepción |
| ExceptionStack | Pila completa de la excepción |
| ExceptionHasStack | Verdadero, si la excepción tiene una pila |
Campos específicos de solicitud
| Propiedad | Descripción |
|---|---|
| Tipo | ApplicationInsights |
| TelemetryType | Solicitud |
| ResponseCode | Respuesta HTTP enviada al cliente |
| RequestSuccess | Indica una solicitud correcta o errónea. True o false. |
| RequestID | Identificador para identificar de forma única la solicitud |
| RequestName | GET/POST + dirección URL base |
| RequestDuration | Tiempo, en segundos, de la duración de la solicitud |
| URL | Dirección URL de la solicitud, sin incluir el host |
| Host | Host del servidor web |
| URLBase | Dirección URL completa de la solicitud |
| ApplicationProtocol | Tipo de protocolo que la aplicación usa |
| RequestCount | 100/(velocidad de muestreo). Por ejemplo, 4 => 25 % |
| RequestDurationCount | 100/(velocidad de muestreo). Por ejemplo, 4 => 25 % |
| RequestDurationMin | En el caso de los registros muestreados, este campo muestra la duración mínima de solicitud (en milisegundos) para los puntos de datos representados. |
| RequestDurationMax | En el caso de los registros muestreados, este campo muestra la duración máxima de solicitud (en milisegundos) para los puntos de datos representados. |
| RequestDurationStdDev | En el caso de los registros muestreados, este campo muestra la desviación estándar entre las duraciones de todas las solicitudes (en milisegundos) para los puntos de datos representados |
Búsquedas de registros de ejemplo
Esta solución no tiene un conjunto de búsquedas de registros de ejemplo que aparezca en el panel. Sin embargo, las consultas de búsquedas de registros de ejemplo con descripciones sí se muestran en la sección Visualización de la información de Application Insights Connector.
Eliminación del conector con PowerShell
Con el desuso del portal de OMS, no hay manera de configurar y quitar las conexiones existentes del portal. Puede quitar las conexiones existentes con el siguiente script de PowerShell. Debe poseer el rol de propietario o colaborador del área de trabajo y el de lector del recurso de Application Insights para llevar a cabo esta acción.
$Subscription_app = "App Subscription Name"
$ResourceGroup_app = "App ResourceGroup"
$Application = "Application Name"
$Subscription_workspace = "Workspace Subscription Name"
$ResourceGroup_workspace = "Workspace ResourceGroup"
$Workspace = "Workspace Name"
Connect-AzAccount
Set-AzContext -SubscriptionId $Subscription_app
$AIApp = Get-AzApplicationInsights -ResourceGroupName $ResourceGroup_app -Name $Application
Set-AzContext -SubscriptionId $Subscription_workspace
Remove-AzOperationalInsightsDataSource -WorkspaceName $Workspace -ResourceGroupName $ResourceGroup_workspace -Name $AIApp.Id
Puede recuperar una lista de aplicaciones mediante el siguiente script de PowerShell que invoca una llamada API REST.
Connect-AzAccount
$Tenant = "TenantId"
$Subscription_workspace = "Workspace Subscription Name"
$ResourceGroup_workspace = "Workspace ResourceGroup"
$Workspace = "Workspace Name"
$AccessToken = "AAD Authentication Token"
Set-AzContext -SubscriptionId $Subscription_workspace
$LAWorkspace = Get-AzOperationalInsightsWorkspace -ResourceGroupName $ResourceGroup_workspace -Name $Workspace
$Headers = @{
"Authorization" = "Bearer $($AccessToken)"
"x-ms-client-tenant-id" = $Tenant
}
$Connections = Invoke-RestMethod -Method "GET" -Uri "https://management.azure.com$($LAWorkspace.ResourceId)/dataSources/?%24filter=kind%20eq%20'ApplicationInsights'&api-version=2015-11-01-preview" -Headers $Headers
$ConnectionsJson = $Connections | ConvertTo-Json
Este script requiere un token de autenticación de portador para la autenticación con Azure Active Directory. Una manera de recuperar este token es mediante un artículo que se encuentra en el sitio de documentación de API REST. Haga clic en Probar e inicie sesión en su suscripción de Azure. Puede copiar el token de portador de la vista previa de la solicitud tal como se muestra en la siguiente imagen.
También puede recuperar una lista de aplicaciones mediante una consulta de registro:
ApplicationInsights | summarize by ApplicationName
Pasos siguientes
- Use Búsqueda de registros para ver información detallada de las aplicaciones de Application Insights.