Partilhar via

Cadeias de conexão no Application Insights

  • Artigo

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, que é 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.

Se você quiser proteger seu recurso do Application Insights contra uso indevido, o ponto de extremidade de ingestão fornece opções de ingestão de telemetria autenticada com base na ID do Microsoft Entra.

Nota

A 31 de março de 2025, o suporte da 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 os novos recursos.

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.

Captura de tela que mostra a visão geral do Application Insights e a cadeia de conexão.

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

Gorjeta

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. Eles podem ser ignorados com segurança se forem observados em 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). 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

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
    • 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 substituição explícitos:
    • Ingestão: https://custom.com:111/
    • Métricas ao vivo: 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 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

Idioma API clássica OpenTelemetry
ASP.NET Core Application Insights SDK AzMon OTel Distro
.NET Framework Application Insights SDK AzMon Exportador
Java N/D Agente Java
JavaScript JavaScript (Web) SDK Loader Script N/D
Node.js Application Insights SDK AzMon OTel Distro
Python OpenCensus Python SDK AzMon OTel Distro

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:

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