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.

Recursos de 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.

Encontrar a sua cadeia de ligaçã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

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). A configuração do sufixo de ponto de extremidade informa ao SDK a qual nuvem do Azure se conectar. O SDK monta o restante do ponto de extremidade 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 ponto de extremidade

<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 ao vivo: live
• Criador de perfil: 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 um 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 URIs (Uniform Resource Identifiers) do serviço regional baseiam-se no sufixo de ponto de extremidade fornecido:
  • Ingestão: https://dc.ai.contoso.com
  • Métricas ao vivo: https://live.ai.contoso.com
  • Criador de perfil: 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 substituição explícitos:
  • Ingestão: https://custom.com:111/
  • Métricas ao vivo: https://custom.com:222/
  • Criador de perfil: 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 substituiçã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

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

Perguntas mais frequentes

Esta secção fornece respostas a perguntas comuns.

As novas regiões do Azure exigem o uso de cadeias de conexão?

As novas regiões do Azure exigem o uso de cadeias de conexão em vez de chaves de instrumentação. A cadeia de conexão identifica o recurso que você deseja associar aos seus dados de telemetria. Ele também permite que você modifique os pontos de extremidade que seu recurso usa como destino para sua telemetria. Copie a cadeia de conexão e adicione-a ao código do seu aplicativo ou a uma variável de ambiente.

Devo usar cadeias de conexão ou teclas de instrumentação?

Recomendamos que você use cadeias de conexão em vez de teclas de instrumentação.

Próximos passos

Introdução ao 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 Aplicativos Web do Serviço de Aplicativo do Azure

Introdução no momento de programação com:

• ASP.NET Core
• ASP.NET
• Java
• Node.js
• Python