Migración de claves de instrumentación de Application Insights a las cadenas de conexión
En este artículo se le guía por la migración de claves de instrumentación a cadenas de conexión.
Requisitos previos
Migración
Vaya al panel de Información general del recurso de Application Insights.
Busque la cadena de conexión que se muestra a la derecha.
Mantenga el puntero sobre la cadena de conexión y seleccione el icono Copiar al Portapapeles.
Para configurar el SDK de Application Insights, siga los pasos que se indican en Cómo establecer una cadena de conexión.
Importante
No use una cadena de conexión ni una clave de instrumentación. Este último conjunto sustituye al otro y podría dar lugar a que la telemetría no aparezca en el portal. Consulte los datos que faltan.
Migración a escala
Puede usar variables de entorno para pasar fácilmente una cadena de conexión al agente o al SDK de Application Insights.
Para establecer una cadena de conexión a través de una variable de entorno, coloque el valor de la cadena de conexión en una variable de entorno denominada APPLICATIONINSIGHTS_CONNECTION_STRING.
Este proceso se puede automatizar en las implementaciones de Azure. Por ejemplo, la siguiente plantilla de Azure Resource Manager muestra cómo puede incluir automáticamente la cadena de conexión correcta con una implementación de Azure App Service. Asegúrate de incluir cualquier otra configuración de la aplicación que requiera la aplicación:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"appServiceName": {
"type": "string",
"metadata": {
"description": "Name of the App Services resource"
}
},
"appServiceLocation": {
"type": "string",
"metadata": {
"description": "Location to deploy the App Services resource"
}
},
"appInsightsName": {
"type": "string",
"metadata": {
"description": "Name of the existing Application Insights resource to use with this App Service. Expected to be in the same Resource Group."
}
}
},
"resources": [
{
"apiVersion": "2016-03-01",
"name": "[parameters('appServiceName')]",
"type": "microsoft.web/sites",
"location": "[parameters('appServiceLocation')]",
"properties": {
"siteConfig": {
"appSettings": [
{
"name": "APPLICATIONINSIGHTS_CONNECTION_STRING",
"value": "[reference(concat('microsoft.insights/components/', parameters('appInsightsName')), '2015-05-01').ConnectionString]"
}
]
},
"name": "[parameters('appServiceName')]"
}
}
]
}
Funcionalidades nuevas
Las cadenas de conexión proporcionan una única configuración y eliminan la necesidad de varias opciones de proxy.
- Fiabilidad: las cadenas de conexión hacen que la ingesta de telemetría sea más confiable mediante la eliminación de dependencias en los puntos de conexión de ingesta globales.
- Seguridad: las cadenas de conexión permiten la ingesta de telemetría autenticada mediante la autenticación de Microsoft Entra para Application Insights.
- Puntos de conexión personalizados (entornos de nube soberana o híbrida): la configuración del punto de conexión permite enviar datos a una región específica de Azure Government. (Ver ejemplos.)
- Privacidad (puntos de conexión regionales): las cadenas de conexión facilitan los problemas de privacidad mediante el envío de datos a puntos de conexión regionales, lo que garantiza que los datos no salen de una región geográfica.
Versiones de SDK compatibles
- .NET y .NET Core v2.12.0 y posteriores
- Java v2.5.1 y Java 3.0 y posteriores
- JavaScript v2.3.0 y posteriores
- NodeJS v1.5.0 y posteriores
- Python v1.0.0 y posteriores
Solución de problemas
En esta sección se proporcionan soluciones de solución de problemas.
Alerta de transición al uso de cadenas de conexión para la ingesta de datos
Siga los pasos de migración de este artículo para resolver esta alerta.
Datos que faltan
- Confirme que usa una versión compatible del SDK. Si usa la integración de Application Insights en otra oferta de productos de Azure, consulte su documentación sobre cómo configurar correctamente una cadena de conexión.
- Confirme que no está estableciendo una clave de instrumentación y una cadena de conexión al mismo tiempo. La configuración de la clave de instrumentación debe quitarse de la configuración.
- Confirme que la cadena de conexión es exactamente como se proporciona en Azure Portal.
Las variables de entorno no funcionan
Si codifica una clave de instrumentación en el código de la aplicación, esa programación puede tener prioridad ante las variables de entorno.
Preguntas más frecuentes
Esta sección proporciona respuestas a preguntas comunes.
¿Dónde más puedo encontrar mi cadena de conexión?
La cadena de conexión también se incluye en las propiedades del recurso de Resource Manager para el recurso de Application Insights bajo el nombre de campo ConnectionString.
¿Cómo afecta esto a la instrumentación automática?
Los escenarios de instrumentación automática no se verán afectados.
¿Puedo usar la autenticación de Microsoft Entra con la instrumentación automática?
No se puede habilitar la autenticación de Microsoft Entra para escenarios de instrumentación automática. Tenemos previsto abordar esta limitación en el futuro.
¿Cuál es la diferencia entre la ingesta global y regional?
La ingesta global envía todos los datos de telemetría a un único punto de conexión, independientemente de dónde se almacenen los datos. La ingesta regional le permite definir puntos de conexión específicos según la región de ingesta de datos. Esta funcionalidad garantiza que los datos permanezcan dentro de una región específica durante el procesamiento y el almacenamiento.
¿Cómo afectan las cadenas de conexión a la facturación?
La facturación no se ve afectada.
Preguntas y respuestas (Q&A) de Microsoft
Publique preguntas en el foro de respuestas.