Dela via

Anslutningssträngar i Application Insights

Anslutningssträngar anger till vilken Application Insights-resurs ditt instrumenterade program ska skicka telemetridata. En anslutningssträng består av flera inställningar, var och en representeras som ett nyckel/värde-par och avgränsas med semikolon. Den här konsoliderade konfigurationsmetoden förenklar konfigurationsprocessen genom att eliminera behovet av flera proxyinställningar.

Viktigt!

Anslutningssträngen innehåller en ikey och ett ApplicationId.

Ikey är en unik identifierare som används av inmatningstjänsten för att associera telemetri till en specifik Application Insights-resurs. Unika Ikey-identifierare är inte säkerhetstoken eller säkerhetsnycklar och betraktas inte som hemligheter. Anslutningssträngar förbättras genom att applicationid-värdet läggs till. Den här uppdateringen är en ny funktion som stöder automatisk instrumentering för scenarier som använder Open Telemetry SDK. Om du vill skydda din Application Insights-resurs från missbruk tillhandahåller inmatningsslutpunkten autentiserade alternativ för inmatning av telemetri baserat på Microsoft Entra-ID.

Kommentar

Stödet för inmatning av instrumentationsnycklar upphör den 31 mars 2025. Inmatningen av instrumenteringsnyckeln fortsätter att fungera, men vi kommer inte längre att tillhandahålla uppdateringar eller stöd för funktionen. Övergå till anslutningssträng för att dra nytta av nya funktioner.

Kapaciteter för anslutningssträngar

  • Tillförlitlighet: Anslutningssträngar gör telemetriinmatningen mer tillförlitlig genom att ta bort beroenden på globala inmatningsslutpunkter.
  • Säkerhet: Anslutningssträngar tillåter autentiserad telemetriinmatning med hjälp av Microsoft Entra-autentisering för Application Insights.
  • Anpassade slutpunkter (nationella miljöer eller hybridmolnmiljöer): Slutpunktsinställningar tillåter att data skickas till en specifik Azure Government-region. (Se exempel.)
  • Sekretess (regionala slutpunkter): Anslutningssträngar underlättar sekretessproblem genom att skicka data till regionala slutpunkter, vilket säkerställer att data inte lämnar en geografisk region.

Hitta anslutningssträngen

Din anslutningssträng visas i avsnittet Översikt för application insights-resursen.

Skärmbild som visar Översikt över Application Insights och anslutningssträng.

Schemat

Schemaelement förklaras i följande avsnitt.

Max längd

Anslutningen har en maximal längd på 4 096 tecken som stöds.

Nyckel-värde-par

En anslutningssträng består av en lista med inställningar som representeras som nyckel/värde-par avgränsade med semikolon:key1=value1;key2=value2;key3=value3

Tips

Konfigurerbara nyckel/värde-par beskrivs i det här dokumentet. Vissa nyckel/värde-par kan inte konfigureras och anges automatiskt, till exempel ApplicationId. Dessa par kan ignoreras på ett säkert sätt om de observeras i din miljö.

Syntax

  • InstrumentationKey (till exempel 000000000-0000-0000-0000-0000000000000). InstrumentationKey är ett obligatoriskt fält.

  • Authorization (till exempel ikey). Den här inställningen är valfri eftersom vi i dag endast stöder ikey-auktorisering.

  • EndpointSuffix (till exempel applicationinsights.azure.cn). Om du anger slutpunktssuffixet talar det om för SDK vilket Azure-moln som ska anslutas till. SDK sätter samman resten av slutpunkten för individuella tjänster.

  • Explicita slutpunkter. Alla tjänster kan uttryckligen åsidosättas i anslutningssträng:

    • IngestionEndpoint (till exempel https://dc.applicationinsights.azure.com)
    • LiveEndpoint (till exempel https://live.applicationinsights.azure.com)
    • ProfilerEndpoint (till exempel https://profiler.monitor.azure.com)
    • SnapshotEndpoint (till exempel https://snapshot.monitor.azure.com)

Endpunktschema

<prefix>.<suffix>

  • Prefix: Definierar en tjänst.
  • Suffix: Definierar det gemensamma domännamnet.

Giltiga suffixer

  • applicationinsights.azure.cn
  • applicationinsights.us

Mer information finns i Regioner som kräver ändring av slutpunkt.

Giltiga prefixer

Exempel på anslutningssträngar

Här följer några exempel på anslutningssträng.

Anslutningssträng med ett slutpunktssuffix

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

I det här exemplet anger anslutningssträng slutpunktssuffixet och SDK:t skapar tjänstslutpunkter:

  • Auktoriseringsschemat är som standard "ikey"
  • Instrumentationsnyckel: 00000000-0000-0000-0000-000000000000
  • URI:er (Uniform Resource Identifiers) för regionala tjänster baseras på det angivna slutpunktssuffixet:
    • Intagning: https://dc.ai.contoso.com
    • Live-mätvärden: https://live.ai.contoso.com
    • Profilerare för .NET: https://profiler.ai.contoso.com
    • Felsökare: https://snapshot.ai.contoso.com

Anslutningssträng med explicita åsidosättningar av slutpunkter

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

I det här exemplet anger anslutningssträng explicita åsidosättningar för varje tjänst. SDK använder de exakta slutpunkter som tillhandahålls utan ändringar:

  • Auktoriseringsschemat är som standard "ikey"
  • Instrumentationsnyckel: 00000000-0000-0000-0000-000000000000
  • De regionala tjänsternas URI:er baseras på de explicita åsidosättningsvärdena:
    • Intagning: https://custom.com:111/
    • Live-mätvärden: https://custom.com:222/
    • Profilerare för .NET: https://custom.com:333/
    • Felsökare: https://custom.com:444/

Anslutningssträng med en explicit region

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

I det här exemplet anger anslutningssträngen regionen South Central USA.

  • Auktoriseringsschemat är som standard "ikey"
  • Instrumentationsnyckel: 00000000-0000-0000-0000-000000000000
  • De regionala tjänsternas URI:er baseras på de explicita åsidosättningsvärdena:
    • Intagning: https://southcentralus.in.applicationinsights.azure.com/

Om du vill visa en lista över tillgängliga regioner kör du följande kommando i Azure CLI:

az account list-locations -o table

Ange en anslutningssträng

Alla våra OpenTelemetry-erbjudanden och följande SDK-versioner och senare stöder anslutningssträngar.

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

Du kan ange en anslutningssträng i kod, med hjälp av en miljövariabel eller en konfigurationsfil.

Miljövariabel

Anslutningssträng: APPLICATIONINSIGHTS_CONNECTION_STRING

Kodexempel

Språk Klassiskt API OpenTelemetry
ASP.NET Core Application Insights SDK AzMon OTel Distro
.NET Framework Application Insights SDK AzMon-exportör
Java Ej tillämpligt Java-agent
JavaScript SDK-inläsningsskript för JavaScript (web) Ej tillämpligt
Node.js Application Insights SDK AzMon OTel Distro
python OpenCensus Python SDK AzMon OTel Distro

Nästa steg

Så här granskar du vanliga frågor och svar:

Kom igång vid körtid med:

Kom igång under utvecklingsfasen med: