Udostępnij za pomocą

Parametry połączenia w usłudze Application Insights

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

Ważne

Parametry połączenia zawierają klucz instrumentacji (ikey) i identyfikator ApplicationId.

Klucz ikey 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. Parametry połączenia są ulepszane przez dodanie wartości ApplicationId. Ta aktualizacja to nowa funkcja, która obsługuje automatyczną instrumentację dla scenariuszy korzystających z zestawu Open Telemetry SDK. 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. zakończy się wsparcie dla pozyskiwania kluczy instrumentacji. Pozyskiwanie klucza instrumentacji będzie nadal działać, ale nie będziemy już zapewniać aktualizacji ani wsparcia dla tej funkcji. Przejście do ciągów połączeń w celu skorzystania z nowych funkcji.

Możliwości ciągó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.

Znajdź ciąg 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ść

Ciąg 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 omówiono pary klucz-wartość, które można konfigurować. Niektóre pary klucz-wartość nie można konfigurować i są ustawiane automatycznie, takie jak ApplicationId. Te pary można bezpiecznie zignorować, jeśli są one obserwowane w danym ś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 SDK, do której chmury Azure ma się podłączyć. Zestaw SDK tworzy pozostałą część punktu końcowego dla poszczególnych usług.

  • Jawne punkty końcowe. W ciągu parametrów 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 łańcuchów połączenia.

Łańcuch 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życie: https://dc.ai.contoso.com
    • Metryki na żywo: https://live.ai.contoso.com
    • Profiler dla platformy .NET: https://profiler.ai.contoso.com
    • Debuger: 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 ciąg połączenia określa jawne przesłonięcia ustawień 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
  • URI usług regionalnych opierają się na jawnych wartościach nadpisanych:
    • Spożycie: https://custom.com:111/
    • Metryki na żywo: https://custom.com:222/
    • Profiler dla platformy .NET: https://custom.com:333/
    • Debuger: https://custom.com:444/

Ciąg połączenia z jawnym regionem

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

W tym przykładzie ciąg połączenia określa region Południowo-Środkowy USA:

  • Domyślna wartość schematu autoryzacji to "ikey"
  • Klucz instrumentacji: 000000000-0000-0000-0000-00000000000000
  • URI usług regionalnych opierają się na jawnych wartościach nadpisanych:
    • Spożycie: 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

Ustaw ciąg połączenia

Wszystkie nasze oferty OpenTelemetry oraz poniższe wersje SDK obsługują łańcuchy połączeniowe.

  • .NET v2.12.0
  • JavaScript w wersji 2.3.0
  • NodeJS v1.5.0
  • Java w wersji 3.1.1

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 Zestaw SDK języka Python OpenCensus został wycofany. Dystrybucja AzMon OTel

Następne kroki

Aby przejrzeć często zadawane pytania:

Rozpocznij w czasie wykonywania za pomocą:

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

  • Last updated on