Download the PHP package michalkortas/pingme-now without Composer

PingMe Now

Agent monitoringu dla aplikacji Laravel 9–13, współpracujący z self-hosted hubem PingMe. Wymaga PHP 8.1 lub nowszego.

Paczka cyklicznie wysyła do huba stan aplikacji, kolejki, schedulera, bazy danych, cache, dysków, logów oraz wersje zależności Composer i npm. Zawiera również skrypty raportujące backupy wykonywane poza Laravelem.

Instalacja

Bezpieczna rejestracja przez MCP

Jeśli administrator zarządza Hubem przez MCP, agent może zgłosić aplikację bez kopiowania tokenu przez terminal lub rozmowę z agentem:

Administrator zatwierdza oczekujące zgłoszenie narzędziem MCP enrollments.approve, wskazując grupę. Następnie na serwerze aplikacji uruchom:

Agent generuje lokalną parę kluczy i zapisuje prywatny stan zgłoszenia z uprawnieniami 0600. Hub szyfruje token kluczem publicznym agenta. Token jest odszyfrowywany bezpośrednio na serwerze aplikacji, zapisywany w .env i nie pojawia się w odpowiedzi MCP ani w komunikatach polecenia.

Rejestracja ręczna

Najpierw utwórz aplikację w hubie PingMe i skopiuj wygenerowany dla niej token integracyjny.

Zainstaluj paczkę:

Uruchom konfigurator:

Konfigurator kolejno zapyta o:

1. adres huba, np. https://pingme.example.com,
2. token integracyjny wygenerowany w konfiguracji aplikacji.

Połączenie zostanie sprawdzone, skrypty backupowe opublikowane do katalogu scripts/, a pierwszy pełny status natychmiast wysłany do huba.

Instalacja bez interakcji, przydatna podczas deploymentu:

Polecenie zapisuje w .env:

Token przypisany jest do jednej aplikacji. Nie należy go umieszczać w repozytorium ani współdzielić między aplikacjami.

Ręczne wysłanie statusu

Polecenie wyświetla wynik połączenia i najważniejsze zebrane metryki. Można go użyć po wdrożeniu albo do diagnostyki integracji.

Scheduler

Paczka automatycznie rejestruje pingme:now --quiet w Laravel Scheduler i uruchamia go co minutę z ochroną przed nakładaniem wykonań. Nie trzeba dopisywać zadania do routes/console.php ani app/Console/Kernel.php.

Na serwerze musi działać standardowy scheduler Laravela, np. z crona:

W Dockerze można uruchomić osobny kontener/proces:

Zbierane informacje

• wersja Laravel i PHP, środowisko oraz hostname,
• dostępność bazy danych i cache,
• heartbeat schedulera,
• test kolejki oraz liczba nieudanych jobów z ostatnich 24 godzin,
• całkowite i wolne miejsce na wskazanych dyskach,
• certyfikat SSL sprawdzany z sieci aplikacji,
• logi na poziomie error lub wyższym,
• lokalny bufor logów na wypadek czasowej niedostępności huba,
• pakiety z composer.lock,
• pakiety z package-lock.json,
• statusy backupów przekazane przez dołączone skrypty.

Hasła, tokeny, nagłówki autoryzacyjne, cookies i klucze API są maskowane przed zapisaniem logu do bufora i wysłaniem do huba.

Konfiguracja

Wszystkie ustawienia są opcjonalne poza adresem huba i tokenem:

Po ręcznej zmianie konfiguracji w środowisku produkcyjnym odśwież cache:

Backupy wykonywane poza aplikacją

pingme:install publikuje trzy pliki:

Skrypty korzystają ze zmiennych środowiskowych PINGME_URL i PINGME_TOKEN. Token powinien należeć do monitorowanej aplikacji.

Debian / Bash

Zgłoszenie aktualnego stanu katalogu z backupami:

Uruchomienie istniejącego skryptu backupowego z raportowaniem rozpoczęcia, powodzenia lub błędu:

Przykład z pg_dump:

Windows CMD / PowerShell

Bezpośrednio z PowerShell:

Raport zawiera nazwę i wynik backupu, czas wykonania, liczbę plików, łączny rozmiar, rozmiar najnowszego pliku oraz datę najstarszej i najnowszej kopii.

Aktualizacja

Wymagania

• PHP 8.1+,
• Laravel 9–13,
• działający Laravel Scheduler,
• dostęp HTTPS do huba PingMe,
• curl, find, awk i GNU date dla skryptu Bash,
• PowerShell dla wariantu Windows.

Licencja

MIT