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 klíč, což 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.

Pokud chcete chránit prostředek Application Insights před zneužitím, koncový bod příjmu dat poskytuje ověřené možnosti příjmu telemetrie na základě ID Microsoft Entra.

Poznámka:

Podpora příjmu dat založeného na instrumentačním klíči 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.

Vyhledání připojovacího řetězce

Vaše připojovací řetězec se zobrazí v části Přehled vašeho 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

Tip

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

Syntaxe

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

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

• EndpointSuffix (například applicationinsights.azure.cn). Nastavení přípony koncového bodu říká 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řepsat v připojovací řetězec:

  • 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 běžný název domény.

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

• Příjem telemetrie: dc
• Živé metriky: live
• Profiler: profiler
• Snímek: snapshot

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

Tady je několik příkladů připojovací řetězec.

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 koncové body služby sady SDK:

• 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:
  • Polknutí: https://dc.ai.contoso.com
  • Živé metriky: https://live.ai.contoso.com
  • Profiler: https://profiler.ai.contoso.com
  • Debugger: https://snapshot.ai.contoso.com

Připojovací řetězec s explicitními přepsáními 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í přepsání 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řepsání:
  • Polknutí: https://custom.com:111/
  • Živé metriky: https://custom.com:222/
  • Profiler: https://custom.com:333/
  • Debugger: https://custom.com:444/

Připojovací řetězec s explicitní oblastí

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řepsání:
  • Polknutí: 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

Nastavení 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
• Python v1.0.0

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	Klasické rozhraní API	OpenTelemetry
ASP.NET Core	Application Insights SDK	AzMon OTel Distro
.NET Framework	Application Insights SDK	AzMon Exportér
Java	–	Agent Java
JavaScript	Skript zavaděče sady JavaScript (Web) SDK	–
Node.js	Application Insights SDK	AzMon OTel Distro
Python	OpenCensus Python SDK	AzMon OTel Distro

Nejčastější dotazy

Tato část obsahuje odpovědi na běžné otázky.

Vyžadují nové oblasti Azure použití připojovací řetězec?

Nové oblasti Azure vyžadují použití připojovací řetězec místo instrumentačních klíčů. Připojovací řetězec identifikuje prostředek, který chcete přidružit k datům telemetrie. Umožňuje také upravit koncové body, které váš prostředek používá jako cíl pro vaši telemetrii. Zkopírujte připojovací řetězec a přidejte ho do kódu aplikace nebo do proměnné prostředí.

Mám používat připojovací řetězec nebo instrumentační klíče?

Místo instrumentačních klíčů doporučujeme používat připojovací řetězec.

Další kroky

Začínáme při spuštění:

• Aplikace hostované službou Azure Virtual Machine a Azure Virtual Machine Scale Sets služby IIS
• Server internetové informační služby (IIS)
• Funkce Web Apps služby Aplikace Azure

Začínáme při vývoji:

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