Dela via

Anslutningssträngar i Application Insights

  • Artikel

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äng innehåller en ikey, som ä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.

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.

Funktioner 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.

Schema

Schemaelement förklaras i följande avsnitt.

Maximal 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

Dricks

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 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:t monterar resten av slutpunkten för enskilda 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)

Slutpunktsschema

<prefix>.<suffix>

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

Giltiga suffix

  • applicationinsights.azure.cn
  • applicationinsights.us

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

Giltiga prefix

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:
    • Intag: https://dc.ai.contoso.com
    • Live-mått: https://live.ai.contoso.com
    • Profilerare: https://profiler.ai.contoso.com
    • Avlusare: 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änst-URI:erna baseras på de explicita åsidosättningsvärdena:
    • Intag: https://custom.com:111/
    • Live-mått: https://custom.com:222/
    • Profilerare: https://custom.com:333/
    • Avlusare: 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äng regionen USA, södra centrala:

  • Auktoriseringsschemat är som standard "ikey"
  • Instrumentationsnyckel: 00000000-0000-0000-0000-000000000000
  • De regionala tjänst-URI:erna baseras på de explicita åsidosättningsvärdena:
    • Intag: 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äng:

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

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 Saknas Java-agent
JavaScript SDK-inläsningsskript för JavaScript (web) Saknas
Node.js Application Insights SDK AzMon OTel Distro
Python OpenCensus Python SDK AzMon OTel Distro

Vanliga frågor och svar

Det här avsnittet innehåller svar på vanliga frågor.

Kräver nya Azure-regioner användning av anslutningssträng?

Nya Azure-regioner kräver användning av anslutningssträng i stället för instrumentationsnycklar. Anslutningssträngen identifierar den resurs som du vill associera med dina telemetridata. Du kan också ändra de slutpunkter som din resurs använder som mål för telemetrin. Kopiera anslutningssträng och lägg till den i programmets kod eller i en miljövariabel.

Ska jag använda anslutningssträng eller instrumentationsnycklar?

Vi rekommenderar att du använder anslutningssträng i stället för instrumentationsnycklar.

Nästa steg

Kom igång under körningsfasen med:

Kom igång under utvecklingsfasen med: