Migración de claves de instrumentación de Application Insights a las cadenas de conexión

En esta guía se le guía a través de la migración de claves de instrumentación a cadenas de conexión.

Requisitos previos

Migración

Captura de pantalla que muestra la descripción general y la cadena de conexión de Application Insights.

  1. Vaya a la hoja de Información general del recurso de Application Insights.

  2. Busque la cadena de conexión que se muestra a la derecha.

  3. Mantenga el puntero sobre la cadena de conexión y seleccione el icono "Copiar al Portapapeles".

  4. Para configurar el SDK de Application Insights, siga los pasos que se indican en Cómo establecer una cadena de conexión.

Importante

No se recomienda el uso de una cadena de conexión y una clave de instrumentación. Lo que se estableció en último lugar tiene prioridad.

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 ARM muestra cómo puede incluir automáticamente la cadena de conexión correcta con una implementación de App Services (asegúrese 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 Azure AD 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 del 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

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

¿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 ARM 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 Azure AD con la instrumentación automática?

No se puede habilitar la autenticación de Azure AD 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 permite definir puntos de conexión específicos por región para la ingesta de datos, lo que garantiza que los datos permanecen 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 de Microsoft

Publique preguntas en el foro de respuestas.