czy uptime-kuma ofertuje API do pobrania statusów?
- User
czy uptime-kuma ofertuje API do pobrania statusów?
Assistant
Tak, Uptime Kuma oferuje API, które umożliwia programowy dostęp do statusów monitorów oraz zarządzanie nimi.
Jest to API typu RESTful. Za jego pomocą możesz między innymi:
- Pobierać statusy wszystkich monitorów: Zazwyczaj głównym endpointem do tego celu jest
/api/monitors. Wywołanie go metodą GET zwraca listę wszystkich skonfigurowanych monitorów wraz z ich aktualnym stanem (np.up,down,pending). - Zarządzać monitorami: Możesz dodawać nowe monitory, usuwać istniejące lub modyfikować ich konfigurację za pomocą odpowiednich żądań POST, PUT, DELETE do dedykowanych endpointów.
Jak uzyskać dostęp do API:
- Wygeneruj Token API: W interfejsie Uptime Kuma przejdź do
Ustawienia(Settings) ->Ustawienia ogólne(General Settings) i tam znajdziesz opcję do wygenerowania lub podejrzeniaTokenu API(API Token). - Użyj Tokenu w nagłówku: Podczas wysyłania żądań do API, musisz dołączyć ten token w nagłówku
Authorizationw formacieUPTIMEKUMA_API_TOKEN <TWÓJ_TOKEN>. - Adres API: API jest dostępne pod adresem Twojej instancji Uptime Kuma, zazwyczaj z dopiskiem
/api/.... Na przykład:http://<twoj-uptime-kuma-host>:<port>/api/monitors.
API jest bardzo przydatne do integracji Uptime Kuma z innymi systemami monitorowania, dashboardami (np. Grafana, Home Assistant) czy do automatyzacji zadań.
- Pobierać statusy wszystkich monitorów: Zazwyczaj głównym endpointem do tego celu jest
- User
jak wejść do panelu administracyjnego uptime-kuma?
Assistant
Panel administracyjny Uptime Kuma to zasadniczo jego główny interfejs użytkownika. Nie ma oddzielnego, dedykowanego panelu administracyjnego, do którego trzeba logować się osobno.
Oto jak uzyskać do niego dostęp:
-
Znajdź adres URL swojej instancji Uptime Kuma: Podczas instalacji Uptime Kuma (np. za pomocą Docker, Node.js, itp.) ustawiłeś dla niego adres, pod którym jest dostępny. Zazwyczaj jest to:
http://localhost:3001(jeśli uruchamiasz na swoim komputerze i nie zmieniłeś portu)http://<IP_Twojego_Serwera>:3001(jeśli uruchamiasz na serwerze i używasz jego adresu IP)https://twojadomena.com(jeśli skonfigurowałeś własną domenę i dostęp przez HTTPS)
-
Pierwsze uruchomienie - Utworzenie konta administratora: Przy pierwszym otwarciu tego adresu URL w przeglądarce, Uptime Kuma poprosi Cię o utworzenie pierwszego użytkownika (administratora). Zostaniesz poproszony o podanie:
- Adresu e-mail
- Hasła
To konto będzie miało pełne uprawnienia administracyjne do zarządzania wszystkimi monitorami i ustawieniami.
-
Logowanie po pierwszym uruchomieniu: Po utworzeniu pierwszego konta, interfejs przełączy się na ekran logowania. Aby uzyskać dostęp do panelu administracyjnego, użyj e-maila i hasła, które podałeś podczas tworzenia pierwszego użytkownika.
Podsumowując:
- Wpisz adres URL swojej instancji Uptime Kuma w przeglądarce.
- Jeśli to pierwsze uruchomienie, utwórz konto administratora.
- Jeśli konto już istnieje, zaloguj się przy użyciu swoich danych logowania (e-mail i hasło).
Co jeśli zapomniałeś hasła?
Uptime Kuma nie posiada wbudowanego mechanizmu "resetuj hasło" w interfejsie. Najprostszym sposobem na odzyskanie dostępu administracyjnego jest:
- Usunięcie danych konfiguracyjnych Uptime Kuma (zazwyczaj katalog
/data, jeśli używasz Dockera lub podobnej metody instalacji). - Ponowne uruchomienie Uptime Kuma. Spowoduje to reset do stanu fabrycznego i ponowne wyświetlenie ekranu tworzenia pierwszego użytkownika.
Uwaga: Usunięcie danych konfiguracyjnych spowoduje utratę wszystkich dotychczasowych monitorów i ustawień.
-
- User
napisz mi polecenie wget lub curl dla /api/service-list, z tokenem API
Assistant
Jasne, oto polecenia
curliwget, aby pobrać listę monitorów (usług) z Uptime Kuma za pomocą API, używając tokenu:Ważna uwaga: Domyślny i obecnie udokumentowany endpoint do pobierania listy monitorów w Uptime Kuma to
/api/monitors. Endpoint/api/service-listmógł być używany w starszych wersjach lub jest nieprawidłowy. Poniższe polecenia używają poprawnego endpointu/api/monitors. Jeśli masz pewność, że potrzebujesz/api/service-list, po prostu zamień/api/monitorsna/api/service-listw poleceniach.Zanim zaczniesz:
- Znajdź swój Token API w Uptime Kuma:
- Przejdź do
Settings(Ustawienia) ->General Settings(Ustawienia ogólne). - Znajdź sekcję
API Tokeni skopiuj swój token.
- Przejdź do
- Zastąp
<TWOJ_TOKEN_API>swoim rzeczywistym tokenem. - Zastąp
<URL_TWOJEJ_INSTANCJI_UPTIME_KUMA>pełnym adresem URL Twojej instancji Uptime Kuma (np.http://localhost:3001,http://192.168.1.100:3001,https://kuma.twojastrona.com).
1. Używając
curl(zalecane)curljest bardziej wszechstronny do interakcji z API.curl -H "Authorization: UPTIMEKUMA_API_TOKEN <TWOJ_TOKEN_API>" http://<URL_TWOJEJ_INSTANCJI_UPTIME_KUMA>/api/monitorsWyjaśnienie:
curl: Polecenie do wysyłania żądań HTTP.-H "Authorization: UPTIMEKUMA_API_TOKEN <TWOJ_TOKEN_API>": Dodaje nagłówekAuthorizationz Twoim tokenem API. To sposób uwierzytelnienia.http://<URL_TWOJEJ_INSTANCJI_UPTIME_KUMA>/api/monitors: Adres URL endpointu API.
2. Używając
wgetwgetjest narzędziem do pobierania plików, ale można go również użyć do wysyłania żądań API i wyświetlania wyników.wget --header="Authorization: UPTIMEKUMA_API_TOKEN <TWOJ_TOKEN_API>" -qO- http://<URL_TWOJEJ_INSTANCJI_UPTIME_KUMA>/api/monitorsWyjaśnienie:
wget: Polecenie do pobierania danych z sieci.--header="Authorization: UPTIMEKUMA_API_TOKEN <TWOJ_TOKEN_API>": Dodaje nagłówek uwierzytelniający.-q: Opcja "quiet" (cichy) - minimalizuje komunikatywget.-O-: Wysyła pobraną zawartość na standardowe wyjście (stdout), zamiast zapisywać do pliku.http://<URL_TWOJEJ_INSTANCJI_UPTIME_KUMA>/api/monitors: Adres URL endpointu API.
Przykład użycia (zakładając, że Uptime Kuma działa lokalnie na porcie 3001, a token to
abcdef12345):Używając
curl:curl -H "Authorization: UPTIMEKUMA_API_TOKEN abcdef12345" http://localhost:3001/api/monitorsUżywając
wget:wget --header="Authorization: UPTIMEKUMA_API_TOKEN abcdef12345" -qO- http://localhost:3001/api/monitorsOba polecenia powinny zwrócić odpowiedź w formacie JSON zawierającą listę Twoich monitorów i ich statusy. Możesz przetworzyć ten JSON za pomocą narzędzi takich jak
jqdla łatwiejszej analizy.- Znajdź swój Token API w Uptime Kuma:
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.