Dzwonił twój skrypt monitorujący Graylog — chce przejść na emeryturę

🌐 Także w: English · Deutsch · Français · Español · Italiano · Português · Nederlands
🔍 Czasem poboczny projekt zaczyna się od problemu w pracy, a nie w homelabie. Tak było tym razem: zawodowo ujarzmiam obecnie Grayloga jako platformę do zarządzania logami i potrzebowałem do niego porządnych pluginów monitorujących — zarówno dla Icinga2, jak i dla Zabbixa. Na pewno ktoś już to rozwiązał, prawda? Prawda?? 😅
Spis treści
📉 Rozczarowująca część: przeszukiwanie Google i GitHuba
Mój pierwszy ruch był oczywisty — znaleźć kogoś, kto już to zbudował, bo wymyślanie koła na nowo jest dla frajerów. Wyniki były, delikatnie mówiąc, rozczarowujące. To, co istniało, było albo skrajnie minimalistyczne (jeden zahardkodowany check, zero progów, monitoringowy odpowiednik czujnika dymu bez baterii), albo naprawdę prastare — niektóre repozytoria nie widziały commita od nawet dziesięciu lat. REST API Grayloga mocno się zmieniło od czasu, gdy ostatni raz dotknęła tych pluginów ludzka ręka. Niezbyt budująca podstawa dla monitoringu. 🦕
💡 Lekko szalony pomysł
Wpadłem więc na coś, co hojnie nazwę „genialnym pomysłem”: niech Claude postawi Grayloga, Icinga2 i Zabbixa na moim własnym serwerze przez Docker Compose i po prostu... zbuduje pluginy od zera, testując wszystko na żywo na prawdziwej działającej instancji, zamiast kopiować z dziesięcioletniego wpisu na blogu i liczyć na najlepsze. 🐳
Poprosiłem ChatGPT o listę najważniejszych checków i metryk wartych monitorowania w Graylogu — zajętość journala, kondycja klastra indeksera, stany inputów, przepustowość, kondycja węzłów, tego typu rzeczy. Właściwe zadanie dla Claude’a brzmiało: zaimplementować checki, przetestować prawdziwe wywołania API na żywej instancji i poprawić/zweryfikować parsowanie JSON-a względem tego, co Graylog faktycznie zwraca, a nie tego, co twierdzi dokumentacja sprzed trzech głównych wersji.
🧠 Gdzie skończyła się wyuczona wiedza
Claude miał z treningu sporą dawkę wcześniejszej wiedzy o REST API Grayloga — nazwy endpointów, ogólny kształt rzeczy. Część z niej się sprawdziła. Część zdecydowanie nie: kilka zakładanych nazw pól JSON po prostu już nie istnieje, a zachowanie co najmniej jednego endpointu (checku statusu load balancera, który sygnalizuje stan surowym kodem statusu HTTP zamiast ciałem JSON, bo po co ułatwiać) było po cichu błędne od pierwszego dnia. Okazuje się, że zgadywanie z pamięci zaprowadzi cię tylko do pewnego momentu przy API, które miało trzy lata na dryfowanie. 🎯
Co naprawdę zamknęło lukę: dałem Claude’owi pełny eksport OpenAPI wyciągnięty prosto z mojej własnej instancji Grayloga. Dzięki temu mógł porównać każdy zakładany endpoint i nazwę pola z prawdziwą, aktualną specyfikacją — a ponieważ pozwoliłem mu też zbudować żywe środowisko testowe w Dockerze, mógł pójść krok dalej i faktycznie wykonać wywołania, zamiast tylko o nich czytać jak jakiś turysta API. Oba prawdziwe bugi, które w ten sposób znalazł, wyszły dopiero w czasie działania, a nie przy czytaniu dokumentacji. 🐛➡️✅
Bonusowy zwrot akcji: w połowie zauważyłem, że całe stanowisko testowe po cichu działało na Graylogu 6.1, podczas gdy specyfikacja OpenAPI, którą przekazałem, była dla 7.1.3. Klasyczny moment „u mnie (na złej maszynie) działa”. Wyłapałem to w trakcie przeglądu, kazałem przebudować środowisko na właściwej wersji i z czystej paranoi kazałem Claude’owi puścić cały zestaw testów od początku do końca jeszcze raz. Dobra wiadomość: oba znalezione bugi były identyczne w obu wersjach — nic specyficznego dla wersji, po prostu od początku naprawdę błędne założenia. Mimo to lepiej przyznać się do niezgodności, niż po cichu udawać, że jej nie było. 🙈
✅ Wynik
Wyszły z tego dwie osobne, porządnie natywne implementacje checków — a nie jedna owinięta taśmą wokół drugiej i fajrant. Icinga2 dostaje klasyczny plugin w stylu Nagiosa (exit codes, OK/WARNING/CRITICAL, perfdata, pełen pakiet). Zabbix dostaje zamiast tego własną idiomatyczną wersję, w której każdy check raportuje surową wartość, a właściwe progi mieszkają w triggerach Zabbixa — bo tak Zabbix chce być karmiony, a nie dlatego, że tryb natywny był leniwą opcją (zdecydowanie nie był — zapytaj mnie kiedyś o parsowanie formatu JSON z Low-Level Discovery Zabbixa). Oba przetestowano też na żywej, działającej instancji Icinga2/Zabbix, a nie tylko na samym Graylogu — łącznie z obserwowaniem, jak prawdziwy trigger Zabbixa przeskakuje na zawołanie w stan „problem”, co dało nieproporcjonalnie dużo satysfakcji jak na sobotę. 📡
Wszystko — pluginy, instrukcja instalacji i pełna dokumentacja — jest publiczne:
github.com/aptupgrademe/graylog-checks
Jeśli utknąłeś z monitorowaniem Grayloga dziesięcioletnim skryptem Nagiosa z przypadkowego repo na GitHubie, mam nadzieję, że to oszczędzi ci archeologii. 🏺
