Pagina di stato di Orbit

Una pagina di stato è un URL pubblico senza login che mostra se il tuo progetto è operativo, come ha funzionato di recente e cosa hai distribuito. Attivarla avvia anche un controllo di uptime che esegue il ping del tuo progetto ogni minuto, così ottieni il monitoraggio come effetto collaterale della pubblicazione.

Dove si trovano le impostazioni della pagina di stato

Apri Orbit, fai clic sul progetto e scegli Status page nel gruppo Observability nella striscia delle schede del progetto. La pagina è intitolata Public status page.

Attivazione

1. Attiva Enable public status page.
2. Scegli un Public slug. Diventa parte dell'URL pubblico, quindi scegli qualcosa di riconoscibile, come il nome del tuo prodotto.
3. Facoltativamente imposta un Ping path. Il valore predefinito è /.
4. Compila il Page title e il Tagline visualizzati nella parte superiore della pagina pubblica.
5. Decidi se Show recent deploys e Show recent incidents.
6. Fai clic su Save settings.

Una volta salvato, la pagina mostra un badge Live e conferma che la tua pagina di stato è pubblicata e fa il ping ogni minuto. Un link ti porta alla pagina pubblica in modo che tu possa vedere quello che vedono i visitatori.

Slug Rules

Lo slug deve contenere lettere minuscole, cifre e trattini, fino a 80 caratteri, e non può iniziare o terminare con un trattino. Gli slug sono univoci in tutto Orbit, non solo nel tuo account, quindi una parola comune potrebbe già essere occupata. Se lo è, il salvataggio restituisce un messaggio che dice che lo slug è già occupato e tu scegli un altro.

Scegli lo slug con attenzione: è l'indirizzo pubblico che metterai nella tua documentazione e nelle tue risposte di supporto, e modificarlo in seguito interrompe ogni link ad esso.

Cosa vedono i visitatori

La pagina pubblica è costruita dagli stessi dati delle schede del tuo progetto:

• Current status, dalla distribuzione più recente: Operational, Building, Deploying, Queued, Awaiting Approval, Build Failed, Cancelled o Rolled Back.
• Uptime, calcolato su finestre temporali di 24 ore, 7 giorni e 30 giorni dai controlli minuto per minuto.
• Recent deployments con una percentuale di successo, se hai abilitato quella sezione.
• 30-day statistics: percentuale di successo, tempo medio di build e distribuzioni totali.
• Core Web Vitals, come p75 negli ultimi 30 giorni, se li stai raccogliendo.
• Incidents, ricavati dalle annotazioni che hai contrassegnato sulla timeline del progetto.

La pagina si aggiorna da sola, quindi un cliente che la lascia aperta durante un incidente la vede aggiornarsi senza ricaricare.

Gli incidenti provengono dalla timeline

La sezione incidenti non è un editor separato. Mostra annotazioni di tipo Incident dalla Timeline del progetto, quindi il flusso di lavoro durante un'interruzione è: contrassegnare un'annotazione di incidente e appare pubblicamente.

È intenzionale. Significa che la tua timeline interna e la tua comunicazione pubblica rimangono sincronizzate senza che nessuno mantenga due record. Vedi Orbit Timeline Annotations per sapere come scriverne una.

Il controllo dell'uptime

L'abilitazione della pagina di stato avvia un controllo che recupera l'URL di produzione del tuo progetto, al ping path che hai impostato, una volta al minuto. Ogni risultato viene archiviato e le percentuali di uptime sulla pagina pubblica vengono calcolate da questi record.

I controlli vengono conservati per 90 giorni e quelli più vecchi vengono eliminati automaticamente.

Scegliere un buon Ping Path

Il valore predefinito / funziona per la maggior parte dei progetti. Due motivi per scegliere qualcosa di diverso:

• La tua home page è pesante. Un percorso leggero è una cosa più giusta ed economica da eseguire il polling una volta al minuto.
• La tua home page può essere operativa mentre l'app è rotta. Una shell statica in cache restituirà felicemente 200 mentre la tua API è inattiva. Un percorso come /api/health che esercita effettivamente l'applicazione dice la verità.

Se hai già un health check configurato per il rollback automatico, l'uso dello stesso percorso qui mantiene entrambi i segnali coerenti. Vedi Deploying Your Project per le impostazioni del health check.

Rimozione della pagina di stato

Fai clic su Remove page e conferma. La conferma è esplicita: tutta la cronologia dell'uptime verrà eliminata.

Vale la pena soffermarsi su questo. Rimuovere la pagina non è un pulsante di pausa. Il controllo si interrompe, l'URL pubblico smette di funzionare e il record di uptime accumulato scompare con esso. Se desideri solo che la pagina sia temporaneamente invisibile, non c'è una modalità nascosta: considerare se spegnere l'interruttore di abilitazione e lasciare la configurazione in posizione è più adatto a te rispetto alla rimozione.

Lo slug viene rilasciato quando la pagina viene rimossa, quindi qualcun altro può reclamarlo in seguito.

Practical Advice

Pubblica prima di averne bisogno. Una pagina di stato creata durante un'interruzione è una pagina di stato che nessuno ha aggiunto ai segnalibri. Metti il link nel tuo footer, nella tua documentazione e nella tua firma di supporto mentre tutto funziona bene.

Non fare promesse eccessive. La cifra dell'uptime sulla pagina proviene da un controllo di un minuto su un unico percorso. È un monitoraggio onesto, non un SLA contrattuale, e non dovrebbe essere presentato come tale.

Mantieni il tagline breve. Appare sotto il titolo su una pagina che le persone aprono quando sono già frustrate. Una riga che dice cos'è il servizio, e nient'altro.

Troubleshooting

Uptime mostra 0% o è molto inferiore alla realtà. Il ping path sta restituendo una risposta non-2xx. Aprilo in una finestra del browser privata: un reindirizzamento a una pagina di login, un 404 da un percorso che non esiste più o un geo-block sono le cause solite.

L'URL pubblico restituisce 404. La pagina è salvata ma l'interruttore di abilitazione è spento, oppure lo slug nel tuo link non corrisponde a quello salvato. Copia il link dalla pagina delle impostazioni.

Lo slug è rifiutato. È occupato, contiene un carattere non valido, oppure inizia o termina con un trattino.

Nessun vitals appare sulla pagina pubblica. I vitals provengono dallo script del collector sul tuo sito. Vedi Orbit Web Vitals.

Nessun incidente appare anche se ne abbiamo avuto uno. L'annotazione deve essere di tipo Incident e l'interruttore Show recent incidents deve essere acceso.

Dove andare dopo

• Orbit Timeline Annotations per pubblicare aggiornamenti degli incidenti.
• Orbit Webhooks per ricevere notifiche prima dei tuoi clienti.
• Orbit Web Vitals per le figure di performance mostrate pubblicamente.