Migración a recursos de Application Insights basados en áreas de trabajo
Este artículo le orienta en la migración de un recurso clásico de Application Insights a un recurso basado en áreas de trabajo.
Recursos basados en el área de trabajo:
- Permiten la integración completa entre Application Insights y Log Analytics.
- Envían telemetría de Application Insights a un área de trabajo de Log Analytics común.
- Permiten acceder a las características más recientes de Azure Monitor, a la vez que se mantienen los registros de aplicación, infraestructura y plataforma en una ubicación consolidada.
- Habilitan el control de acceso basado en rol de Azure en todos los recursos.
- Eliminan la necesidad de consultas entre aplicaciones o áreas de trabajo.
- Están disponibles en todas las regiones comerciales y en Azure US Government.
- No requieren que se cambien las claves de instrumentación después de la migración desde un recurso clásico
Funcionalidades nuevas
Los recursos de Application Insights basados en áreas de trabajo permiten aprovechar las capacidades más recientes de Azure Monitor y Log Analytics:
- Las claves administradas por el cliente proporcionan cifrado en reposo de los datos mediante claves de cifrado a las que solo tiene acceso el usuario.
- Azure Private Link le permite vincular de forma segura los servicios de plataforma como servicio (PaaS) de Azure a una red virtual mediante puntos de conexión privados.
- Traiga su propio almacenamiento (BYOS) para Profiler y Snapshot Debugger le proporciona control total sobre lo siguiente:
- Directiva de cifrado en reposo.
- Directiva de administración de la vigencia.
- Acceso de red para todos los datos asociados a Application Insights Profiler y Snapshot Debugger.
- Los niveles de compromiso permiten ahorrar hasta un 30 %, en comparación con el precio de Pago por uso. De lo contrario, la facturación de la ingesta de datos y la retención de datos de pago por uso en Log Analytics es similar a la facturación en Application Insights.
- Los datos se ingieren más rápido mediante la ingesta de streaming de Log Analytics.
Nota
Después de migrar a un recurso de Application Insights basado en áreas de trabajo, se podrían almacenar datos de telemetría que procedan de varios recursos de Application Insights en un área de trabajo común de Log Analytics. Todavía puede extraer datos de un recurso específico de Application Insights, tal como se describe en la sección Descripción de las consultas de registro.
Proceso de migración
Al migrar a un recurso basado en áreas de trabajo no se transfieren datos del almacenamiento del recurso clásico al nuevo almacenamiento basado en áreas de trabajo. Si se decide migrar, la ubicación donde se escriben los nuevos datos cambia a un área de trabajo de Log Analytics, a la vez que se conserva el acceso a los datos del recurso clásico.
Los datos de recursos clásicos se conservan y están sujetos a la configuración de retención en el recurso de Application Insights clásico. Todos los nuevos datos ingeridos después de la migración están sujetos a la configuración de retención del área de trabajo asociada de Log Analytics, que admite diferentes configuraciones de retención por tipo datos.
El proceso de migración es permanente y no se puede revertir. Una vez que se migra un recurso a Application Insights basado en áreas de trabajo, siempre va a ser un recurso basado en áreas de trabajo. Una vez migrado, puede cambiar el área de trabajo de destino siempre que sea necesario.
Si no tiene que migrar un recurso existente y quiere crear un nuevo recurso de Application Insights basado en áreas de trabajo, use la guía de creación de recursos basados en áreas de trabajo.
Nota:
El proceso de migración no debe introducir ningún tiempo de inactividad o reinicio de la aplicación ni cambiar la clave de instrumentación o la cadena de conexión existentes.
Requisitos previos
Un área de trabajo de Log Analytics con el modo de control de acceso establecido en el valor Usar permisos de recurso o de área de trabajo:
- Los recursos de Application Insights basados en áreas de trabajo no son compatibles con las áreas de trabajo establecidas en la opción dedicada permisos basados en el área de trabajo. Para más información sobre el control de acceso al área de trabajo de Log Analytics, consulte la guía de modos de control de acceso.
- Si aún no tiene un área de trabajo de Log Analytics, consulte la documentación sobre la creación de áreas de trabajo de Log Analytics.
La exportación continua no es compatible con los recursos basados en áreas de trabajo y se debe deshabilitar. Una vez finalizada la migración, puede usar la configuración de diagnóstico para configurar el archivado de datos en una cuenta de almacenamiento o el streaming a Azure Event Hubs.
Precaución
- La configuración de diagnóstico usa un formato o esquema de exportación diferente al de la exportación continua. La migración hace que se interrumpan las integraciones existentes con Azure Stream Analytics.
- La exportación de la configuración de diagnóstico puede aumentar los costos. Para más información, consulte Exportación de telemetría desde Application Insights.
Compruebe la configuración de retención actual en Configuración>Uso y costos estimados>Retención de datos del área de trabajo de Log Analytics. Esta opción afecta al periodo de tiempo que se almacenan los nuevos datos ingeridos después de migrar el recurso de Application Insights.
Nota
- Si actualmente almacena datos de Application Insights durante más tiempo que el valor predeterminado de 90 días y quiere mantener este período de retención mayor después de la migración, debe ajustar la configuración de retención del área de trabajo.
- Si ha seleccionado una retención de datos superior a 90 días en los datos ingeridos en el recurso de Application Insights clásico antes de la migración, la retención de datos sigue facturando mediante ese recurso de Application Insights hasta que los datos superen el período de retención.
- Si la configuración de retención de la instancia de Application Insights en Configurar>Uso y costos estimados>Retention de datos está habilitada, use esa opción para controlar los días de retención de los datos de telemetría guardados aún en el almacenamiento del recurso clásico.
Consulte el uso y los costos de Application Insights basado en áreas de trabajo.
Búsqueda de los recursos clásicos de Application Insights
Puede usar en de los métodos siguientes para buscar recursos de Application Insights clásicos dentro de la suscripción:
Recurso de Application Insights en Azure Portal
En la Información general de un recurso de Application Insights, los recursos clásicos de Application Insights no tienen un área de trabajo vinculada y aparece el banner de advertencia de retirada de Application Insights clásico. Los recursos basados en áreas de trabajo tienen un área de trabajo vinculada en la sección de información general
Recurso basados en áreas de trabajo:
Azure Resource Graph
Puede usar el Explorador de Azure Resource Graph (ARG) y ejecutar una consulta en la tabla "resources" para extraer esta información:
resources
| where subscriptionId == 'Replace with your own subscription ID'
| where type contains 'microsoft.insights/components'
| distinct resourceGroup, name, tostring(properties['IngestionMode']), tostring(properties['WorkspaceResourceId'])
Nota:
Los recursos clásicos se identifican mediante ‘ApplicationInsights’, "N/D" o valores vacíos.
CLI de Azure:
Ejecute el siguiente script desde Cloud Shell en el portal donde se crea la autenticación o en cualquier otro lugar después de autenticarse mediante az login
:
$resources = az resource list --resource-type 'microsoft.insights/components' | ConvertFrom-Json
$resources | Sort-Object -Property Name | Format-Table -Property @{Label="App Insights Resource"; Expression={$_.name}; width = 35}, @{Label="Ingestion Mode"; Expression={$mode = az resource show --name $_.name --resource-group $_.resourceGroup --resource-type microsoft.insights/components --query "properties.IngestionMode" -o tsv; $mode}; width = 45}
Nota:
Los recursos clásicos se identifican mediante ‘ApplicationInsights’, "N/D" o valores vacíos. El siguiente script de PowerShell se puede ejecutar desde la CLI de Azure:
$subscription = "SUBSCRIPTION ID GOES HERE"
$token = (Get-AZAccessToken).Token
$header = @{Authorization = "Bearer $token"}
$uri = "https://management.azure.com/subscriptions/$subscription/providers/Microsoft.Insights/components?api-version=2015-05-01"
$RestResult=""
$RestResult = Invoke-RestMethod -Method GET -Uri $uri -Headers $header -ContentType "application/json" -ErrorAction Stop -Verbose
$list=@()
$ClassicList=@()
foreach ($app in $RestResult.value)
{
#"processing: " + $app.properties.WorkspaceResourceId ## Classic Application Insights do not have a workspace.
if ($app.properties.WorkspaceResourceId)
{
$Obj = New-Object -TypeName PSObject
#$app.properties.WorkspaceResourceId
$Obj | Add-Member -Type NoteProperty -Name Name -Value $app.name
$Obj | Add-Member -Type NoteProperty -Name WorkspaceResourceId -Value $app.properties.WorkspaceResourceId
$list += $Obj
}
else
{
$Obj = New-Object -TypeName PSObject
$app.properties.WorkspaceResourceId
$Obj | Add-Member -Type NoteProperty -Name Name -Value $app.name
$ClassicList += $Obj
}
}
$list |Format-Table -Property Name, WorkspaceResourceId -Wrap
"";"Classic:"
$ClassicList | FT
Migración del recurso
Para migrar un recurso clásico de Application Insights a un recurso basado en áreas de trabajo:
Desde el recurso de Application Insights, seleccione "Propiedades" en el título "Configurar" del menú de la izquierda.
Seleccione Migración a Basado en el área de trabajo.
Seleccione el área de trabajo de Log Analytics donde quiere que se almacene toda la telemetría de Application Insights ingerida en el futuro. Puede tratarse de un área de trabajo de Log Analytics que se ubique tanto en la misma suscripción como en una diferente que comparta el mismo inquilino de Microsoft Entra. No es necesario que el área de trabajo de Log Analytics se ubique en el mismo grupo de recursos que el recurso Application Insights.
Nota
La migración a un recurso basado en áreas de trabajo puede tardar hasta 24 horas, aunque el proceso suele ser más rápido. Confíe en el acceso a los datos mediante el recurso de Application Insights mientras espera a que se complete el proceso de migración. Una vez finalizado, verá los nuevos datos almacenados en las tablas del área de trabajo de Log Analytics.
Una vez que migre el recurso, verá la información del área de trabajo correspondiente en el panel Información general.
Al seleccionar el texto del vínculo azul, se le dirige al área de trabajo de Log Analytics asociada, donde puede aprovechar las ventajas del nuevo entorno de consultas unificado del área de trabajo.
Sugerencia
Después de migrar a un recurso de Application Insights basado en áreas de trabajo, use el límite diario del área de trabajo para limitar la ingesta y los costos, en lugar del límite de Application Insights.
Descripción de las consultas de registro
Se proporciona compatibilidad total con versiones anteriores con las consultas de recursos clásicas, los libros y las alertas basadas en registro de Application Insights dentro de la experiencia de Application Insights.
Para escribir consultas para la nueva estructura o esquema de tabla basado en áreas de trabajo, primero debe ir al área de trabajo de Log Analytics.
Para asegurarse de que las consultas se ejecuten correctamente, compruebe que los campos de la consulta se alineen con los campos del nuevo esquema.
Es posible que tenga varios recursos de Application Insights que almacenan datos de telemetría en un área de trabajo de Log Analytics, pero quiere consultar los datos pertenecientes a un recurso específico de Application Insights. Tiene dos opciones:
- Vaya al recurso de Application Insights y seleccione la pestaña Registros. Todas las consultas que se realicen en esta pestaña extraen automáticamente los datos del recurso de Application Insights seleccionado.
- Vaya al área de trabajo de Log Analytics que configuró como destino de los datos de telemetría de Application Insights y seleccione la pestaña Registros. Para consultar datos de un recurso específico de Application Insights, fíltrelos en función de la propiedad integrada
_ResourceId
, que está disponible en todas las tablas específicas de una aplicación.
Cuando realiza consultas directamente desde el área de trabajo de Log Analytics, solo se ven los datos que se hayan ingerido después de la migración. Para ver los datos clásicos de Application Insights junto con los nuevos datos que se hayan ingerido tras una migración mediante una experiencia de consulta unificada, use la pestaña Registros que se ubica en el recurso de Application Insights que se migró.
Nota
Si cambia el nombre del recurso de Application Insights después de migrar al modelo basado en áreas de trabajo, la pestaña Registros de Application Insights ya no mostrará los datos de telemetría recopilados antes de cambiar el nombre. Puede ver todos los datos antiguos y nuevos en la pestaña Registros del recurso de Log Analytics asociado.
Identificación de los recursos de Application Insights por tipo de ingesta
Use el siguiente script para identificar los recursos de Application Insights por tipo de ingesta.
Ejemplo
Get-AzApplicationInsights -SubscriptionId 'Your Subscription ID' | Format-Table -Property Name, IngestionMode, Id, @{label='Type';expression={
if ([string]::IsNullOrEmpty($_.IngestionMode)) {
'Unknown'
} elseif ($_.IngestionMode -eq 'LogAnalytics') {
'Workspace-based'
} elseif ($_.IngestionMode -eq 'ApplicationInsights' -or $_.IngestionMode -eq 'ApplicationInsightsWithDiagnosticSettings') {
'Classic'
} else {
'Unknown'
}
}}
Migración de recursos mediante programación
Esta sección le ayuda a migrar los recursos.
Azure CLI
Para acceder a los comandos de la CLI de Azure de Application Insights en versión preliminar, primero debe ejecutar:
az extension add -n application-insights
Si no ejecuta el comando az extension add
, verá un mensaje de error que indica az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.
Ahora puede ejecutar el siguiente código para crear el recurso de Application Insights:
az monitor app-insights component update --app
--resource-group
[--ingestion-access {Disabled, Enabled}]
[--kind]
[--query-access {Disabled, Enabled}]
[--retention-time]
[--workspace]
Ejemplo
az monitor app-insights component update --app your-app-insights-resource-name -g your_resource_group --workspace "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/test1234/providers/microsoft.operationalinsights/workspaces/test1234555"
Para obtener la documentación completa de la CLI de Azure para este comando, consulte la documentación de la CLI de Azure.
Azure PowerShell
A partir de la versión 8.0 o posterior de Azure PowerShell, puede usar el comando Update-AzApplicationInsights
de PowerShell para migrar un recurso de Application Insights clásico a uno basado en el área de trabajo.
Para usar este cmdlet, debe especificar el nombre y el grupo de recursos del recurso de Application Insights que desea actualizar. Use los parámetros IngestionMode
y WorkspaceResoruceId
para migrar la instancia clásica a una basada en el área de trabajo. Para obtener más información sobre los parámetros y la sintaxis de este cmdlet, consulte Update-AzApplicationInsights.
Ejemplo
# Get the resource ID of the Log Analytics workspace
$workspaceResourceId = (Get-AzOperationalInsightsWorkspace -ResourceGroupName "rgName" -Name "laName").ResourceId
# Update the Application Insights resource with the workspace parameter
Update-AzApplicationInsights -Name "aiName" -ResourceGroupName "rgName" -IngestionMode LogAnalytics -WorkspaceResourceId $workspaceResourceId
Plantillas del Administrador de recursos de Azure
En esta sección, se proporcionan plantillas.
Precaución
Asegúrese de haber quitado toda la configuración de Exportación continua del recurso antes de ejecutar las plantillas de migración. Consulte Requisitos previos.
Archivo de plantilla
{
"$schema": "http://schema.management.azure.com/schemas/2014-04-01-preview/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"regionId": {
"type": "string"
},
"tagsArray": {
"type": "object"
},
"requestSource": {
"type": "string"
},
"workspaceResourceId": {
"type": "string"
}
},
"resources": [
{
"name": "[parameters('name')]",
"type": "microsoft.insights/components",
"location": "[parameters('regionId')]",
"tags": "[parameters('tagsArray')]",
"apiVersion": "2020-02-02-preview",
"properties": {
"ApplicationId": "[parameters('name')]",
"Application_Type": "[parameters('type')]",
"Flow_Type": "Redfield",
"Request_Source": "[parameters('requestSource')]",
"WorkspaceResourceId": "[parameters('workspaceResourceId')]"
}
}
]
}
Archivo de parámetros
{
"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"type": {
"value": "web"
},
"name": {
"value": "customresourcename"
},
"regionId": {
"value": "eastus"
},
"tagsArray": {
"value": {}
},
"requestSource": {
"value": "Custom"
},
"workspaceResourceId": {
"value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my_resource_group/providers/microsoft.operationalinsights/workspaces/myworkspacename"
}
}
}
Modificación del área de trabajo asociada
Una vez creado un recurso de Application Insights basado en áreas de trabajo, puede modificar el área de trabajo de Log Analytics asociada.
En el panel del recurso de Application Insights, seleccione Propiedades>Cambiar el área de trabajo>Áreas de trabajo de Log Analytics.
Preguntas más frecuentes
Esta sección proporciona respuestas a preguntas comunes.
¿Qué ocurre si no migro el recurso clásico de Application Insights a un recurso basado en área de trabajo?
Microsoft ha iniciado un enfoque por fases para migrar recursos clásicos a recursos basados en áreas de trabajo en mayo de 2024 y esta migración abarcará varios meses. No se pueden proporcionar fechas aproximadas en las que se migrarán recursos, suscripciones o regiones específicos.
Recomendamos encarecidamente la migración manual a recursos basados en áreas de trabajo. Este proceso se inicia al seleccionar el banner del aviso de retirada. Puede encontrarlo en el panel Información general del recurso de Application Insights clásico de Azure Portal. Este proceso suele implicar un único paso para elegir qué área de trabajo de Log Analytics se usa para almacenar los datos de la aplicación. Si usa la exportación continua, además debe migrar a la configuración de diagnóstico o deshabilitar primero la característica.
Si no quiere que el recurso clásico se migre automáticamente a un recurso basado en el área de trabajo, puede eliminar o migrar manualmente el recurso.
¿Hay alguna implicación en el costo de la migración?
Normalmente no hay ninguna diferencia, con dos excepciones.
- Los recursos de Application Insights que hayan recibido 1 GB al mes gratis mediante el modelo de precios heredado de Application Insights ya no recibirán los datos gratuitos.
- Los recursos de Application Insights que estaban en el plan de tarifa básico antes de abril de 2018 se siguen facturando al mismo precio no regional que antes de abril de 2018. Los recursos de Application Insights creados después de esa fecha, o bien los que se hayan convertido a recursos basados en área de trabajo, recibirán los precios regionales actuales. Para ver los precios vigentes actualmente en su moneda y región, consulte Precios de Application Insights.
La migración a Application Insights basada en áreas de trabajo ofrece muchas opciones para optimizar aún más el costo, incluidos los niveles de compromiso de Log Analytics, los clústeres dedicados y los registros Básico y Auxiliar.
¿Cómo funcionará el límite de telemetría?
Puede establecer un límite diario en el área de trabajo de Log Analytics.
No hay ningún límite de facturación estricto disponible.
¿Cómo funcionará el muestreo basado en la ingesta?
No hay ningún cambio en el muestreo basado en la ingesta.
¿Hay lagunas en los datos recopilados durante la migración?
No. Combinamos datos durante el tiempo de consulta.
¿Siguen funcionando mis consultas de registro antiguas?
Sí, siguen funcionando.
¿Los paneles con gráficos de métricas y de registro anclados seguirán funcionando después de la migración?
Sí, siguen funcionando.
¿Afecta la migración a la API de AppInsights que accede a los datos?
No. La migración no afecta al acceso de la API existente a los datos. Después de la migración, puede acceder a los datos directamente desde un área de trabajo mediante un esquema ligeramente diferente.
¿Hay algún impacto en Live Metrics u otras experiencias de supervisión?
No. No habrá ningún impacto en Live Metrics ni en otras experiencias de supervisión.
¿Qué ocurre con la exportación continua después de la migración?
Para continuar con las exportaciones automatizadas, deberá migrar a la configuración de diagnóstico antes de migrar a un recurso basado en el área de trabajo. La configuración de diagnóstico se transferirá en la migración a Application Insights basado en el área de trabajo.
¿Cómo puedo tener la certeza de que se va a producir una migración correcta de mi recurso de App Insights mediante Terraform?
Si usa Terraform para administrar los recursos de Azure, es importante usar la versión más reciente del proveedor azurerm de Terraform antes de intentar actualizar el recurso de App Insights. El uso de una versión anterior del proveedor, como la versión 3.12, puede provocar la eliminación del componente clásico antes de crear el recurso de Application Insights basado en el área de trabajo de reemplazo. Esto no solo puede provocar la pérdida de datos anteriores, sino también requerir la actualización de las configuraciones en las aplicaciones supervisadas con nuevos valores de cadenas de conexión y claves de instrumentación.
Para evitar este problema, asegúrese de usar la versión más reciente del proveedor azurermde Terraform, versión 3.89 o posterior. Realiza los pasos de migración adecuados, ya que genera la llamada de Azure Resource Manager (ARM) adecuada para actualizar el recurso clásico de App Insights a un recurso basado en área de trabajo, al tiempo que conserva todos los datos anteriores y los valores de las cadenas de conexión y claves de instrumentación.
¿Puedo seguir usando la API antigua para crear recursos de Application Insights mediante programación?
Para la compatibilidad con versiones anteriores, las llamadas a la API anterior para crear recursos de Application Insights siguen funcionando. Cada una de estas llamadas crea un recurso de Application Insights basado en el área de trabajo y un área de trabajo de Log Analytics para almacenar los datos.
Recomendamos encarecidamente actualizar a la nueva API para un mejor control sobre la creación de recursos.
¿Debo migrar la configuración de diagnóstico en Application Insights clásico antes de pasar a una inteligencia artificial basada en áreas de trabajo?
Sí, se recomienda migrar la configuración de diagnóstico en los recursos clásicos de Application Insights antes de realizar la transición a Application Insights basado en el área de trabajo. Esto garantiza la continuidad y la compatibilidad de la configuración de diagnóstico.
Solución de problemas
En esta sección se proporcionan sugerencias de solución de problemas.
Modo de acceso
Mensaje de error: "El área de trabajo seleccionada está configurada con el modo de acceso basado en áreas de trabajo. Algunas de las características de supervisión del rendimiento de aplicaciones (APM) se pueden ver afectadas. Seleccione otra área de trabajo o permita el acceso basado en recursos en la configuración del área de trabajo. Puede invalidar este error mediante la CLI."
Para que el recurso de Application Insights basado en áreas de trabajo funcione correctamente, debe cambiar el modo de control de acceso del área de trabajo de Log Analytics de destino a la opción Usar permisos de recurso o de área de trabajo. Este valor se encuentra en la interfaz de usuario del área de trabajo de Log Analytics, en Propiedades>Modo de control de acceso. Para obtener instrucciones, consulte la guía de configuración del modo de control de acceso de Log Analytics. Si el modo de control de acceso está establecido en el valor exclusivo Requerir permisos de área de trabajo, la migración mediante la experiencia de migración del portal permanece bloqueada.
Si no puede cambiar el modo de control de acceso del área de trabajo de destino actual por motivos de seguridad, cree una nueva área de trabajo de Log Analytics para la migración.
Exportación continua
Mensaje de error: "Se debe deshabilitar la exportación continua para continuar. Después de la migración, use la configuración de diagnóstico para la exportación."
La funcionalidad de exportación continua heredada no es compatible con los recursos basados en áreas de trabajo. Antes de realizar la migración, debe habilitar la configuración de diagnóstico y deshabilitar la exportación continua.
Habilite la configuración de diagnóstico en el recurso de Application Insights clásico.
Desde la vista del recurso de Application Insights, en el título "Configurar", seleccione "Exportación continua".
Seleccione Deshabilitar.
Después de seleccionar Deshabilitar, puede volver a la interfaz de usuario de migración. Si la página Editar exportación continua le indica que la configuración no se guarda, seleccione Aceptar. Este mensaje no pertenece a la deshabilitación o habilitación de la exportación continua.
Después de migrar correctamente el recurso de Application Insights, puede usar la configuración de diagnóstico para reemplazar la funcionalidad que solía proporcionar la exportación continua. Seleccione Configuración de diagnóstico>Agregar configuración de diagnóstico en el recurso de Application Insights. Puede seleccionar todas las tablas, o un subconjunto de tablas, para archivar en una cuenta de almacenamiento o para transmitir a Azure Event Hubs. Para más información sobre la configuración de diagnóstico, consulte la guía de configuración de diagnóstico de Azure Monitor.
Configuración de retención
Mensaje de advertencia: "La configuración de retención personalizada de Application Insights no se aplica a los datos enviados al área de trabajo. Debe volver a configurarla por separado".
No es necesario realizar ningún cambio antes de la migración. Este mensaje le avisa que la configuración de retención actual de Application Insights no está establecida en el período de retención predeterminado de 90 días. Este mensaje de advertencia significa que es posible que quiera modificar la configuración de retención del área de trabajo de Log Analytics antes de migrar y comenzar a ingerir datos nuevos.
Puede comprobar la configuración de retención actual de Log Analytics en Configuración>Uso y costos estimados>Retención de datos en la interfaz de usuario de Log Analytics. Esta opción afecta al periodo de tiempo que se almacenan los nuevos datos ingeridos después de migrar el recurso de Application Insights.
Cambios en los recursos basados en áreas de trabajo
Antes de la introducción de los recursos de Application Insights basados en áreas de trabajo, los datos de Application Insights se almacenaban en un lugar diferente de otros datos de registro en Azure Monitor. Ambos se basan en Azure Data Explorer y usan el mismo lenguaje de consulta de Kusto (KQL). Los datos de los recursos de Application Insights basados en áreas de trabajo se almacenan en un área de trabajo de Log Analytics junto con otros datos de supervisión y de aplicaciones. Esta disposición simplifica la configuración. Puede analizar los datos en varias soluciones con más facilidad y usar las capacidades de las áreas de trabajo.
Estructura de datos clásica
La estructura de un área de trabajo de Log Analytics se describe en Introducción al área de trabajo de Log Analytics. Si se trata de una aplicación clásica, los datos no se almacenan en un área de trabajo de Log Analytics. Usa el mismo lenguaje de consulta. Las consultas se crean y ejecutan con la misma herramienta de Log Analytics en Azure Portal. Los elementos de datos de las aplicaciones clásicas se almacenan separados entre sí. La estructura general es igual que la de las aplicaciones basadas en áreas de trabajo, aunque los nombres de tablas y columnas son distintos.
Nota
La experiencia clásica de Application Insights incluye compatibilidad con versiones anteriores para las consultas de recursos, los libros y las alertas basadas en registros. Para consultar o ver según la nueva estructura o esquema de tablas basada en áreas de trabajo, primero debe ir al área de trabajo de Log Analytics. Durante la versión preliminar, al seleccionar Registros en el panel de Application Insights, se proporciona acceso a la experiencia de consulta clásica de Application Insights. Para más información, consulte Ámbito e intervalo de tiempo de una consulta de registro en Log Analytics de Azure Monitor.
Estructura de tabla
Nombre de tabla heredada | Nombre de la nueva tabla | Descripción |
---|---|---|
availabilityResults | AppAvailabilityResults | Datos de resumen de las pruebas de disponibilidad. |
browserTimings | AppBrowserTimings | Datos sobre el rendimiento del cliente, como el tiempo que se tardan en procesar los datos entrantes. |
dependencies | AppDependencies | Las llamadas de la aplicación a otros componentes (incluidos los componentes externos) se registran mediante TrackDependency() . Algunos ejemplos son las llamadas a la API REST o a la base de datos o a un sistema de archivos. |
customEvents | AppEvents | Eventos personalizados creados por la aplicación. |
customMetrics | AppMetrics | Métricas personalizadas creadas por la aplicación. |
pageViews | AppPageViews | Datos sobre cada vista del sitio web con información del explorador. |
performanceCounters | AppPerformanceCounters | Medidas de rendimiento de los recursos de proceso que respaldan la aplicación. Un ejemplo son los contadores de rendimiento de Windows. |
Solicitudes | AppRequests | Solicitudes recibidas por su aplicación. Por ejemplo, se registra un registro de solicitud independiente para cada solicitud HTTP que recibe la aplicación web. |
exceptions | AppExceptions | Excepciones generadas por el entorno de ejecución de la aplicación. Captura las excepciones del lado servidor y del lado cliente (exploradores). |
traces | AppTraces | Registros detallados (seguimientos) emitidos mediante el código de aplicación y las plataformas de registro, registrados mediante TrackTrace() . |
Precaución
Espere a que se produzcan nuevos datos de telemetría en Log Analytics antes de confiar en ella. Después de iniciar la migración, la telemetría se dirige primero a Classic Application Insights. La ingesta de telemetría se cambia a Log Analytics en un plazo de 24 horas. Una vez hecho esto, Log Analytics solo captura nuevos datos de telemetría.
Esquemas de tabla
En las secciones siguientes se muestra la asignación entre los nombres de propiedades clásicas y los nuevos nombres de propiedad de Application Insights basados en áreas de trabajo. Utilice esta información para convertir las consultas mediante tablas heredadas.
La mayoría de las columnas tienen el mismo nombre con diferentes mayúsculas y minúsculas. Dado que KQL distingue entre mayúsculas y minúsculas, debe cambiar cada nombre de columna junto con los nombres de tabla en las consultas existentes. Se resaltan las columnas con cambios además de mayúsculas. Todavía puede usar las consultas clásicas de Application Insights en el panel de registros del recurso de Application Insights, incluso si se trata de un recurso basado en el área de trabajo. Los nuevos nombres de propiedad son necesarios cuando se realizan consultas desde el contexto de la experiencia del área de trabajo de Log Analytics.
AppAvailabilityResults
Tabla heredada: availabilityResults
ApplicationInsights | Tipo | LogAnalytics | Tipo |
---|---|---|---|
appId | string | ResourceGUID | string |
application_Version | string | AppVersion | string |
appName | string | (se ha quitado) | |
client_Browser | string | ClientBrowser | string |
client_city | string | ClientCity | string |
client_CountryOrRegion | string | ClientCountryOrRegion | string |
client_IP | string | ClientIP | string |
client_Model | string | ClientModel | string |
client_OS | string | ClientOS | string |
client_StateOrProvince | string | ClientStateOrProvince | string |
client_Type | string | ClientType | string |
cloud_RoleInstance | string | AppRoleInstance | string |
cloud_RoleName | string | AppRoleName | string |
customDimensions | dinámico | Propiedades | Dinámica |
customMeasurements | dinámico | Medidas | Dinámica |
duration | real | DurationMs | real |
id |
string | Id |
string |
iKey |
string | IKey |
string |
itemCount | int | ItemCount | int |
itemId | string | (se ha quitado) | |
itemType | string | Tipo | String |
ubicación | string | Location | string |
message | string | Message | string |
name | string | Nombre | string |
operation_Id | string | OperationId | string |
operation_Name | string | OperationName | string |
operation_ParentId | string | ParentId | string |
operation_SyntheticSource | string | SyntheticSource | string |
performanceBucket | string | PerformanceBucket | string |
sdkVersion | string | SDKVersion | string |
session_Id | string | SessionId | string |
tamaño | real | Size | real |
success | string | Correcto | Bool |
timestamp | datetime | TimeGenerated | datetime |
user_AccountId | string | UserAccountId | string |
user_AuthenticatedId | string | UserAuthenticatedId | string |
user_Id | string | UserId | string |
AppBrowserTimings
Tabla heredada: browserTimings
ApplicationInsights | Tipo | LogAnalytics | Tipo |
---|---|---|---|
appId | string | ResourceGUID | string |
application_Version | string | AppVersion | string |
appName | string | (se ha quitado) | |
client_Browser | string | ClientBrowser | string |
client_city | string | ClientCity | string |
client_CountryOrRegion | string | ClientCountryOrRegion | string |
client_IP | string | ClientIP | string |
client_Model | string | ClientModel | string |
client_OS | string | ClientOS | string |
client_StateOrProvince | string | ClientStateOrProvince | string |
client_Type | string | ClientType | string |
cloud_RoleInstance | string | AppRoleInstance | string |
cloud_RoleName | string | AppRoleName | string |
customDimensions | dinámico | Propiedades | Dinámica |
customMeasurements | dinámico | Medidas | Dinámica |
iKey |
string | IKey |
string |
itemCount | int | ItemCount | int |
itemId | string | (se ha quitado) | |
itemType | string | Tipo | string |
name | string | Nombre | datetime |
networkDuration | real | NetworkDurationMs | real |
operation_Id | string | OperationId | string |
operation_Name | string | OperationName | string |
operation_ParentId | string | ParentId | string |
operation_SyntheticSource | string | SyntheticSource | string |
performanceBucket | string | PerformanceBucket | string |
processingDuration | real | ProcessingDurationMs | real |
receiveDuration | real | ReceiveDurationMs | real |
sdkVersion | string | SDKVersion | string |
sendDuration | real | SendDurationMs | real |
session_Id | string | SessionId | string |
timestamp | datetime | TimeGenerated | datetime |
totalDuration | real | TotalDurationMs | real |
url | string | Url | string |
user_AccountId | string | UserAccountId | string |
user_AuthenticatedId | string | UserAuthenticatedId | string |
user_Id | string | UserId | string |
AppDependencies
Tabla heredada: dependencias
ApplicationInsights | Tipo | LogAnalytics | Tipo |
---|---|---|---|
appId | string | ResourceGUID | string |
application_Version | string | AppVersion | string |
appName | string | (se ha quitado) | |
client_Browser | string | ClientBrowser | string |
client_city | string | ClientCity | string |
client_CountryOrRegion | string | ClientCountryOrRegion | string |
client_IP | string | ClientIP | string |
client_Model | string | ClientModel | string |
client_OS | string | ClientOS | string |
client_StateOrProvince | string | ClientStateOrProvince | string |
client_Type | string | ClientType | string |
cloud_RoleInstance | string | AppRoleInstance | string |
cloud_RoleName | string | AppRoleName | string |
customDimensions | dinámico | Propiedades | Dinámica |
customMeasurements | dinámico | Medidas | Dinámica |
datos | string | data | string |
duration | real | DurationMs | real |
id |
string | Id |
string |
iKey |
string | IKey |
string |
itemCount | int | ItemCount | int |
itemId | string | (se ha quitado) | |
itemType | string | Tipo | String |
name | string | Nombre | string |
operation_Id | string | OperationId | string |
operation_Name | string | OperationName | string |
operation_ParentId | string | ParentId | string |
operation_SyntheticSource | string | SyntheticSource | string |
performanceBucket | string | PerformanceBucket | string |
resultCode | string | ResultCode | string |
sdkVersion | string | SDKVersion | string |
session_Id | string | SessionId | string |
success | string | Correcto | Bool |
Destino | string | Destino | string |
timestamp | datetime | TimeGenerated | datetime |
type | string | DependencyType | string |
user_AccountId | string | UserAccountId | string |
user_AuthenticatedId | string | UserAuthenticatedId | string |
user_Id | string | UserId | string |
AppEvents
Tabla heredada: customEvents
ApplicationInsights | Tipo | LogAnalytics | Tipo |
---|---|---|---|
appId | string | ResourceGUID | string |
application_Version | string | AppVersion | string |
appName | string | (se ha quitado) | |
client_Browser | string | ClientBrowser | string |
client_city | string | ClientCity | string |
client_CountryOrRegion | string | ClientCountryOrRegion | string |
client_IP | string | ClientIP | string |
client_Model | string | ClientModel | string |
client_OS | string | ClientOS | string |
client_StateOrProvince | string | ClientStateOrProvince | string |
client_Type | string | ClientType | string |
cloud_RoleInstance | string | AppRoleInstance | string |
cloud_RoleName | string | AppRoleName | string |
customDimensions | dinámico | Propiedades | Dinámica |
customMeasurements | dinámico | Medidas | Dinámica |
iKey |
string | IKey |
string |
itemCount | int | ItemCount | int |
itemId | string | (se ha quitado) | |
itemType | string | Tipo | string |
name | string | Nombre | string |
operation_Id | string | OperationId | string |
operation_Name | string | OperationName | string |
operation_ParentId | string | ParentId | string |
operation_SyntheticSource | string | SyntheticSource | string |
sdkVersion | string | SDKVersion | string |
session_Id | string | SessionId | string |
timestamp | datetime | TimeGenerated | datetime |
user_AccountId | string | UserAccountId | string |
user_AuthenticatedId | string | UserAuthenticatedId | string |
user_Id | string | UserId | string |
AppMetrics
Tabla heredada: customMetrics
ApplicationInsights | Tipo | LogAnalytics | Tipo |
---|---|---|---|
appId | string | ResourceGUID | string |
application_Version | string | AppVersion | string |
appName | string | (se ha quitado) | |
client_Browser | string | ClientBrowser | string |
client_city | string | ClientCity | string |
client_CountryOrRegion | string | ClientCountryOrRegion | string |
client_IP | string | ClientIP | string |
client_Model | string | ClientModel | string |
client_OS | string | ClientOS | string |
client_StateOrProvince | string | ClientStateOrProvince | string |
client_Type | string | ClientType | string |
cloud_RoleInstance | string | AppRoleInstance | string |
cloud_RoleName | string | AppRoleName | string |
customDimensions | dinámico | Propiedades | Dinámica |
iKey |
string | IKey |
string |
itemId | string | (se ha quitado) | |
itemType | string | Tipo | string |
name | string | Nombre | string |
operation_Id | string | OperationId | string |
operation_Name | string | OperationName | string |
operation_ParentId | string | ParentId | string |
operation_SyntheticSource | string | SyntheticSource | string |
sdkVersion | string | SDKVersion | string |
session_Id | string | SessionId | string |
timestamp | datetime | TimeGenerated | datetime |
user_AccountId | string | UserAccountId | string |
user_AuthenticatedId | string | UserAuthenticatedId | string |
user_Id | string | UserId | string |
value | real | (se ha quitado) | |
valueCount | int | ItemCount | int |
valueMax | real | Máx. | real |
valueMin | real | Min | real |
valueSum | real | Sum | real |
valueStdDev | real | (se ha quitado) |
Nota:
Versiones anteriores de los SDK de Application Insights que se usan para notificar la desviación estándar (valueStdDev
) en la agregación previa de métricas. Debido a la poca adopción en el análisis de métricas, el campo se quitó y los SDK ya no lo agregan. Si el punto de conexión de recopilación de datos de Application Insights recibe el valor, se quita durante la ingesta y no se envía al área de trabajo de Log Analytics. Si quiere usar la desviación estándar en el análisis, use consultas en eventos sin procesar de Application Insights.
AppPageViews
Tabla heredada: pageViews
ApplicationInsights | Tipo | LogAnalytics | Tipo |
---|---|---|---|
appId | string | ResourceGUID | string |
application_Version | string | AppVersion | string |
appName | string | (se ha quitado) | |
client_Browser | string | ClientBrowser | string |
client_city | string | ClientCity | string |
client_CountryOrRegion | string | ClientCountryOrRegion | string |
client_IP | string | ClientIP | string |
client_Model | string | ClientModel | string |
client_OS | string | ClientOS | string |
client_StateOrProvince | string | ClientStateOrProvince | string |
client_Type | string | ClientType | string |
cloud_RoleInstance | string | AppRoleInstance | string |
cloud_RoleName | string | AppRoleName | string |
customDimensions | dinámico | Propiedades | Dinámica |
customMeasurements | dinámico | Medidas | Dinámica |
duration | real | DurationMs | real |
id |
string | Id |
string |
iKey |
string | IKey |
string |
itemCount | int | ItemCount | int |
itemId | string | (se ha quitado) | |
itemType | string | Tipo | String |
name | string | Nombre | string |
operation_Id | string | OperationId | string |
operation_Name | string | OperationName | string |
operation_ParentId | string | ParentId | string |
operation_SyntheticSource | string | SyntheticSource | string |
performanceBucket | string | PerformanceBucket | string |
sdkVersion | string | SDKVersion | string |
session_Id | string | SessionId | string |
timestamp | datetime | TimeGenerated | datetime |
url | string | Url | string |
user_AccountId | string | UserAccountId | string |
user_AuthenticatedId | string | UserAuthenticatedId | string |
user_Id | string | UserId | string |
AppPerformanceCounters
Tabla heredada: performanceCounters
ApplicationInsights | Tipo | LogAnalytics | Tipo |
---|---|---|---|
appId | string | ResourceGUID | string |
application_Version | string | AppVersion | string |
appName | string | (se ha quitado) | |
category | string | Category | string |
client_Browser | string | ClientBrowser | string |
client_city | string | ClientCity | string |
client_CountryOrRegion | string | ClientCountryOrRegion | string |
client_IP | string | ClientIP | string |
client_Model | string | ClientModel | string |
client_OS | string | ClientOS | string |
client_StateOrProvince | string | ClientStateOrProvince | string |
client_Type | string | ClientType | string |
cloud_RoleInstance | string | AppRoleInstance | string |
cloud_RoleName | string | AppRoleName | string |
counter | string | (se ha quitado) | |
customDimensions | dinámico | Propiedades | Dinámica |
iKey |
string | IKey |
string |
instance | string | Instancia | string |
itemId | string | (se ha quitado) | |
itemType | string | Tipo | string |
name | string | Nombre | string |
operation_Id | string | OperationId | string |
operation_Name | string | OperationName | string |
operation_ParentId | string | ParentId | string |
operation_SyntheticSource | string | SyntheticSource | string |
sdkVersion | string | SDKVersion | string |
session_Id | string | SessionId | string |
timestamp | datetime | TimeGenerated | datetime |
user_AccountId | string | UserAccountId | string |
user_AuthenticatedId | string | UserAuthenticatedId | string |
user_Id | string | UserId | string |
value | real | Value | real |
AppRequests
Tabla heredada: solicitudes
ApplicationInsights | Tipo | LogAnalytics | Tipo |
---|---|---|---|
appId | string | ResourceGUID | string |
application_Version | string | AppVersion | string |
appName | string | (se ha quitado) | |
client_Browser | string | ClientBrowser | string |
client_city | string | ClientCity | string |
client_CountryOrRegion | string | ClientCountryOrRegion | string |
client_IP | string | ClientIP | string |
client_Model | string | ClientModel | string |
client_OS | string | ClientOS | string |
client_StateOrProvince | string | ClientStateOrProvince | string |
client_Type | string | ClientType | string |
cloud_RoleInstance | string | AppRoleInstance | string |
cloud_RoleName | string | AppRoleName | string |
customDimensions | dinámico | Propiedades | Dinámica |
customMeasurements | dinámico | Medidas | Dinámica |
duration | real | DurationMs | Real |
id |
string | Id |
String |
iKey |
string | IKey |
string |
itemCount | int | ItemCount | int |
itemId | string | (se ha quitado) | |
itemType | string | Tipo | String |
name | string | Nombre | String |
operation_Id | string | OperationId | string |
operation_Name | string | OperationName | string |
operation_ParentId | string | ParentId | string |
operation_SyntheticSource | string | SyntheticSource | string |
performanceBucket | string | PerformanceBucket | String |
resultCode | string | ResultCode | String |
sdkVersion | string | SDKVersion | string |
session_Id | string | SessionId | string |
source | string | Source | String |
success | string | Correcto | Bool |
timestamp | datetime | TimeGenerated | datetime |
url | string | Url | String |
user_AccountId | string | UserAccountId | string |
user_AuthenticatedId | string | UserAuthenticatedId | string |
user_Id | string | UserId | string |
AppExceptions
Tabla heredada: excepciones
ApplicationInsights | Tipo | LogAnalytics | Tipo |
---|---|---|---|
appId | string | ResourceGUID | string |
application_Version | string | AppVersion | string |
appName | string | (se ha quitado) | |
ensamblado | string | Assembly | string |
client_Browser | string | ClientBrowser | string |
client_city | string | ClientCity | string |
client_CountryOrRegion | string | ClientCountryOrRegion | string |
client_IP | string | ClientIP | string |
client_Model | string | ClientModel | string |
client_OS | string | ClientOS | string |
client_StateOrProvince | string | ClientStateOrProvince | string |
client_Type | string | ClientType | string |
cloud_RoleInstance | string | AppRoleInstance | string |
cloud_RoleName | string | AppRoleName | string |
customDimensions | dinámico | Propiedades | dinámico |
customMeasurements | dinámico | Medidas | dinámico |
detalles | dinámico | Detalles | dinámico |
handledAt | string | HandledAt | string |
iKey |
string | IKey |
string |
innermostAssembly | string | InnermostAssembly | string |
innermostMessage | string | InnermostMessage | string |
innermostMethod | string | InnermostMethod | string |
innermostType | string | InnermostType | string |
itemCount | int | ItemCount | int |
itemId | string | (se ha quitado) | |
itemType | string | Tipo | string |
message | string | Message | string |
method | string | Método | string |
operation_Id | string | OperationId | string |
operation_Name | string | OperationName | string |
operation_ParentId | string | ParentId | string |
operation_SyntheticSource | string | SyntheticSource | string |
outerAssembly | string | OuterAssembly | string |
outerMessage | string | OuterMessage | string |
outerMethod | string | OuterMethod | string |
outerType | string | OuterType | string |
problemId | string | ProblemId | string |
sdkVersion | string | SDKVersion | string |
session_Id | string | SessionId | string |
severityLevel | int | SeverityLevel | int |
timestamp | datetime | TimeGenerated | datetime |
type | string | ExceptionType | string |
user_AccountId | string | UserAccountId | string |
user_AuthenticatedId | string | UserAuthenticatedId | string |
user_Id | string | UserId | string |
AppTraces
Tabla heredada: seguimientos
ApplicationInsights | Tipo | LogAnalytics | Tipo |
---|---|---|---|
appId | string | ResourceGUID | string |
application_Version | string | AppVersion | string |
appName | string | (se ha quitado) | |
client_Browser | string | ClientBrowser | string |
client_city | string | ClientCity | string |
client_CountryOrRegion | string | ClientCountryOrRegion | string |
client_IP | string | ClientIP | string |
client_Model | string | ClientModel | string |
client_OS | string | ClientOS | string |
client_StateOrProvince | string | ClientStateOrProvince | string |
client_Type | string | ClientType | string |
cloud_RoleInstance | string | AppRoleInstance | string |
cloud_RoleName | string | AppRoleName | string |
customDimensions | dinámico | Propiedades | dinámico |
customMeasurements | dinámico | Medidas | dinámico |
iKey |
string | IKey |
string |
itemCount | int | ItemCount | int |
itemId | string | (se ha quitado) | |
itemType | string | Tipo | string |
message | string | Message | string |
operation_Id | string | OperationId | string |
operation_Name | string | OperationName | string |
operation_ParentId | string | ParentId | string |
operation_SyntheticSource | string | SyntheticSource | string |
sdkVersion | string | SDKVersion | string |
session_Id | string | SessionId | string |
severityLevel | int | SeverityLevel | int |
timestamp | datetime | TimeGenerated | datetime |
user_AccountId | string | UserAccountId | string |
user_AuthenticatedId | string | UserAuthenticatedId | string |
user_Id | string | UserId | string |