Status page
Pagine pubbliche che dicono ai tuoi utenti cosa funziona. Si creano nella pagina status dell'interfaccia web.
──Creare una pagina
Scegli titolo, slug e monitor, nell'ordine che vuoi. Puoi anche aggiungere interi gruppi: ogni monitor del gruppo viene mostrato, anche quelli aggiunti in seguito, e ogni gruppo è una sezione con il suo stato. Scegli se mostrare gli incidenti passati. anteprima mostra la pagina come la vedranno i visitatori, prima di salvare.
Una pagina pubblicata è pubblica su https://<hub>/status/<slug>/. Le bozze sono visibili solo agli utenti con
accesso. I visitatori vedono nomi dei monitor, stato, storico giornaliero dell'uptime e orari degli incidenti, mai
destinazioni, località o messaggi di errore. Lo storico copre il periodo di conservazione, fino a 90 giorni.
──Dominio personalizzato
Per servire una pagina sul suo dominio (per esempio status.example.com), impostalo sulla pagina, punta un record DNS
(CNAME o A) dell'host verso l'hub e instrada l'host verso pingtxt nel tuo reverse proxy,
con il suo certificato TLS. Su quell'host pingtxt serve solo la status page, su /: interfaccia web e API non sono
raggiungibili da lì.
──Password
Per tenere privata una pagina, attiva proteggi con una password. I visitatori vedono allora un modulo per la password; quella giusta apre la pagina per 30 giorni in quel browser, insieme ai suoi badge e al modulo di iscrizione. La password è salvata come hash, i tentativi sbagliati sono limitati e cambiarla disconnette tutti i visitatori. Agli utenti con accesso non serve mai.
──Link del nome e logo
- link del nome: cliccando il nome o il logo della pagina si apre questo indirizzo, per esempio il tuo sito.
- logo: SVG, PNG, JPEG, GIF, WebP o AVIF, fino a 4 MB, caricato o importato da un URL. Le immagini vengono ridimensionate e servite come AVIF e WebP; i file SVG restano vettoriali, senza script.
- mostra solo il logo: per i loghi che contengono già il nome. Il nome resta il titolo della scheda del browser.
──Incidenti e iscritti via email
Apri gli incidenti di una pagina (pulsante nell'elenco delle status page) per spiegare ai visitatori cosa succede: un titolo, un impatto (nessuno, minore, grave, critico) e una cronologia di aggiornamenti, ognuno con uno stato (stiamo indagando, causa individuata, sotto osservazione, risolto) e un messaggio. Gli incidenti aperti compaiono in cima alla pagina, e il loro impatto porta il banner almeno a degradato (minore), disservizio parziale (grave) o disservizio grave (critico). Quelli risolti vanno nello storico.
Per permettere ai visitatori di iscriversi via email, scegli un canale email in iscrizioni via email nelle
impostazioni della pagina: vengono usati il suo server SMTP o account Resend e il suo mittente, non i destinatari. I
visitatori inseriscono l'indirizzo sulla pagina e lo confermano con un link (valido 7 giorni); poi ricevono ogni
aggiornamento pubblicato con avvisa gli iscritti via email spuntato. Ogni email ha un link per disiscriversi e un
header List-Unsubscribe con un clic. Gli admin vedono e rimuovono gli iscritti negli incidenti della pagina. I link
puntano al dominio personalizzato della pagina, altrimenti all'URL pubblico delle impostazioni.
──Badge
Ogni pagina pubblicata ha badge SVG in stile shields, senza accesso:
| badge | URL |
|---|---|
| stato della pagina | /api/badge/<slug>/status.svg |
| stato di un monitor | /api/badge/<slug>/<id monitor>/status.svg |
| uptime | /api/badge/<slug>/<id monitor>/uptime.svg (predefinito 30 giorni) |
| tempo di risposta | /api/badge/<slug>/<id monitor>/response.svg (predefinito 24 ore) |
Opzioni: ?period=24h|7d|30d|90d, ?label= per il testo a sinistra, ?style=flat-square per gli angoli squadrati.
Copia il Markdown dalla pagina del monitor o dall'editor della status page:
[](https://status.example.com/status/acme/)
Un badge non mostra mai più della sua pagina: le bozze e i monitor che non sono nella pagina rispondono con un "not found" grigio.