Parametry połączeń

W tym artykule pokazano, jak używać parametry połączenia.

Omówienie

Uwaga

Poniższa dokumentacja opiera się na klasycznym interfejsie API usługi Application Insights. Długoterminowy plan usługi Application Insights polega na zbieraniu danych przy użyciu technologii OpenTelemetry. Aby uzyskać więcej informacji, zobacz Enable Azure Monitor OpenTelemetry for .NET, Node.js, Python and Java applications (Włączanie usługi Azure Monitor OpenTelemetry dla platformy .NET, Node.js, Python i Java applications).

Parametry połączenia definiują miejsce wysyłania danych telemetrycznych.

Pary klucz-wartość umożliwiają użytkownikom łatwe definiowanie kombinacji sufiksu prefiksu dla każdej usługi Application Insights lub produktu.

Uwaga

31 marca 2025 r. zostanie zakończone świadczenie pomocy technicznej dla pozyskiwania klucza instrumentacji. Pozyskiwanie klucza instrumentacji będzie nadal działać, ale nie udostępnimy już aktualizacji ani obsługi funkcji. Przejście do parametry połączenia w celu skorzystania z nowych funkcji.

Omówienie scenariusza

Scenariusze najbardziej dotknięte tą zmianą:

• Wyjątki zapory lub przekierowania serwera proxy:

  W przypadkach, gdy wymagane jest monitorowanie intranetowego serwera internetowego, nasze wcześniejsze rozwiązanie poprosiło Cię o dodanie poszczególnych punktów końcowych usługi do konfiguracji. Aby uzyskać więcej informacji, zobacz Czy mogę monitorować intranetowy serwer internetowy?. Parametry połączenia oferują lepszą alternatywę dzięki zmniejszeniu tego nakładu pracy na pojedyncze ustawienie. Prosty prefiks, poprawka sufiksu, umożliwia automatyczną populację i przekierowywanie wszystkich punktów końcowych do odpowiednich usług.

• Suwerenne lub hybrydowe środowiska chmury:

  Użytkownicy mogą wysyłać dane do zdefiniowanego regionu usługi Azure Government. Za pomocą parametry połączenia można zdefiniować ustawienia punktu końcowego dla serwerów intranetowych lub ustawień chmury hybrydowej.

Rozpocznij

Zapoznaj się z poniższymi sekcjami, aby rozpocząć pracę.

Znajdywanie parametrów połączenia

Twoje parametry połączenia zostanie wyświetlone w sekcji Przegląd zasobu usługi Application Insights.

Schemat

Elementy schematu zostały wyjaśnione w poniższych sekcjach.

Maksymalna długość

Połączenie ma maksymalną obsługiwaną długość 4096 znaków.

Pary klucz-wartość

Parametry połączenia składa się z listy ustawień reprezentowanych jako pary klucz-wartość oddzielone średnikiem:key1=value1;key2=value2;key3=value3

Składnia

