Udostępnij za pośrednictwem

Parametry połączenia w usłudze Application Insights

  • Artykuł

Parametry połączenia określają, do którego zasobu usługi Application Insights instrumentowana aplikacja powinna wysyłać dane telemetryczne. Parametry połączenia składa się z wielu ustawień, z których każda jest reprezentowana jako para klucz-wartość i oddzielona średnikami. Ta skonsolidowana metoda konfiguracji upraszcza proces instalacji, eliminując konieczność korzystania z wielu ustawień serwera proxy.

Ważne

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. Unikatowe identyfikatory Ikey nie są tokenami zabezpieczającymi ani kluczami zabezpieczeń i nie są uznawane za wpisy tajne.

Jeśli chcesz chronić zasób usługi Application Insights przed nieprawidłowym użyciem, punkt końcowy pozyskiwania udostępnia opcje pozyskiwania uwierzytelnionych danych telemetrycznych na podstawie identyfikatora Entra firmy Microsoft.

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.

Możliwości parametrów połączenia

  • Niezawodność: Parametry połączenia sprawiają, że pozyskiwanie danych telemetrycznych jest bardziej niezawodne, usuwając zależności od globalnych punktów końcowych pozyskiwania.
  • Zabezpieczenia: Parametry połączenia umożliwiają uwierzytelnione pozyskiwanie danych telemetrycznych przy użyciu uwierzytelniania firmy Microsoft Entra dla usługi Application Insights.
  • Niestandardowe punkty końcowe (suwerenne lub hybrydowe środowiska chmury): ustawienia punktu końcowego umożliwiają wysyłanie danych do określonego regionu usługi Azure Government. (Zobacz przykłady).
  • Prywatność (regionalne punkty końcowe): Parametry połączenia ułatwiają problemy z prywatnością, wysyłając dane do regionalnych punktów końcowych, zapewniając, że dane nie opuszczają regionu geograficznego.

Znajdywanie parametrów połączenia

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

Zrzut ekranu przedstawiający przegląd usługi Application Insights i parametry połączenia.

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

Napiwek

W tym dokumencie opisano konfigurowalne pary klucz-wartość. Niektóre pary klucz-wartość nie można konfigurować i są ustawiane automatycznie, takie jak ApplicationId. Można je bezpiecznie zignorować, jeśli są one obserwowane w twoim środowisku.

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

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 (Uniform Resource Identifiers) 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 dla platformy .NET: 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 dla platformy .NET: 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/

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

az account list-locations -o table

Ustawianie parametry połączenia

Wszystkie nasze oferty OpenTelemetry i następujące wersje zestawu SDK obsługują parametry połączenia:

  • .NET v2.12.0
  • JavaScript w wersji 2.3.0
  • NodeJS v1.5.0
  • Python v1.0.0

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

Zmienna środowiskowa

Parametry połączenia: APPLICATIONINSIGHTS_CONNECTION_STRING

Przykłady kodu

Język Klasyczny interfejs API OpenTelemetry
ASP.NET Core Application Insights SDK Dystrybucja AzMon OTel
.NET Framework Application Insights SDK Eksporter AzMon
Java Nie dotyczy Agent języka Java
JavaScript Skrypt modułu ładującego zestawu SDK języka JavaScript (Web) Nie dotyczy
Node.js Application Insights SDK Dystrybucja AzMon OTel
Python OpenCensus Python SDK Dystrybucja AzMon OTel

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ń:

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