Delen via

Verbindingsreeksen in Application Insights

  • Artikel

Verbindingsreeksen geven op aan welke Application Insights-resource uw geïnstrueerde toepassing telemetriegegevens moet verzenden. Een verbindingsreeks bestaat uit meerdere instellingen, die elk worden weergegeven als een sleutel-waardepaar en gescheiden door puntkomma's. Deze geconsolideerde configuratiemethode vereenvoudigt het installatieproces door de noodzaak van meerdere proxy-instellingen te elimineren.

Belangrijk

De verbindingsreeks bevat een ikey, een unieke id die wordt gebruikt door de opnameservice om telemetrie te koppelen aan een specifieke Application Insights-resource. Unieke id's van Ikey zijn geen beveiligingstokens of beveiligingssleutels en worden niet beschouwd als geheimen.

Als u uw Application Insights-resource wilt beschermen tegen misbruik, biedt het opname-eindpunt geverifieerde telemetrieopnameopties op basis van Microsoft Entra-id.

Notitie

Op 31 maart 2025 eindigt de ondersteuning voor opname van instrumentatiesleutels. Opname van instrumentatiesleutels blijft werken, maar we bieden geen updates of ondersteuning meer voor de functie. Overgang naar verbindingsreeks s om te profiteren van nieuwe mogelijkheden.

Mogelijkheden voor verbindingsreeksen

  • Betrouwbaarheid: verbindingsreeksen maken telemetrieopname betrouwbaarder door afhankelijkheden van globale opname-eindpunten te verwijderen.
  • Beveiliging: Verbindingsreeksen staan geverifieerde telemetrieopname toe met behulp van Microsoft Entra-verificatie voor Application Insights.
  • Aangepaste eindpunten (onafhankelijke of hybride cloudomgevingen): met eindpuntinstellingen kunnen gegevens worden verzonden naar een specifieke Azure Government-regio. (Zie voorbeelden.)
  • Privacy (regionale eindpunten): verbindingsreeksen vereenvoudigen privacyproblemen door gegevens naar regionale eindpunten te verzenden, zodat gegevens geen geografische regio verlaten.

Uw verbindingsreeks zoeken

Uw verbindingsreeks wordt weergegeven in de sectie Overzicht van uw Application Insights-resource.

Schermopname van het Application Insights-overzicht en verbindingsreeks.

Schema

Schema-elementen worden in de volgende secties uitgelegd.

Maximumlengte

De verbinding heeft een maximale ondersteunde lengte van 4096 tekens.

Sleutel-waardeparen

Een verbindingsreeks bestaat uit een lijst met instellingen die worden weergegeven als sleutel-waardeparen, gescheiden door een puntkomma:key1=value1;key2=value2;key3=value3

Tip

Configureerbare sleutel-waardeparen worden in dit document behandeld. Sommige sleutel-waardeparen kunnen niet worden geconfigureerd en worden automatisch ingesteld, zoals ApplicationId. Deze kunnen veilig worden genegeerd als ze in uw omgeving worden waargenomen.

Syntaxis

  • InstrumentationKey (bijvoorbeeld 000000000-0000-0000-0000-000000000000000000). InstrumentationKey is een verplicht veld.

  • Authorization (bijvoorbeeld ikey). Deze instelling is optioneel omdat momenteel alleen ikey-autorisatie wordt ondersteund.

  • EndpointSuffix (bijvoorbeeld applicationinsights.azure.cn). Als u het eindpuntachtervoegsel instelt, wordt aan de SDK aangegeven met welke Azure-cloud verbinding moet worden gemaakt. De SDK verzamelt de rest van het eindpunt voor afzonderlijke services.

  • Expliciete eindpunten. Elke service kan expliciet worden overschreven in de verbindingsreeks:

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

Eindpuntschema

<prefix>.<suffix>

  • Voorvoegsel: Definieert een service.
  • Achtervoegsel: Definieert de algemene domeinnaam.

Geldige achtervoegsels

  • applicationinsights.azure.cn
  • applicationinsights.us

