Delen via


Verbindingsreeksen in Application Insights

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 en een ApplicationId.

De ikey is 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. Verbindingsreeksen worden uitgebreid door de ApplicationId-waarde toe te voegen. Deze update is een nieuwe functie die ondersteuning biedt voor automatische instrumentatie voor scenario's die gebruikmaken van de Open Telemetry SDK. 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 stopt de ondersteuning voor het verwerken van instrumentatiesleutels. Het verwerken van instrumentatiesleutels blijft mogelijk, maar we zullen geen updates of ondersteuning meer bieden voor deze functie. Overgang naar verbindingsreeksen om te profiteren van nieuwe mogelijkheden.

Functies van 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 de 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

Aanbeveling

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

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: Hiermee definieert u een service.
  • Achtervoegsel: Hiermee definieert u 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 eindpuntenachtervoegsel

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-000000000000
  • De regionale service Uniform Resource Identifiers (URI's) zijn gebaseerd op het opgegeven eindpuntachtervoegsel:
    • Inname: https://dc.ai.contoso.com
    • Live Statistieken: https://live.ai.contoso.com
    • Profiler voor .NET: 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 specificeert de verbindingsreeks expliciete overschrijvingen 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-000000000000
  • De regionale service-URI's zijn gebaseerd op de expliciete overschrijvingswaarden.
    • Inname: https://custom.com:111/
    • Live Statistieken: https://custom.com:222/
    • Profiler voor .NET: 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-000000000000
  • De regionale service-URI's zijn gebaseerd op de expliciete overschrijvingswaarden.
    • 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 verbindingsreeksen.

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

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 NVT Java-agent
Javascript JavaScript (Web) SDK Loader Script NVT
Node.js Application Insights SDK AzMon OTel Distro
Python OpenCensus Python SDK AzMon OTel Distro

Volgende stappen

Veelgestelde vragen (FAQ) bekijken:

Begin tijdens runtime met:

Begin tijdens de ontwikkelingsfase met: