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 dochodzeniowe w prostym języku. Agent uruchamia zapytanie i odpowiada liczbami rzeczywistymi.

Ten samouczek obejmuje konektory z kategorii Telemetry. Azure Data Explorer korzysta z path 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 odbywa się uwierzytelnianie źródeł, które operacje włączyć oraz jak walidować za pomocą zapytania.

Important

Zarządzane złącza są w wersji zapoznawczej. Dostępność łączników, pól i operacji może 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 odczytu źródła telemetrii, z którym się łą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 Skonfiguruj zarządzane złącze, aby wyświetlić pełny przewodnik kreatora. 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 Przeglądaj logi 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 łącznik Dzienniki wyszukiwania i indeksowana telemetria
Dynatrace Dynatrace Dane uwierzytelniające usługi wyświetlane przez złącze Wyszukaj dane observability i ślady
New Relic New Relic Poświadczenia usługi wyświetlane przez łącznik Telemetria dotycząca zapytań i incydentów
Splunk Splunk Poświadczenia usługi wyświetlane przez łącznik Wyszukaj logi i wydarzenia Splunk
Hawkeye (NeuBird) Hawkeye autorstwa NeuBird Dane logowania usługi wyświetlane przez łącznik Przeszukaj dane observability 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 konektor dostarczony przez użytkownika. Używaj tej opcji, gdy Twój zespół ma własne narzędzie lub źródło, które nie jest wymienione w selektorze łączników.

Krok 1: Dodaj złącze

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

  2. W lewym pasku bocznym wybierz Build + konfiguracja>Extensions>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óra korzysta ze ścieżki Azure MCP Kusto.

Krok 2: Uwierzytelnij się

Dla łączników telemetrycznych platformy Azure:

  1. Uzupełnij pola pokazane przez konektor.

    • W Azure Data Explorer nazwij łącznik, wybierz tożsamość zarządzaną, której agent używa do wykonywania zapytań w usłudze Kusto, a następnie dodaj jedną lub więcej grup klastrów z adresami URL klastra.
    • W przypadku Log Analytics Workspace wybierz obszar roboczy z selektora obszaru roboczego lub ręcznie wprowadź identyfikator zasobu ARM obszaru roboczego.
    • W przypadku Application Insights wybierz zasób Application Insights w selektorze zasobów lub ręcznie wprowadź identyfikator zasobu ARM.

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

  3. Przejdź do etapu przeglądu, klastra lub wyboru narzędzi pokazanego w kreatorze.

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

Krok 3: Skonfiguruj narzędzia zapytań

W kroku Konfigurowanie narzędzi włącz operacje odczytujące telemetrię. Operacje zapytań są rdzeniem konektora telemetrii, więc wybierz operacje run-query lub search. Pozostaw operacje administracyjne wyłączone, 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 Pytaj.

W przypadku usługi Azure Data Explorer za pośrednictwem Azure MCP kreator zawiera krok grupy klastra oraz krok przeglądu z testowaniem połączenia. Konfiguruj grupy klastra, testuj łączność i zapisuj konektor. Zestaw narzędzi Kusto obsługiwany jest przez ścieżkę Azure MCP Kusto.

Wskazówka

Utrzymuj niewielki zestaw włączonych elementów. Złącze telemetryczne zazwyczaj wymaga jedynie 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: Zweryfikuj za pomocą pytania

  1. Otwórz czat ze swoim agentem.

  2. Zadaj pytanie, które wymaga danych telemetrycznych. Przykład:

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

  3. Obserwuj odpowiedź. Karta narzędzi pokazuje, że agent wybiera narzędzie zapytania łącznika i uruchamia zapytanie, po czym wyświetlana jest odpowiedź oparta na twojej telemetrii.

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

Troubleshooting

Problem Cause Napraw.
Zapytanie zwraca „Brak autoryzacji” lub „Zabronione” 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.
Łącznik innej firmy nie może się połączyć URL, token lub wartość nagłówka jest błędna Potwierdź wartości z administratorem ds. obserwowalności i zaktualizuj konektor.
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 danych telemetrycznych, na przykład „policz nieudane żądania w usłudze X za ostatni dzień.”
Łącznik zapisany, 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

  • Ostatnia aktualizacja o