Připojovací řetězce v Application Insights

Připojovací řetězce určují, do kterého prostředku Application Insights má instrumentovaná aplikace odesílat telemetrická data. Připojovací řetězec se skládá z více nastavení, přičemž každý z nich je reprezentovaný jako pár klíč-hodnota a oddělený středníky. Tato konsolidovaná metoda konfigurace zjednodušuje proces nastavení tím, že eliminuje potřebu více nastavení proxy serveru.

Důležité

Připojovací řetězec obsahuje instrumentační klíč (ikey) a ApplicationId.

Ikey je jedinečný identifikátor používaný službou příjmu dat k přidružení telemetrie ke konkrétnímu prostředku Application Insights. Jedinečné identifikátory klíče nejsou tokeny zabezpečení ani klíče zabezpečení a nejsou považovány za tajné kódy. Připojovací řetězce se vylepšují přidáním hodnoty ApplicationId. Tato aktualizace je nová funkce, která podporuje automatickou instrumentaci pro scénáře využívající sadu Open Telemetry SDK. Pokud chcete chránit prostředek Application Insights před zneužitím, koncový bod příjmu poskytuje ověřené možnosti příjmu telemetrie založené na Microsoft Entra ID.

Poznámka:

Podpora příjmu instrumentačních klíčů skončí 31. března 2025. Příjem klíčů instrumentace bude dál fungovat, ale už nebudeme poskytovat aktualizace ani podporu pro tuto funkci. Přechod na připojovací řetězec, abyste mohli využívat nové funkce.

Možnosti připojovacího řetězce

• Spolehlivost: Připojovací řetězce usnadňují příjem telemetrie odebráním závislostí na globálních koncových bodech příjmu dat.
• Zabezpečení: Připojovací řetězce umožňují ingestování ověřené telemetrie pomocí ověřování Microsoft Entra pro Application Insights.
• Přizpůsobené koncové body (suverénní nebo hybridní cloudová prostředí):: Nastavení koncového bodu umožňují odesílat data do konkrétní oblasti Azure Government. (Viz příklady.)
• Ochrana osobních údajů (regionální koncové body):: Připojovací řetězce usnadňují ochranu osobních údajů odesláním dat do regionálních koncových bodů a zajištěním, že data neopustí geografickou oblast.

Najděte svůj připojovací řetězec

Váš připojovací řetězec se zobrazí v sekci Přehled prostředku Application Insights.

Schéma

Prvky schématu jsou vysvětleny v následujících částech.

Maximální délka

Připojení má maximální podporovanou délku 4 096 znaků.

Páry klíč-hodnota

Připojovací řetězec se skládá ze seznamu nastavení reprezentovaných jako páry klíč-hodnota oddělené středníkem:key1=value1;key2=value2;key3=value3

Návod

Konfigurovatelné páry klíč-hodnota jsou popsány v tomto dokumentu. Některé páry klíč-hodnota se nedají konfigurovat a nastaví se automaticky, například ApplicationId. Tyto páry je možné bezpečně ignorovat, pokud jsou ve vašem prostředí pozorovány.

Syntaxe

• InstrumentationKey (například 000000000-0000-0000-0000-00000000000000). InstrumentationKey je povinné pole.

• Authorization (například ikey). Toto nastavení je volitelné, protože dnes podporujeme pouze autorizaci ikey.

• EndpointSuffix (například applicationinsights.azure.cn). Nastavení koncové přípony určuje sadě SDK, ke kterému cloudu Azure se má připojit. Sada SDK sestaví zbytek koncového bodu pro jednotlivé služby.

• Explicitní koncové body Libovolnou službu je možné explicitně překonfigurovat v připojovacím řetězci.

  • IngestionEndpoint (například https://dc.applicationinsights.azure.com)
  • LiveEndpoint (například https://live.applicationinsights.azure.com)
  • ProfilerEndpoint (například https://profiler.monitor.azure.com)
  • SnapshotEndpoint (například https://snapshot.monitor.azure.com)

Schéma koncového bodu

<prefix>.<suffix>

• Předpona: Definuje službu.
• Přípona: Definuje společný doménový název.

Platné přípony

• applicationinsights.azure.cn
• applicationinsights.us

Další informace najdete v tématu Oblasti, které vyžadují úpravy koncového bodu.

Platné předpony

• Ingestace telemetrie: dc
• Živé metriky: live
• Profiler pro .NET: profiler
• Snímek: snapshot

Příklady připojovacích řetězců

Zde jsou některé příklady připojovacích řetězců.

Připojovací řetězec s příponou koncového bodu

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

V tomto příkladu připojovací řetězec určuje příponu koncového bodu a SDK konstruuje koncové body služby.

• Výchozí schéma autorizace je "ikey".
• Instrumentační klíč: 00000000-0000-0000-0000-0000000000000
• Identifikátory URI (Regional Service Uniform Resource Identifier) jsou založené na zadané příponě koncového bodu:
  • Požití: https://dc.ai.contoso.com
  • Živé metriky: https://live.ai.contoso.com
  • Profiler pro .NET: https://profiler.ai.contoso.com
  • Debugger: https://snapshot.ai.contoso.com

Připojovací řetězec s explicitními úpravami koncových bodů

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

V tomto příkladu připojovací řetězec určuje explicitní nastavení pro každou službu. Sada SDK používá přesné koncové body poskytnuté beze změny:

• Výchozí schéma autorizace je "ikey".
• Instrumentační klíč: 00000000-0000-0000-0000-0000000000000
• Identifikátory URI regionální služby jsou založené na explicitních hodnotách přetížení:
  • Požití: https://custom.com:111/
  • Živé metriky: https://custom.com:222/
  • Profiler pro .NET: https://custom.com:333/
  • Debugger: https://custom.com:444/

Připojovací řetězec s explicitním regionem

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

V tomto příkladu připojovací řetězec určuje oblast USA – středojiž:

• Výchozí schéma autorizace je "ikey".
• Instrumentační klíč: 00000000-0000-0000-0000-0000000000000
• Identifikátory URI regionální služby jsou založené na explicitních hodnotách přetížení:
  • Požití: https://southcentralus.in.applicationinsights.azure.com/

Pokud chcete zobrazit seznam dostupných oblastí, spusťte v Azure CLI následující příkaz:

az account list-locations -o table

Nastavte připojovací řetězec

Všechny naše nabídky OpenTelemetry a následující verze sady SDK podporují připojovací řetězec:

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

V kódu můžete nastavit připojovací řetězec pomocí proměnné prostředí nebo konfiguračního souboru.

Proměnná prostředí

Připojovací řetězec: APPLICATIONINSIGHTS_CONNECTION_STRING

Ukázky kódu

Jazyk	Classic API	OpenTelemetry
ASP.NET Core	Application Insights SDK	AzMon OTel Distro
.NET Framework	Application Insights SDK	AzMon Exportér
Java	Není k dispozici	Java Agent
JavaScript	Skript zavaděče sady JavaScript (Web) SDK	Není k dispozici
Node.js	Application Insights SDK	AzMon OTel Distro
Python	Sada OpenCensus Python SDK byla vyřazena.	AzMon OTel Distro

Další kroky

Pokud chcete zkontrolovat nejčastější dotazy:

• Nejčastější dotazy k připojovacím řetězcům v Application Insights

Začněte během běhu programu:

• Aplikace hostované na Azure Virtual Machine (VM) a Azure Virtual Machine Scale Sets v prostředí IIS
• Server internetové informační služby (IIS)
• Funkce Web Apps služby Aplikace Azure

Začněte při vývoji s:

• .NET
• Java
• Node.js