Cadeias de conexão no Application Insights

As cadeias de conexão especificam para qual recurso do Application Insights seu aplicativo instrumentado deve enviar dados de telemetria. Uma cadeia de conexão é composta por várias configurações, cada uma representada como um par chave-valor e separada por ponto-e-vírgula. Esse método de configuração consolidado simplifica o processo de instalação, eliminando a necessidade de várias configurações de proxy.

Importante

A cadeia de conexão contém um ikey e um ApplicationId.

O ikey é um identificador exclusivo usado pelo serviço de ingestão para associar telemetria a um recurso específico do Application Insights. Os identificadores exclusivos do Ikey não são tokens de segurança ou chaves de segurança e não são considerados segredos. As cadeias de conexão são aprimoradas adicionando o valor ApplicationId. Esta atualização é um novo recurso que oferece suporte à instrumentação automática para cenários que utilizam o SDK de Telemetria Aberta. Se quiser proteger o seu recurso do Application Insights contra uso indevido, o ponto de extremidade de ingestão fornece opções de ingestão de telemetria autenticada baseado no ID do Microsoft Entra.

Nota

A partir de 31 de março de 2025, o suporte para a ingestão de chaves de instrumentação terminará. A ingestão de chaves de instrumentação continuará a funcionar, mas não forneceremos mais atualizações ou suporte para o recurso. Transição para cadeias de conexão para aproveitar as novas capacidades.

Capacidades da cadeia de conexão

• Confiabilidade: as cadeias de conexão tornam a ingestão de telemetria mais confiável, removendo dependências em pontos de extremidade de ingestão global.
• Segurança: as cadeias de conexão permitem a ingestão de telemetria autenticada usando a autenticação do Microsoft Entra para Application Insights.
• Pontos de extremidade personalizados (ambientes de nuvem soberana ou híbrida): as configurações de ponto de extremidade permitem enviar dados para uma região específica do Azure Government. (Ver exemplos.)
• Privacidade (pontos de extremidade regionais): as cadeias de conexão facilitam as preocupações de privacidade enviando dados para pontos de extremidade regionais, garantindo que os dados não saiam de uma região geográfica.

Encontre a sua string de conexão

Sua cadeia de conexão aparece na seção Visão geral do recurso do Application Insights.

Esquema

Os elementos do esquema são explicados nas seções a seguir.

Comprimento máximo

A conexão tem um comprimento máximo suportado de 4.096 caracteres.

Pares chave-valor

Uma cadeia de conexão consiste em uma lista de configurações representadas como pares chave-valor separados por ponto-e-vírgula: key1=value1;key2=value2;key3=value3

Sugestão

Os pares chave-valor configuráveis são abordados neste documento. Alguns pares chave-valor não são configuráveis e são definidos automaticamente, como ApplicationId. Esses pares podem ser ignorados sem preocupação se forem observados no seu ambiente.

Sintaxe

• InstrumentationKey (por exemplo, 00000000-0000-0000-0000-00000000000000). InstrumentationKey é um campo obrigatório .

• Authorization (por exemplo, ikey). Essa configuração é opcional porque hoje só suportamos a autorização do ikey.

• EndpointSuffix (por exemplo, applicationinsights.azure.cn). Definir o sufixo do endpoint informa ao SDK a que nuvem Azure se deve conectar. O SDK monta o restante do endpoint para serviços individuais.

• Pontos de extremidade explícitos. Qualquer serviço pode ser explicitamente substituído na cadeia de conexão:

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

Esquema de Endpoint

<prefix>.<suffix>

• Prefixo: define um serviço.
• Sufixo: Define o nome de domínio comum.

Sufixos válidos

• applicationinsights.azure.cn
• applicationinsights.us

Para obter mais informações, consulte Regiões que exigem modificação de ponto de extremidade.

Prefixos válidos

• Ingestão de telemetria: dc
• Métricas em tempo real: live
• Profiler para .NET:profiler
• Instantâneo: snapshot

Exemplos de cadeia de conexão

Aqui estão alguns exemplos de cadeias de conexão.

Cadeia de conexão com sufixo de ponto de extremidade

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

Neste exemplo, a cadeia de conexão especifica o sufixo de ponto de extremidade e o SDK constrói pontos de extremidade de serviço:

• O padrão do esquema de autorização é "ikey"
• Chave de instrumentação: 00000000-0000-0000-0000-0000000000000
• Os Identificadores de Recursos Uniformes (URIs) do serviço regional baseiam-se no sufixo de endpoint fornecido:
  • Ingestão: https://dc.ai.contoso.com
  • Métricas em tempo real: https://live.ai.contoso.com
  • Profiler para .NET: https://profiler.ai.contoso.com
  • Depurador: https://snapshot.ai.contoso.com

Cadeia de conexão com substituições explícitas de ponto de extremidade

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/;

Neste exemplo, a cadeia de conexão especifica substituições explícitas para cada serviço. O SDK usa os pontos de extremidade exatos fornecidos sem modificação:

• O padrão do esquema de autorização é "ikey"
• Chave de instrumentação: 00000000-0000-0000-0000-0000000000000
• Os URIs de serviço regional são baseados nos valores de sobreposição explícitos.
  • Ingestão: https://custom.com:111/
  • Métricas em tempo real: https://custom.com:222/
  • Profiler para .NET: https://custom.com:333/
  • Depurador: https://custom.com:444/

Cadeia de conexão com uma região explícita

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

Neste exemplo, a cadeia de conexão especifica a região Centro-Sul dos EUA:

• O padrão do esquema de autorização é "ikey"
• Chave de instrumentação: 00000000-0000-0000-0000-0000000000000
• Os URIs de serviço regional são baseados nos valores de sobreposição explícitos.
  • Ingestão: https://southcentralus.in.applicationinsights.azure.com/

Para listar regiões disponíveis, execute o seguinte comando na CLI do Azure:

az account list-locations -o table

Definir uma cadeia de conexão

Todas as nossas ofertas OpenTelemetry e as seguintes versões do SDK em diante suportam cadeias de conexão:

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

Você pode definir uma cadeia de conexão no código, usando uma variável de ambiente ou um arquivo de configuração.

Variável de ambiente

Cadeia de conexão: APPLICATIONINSIGHTS_CONNECTION_STRING

Amostras de código

Idioma	API clássica	OpenTelemetria
ASP.NET Núcleo	Application Insights SDK	AzMon OTel Distro
.NET Framework	Application Insights SDK	AzMon Exportador
Java	N/A	Agente Java
Javascript	JavaScript (Web) SDK Loader Script	N/A
Node.js	Application Insights SDK	AzMon OTel Distro
Píton	OpenCensus Python SDK	AzMon OTel Distro

Próximos passos

Para rever as perguntas frequentes (FAQ):

• Perguntas frequentes sobre cadeias de conexão no Application Insights

Comece no tempo de execução com:

• Máquina Virtual do Azure (VM) e Dimensionamento de Máquina Virtual do Azure Define aplicativos hospedados no IIS
• Servidor do Internet Information Server (IIS)
• Recurso Aplicações Web do Serviço de Aplicações do Azure

Comece no momento de desenvolvimento com:

• ASP.NET Núcleo
• ASP.NET
• Java
• Node.js
• Píton