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.

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.

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

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

• Telemetriinmatning: dc
• Live-mått: live
• Profilerare: profiler
• Ögonblicksbild: snapshot

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

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:

• Azure Virtual Machine (VM) och Azure Virtual Machine Scale Sets IIS-värdbaserade appar
• IIS-server (Internet Information Server)
• Funktionen Web Apps i Azure App Service

Kom igång under utvecklingsfasen med:

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