Zie Regio's waarvoor eindpuntwijziging is vereist voor meer informatie.

Geldige voorvoegsels

Voorbeelden van verbindingsreeksen

Hier volgen enkele voorbeelden van verbindingsreeks s.

Verbindingsreeks met een eindpuntachtervoegsel

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

In dit voorbeeld geeft de verbindingsreeks het eindpuntachtervoegsel op en maakt de SDK service-eindpunten:

  • Autorisatieschema is standaard ingesteld op 'ikey'
  • Instrumentatiesleutel: 00000000-0000-0000-0000-0000000000000
  • De regionale service Uniform Resource Identifiers (URI's) zijn gebaseerd op het opgegeven eindpuntachtervoegsel:
    • Inname: https://dc.ai.contoso.com
    • Live metrische gegevens: https://live.ai.contoso.com
    • Profiler: https://profiler.ai.contoso.com
    • Debugger: https://snapshot.ai.contoso.com

Verbindingsreeks met expliciete eindpuntoverschrijvingen

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

In dit voorbeeld geeft de verbindingsreeks expliciete onderdrukkingen op voor elke service. De SDK maakt gebruik van de exacte eindpunten die zonder wijziging worden geleverd:

  • Autorisatieschema is standaard ingesteld op 'ikey'
  • Instrumentatiesleutel: 00000000-0000-0000-0000-0000000000000
  • De regionale service-URI's zijn gebaseerd op de expliciete onderdrukkingswaarden:
    • Inname: https://custom.com:111/
    • Live metrische gegevens: https://custom.com:222/
    • Profiler: https://custom.com:333/
    • Debugger: https://custom.com:444/

Verbindingsreeks met een expliciete regio

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

In dit voorbeeld geeft de verbindingsreeks de regio VS - zuid-centraal op:

  • Autorisatieschema is standaard ingesteld op 'ikey'
  • Instrumentatiesleutel: 00000000-0000-0000-0000-0000000000000
  • De regionale service-URI's zijn gebaseerd op de expliciete onderdrukkingswaarden:
    • Inname: https://southcentralus.in.applicationinsights.azure.com/

Als u beschikbare regio's wilt weergeven, voert u de volgende opdracht uit in de Azure CLI:

az account list-locations -o table

Een verbindingsreeks instellen

Al onze OpenTelemetry-aanbiedingen en de volgende SDK-versies ondersteunen verbindingsreeks s:

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

U kunt een verbindingsreeks instellen in code, met behulp van een omgevingsvariabele of een configuratiebestand.

Omgevingsvariabele

Verbindingsreeks: APPLICATIONINSIGHTS_CONNECTION_STRING

Codevoorbeelden

Taal Klassieke API OpenTelemetry
ASP.NET Core Application Insights SDK AzMon OTel Distro
.NET Framework Application Insights SDK AzMon Exporter
Java N.v.t. Java-agent
JavaScript JavaScript (Web) SDK Loader Script N.v.t.
Node.js Application Insights SDK AzMon OTel Distro
Python OpenCensus Python SDK AzMon OTel Distro

Veelgestelde vragen

In deze sectie vindt u antwoorden op veelgestelde vragen.

Vereisen nieuwe Azure-regio's het gebruik van verbindingsreeks s?

Voor nieuwe Azure-regio's is het gebruik van verbindingsreeks s in plaats van instrumentatiesleutels vereist. Verbindingsreeks identificeert de resource die u wilt koppelen aan uw telemetriegegevens. Hiermee kunt u ook de eindpunten wijzigen die uw resource gebruikt als bestemming voor uw telemetrie. Kopieer de verbindingsreeks en voeg deze toe aan de code van uw toepassing of aan een omgevingsvariabele.

Moet ik verbindingsreeks s of instrumentatiesleutels gebruiken?

U wordt aangeraden verbindingsreeks s te gebruiken in plaats van instrumentatiesleutels.

Volgende stappen

Gebruik tijdens runtime:

Gebruik tijdens het ontwikkelen: