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

Application Insights cambia de los puntos de conexión de ingesta globales a los puntos de conexión regionales que usan cadenas de conexión, que proporcionan funcionalidades adicionales.

Escenarios más afectados por este cambio:

• Excepciones de firewall o redireccionamientos de proxy : en los casos en los que se requiere la supervisión del servidor web de intranet, nuestra solución anterior le pidió que agregara puntos de conexión de servicio individuales a la configuración. Para obtener más información, consulte ¿Puedo supervisar un servidor web de una intranet?. Las cadenas de conexión ofrecen una mejor alternativa, ya que reducen esta labor a una única configuración. Una modificación sencilla de prefijos y sufijos permite el llenado y la redirección automáticos de todos los puntos de conexión hacia los servicios apropiados.

• Entornos de nube soberana o híbrida : los usuarios pueden enviar datos a una región definida de Azure Government. El uso de las cadenas de conexión permite definir la configuración de los puntos de conexión para los servidores de la intranet o la configuración de la nube híbrida.

En este artículo se explica cómo migrar de claves de instrumentación a cadenas de conexión.

Prerrequisitos

Migración

1. Vaya al panel de Información general del recurso de Application Insights.

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

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

4. Configure el SDK de Application Insights siguiendo cómo establecer cadenas de conexión.

Migración a escala

Utiliza variables de entorno para pasar una cadena de conexión al SDK o al agente 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úrese de incluir cualquier otra configuración de 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')]"
            }
        }
    ]
}

Versiones de SDK compatibles

• .NET y .NET Core v2.12.0+
• Java v2.5.1 y Java 3.0+
• JavaScript v2.3.0+
• NodeJS v1.5.0+
• Python v1.0.0+

Solución de problemas

En esta sección se proporcionan soluciones de solución de problemas.

Alerta: "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 del SDK compatible. Si usa la integración de Application Insights en otra oferta de producto 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 clave de instrumentación debe eliminarse de tu configuración.
• Confirme que la cadena de conexión es exactamente la que se proporciona en Azure Portal.

Las variables de entorno no funcionan

Si codifica de forma rígida una clave de instrumentación en el código de la aplicación, esa programación podría tener prioridad antes de las variables de entorno.

Preguntas más frecuentes

En esta sección se proporcionan 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 su recurso de Application Insights, en el campo denominado ConnectionString.

¿Cómo afecta esto a la autoinstrumentación?

Los escenarios de autoinstrumentación no se ven afectados.

¿Puedo usar la autenticación de Microsoft Entra con la autoinstrumentación?

No se puede habilitar la autenticación de Microsoft Entra para escenarios de autoinstrumentación . Tenemos planes para 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 estos datos. La ingesta regional permite definir puntos de conexión específicos por región para la 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 acerca de Microsoft

Publique preguntas en el foro de respuestas.