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í, z nichž každé je reprezentováno 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é

Connection string obsahuje instrumentační klíč (ikey) a ID aplikace.

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 Ikey nejsou bezpečnostní tokeny ani bezpečnostní klíče a nejsou považovány za tajemství. Pokud chcete vylepšit připojovací řetězce, přidejte hodnotu 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 dat poskytuje ověřené možnosti příjmu telemetrie na základě Microsoft Entra ID.

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.
  • Security: Připojovací řetězce umožňují ověřený příjem telemetrie pomocí ověření pomocí Microsoft Entra pro Application Insights.
  • Kontomizované 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

Svoje připojovací řetězec najdete v části Overview prostředku Application Insights.

Screenshot, který zobrazuje přehled Application Insights a připojovací řetězec.

Schéma

Následující části popisují prvky schématu.

Maximální délka

Připojení podporuje až 4 096 znaků.

Páry klíč-hodnota

Connection string 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

Tento dokument popisuje konfigurovatelné páry klíč-hodnota. Některé páry klíč-hodnota se nedají konfigurovat a nastaví se automaticky, například ApplicationId. Tyto páry můžete bezpečně ignorovat, pokud je uvidíte ve svém prostředí.

Syntaxe

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

  • Authorization (například ikey). Toto nastavení je volitelné, protože v současné době sada SDK podporuje pouze autorizaci ikey.

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

  • Explicitní koncové body Jakoukoli službu můžete 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 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

příklady řetězce připojení

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

Connection string s příponou koncového bodu na konci

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

V tomto příkladu řetězec připojení definuje příponu koncového bodu a sada SDK sestavuje 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
    • Ladicí program: https://snapshot.ai.contoso.com

Connection string 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řetížení:
    • Požití: https://custom.com:111/
    • Živé metriky: https://custom.com:222/
    • Profiler pro .NET: https://custom.com:333/
    • Ladicí program: 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 CLI0 následující příkaz:

az account list-locations -o table

Nastavte připojovací řetězec

Další informace o nastavení připojovacího řetězce najdete v tématu Konfigurace OpenTelemetry a ověřování Microsoft Entra pro Application Insights.

Ověřená telemetrie prohlížeče pomocí připojovacích řetězců

Když organizace vypnou místní ověřování v Application Insights, aby vynutily použití Microsoft Entra ID, JavaScript SDK se nemůže přímo ověřovat pro telemetrii probíhající v prohlížeči, což může způsobit zastavení toku telemetrie.

Praktickým vzorem je směrování telemetrie prohlížeče přes Azure API Management (APIM), které:

  • Ověřuje se ve službě Application Insights pomocí spravované identity.
  • Přesměruje požadavky na koncový bod pro příjem dat v jednotlivých oblastech vaším jménem.

S tímto nastavením vaše připojovací řetězec nadále identifikuje cílový prostředek Application Insights, ale IngestionEndpoint odkazuje na URL proxy serveru APIM.

K získání podrobných pokynů, včetně zásad CORS a APIM, se podívejte na: Použití služby Azure API Management jako proxy pro telemetrii Application Insights.

Další kroky

Pokud chcete zkontrolovat nejčastější dotazy, přečtěte si:

Začínáme s:

  • Last updated on