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 Szczegółowe informacje. Długoterminowy plan Szczegółowe informacje aplikacji polega na zbieraniu danych przy użyciu biblioteki 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).

ciągi Połączenie ion definiują miejsce wysyłania danych telemetrycznych.

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

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?. ciągi Połączenie ion 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

Parametry połączenia pojawi się w sekcji Przegląd zasobu Application Szczegółowe informacje.

Screenshot that shows the Application Insights overview and connection string.

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

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 Szczegółowe informacje. 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 usługi Application Szczegółowe informacje JavaScript wymaga przekazania parametry połączenia podczas inicjowania i konfigurowania. 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 aplikacji Szczegółowe informacje dla telemetrii przeglądarki, jeśli musisz zabezpieczyć telemetrię usługi.

Przykłady ciągów Połączenie ion

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

ciąg Połączenie ion 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
    • Debuger: https://snapshot.ai.contoso.com

ciąg Połączenie ion 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/
    • Debuger: https://custom.com:444/

ciąg Połączenie ion 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

Ciągi Połączenie ion 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

ciąg Połączenie ion:APPLICATIONINSIGHTS_CONNECTION_STRING

Przykłady kodu

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

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. ciąg Połączenie ion identyfikuje 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ń:

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