$ man pingtxt-status-pages

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: 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:

markdown
[![uptime](https://status.example.com/api/badge/acme/12/uptime.svg)](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.

modifica questa pagina su GitHub