• InstrumentationKey (na przykład 000000000-0000-0000-0000-00000000000000000). InstrumentationKeyjest polem wymaganym.
• Authorization (na przykład ikey). To ustawienie jest opcjonalne, ponieważ obecnie obsługujemy tylko autoryzację klucza ikey.
• EndpointSuffix (na przykład applicationinsights.azure.cn). Ustawienie sufiksu punktu końcowego informuje zestaw SDK, z którym ma się łączyć chmura platformy Azure. Zestaw SDK tworzy pozostałą część punktu końcowego dla poszczególnych usług.
• Jawne punkty końcowe. W parametry połączenia można jawnie zastąpić dowolną usługę:
  • IngestionEndpoint (na przykład https://dc.applicationinsights.azure.com)
  • LiveEndpoint (na przykład https://live.applicationinsights.azure.com)
  • ProfilerEndpoint (na przykład https://profiler.monitor.azure.com)
  • SnapshotEndpoint (na przykład https://snapshot.monitor.azure.com)

Schemat punktu końcowego

<prefix>.<suffix>

• Prefiks: definiuje usługę.
• Sufiks: definiuje wspólną nazwę domeny.

Prawidłowe sufiksy

• applicationinsights.azure.cn
• applicationinsights.us

Aby uzyskać więcej informacji, zobacz Regiony wymagające modyfikacji punktu końcowego.

Prawidłowe prefiksy

• Pozyskiwanie danych telemetrycznych: dc
• Metryki na żywo: live
• Profiler: profiler
• Migawka: snapshot

Czy parametry połączenia wpis tajny?

Parametry połączenia zawiera klucz ikey, który jest unikatowym identyfikatorem używanym przez usługę pozyskiwania do kojarzenia danych telemetrycznych z określonym zasobem usługi Application Insights. Te unikatowe identyfikatory ikey nie są tokenami zabezpieczającymi ani kluczami zabezpieczeń. Jeśli chcesz chronić zasób sztucznej inteligencji przed nieprawidłowym użyciem, punkt końcowy pozyskiwania udostępnia opcje pozyskiwania uwierzytelnionych danych telemetrycznych na podstawie identyfikatora Entra firmy Microsoft.

Uwaga

Zestaw SDK języka JavaScript usługi Application Insights wymaga przekazania parametry połączenia podczas inicjowania i konfiguracji. Jest ona widoczna w postaci zwykłego tekstu w przeglądarkach klienckich. Nie ma łatwego sposobu korzystania z uwierzytelniania opartego na identyfikatorze Entra firmy Microsoft na potrzeby telemetrii przeglądarki. Zalecamy rozważenie utworzenia oddzielnego zasobu usługi Application Insights dla telemetrii przeglądarki, jeśli musisz zabezpieczyć telemetrię usługi.

Przykłady parametrów połączenia

Oto kilka przykładów parametry połączenia.

Parametry połączenia z sufiksem punktu końcowego

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

W tym przykładzie parametry połączenia określa sufiks punktu końcowego i zestaw SDK tworzy punkty końcowe usługi:

• Domyślna wartość schematu autoryzacji to "ikey"
• Klucz instrumentacji: 000000000-0000-0000-0000-00000000000000
• Identyfikatory URI usługi regionalnej są oparte na podanym sufiksie punktu końcowego:
  • Spożyciu: https://dc.ai.contoso.com
  • Metryki na żywo: https://live.ai.contoso.com
  • Profiler: https://profiler.ai.contoso.com
  • Debugger: https://snapshot.ai.contoso.com

Parametry połączenia z jawnymi przesłonięciami punktu końcowego

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

W tym przykładzie parametry połączenia określa jawne przesłonięcia dla każdej usługi. Zestaw SDK używa dokładnych punktów końcowych podanych bez modyfikacji:

• Domyślna wartość schematu autoryzacji to "ikey"
• Klucz instrumentacji: 000000000-0000-0000-0000-00000000000000
• Identyfikatory URI usługi regionalnej są oparte na jawnych wartościach zastąpienia:
  • Spożyciu: https://custom.com:111/
  • Metryki na żywo: https://custom.com:222/
  • Profiler: https://custom.com:333/
  • Debugger: https://custom.com:444/

Parametry połączenia z jawnym regionem

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

W tym przykładzie parametry połączenia określa region Południowo-środkowe stany USA:

• Domyślna wartość schematu autoryzacji to "ikey"
• Klucz instrumentacji: 000000000-0000-0000-0000-00000000000000
• Identyfikatory URI usługi regionalnej są oparte na jawnych wartościach zastąpienia:
  • Spożyciu: https://southcentralus.in.applicationinsights.azure.com/

Uruchom następujące polecenie w interfejsie wiersza polecenia platformy Azure, aby wyświetlić listę dostępnych regionów:

az account list-locations -o table

Ustawianie parametry połączenia

Parametry połączenia są obsługiwane w następujących wersjach zestawu SDK:

• .NET v2.12.0
• Java w wersji 2.5.1 i Java 3.0
• JavaScript w wersji 2.3.0
• NodeJS v1.5.0
• Python v1.0.0

Można ustawić parametry połączenia w kodzie lub przy użyciu zmiennej środowiskowej lub pliku konfiguracji.

Zmienna środowiskowa

Parametry połączenia: APPLICATIONINSIGHTS_CONNECTION_STRING

Przykłady kodu

.NET 5.0+

1. Ustaw parametry połączenia w appsettings.json pliku:

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

2. Pobierz parametry połączenia podczas Program.cs rejestrowania ApplicationInsightsTelemetry usługi:

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

.NET Framework

Ustaw właściwość TelemetryConfiguration.ConnectionString lub ApplicationInsightsServiceOptions.ConnectionString.

Jawnie ustaw parametry połączenia w kodzie:

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

Ustaw parametry połączenia przy użyciu pliku konfiguracji:

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

Parametry połączenia można ustawić w applicationinsights.json pliku konfiguracji:

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

Aby uzyskać więcej informacji, zobacz Konfiguracja parametrów połączenia.

JavaScript

Język JavaScript nie obsługuje używania zmiennych środowiskowych. Dostępne są dwie opcje:

• Aby użyć skryptu modułu ładującego zestawu SDK języka JavaScript (Web), zobacz JavaScript (Web) SDK Loader Script (Skrypt modułu ładującego zestawu JAVAScript (Web).
• Konfiguracja ręczna:

  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

Zalecamy, aby użytkownicy ustawiali zmienną środowiskową.

Aby jawnie ustawić parametry połączenia:

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

Często zadawane pytania

Ta sekcja zawiera odpowiedzi na typowe pytania.

Czy nowe regiony platformy Azure wymagają użycia parametry połączenia?

Nowe regiony platformy Azure wymagają użycia parametry połączenia zamiast kluczy instrumentacji. Parametry połączenia identyfikują zasób, który chcesz skojarzyć z danymi telemetrycznymi. Umożliwia również modyfikowanie punktów końcowych używanych przez zasób jako miejsca docelowego dla telemetrii. Skopiuj parametry połączenia i dodaj ją do kodu aplikacji lub zmiennej środowiskowej.

Czy należy używać parametry połączenia lub kluczy instrumentacji?

Zalecamy używanie parametry połączenia zamiast kluczy instrumentacji.

Następne kroki

Rozpocznij pracę w czasie wykonywania za pomocą rozwiązań:

• Maszyny wirtualne platformy Azure i aplikacje hostowane przez usługi IIS w usłudze Azure Virtual Machine Scale Sets
• Serwer usług IIS
• Funkcja web apps usługi aplikacja systemu Azure Service

Rozpocznij pracę w czasie programowania za pomocą rozwiązań:

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