Parametry połączeń

W tym artykule pokazano, jak używać parametrów połączenia.

Omówienie

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 będziemy już zapewniać aktualizacji ani obsługi funkcji. Przejście do parametrów połączenia w celu skorzystania z nowych możliwości.

Nie używaj jednocześnie parametrów połączenia i klucza instrumentacji. Niezależnie od tego, która wartość została ustawiona jako ostatnia, będzie miała pierwszeństwo.

Omówienie scenariusza

Te zmiany mają największy wpływ na scenariusze:

  • 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 Często zadawane pytania dotyczące usługi Azure Monitor. Parametry połączenia oferują lepszą alternatywę, zmniejszając ten nakład 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 Azure Government. Za pomocą parametrów połączenia można zdefiniować ustawienia punktu końcowego dla serwerów intranetowych lub ustawień chmury hybrydowej.

Rozpoczęcie pracy

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

Znajdywanie parametrów połączenia

Parametry połączenia są wyświetlane 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.

Długość maksymalna

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

Pary klucz-wartość

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

Składnia

  • InstrumentationKey (na przykład 000000000-0000-0000-0000-000000000000000). Parametry połączenia są 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 spowoduje, że zestaw SDK, z którym ma nawiązać połączenie chmura platformy Azure. Zestaw SDK zmontuje resztę punktu końcowego dla poszczególnych usług.
  • Jawne punkty końcowe. W parametrach 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 są wpisem tajnym?

Parametry połączenia zawierają 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. Nie jest uważany za token zabezpieczający ani klucz. Jeśli chcesz chronić zasób sztucznej inteligencji przed nieprawidłowym użyciem, punkt końcowy pozyskiwania zapewnia opcje pozyskiwania uwierzytelnionych danych telemetrycznych na podstawie usługi Azure Active Directory (Azure AD).

Uwaga

Zestaw SDK javaScript usługi Application Insights wymaga przekazania parametrów połączenia podczas inicjowania i konfiguracji. Jest ona widoczna w postaci zwykłego tekstu w przeglądarkach klienckich. Nie ma łatwego sposobu używania uwierzytelniania opartego na Azure AD na potrzeby telemetrii przeglądarki. Zalecamy rozważ utworzenie 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 parametrów 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ślają sufiks punktu końcowego, a zestaw SDK utworzy punkty końcowe usługi:

  • Schemat autoryzacji domyślnie ma wartość "ikey"
  • Klucz instrumentacji: 00000000-0000-0000-0000-0000000000000
  • 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

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ślają jawne przesłonięcia dla każdej usługi. Zestaw SDK użyje dokładnych punktów końcowych podanych bez modyfikacji:

  • Schemat autoryzacji domyślnie ma wartość "ikey"
  • Klucz instrumentacji: 00000000-0000-0000-0000-0000000000000
  • 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/

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ślają region Południowo-środkowe stany USA:

  • Schemat autoryzacji domyślnie ma wartość "ikey"
  • Klucz instrumentacji: 00000000-0000-0000-0000-0000000000000
  • 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 parametrów połączenia

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

  • .NET, wersja 2.12.0
  • Java w wersji 2.5.1 i Java 3.0
  • JavaScript w wersji 2.3.0
  • NodeJS w wersji 1.5.0
  • Python w wersji 1.0.0

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

Zmienna środowiskowa

Parametry połączenia: APPLICATIONINSIGHTS_CONNECTION_STRING

Przykłady kodu

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

Jawne ustawienie platformy .NET:

var configuration = new TelemetryConfiguration
{
    ConnectionString = "InstrumentationKey=00000000-0000-0000-0000-000000000000;"
};

Plik konfiguracji platformy .NET:

<?xml version="1.0" encoding="utf-8"?>
<ApplicationInsights xmlns="http://schemas.microsoft.com/ApplicationInsights/2013/Settings">
    <ConnectionString>InstrumentationKey=00000000-0000-0000-0000-000000000000</ConnectionString>
</ApplicationInsights>

Jawne ustawienie platformy .NET Core:

public void ConfigureServices(IServiceCollection services)
{
    var options = new ApplicationInsightsServiceOptions { ConnectionString = "InstrumentationKey=00000000-0000-0000-0000-000000000000;" };
    services.AddApplicationInsightsTelemetry(options: options);
}

Plik config.json platformy .NET Core:

{
  "ApplicationInsights": {
    "ConnectionString" : "InstrumentationKey=00000000-0000-0000-0000-000000000000;"
    }
  }

Następne kroki

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

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