ThinkWatch è il watchdog che si installa sui siti collegati a ThinkRepo, il repository dei plugin ThinkClouds. Quando il repository lo interroga con una richiesta firmata, il plugin risponde con un resoconto dello stato interno del sito: database, cron, spazio su disco, errori fatali, email non inviate, aggiornamenti in sospeso. In più avvisa subito il repository quando succede qualcosa di grave. È pensato per chi gestisce più siti WordPress con ThinkRepo e vuole un controllo che vada oltre la semplice raggiungibilità della home.
Registrazione senza chiavi da copiare
All’attivazione ThinkWatch genera una chiave propria e si registra presso il repository, autenticandosi con lo stesso segreto del sito che la libreria ThinkClouds Updater usa per gli aggiornamenti. Non c’è quindi nessuna chiave da copiare a mano: basta che il sito sia approvato in ThinkRepo → Siti. La registrazione si rinnova ogni giorno con WP-Cron e, se il cron non gira, viene ritentata dalla bacheca al massimo una volta all’ora quando l’ultima risale a più di una settimana prima.
L’indirizzo del repository è di serie https://thinkclouds.com e si cambia con la costante THINKCLOUDS_REPO_URL.
Resoconto firmato per il repository
Il repository chiama la rotta GET /wp-json/thinkwatch/v1/pulse con una firma HMAC SHA-256 calcolata sulla chiave del sito, su un valore casuale e sull’ora; richieste con firma errata o più vecchie di cinque minuti vengono respinte. La risposta è a sua volta firmata con la stessa chiave e porta intestazioni che ne impediscono la memorizzazione nelle cache.
Il resoconto contiene le versioni di WordPress e PHP, l’esito e il tempo di una query di prova al database, il numero di eventi cron in ritardo di oltre un’ora e se WP-Cron è disattivato, lo spazio libero su disco, gli errori fatali e le email fallite degli ultimi sette giorni, il numero di aggiornamenti disponibili per core, plugin e temi, il riepilogo di Salute del sito se disponibile, le versioni dei plugin ThinkClouds installati e lo stato di WP_DEBUG. Con questi dati ThinkRepo decide se aprire un incidente e mandare l’avviso su Telegram.
Eventi immediati
Alcune cose non possono aspettare il controllo successivo. Un errore fatale di PHP viene intercettato alla chiusura della richiesta, registrato con file e riga (con i percorsi resi relativi alla cartella di WordPress) e inviato subito al repository come evento firmato; errori identici ripetuti entro un minuto non si duplicano. Lo stesso accade quando un aggiornamento automatico di WordPress fallisce. Le email che wp_mail non riesce a spedire vengono invece annotate nel registro locale e consegnate con il resoconto.
Pagina di stato
In Strumenti → ThinkWatch si vedono l’indirizzo del repository, lo stato della registrazione (in attesa, approvato, revocato, oppure escluso dal monitoraggio), l’ora dell’ultimo controllo ricevuto e gli errori fatali e le email non inviate degli ultimi sette giorni. Tre pulsanti permettono di registrare di nuovo il sito, inviare un evento di prova per verificare che l’avviso arrivi e svuotare i registri.
Integrazione con l’ecosistema ThinkClouds
ThinkWatch si aggiorna da ThinkRepo tramite la libreria ThinkClouds Updater e pubblica un manifesto ThinkClouds con un controllo di salute sullo stato della registrazione. Chiave e registri sono dichiarati come stato locale, quindi non vengono copiati nelle migrazioni tra siti.
Requisiti
- WordPress 6.2 o successivo
- PHP 7.4 o successivo
- Un repository ThinkRepo raggiungibile, con il sito approvato
Download riservato alle persone autorizzate: ti chiederemo la tua email e un codice di conferma.
Novità per versione
1.1.0 03/11/2026
Nessuna nota per questa versione.
