Parametry połączeń

Omówienie

Parametry połączenia zapewniają użytkownikom usługi Application Insights jedno ustawienie konfiguracji, eliminując konieczność stosowania wielu ustawień serwera proxy. Bardzo przydatne w przypadku intranetowych serwerów internetowych, suwerennych lub hybrydowych środowisk chmury, które chcą wysyłać dane do usługi monitorowania.

Pary klucz-wartość zapewniają użytkownikom łatwy sposób definiowania kombinacji sufiksów prefiksu dla każdej usługi application Szczegółowe informacje (AI) /produktu.

Ważne

Nie zalecamy ustawiania parametrów połączenia i klucza instrumentacji. W przypadku, gdy użytkownik ustawi obie te wartości, pierwszeństwo będzie miała ta, która została ustawiona ostatnio.

Porada

Zalecamy używanie ciągów połączenia za pośrednictwem kluczy instrumentacji.

Omówienie scenariusza

Scenariusze klientów, w których wizualizowanie ma największe znaczenie:

  • Wyjątki zapory lub przekierowania serwera proxy

    W przypadkach, gdy wymagane jest monitorowanie intranetowego serwera internetowego, nasze wcześniejsze rozwiązanie zwróciło się do klientów o dodanie poszczególnych punktów końcowych usługi do konfiguracji. Aby uzyskać więcej informacji, zobacz tutaj. Parametry połączenia oferują lepszą alternatywę, ograniczając ten nakład pracy do pojedynczego ustawienia. Prosty prefiks, poprawka sufiksu umożliwia automatyczne zaludnianie i przekierowywanie wszystkich punktów końcowych do odpowiednich usług.

  • Suwerenne lub hybrydowe środowiska chmury

    Użytkownicy mogą wysyłać dane do zdefiniowanego Azure Government Region. Parametry połączenia umożliwiają definiowanie ustawień punktu końcowego dla serwerów intranetowych lub ustawień chmury hybrydowej.

Wprowadzenie

Czy znaleźć moje ciągi połączenia?

Twoje parametrów połączenia są wyświetlane w bloku Przegląd zasobu aplikacji Szczegółowe informacje aplikacji.

parametrów połączenia w bloku przeglądu

Schemat

Długość maksymalna

Maksymalna obsługiwana długość połączenia to 4096 znaków.

Pary klucz-wartość

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

Składnia

  • InstrumentationKey(np. 000000000-0000-0000-0000-000000000000) Wymagane jest pole parametrów InstrumentationKey
  • Authorization (np. ikey) (To ustawienie jest opcjonalne, ponieważ obecnie obsługujemy tylko autoryzację ikey).
  • EndpointSuffix (np. applicationinsights.azure.cn) Ustawienie sufiksu punktu końcowego spowoduje nakaże zestawowi SDK, z którą chmurą platformy Azure nawiązać połączenie. Zestaw SDK skompletuje resztę punktu końcowego dla poszczególnych usług.
  • Jawne punkty końcowe. W ciągu połączenia można jawnie przesłonić dowolną usługę.
    • IngestionEndpoint (np. https://dc.applicationinsights.azure.com )
    • LiveEndpoint (np. https://live.applicationinsights.azure.com )
    • ProfilerEndpoint (np. https://profiler.monitor.azure.com )
    • SnapshotEndpoint (np. https://snapshot.monitor.azure.com )

Schemat punktu końcowego

<prefix>.<suffix>

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

Oto lista prawidłowych sufiksów

  • applicationinsights.azure.cn
  • applicationinsights.us

Zobacz też: Regiony, które wymagają modyfikacji punktu końcowego

Prawidłowe prefiksy

Przykłady parametrów połączenia

Minimalne prawidłowe ciągi połączenia

InstrumentationKey=00000000-0000-0000-0000-000000000000;

W tym przykładzie ustawiono tylko klucz instrumentacji.

  • Schemat autoryzacji domyślnie ma wartość "ikey"
  • Klucz instrumentacji: 00000000-0000-0000-0000-0000000000000
  • Regionalne adresy URI usługi są oparte na wartościach domyślnych zestawu SDK i będą łączyć się z publiczną globalną platformą Azure:
    • Spożyciu: https://dc.services.visualstudio.com/
    • Metryki na żywo: https://rt.services.visualstudio.com/
    • Profiler: https://profiler.monitor.azure.com/
    • Debuger: https://snapshot.monitor.azure.com/

Ciąg połączenia z sufiksem punktu końcowego

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

W tym przykładzie te ciągi połączenia określają sufiks punktu końcowego, a zestaw SDK skonstruuje punkty końcowe usługi.

  • Schemat autoryzacji domyślnie ma wartość "ikey"
  • Klucz instrumentacji: 00000000-0000-0000-0000-0000000000000
  • Regionalne adresy URI usługi są oparte na dostarczanym 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

Parametrów 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 te ciągi połączenia określają jawne przesłonięcia dla każdej usługi. Zestaw SDK będzie używać dokładnych punktów końcowych podanych bez żadnych modyfikacji.

  • Schemat autoryzacji domyślnie ma wartość "ikey"
  • Klucz instrumentacji: 00000000-0000-0000-0000-0000000000000
  • Regionalne adresy URI usługi są oparte na jawnych wartościach przesłonięcia:
    • Spożyciu: https://custom.com:111/
    • Metryki na żywo: https://custom.com:222/
    • Profiler: https://custom.com:333/
    • Debuger: https://custom.com:444/

Jak ustawić ciąg połączenia

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

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

Ciąg połączenia można ustawić za pomocą kodu, zmiennej środowiskowej lub pliku konfiguracji.

Zmienna środowiskowa

  • Connection String (Ciąg połączenia): APPLICATIONINSIGHTS_CONNECTION_STRING

Przykłady kodu

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

Jawne ustawienie .NET:

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

Plik konfiguracji .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 netcore:

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

NetCore config.json:

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