Podłącz źródło telemetrii

Podłącz źródło telemetrii, aby odpowiedzi agenta były oparte na własnych sygnałach, a nie na wiedzy ogólnej. Po skonfigurowaniu łącznika telemetrycznego zadaj pytanie o dochodzenie w prostym języku. Agent uruchamia zapytanie i odpowiada na rzeczywiste liczby.

Ten samouczek obejmuje konektory z kategorii Telemetria . Azure Data Explorer korzysta ze ścieżki Azure MCP Kusto. Złącza telemetryczne firm trzecich również pojawiają się w zakładce Telemetry , nawet gdy korzystają z MCP za kulisami. Konfiguracja korzysta z tego samego kreatora co każdy zarządzany konektor, dlatego ten artykuł skupia się na szczegółach telemetrii: jak źródła uwierzytelniają, które operacje włączyć oraz jak walidować za pomocą zapytania.

Important

Zarządzane złącza są w podglądzie. Dostępność łączników, pola i operacje mogą się zmieniać.

Wymagania wstępne

  • Działający agent SRE i dostęp do sre.azure.com.
  • Uprawnienia do konfiguracji złączy na agencie.
  • Dostęp do źródła telemetrii, które łączysz. Dla źródła Azure tożsamość autoryzująca połączenie musi mieć przynajmniej dostęp do odczytu do docelowego zasobu.

Jeśli nigdy wcześniej nie konfigurowałeś złącza, zacznij od Ustaw zarządzany złącz dla pełnego przewodnika wizarda. Ten artykuł wskazuje jedynie różnice źródeł telemetrii.

Złącza telemetryczne

Złącze Usługa Authentication Typowe użycie
Azure Data Explorer (via Azure MCP) Azure Data Explorer (Kusto) Tożsamość zarządzana Uruchamiaj zapytania KQL na klastrach ADX
Obszar roboczy usługi Log Analytics Analiza dzienników Tożsamość zarządzana Logi zapytania w przestrzeni roboczej w trybie tylko do odczytu
Application Insights Application Insights Tożsamość zarządzana Zapytanie o telemetrię aplikacji w trybie tylko do odczytu
Datadog Datadog Poświadczenia usługi wyświetlane przez złącze Metryki zapytań, logi i monitory
Elasticsearch Elasticsearch Poświadczenia usługi wyświetlane przez złącze Dzienniki wyszukiwania i indeksowana telemetria
Dynatrace Dynatrace Poświadczenia usługi wyświetlane przez złącze Zapytanie o dane obserwowalności i ślady
New Relic New Relic Poświadczenia usługi wyświetlane przez złącze Telemetria zapytań i incydenty
Splunk Splunk Poświadczenia usługi wyświetlane przez złącze Wyszukaj logi i wydarzenia Splunk
Hawkeye (NeuBird) Hawkeye autorstwa NeuBird Poświadczenia usługi wyświetlane przez złącze Zapytanie o dane obserwowalności oparte na sztucznej inteligencji

Zewnętrzne łączniki telemetryczne zawierają domyślne URL, uwierzytelnianie i wskazówki nagłówkowe, które pomagają skonfigurować połączenie.

Możesz także dodać kolejne źródło telemetrii przez podłączony przez użytkownika konektor. Używaj tej opcji, gdy Twój zespół ma własne narzędzie lub źródło, które nie jest wymienione w przełączniku łączników.

Krok 1: Dodaj złącze

  1. Przejdź do sre.azure.com i wybierz agenta.

  2. W lewym pasku bocznym rozwiń Builder, a następnie wybierz Connectors.

  3. Wybierz pozycję Dodaj łącznik.

  4. Wybierz zakładkę Telemetria , a następnie wybierz źródło telemetrii. Dla Azure Data Explorer wybierz Azure Data Explorer, który korzysta ze ścieżki Azure MCP Kusto.

Krok 2: Uwierzytelnij się

