Anslutningssträngar

Den här artikeln visar hur du använder anslutningssträng.

Översikt

Kommentar

Följande dokumentation förlitar sig på det klassiska API:et Application Insights. Den långsiktiga planen för Application Insights är att samla in data med OpenTelemetry. Mer information finns i Aktivera Azure Monitor OpenTelemetry för .NET-, Node.js-, Python- och Java-program.

Anslut ionssträngar definierar var telemetridata ska skickas.

Nyckel/värde-par är ett enkelt sätt för användare att definiera en prefixsuffixkombination för varje Application Insights-tjänst eller produkt.

Kommentar

Stödet för inmatning av instrumentationsnycklar upphör den 31 mars 2025. Inmatningen av instrumenteringsnyckeln fortsätter att fungera, men vi kommer inte längre att tillhandahålla uppdateringar eller stöd för funktionen. Övergå till anslutningssträng för att dra nytta av nya funktioner.

Scenarioöversikt

Scenarier som påverkas mest av den här ändringen:

• Brandväggsfel eller proxyomdirigeringar:

  I de fall där övervakning för intranätswebbserver krävs bad vår tidigare lösning dig att lägga till enskilda tjänstslutpunkter i konfigurationen. Mer information finns i Kan jag övervaka en intranätwebbserver?. Anslut ionssträngar erbjuder ett bättre alternativ genom att minska den här ansträngningen till en enda inställning. Ett enkelt prefix, suffixändring, tillåter automatisk population och omdirigering av alla slutpunkter till rätt tjänster.

• Nationella miljöer eller hybridmolnmiljöer:

  Användare kan skicka data till en definierad Azure Government-region. Med hjälp av anslutningssträng kan du definiera slutpunktsinställningar för intranätservrar eller hybridmolninställningar.

Kom igång

Gå igenom följande avsnitt för att komma igång.

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

Är anslutningssträng en hemlighet?

Anslutningssträng innehåller en ikey, som är en unik identifierare som används av inmatningstjänsten för att associera telemetri till en specifik Application Insights-resurs. Dessa unika ikey-identifierare är inte säkerhetstoken eller säkerhetsnycklar. Om du vill skydda din AI-resurs från missbruk tillhandahåller inmatningsslutpunkten autentiserade alternativ för telemetriinmatning baserat på Microsoft Entra-ID.

Kommentar

Application Insights JavaScript SDK kräver att anslutningssträng skickas in under initieringen och konfigurationen. Den kan visas i oformaterad text i klientwebbläsare. Det finns inget enkelt sätt att använda Microsoft Entra ID-baserad autentisering för webbläsartelemetri. Vi rekommenderar att du skapar en separat Application Insights-resurs för webbläsartelemetri om du behöver skydda tjänsttelemetrin.

Anslut ionssträngsexempel

Här följer några exempel på anslutningssträng.

Anslut ionssträng med 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
• De regionala tjänst-URI:erna 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
  • Debugger: https://snapshot.ai.contoso.com

Anslut ionssträ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/
  • Debugger: https://custom.com:444/

Anslut ionssträ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/

Kör följande kommando i Azure CLI för att visa tillgängliga regioner:

az account list-locations -o table

Ange en anslutningssträng

Anslut ionssträngar stöds i följande SDK-versioner:

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

Du kan ange en anslutningssträng i kod eller med hjälp av en miljövariabel eller en konfigurationsfil.

Miljövariabel

Anslut ionssträng:APPLICATIONINSIGHTS_CONNECTION_STRING

Kodexempel

.NET 5.0+

1. Ange anslutningssträng i appsettings.json filen:

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

2. Hämta anslutningssträng i Program.cs när du registrerar ApplicationInsightsTelemetry tjänsten:

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

.NET Framework

Ange egenskapen TelemetryConfiguration.AnslutionString eller ApplicationInsightsServiceOptions.AnslutionString.

Ange uttryckligen anslutningssträng i kod:

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

Ange anslutningssträng med hjälp av en konfigurationsfil:

<?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

Du kan ange anslutningssträng i konfigurationsfilenapplicationinsights.json:

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

Mer information finns i Anslut ionssträngskonfiguration.

JavaScript

JavaScript stöder inte användning av miljövariabler. Du har två alternativ:

• Mer information om hur du använder SDK-inläsningsskriptet för JavaScript (web) finns i SDK-inläsningsskriptet för JavaScript (web).
• Manuell installation:

  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

Vi rekommenderar att användarna anger miljövariabeln.

Så här anger du uttryckligen anslutningssträng:

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))

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. Anslut ionssträ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 VM och Azure Virtual Machine Scale Sets IIS-värdbaserade appar
• IIS-server
• Funktionen Web Apps i Azure App Service

Kom igång under utvecklingsfasen med:

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