Anslutningssträngar

Den här artikeln visar hur du använder niska veze.

Ö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.

Anslutningssträ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 niska veze 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?. Anslutningssträngar är 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 niska veze 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 niska veze visas i avsnittet Översikt för din Application Insights-resurs.

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 niska veze 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 niska veze:
  • 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 niska veze en hemlighet?

Niska veze 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 niska veze 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.

Exempel på anslutningssträngar

Här följer några exempel på niska veze.

Anslutningssträng med ett slutpunktssuffix

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

I det här exemplet anger niska veze 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
  • Avlusare: https://snapshot.ai.contoso.com

Anslutningssträ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 niska veze 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/
  • Avlusare: https://custom.com:444/

Anslutningssträng med en explicit region

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

I det här exemplet anger niska veze 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 niska veze

Anslutningssträ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 niska veze i kod eller med hjälp av en miljövariabel eller en konfigurationsfil.

Miljövariabel

Anslutningssträng: APPLICATIONINSIGHTS_CONNECTION_STRING

Kodexempel

.NET 5.0+

1. Ange niska veze 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 niska veze 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.ConnectionString eller ApplicationInsightsServiceOptions.ConnectionString.

Ange uttryckligen niska veze 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 niska veze 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 niska veze 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 Konfiguration av anslutningssträngar.

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 niska veze:

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

Nya Azure-regioner kräver användning av niska veze i stället för instrumentationsnycklar. Anslutningssträ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 niska veze och lägg till den i programmets kod eller i en miljövariabel.

Ska jag använda niska veze eller instrumentationsnycklar?

Vi rekommenderar att du använder niska veze 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