For Azure telemetry connectors:

  1. Uzupełnij pola pokazane przez łącznik.

    • W Azure Data Explorer nazwij konektor, wybierz tożsamość zarządzaną, której agent używa do zapytania do Kusto, a następnie dodaj jedną lub więcej grup klastrów z adresami URL klastra.
    • W przypadku Log Analytics Workspace wybierz workspace z wyboru workspace lub ręcznie wprowadź ID zasobu workspace ARM.
    • W przypadku Application Insights wybierz zasób Application Insights w wyszukiwarce zasobów lub ręcznie wprowadź ID zasobu ARM resource ID.

  2. Wybierz Managed Identity , gdy łącznik o nią prosi.

  3. Przejdź do etapu przeglądu, klasteryzmu lub wyboru narzędzi pokazanego przez kreatora.

Zarządzana tożsamość musi mieć dostęp do odczytu do docelowego zasobu. Jeśli zapytania później nie wydadzą błędu uprawnień, przyznaj dostęp do odczytu tej tożsamości i spróbuj zapytania ponownie.

Krok 3: Ustaw narzędzia do zapytań

W kroku narzędzi konfiguracyjnych włącz operacje odczytujące telemetrię. Operacje zapytań są rdzeniem złącza telemetrycznego, więc wybierz operacje run-query lub search. Wyłącz operacje administracyjne, chyba że są potrzebne.

Ustaw każdą operację odczytu na Pozwól, aby agent mógł odpowiadać na pytania bez pauzy. Jeśli włączysz dowolną operację zmieniającą dane, ustaw ją na Ask.

Dla Azure Data Explorer do Azure MCP kreator zawiera krok grupowy klastra oraz krok przeglądu z testowaniem połączenia. Konfiguruj grupy klastra, testuj łączność i zapisuj złącze. Zestaw narzędzi Kusto obsługiwany jest przez ścieżkę Azure MCP Kusto.

Wskazówka

Utrzymuj zestaw włączony na mały. Złącze telemetryczne zazwyczaj potrzebuje tylko swoich operacji zapytań. Mniej narzędzi oznacza, że agent wybiera właściwe bardziej niezawodnie i mieści się w budżecie 80 narzędzi.

Krok 4: Zweryfikowaj pytanie

  1. Otwórz czat ze swoim agentem.

  2. Zadaj pytanie, które wymaga twojej telemetrii. Przykład:

    How many errors were logged in the last hour, grouped by service?

  3. Zobacz odpowiedź. Karta narzędzi pokazuje, że agent wybiera narzędzie zapytania łącznika i uruchamia zapytanie, a następnie otrzymuje odpowiedź opartą na twojej telemetrii.

Gdy widzisz rzeczywistą liczbę z własnego źródła zamiast ogólnego wyjaśnienia, łącznik działa od początku do końca.

Troubleshooting

Problem Cause Napraw.
Zapytanie zwraca "Nieautoryzowane" lub "Zakazane" Tożsamość połączenia nie ma dostępu do odczytu Udziel tożsamości dostępu do odczytu do docelowego zasobu, a następnie spróbuj ponownie.
Zapytanie zwraca "nie znaleziono" Niewłaściwa nazwa przestrzeni roboczej, klastra, bazy danych lub tabeli Potwierdź dokładną nazwę w usługie. Nazwy są wrażliwe na wielkość liter.
Złącze zewnętrzne firmy nie może się połączyć URL, token lub wartość nagłówka jest błędna Potwierdź wartości z administratorem obserwacji i zaktualizuj złącze.
Odpowiedź jest ogólna i nie pojawia się żadna karta narzędzi Pytanie nie wymagało twojej telemetrii Przeformułuj pytanie tak, aby wymagało twojej telemetrii, na przykład "policz nieudane żądania w usłudze X za ostatni dzień."
Złącze zapisane, ale telemetria nie wróciła Wynik pusty lub filtrowany Poszerz zakres czasowy w swoim pytaniu, albo popewnij, że źródło ma najnowsze dane telemetryczne.

Treści powiązane

  • Last updated on