Samouczek: testowanie narzędzia na placu zabaw w agencie SRE platformy Azure

W tym samouczku użyjesz środowiska testowego w Portalu Agenta Azure SRE, aby przetestować i debugować narzędzia przed wdrożeniem. Plac zabaw umożliwia wykonywanie narzędzi w izolacji przy użyciu niestandardowych parametrów i natychmiastowego przeglądania wyników.

W tym poradniku nauczysz się, jak:

  • Uzyskiwanie dostępu do testowego środowiska zabaw dla dowolnego narzędzia
  • Testowanie narzędzia Kusto za pomocą zapytań na żywo
  • Testowanie narzędzia systemowego przy użyciu parametrów niestandardowych
  • Przed wdrożeniem sprawdź wyniki

Szacowany czas: 5 minut

Wymagania wstępne

Przed rozpoczęciem upewnij się, że masz następujące elementy:

Otwórz plac zabaw

Przejdź do testowego placu zabaw na Płótnie Agenta.

  1. Otwórz portal agenta SRE i wybierz agenta.
  2. Wybierz Płótno agenta budowniczego>.
  3. Wybierz pozycję Testowy plac zabaw w przełączniku widoku (obok pozycji Widok kanwy i Widok tabeli).

Zrzut ekranu przedstawiający widok przestrzeni testowej z pustym stanem oraz niestandardowego agenta i selektora narzędzi u góry.

Na placu zabaw jest wyświetlany pusty stan z selektorem agenta niestandardowego/narzędzia u góry i komunikatem "Wybierz agenta lub narzędzie, aby rozpocząć sesję placu zabaw".

Wybieranie narzędzia

Wybierz narzędzie, które chcesz przetestować z selektora jednostek.

  1. Wybierz menu rozwijane Agent niestandardowy/Narzędzie znajdujące się u góry.
  2. Przeglądaj lub wyszukaj listę. Każdy wpis zawiera etykietę podrzędną wskazującą jego typ, taki jak Autonomiczny dla agentów niestandardowych, Wbudowane narzędzie dla narzędzi systemowych lub Narzędzie Kusto dla narzędzi Kusto .
  3. Wybierz narzędzie, które chcesz przetestować.
  4. Wybierz i zastosuj.

Zrzut ekranu przedstawiający listę rozwijaną selektora jednostek z agentami i narzędziami dostępnymi do testowania.

Plac zabaw ładuje konfigurację i interfejs testowy wybranego narzędzia.

Testowanie narzędzia Kusto

Jeśli wybrano narzędzie Kusto, wykonaj następujące kroki, aby go przetestować.

  1. Przejrzyj panel po lewej stronie, który pokazuje konfigurację zapytania (klaster, baza danych, tekst zapytania i definicje parametrów).
  2. W prawym panelu wypełnij wszystkie wartości parametrów wymagane przez zapytanie.
  3. Wybierz Uruchom test.

Panel testowy zawiera następujące informacje:

  • Stan powodzenia lub niepowodzenia
  • Liczba zwróconych wierszy i kolumn
  • Wyniki zapytania wyświetlane w tabeli
  • Czas wykonywania w milisekundach

Zielony wskaźnik powodzenia potwierdza, że zapytanie działa poprawnie względem połączonego klastra.

Uwaga / Notatka

Przycisk Zapisz jest wyłączony do momentu pomyślnego uruchomienia testu. Ten warunek zapewnia zapisywanie tylko zapytań, które rzeczywiście działają względem klastra.

Wskazówka

Jeśli zapytanie zwraca nieoczekiwane wyniki, dostosuj język KQL i ponownie wybierz pozycję Uruchom test . Można iterować bez opuszczania placu zabaw.

Testowanie narzędzia systemowego

Jeśli wybierzesz narzędzie systemowe, wykonaj następujące kroki, aby go przetestować.

  1. Przejrzyj panel po lewej stronie, który zawiera informacje o narzędziu (nazwa, opis, wtyczka i kategoria).
  2. W prawym panelu wypełnij wymagane wartości parametrów.
  3. Wybierz Wykonaj narzędzie.

Narzędzie wykonuje i wyświetla dane wyjściowe JSON w edytorze osadzonym. Sprawdź, czy dane wyjściowe są zgodne z oczekiwanym zachowaniem danych wejściowych.

Weryfikowanie i iterowanie

Po przetestowaniu przejrzyj wyniki i dostosuj je zgodnie z potrzebami.

  • Narzędzie Kusto: jeśli wyniki są niepoprawne, dostosuj zapytanie w języku KQL i uruchom je jeszcze raz. Wybierz pozycję Zapisz , gdy zapytanie jest poprawne. Zapisywanie jest włączone tylko po pomyślnym uruchomieniu testu.
  • Narzędzie systemowe: jeśli dane wyjściowe są nieoczekiwane, sprawdź wartości parametrów i wykonaj je ponownie.

Zmiany w narzędziach Kusto są zapisywane po wybraniu pozycji Zapisz. Narzędzia systemowe nie wymagają zapisywania, ponieważ są wykonywane przy użyciu podanego parametru.

Troubleshooting

Skorzystaj z poniższych informacji, aby rozwiązać typowe problemy.

W selektorze nie są wyświetlane żadne narzędzia

Musisz utworzyć co najmniej jedno narzędzie. Na pasku narzędzi Agent Canvas wybierz Utwórz>narzędzie>Kusto, aby je utworzyć.

Narzędzie Kusto wyświetla komunikat "Brak skonfigurowanych łączników"

Test narzędzia Kusto wymaga łącznika danych. Przejdź do Builder>Connectors i dodaj łącznik Azure Data Explorer przy użyciu adresu URL klastra i bazy danych. Następnie wróć do placu zabaw i ponownie wybierz narzędzie Kusto.

Test Kusto pokazuje błąd autoryzacji

Agent musi mieć dostęp do klastra Kusto. Sprawdź następujące elementy:

  • Skonfigurowałeś łącznik danych dla klastra w Builderze>Łączniki.
  • Poświadczenia łącznika mają uprawnienia zapytania do docelowej bazy danych.

Narzędzie systemowe zwraca błąd

Sprawdź następujące elementy:

  • Wszystkie wymagane parametry zostały wypełnione.
  • Wartości parametrów są zgodne z oczekiwanym formatem (ciągami, liczbami i podobnymi wartościami).
  • Nazwa narzędzia i wtyczka są poprawnie skonfigurowane.

Narzędzia języka Python nie są wyświetlane na liście

Narzędzia języka Python mają własny interfejs testowy w edytorze narzędzi języka Python. Otwórz edytor z płótna Agenta. Aby przetestować narzędzie języka Python, użyj wbudowanego panelu testowego w edytorze.

Następne kroki

Tworzenie narzędzia języka Python

Treści powiązane

  • Last updated on