Cadenas de conexión en Application Insights

Las cadenas de conexión especifican en qué recurso de Application Insights la aplicación instrumentada debe enviar datos de telemetría. Una cadena de conexión se compone de varias configuraciones, cada una representada como un par clave-valor y separadas por punto y coma. Este método de configuración consolidado simplifica el proceso de configuración eliminando la necesidad de varias opciones de proxy.

Funcionalidades de cadena de conexión

• Confiabilidad: 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.

Encuentra tu cadena de conexión

La cadena de conexión aparece en la sección de información general del recurso de Application Insights.

Esquema

Los elementos de esquema se explican en las siguientes secciones.

Longitud máxima

La conexión tiene una longitud máxima admitida de 4,096 caracteres.

Pares de clave-valor

Una cadena de conexión consta de una lista de valores de configuración representados como pares de clave-valor separados por punto y coma: key1=value1;key2=value2;key3=value3

Sintaxis

• InstrumentationKey (por ejemplo, 00000000-0000-0000-0000-000000000000). InstrumentationKey es un campo obligatorio.

• Authorization (por ejemplo, ikey). Este valor es opcional porque actualmente solo se admite la autorización mediante ikey.

• EndpointSuffix (por ejemplo, applicationinsights.azure.cn). Al establecer el sufijo del punto de conexión, se indicará al SDK a qué nube de Azure se conectará. El SDK ensambla el resto del punto de conexión para los servicios individuales.

• Puntos de conexión explícitos. Cualquier servicio se puede invalidar explícitamente en la cadena de conexión:

  • IngestionEndpoint (por ejemplo, https://dc.applicationinsights.azure.com)
  • LiveEndpoint (por ejemplo, https://live.applicationinsights.azure.com)
  • ProfilerEndpoint (por ejemplo, https://profiler.monitor.azure.com)
  • SnapshotEndpoint (por ejemplo, https://snapshot.monitor.azure.com)

Esquema del punto de conexión

<prefix>.<suffix>

• Prefijo: define un servicio.
• Sufijo: define el nombre de dominio común.

Sufijos válidos

• applicationinsights.azure.cn
• applicationinsights.us

Para obtener más información, consulte Regiones que requieren modificación del punto de conexión.

Prefijos válidos

• Ingesta de telemetría: dc
• Live Metrics: live
• Generador de perfiles para .NET: profiler
• Instantánea: snapshot

Ejemplos de cadena de conexión

A continuación, se incluyen algunos ejemplos de cadenas de conexión.

Cadena de conexión con sufijo de punto de conexión

InstrumentationKey=00000000-0000-0000-0000-000000000000;EndpointSuffix=ai.contoso.com;

En este ejemplo, la cadena de conexión especifica el sufijo del punto final y el SDK construye los puntos finales del servicio:

• El esquema de autorización tiene como valor predeterminado "ikey".
• Clave de instrumentación: 00000000-0000-0000-0000-000000000000
• Los identificadores uniformes de recursos (URI) del servicio regional se basan en el sufijo de punto de conexión proporcionado:
  • Ingesta: https://dc.ai.contoso.com
  • Métricas en directo: https://live.ai.contoso.com
  • Generador de perfiles para .NET: https://profiler.ai.contoso.com
  • Depurador: https://snapshot.ai.contoso.com

Cadena de conexión con invalidaciones explícitas del punto de conexión

InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://custom.com:111/;LiveEndpoint=https://custom.com:222/;ProfilerEndpoint=https://custom.com:333/;SnapshotEndpoint=https://custom.com:444/;

En este ejemplo, la cadena de conexión especifica anulaciones explícitas para cada servicio. El SDK usará los puntos de conexión exactos proporcionados sin modificaciones:

• El esquema de autorización tiene como valor predeterminado "ikey".
• Clave de instrumentación: 00000000-0000-0000-0000-000000000000
• Los identificadores URI de servicio regional se basan en los valores de invalidación explícitos:
  • Ingesta: https://custom.com:111/
  • Métricas en directo: https://custom.com:222/
  • Generador de perfiles para .NET: https://custom.com:333/
  • Depurador: https://custom.com:444/

Cadena de conexión con una región explícita

InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://southcentralus.in.applicationinsights.azure.com/

En este ejemplo, la cadena de conexión especifica la región Centro y Sur de EE. UU:

• El esquema de autorización tiene como valor predeterminado "ikey".
• Clave de instrumentación: 00000000-0000-0000-0000-000000000000
• Los identificadores URI de servicio regional se basan en los valores de invalidación explícitos:
  • Ingesta: https://southcentralus.in.applicationinsights.azure.com/

Para enumerar las regiones disponibles, ejecute el siguiente comando en la CLI de Azure:

az account list-locations -o table

Establezca una cadena de conexión

Todas nuestras ofertas de OpenTelemetry y las siguientes versiones del SDK admiten cadenas de conexión:

• .NET v2.12.0
• JavaScript v2.3.0
• NodeJS v1.5.0
• Python v1.0.0
• Java v3.1.1

Puede establecer una cadena de conexión en el código o mediante una variable de entorno o un archivo de configuración.

Variable del entorno

Cadena de conexión: APPLICATIONINSIGHTS_CONNECTION_STRING

Ejemplos de código

Pasos siguientes

Para revisar las preguntas frecuentes (FAQ):

• Preguntas más frecuentes sobre las cadenas de conexión en Application Insights

Comience en el tiempo de ejecución con:

• Máquinas virtuales (VM) y aplicaciones hospedadas en IIS de Azure Virtual Machine Scale Sets
• Servidor de Internet Information Server (IIS)
• La característica de Web Apps en Azure App Service

Comience en el tiempo de desarrollo con:

• ASP.NET Core
• ASP.NET
• Java
• Node.js
• Pitón