Verbindingsreeksen

In dit artikel wordt beschreven hoe u verbindingsreeks s gebruikt.

Overzicht

Notitie

De volgende documentatie is afhankelijk van de klassieke Application Insights-API. Het langetermijnplan voor Application Insights is het verzamelen van gegevens met behulp van OpenTelemetry. Zie Azure Monitor OpenTelemetry inschakelen voor .NET-, Node.js-, Python- en Java-toepassingen voor meer informatie.

Verbinding maken iontekenreeksen bepalen waar telemetriegegevens moeten worden verzonden.

Sleutel-waardeparen bieden gebruikers een eenvoudige manier om een combinatie van voorvoegsels te definiëren voor elke Application Insights-service of elk product.

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.

Overzicht van scenario

Scenario's die het meest worden beïnvloed door deze wijziging:

• Firewall-uitzonderingen of proxyomleidingen:

  In gevallen waarin bewaking voor intranetwebserver vereist is, vroeg onze eerdere oplossing u om afzonderlijke service-eindpunten toe te voegen aan uw configuratie. Zie de pagina Kan ik een intranetwebserver bewaken voor meer informatie. Verbinding maken iontekenreeksen bieden een beter alternatief door deze inspanning te verminderen tot één instelling. Een eenvoudig voorvoegsel, achtervoegselwijziging, maakt automatische populatie en omleiding van alle eindpunten naar de juiste services mogelijk.

• Onafhankelijke of hybride cloudomgevingen:

  Gebruikers kunnen gegevens verzenden naar een gedefinieerde Azure Government-regio. Met behulp van verbindingsreeks s kunt u eindpuntinstellingen definiëren voor uw intranetservers of hybride cloudinstellingen.

Aan de slag

Bekijk de volgende secties om aan de slag te gaan.

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

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

• Telemetrieopname: dc
• Live Metrics: live
• Profiler: profiler
• Momentopname: snapshot

Is de verbindingsreeks een geheim?

De verbindingsreeks bevat een ikey, een unieke id die wordt gebruikt door de opnameservice om telemetrie te koppelen aan een specifieke Application Insights-resource. Deze unieke ikey-id's zijn geen beveiligingstokens of beveiligingssleutels. Als u uw AI-resource wilt beschermen tegen misbruik, biedt het opname-eindpunt geverifieerde opties voor telemetrieopname op basis van Microsoft Entra-id.

Notitie

Voor de JavaScript SDK van Application Insights moet de verbindingsreeks worden doorgegeven tijdens de initialisatie en configuratie. Het is zichtbaar in tekst zonder opmaak in clientbrowsers. Er is geen eenvoudige manier om de verificatie op basis van Microsoft Entra ID voor browsertelemetrie te gebruiken. Het is raadzaam om een afzonderlijke Application Insights-resource te maken voor browsertelemetrie als u de servicetelemetrie wilt beveiligen.

voorbeelden van Verbinding maken iontekenreeksen

Hier volgen enkele voorbeelden van verbindingsreeks s.

Verbinding maken iontekenreeks 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-URI's zijn gebaseerd op het opgegeven eindpuntachtervoegsel:
  • Ingestion: 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

Verbinding maken iontekenreeks 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:
  • Ingestion: https://custom.com:111/
  • Live metrische gegevens: https://custom.com:222/
  • Profiler: https://custom.com:333/
  • Debugger: https://custom.com:444/

Verbinding maken iontekenreeks 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:
  • Ingestion: https://southcentralus.in.applicationinsights.azure.com/

Voer de volgende opdracht uit in de Azure CLI om beschikbare regio's weer te geven:

az account list-locations -o table

Een verbindingsreeks instellen

Verbinding maken iontekenreeksen worden ondersteund in de volgende SDK-versies:

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

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

Omgevingsvariabele

Verbinding maken iontekenreeks:APPLICATIONINSIGHTS_CONNECTION_STRING

Codevoorbeelden

.NET 5.0+

1. Stel de verbindingsreeks in het appsettings.json bestand in:

   {
     "ApplicationInsights": {
       "ConnectionString" : "InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/"
       }
   }
   

2. Haal de verbindingsreeks op Program.cs bij het registreren van de ApplicationInsightsTelemetry service:

   var options = new ApplicationInsightsServiceOptions { ConnectionString = app.Configuration["ApplicationInsights:ConnectionString"] };
   builder.Services.AddApplicationInsightsTelemetry(options: options);
   

.NET Framework

De eigenschap TelemetryConfiguration.Verbinding maken instellenionString of ApplicationInsightsServiceOptions.Verbinding makenionString.

Stel de verbindingsreeks expliciet in code in:

var configuration = new TelemetryConfiguration
{
    ConnectionString = "InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/"
};

Stel de verbindingsreeks in met behulp van een configuratiebestand:

<?xml version="1.0" encoding="utf-8"?>
<ApplicationInsights xmlns="http://schemas.microsoft.com/ApplicationInsights/2013/Settings">
    <ConnectionString>InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/</ConnectionString>
</ApplicationInsights>

Java

U kunt de verbindingsreeks instellen in het applicationinsights.json configuratiebestand:

{
  "connectionString": "InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/"
}

Zie Verbinding maken ion-tekenreeksconfiguratie voor meer informatie.

JavaScript

JavaScript biedt geen ondersteuning voor het gebruik van omgevingsvariabelen. U hebt twee opties:

• Als u het JavaScript (Web) SDK Loader Script wilt gebruiken, raadpleegt u JavaScript (Web) SDK Loader Script.
• Handmatige installatie:

  import { ApplicationInsights } from '@microsoft/applicationinsights-web'
  
  const appInsights = new ApplicationInsights({ config: {
     connectionString: 'InstrumentationKey=00000000-0000-0000-0000-000000000000;'
     /* ...Other Configuration Options... */
  } });
  appInsights.loadAppInsights();
  appInsights.trackPageView();
  

Node.js

const appInsights = require("applicationinsights");
appInsights.setup("InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/");
appInsights.start();

Python

Het is raadzaam dat gebruikers de omgevingsvariabele instellen.

De verbindingsreeks expliciet instellen:

from opencensus.ext.azure.trace_exporter import AzureExporter
from opencensus.trace.samplers import ProbabilitySampler
from opencensus.trace.tracer import Tracer

tracer = Tracer(exporter=AzureExporter(connection_string='InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/'), sampler=ProbabilitySampler(1.0))

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. Verbinding maken iontekenreeks 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:

• Door IIS gehoste IIS-apps voor Azure VM en virtuele-machineschaalsets
• IIS-server
• Web Apps-functie van Azure-app Service

Gebruik tijdens het ontwikkelen:

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