query-axiom-logs
Debuguj aplikację poprzez analizę logów z Axiom – szybki dostęp do danych telemetrycznych
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Umiejętność do przeszukiwania i analizy logów z platformy Axiom na potrzeby debugowania. Masz dostęp do pięciu zbiorów danych: logów serwera, zdarzeń agenta, telemetrii sandboxa (system, metryki, sieć). Narzędzie pracuje w trybie tylko do odczytu – nie możesz zapisywać ani ingestionować danych. Obsługuje zapytania w języku APL z filtrowaniem po poziomie błędu, wyszukiwaniem tekstu, zakresami czasowymi i projekcją pól. Wyniki wyświetla w formacie tabelarycznym lub JSON.
Jak używać
Upewnij się, że token Axiom jest dostępny w pliku turbo/apps/web/.env.local pod kluczem AXIOM_TOKEN. Jeśli brakuje tokena, uruchom skrypt synchronizacji: ./scripts/sync-env.sh – pobierze on zmienne środowiskowe z 1Password.
Wybierz odpowiedni zbiór danych do zapytania: vm0-web-logs-dev dla logów serwera (błędy, ostrzeżenia, wywołania API), vm0-agent-run-events-dev dla zdarzeń wykonania agenta, vm0-sandbox-telemetry-system-dev dla logów konsoli sandboxa, vm0-sandbox-telemetry-metrics-dev dla metryk zasobów (CPU, pamięć, dysk) lub vm0-sandbox-telemetry-network-dev dla żądań HTTP. W środowisku produkcyjnym zamień sufiks -dev na -prod.
Sformułuj zapytanie w języku APL, korzystając z operatorów filtrowania (where level == "error"), wyszukiwania tekstu (search "connection refused"), zakresu czasowego (where _time > now(-1h)) i projekcji pól (project _time, message).
Wykonaj zapytanie za pomocą komendy: source turbo/apps/web/.env.local && axiom query "TWOJE_ZAPYTANIE_APL" -T "$AXIOM_TOKEN" -f table. Użyj flagi -f table dla wyniku czytelnego dla człowieka lub -f json do dalszego przetwarzania.
Przeanalizuj wyniki – tabela pokaże pola wybrane w projekcji, posortowane domyślnie po czasie. Możesz zawęzić wyniki dodając limit 100 na koniec zapytania APL.
Pamiętaj, że ta umiejętność działa wyłącznie w trybie odczytu – nigdy nie ingestionuj ani nie modyfikuj danych w Axiom.