Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
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.
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
-
Telemetrieopname:
dc
-
Live Metrics:
live
-
Profiler voor .NET:
profiler
-
Momentopname:
snapshot
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
- Inname:
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/
- Inname:
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/
- Inname:
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:
- Azure Virtual Machine (VM) en Azure Virtual Machine Scale Sets IIS-gehoste apps
- IIS-server (Internet Information Server)
- Web Apps-functie van Azure App Service
Begin tijdens de ontwikkelingsfase met: