Näin rakennat tilasivun: komponentit, häiriöt ja käytettävyystarkistukset

Tilasivu kertoo käyttäjillesi yhdestä paikasta, toimiiko palvelusi. Tilasivun rakentamiseen tarvitset luettelon komponenteista (verkkosivu, rajapinta, maksut, sähköpostin toimitus), jokaisen komponentin nykytilan, häiriöt aikaleimattuine päivityksineen, historian aiemmista häiriöistä ja tarvittaessa tilaukset, jotta ihmiset kuulevat ongelmista ilman, että heidän täytyy käydä tarkistamassa. Itse sivu on yksinkertainen. Tärkein päätös on se, missä sivu toimii: tilasivun on pysyttävä pystyssä silloinkin, kun sovelluksesi on alhaalla, joten sen ei pidä jakaa hostingia, tietokantaa eikä julkaisuputkea sen kohteen kanssa, jota se raportoi.

Mihin tilasivua käytetään

Kun jokin hajoaa, käyttäjät haluavat tietää kolme asiaa: onko vika vain minun päässäni, tietävätkö he ongelmasta ja milloin se korjataan. Tilasivu vastaa kaikkiin kolmeen ilman tukipyyntöjen tulvaa. Se rakentaa myös luottamusta ajan myötä, sillä näkyvä häiriöhistoria rehellisine selvityksineen näyttää, miten ongelmat hoidetaan.

Se ei ole muutoslokki. Uudet ominaisuudet kuuluvat muutoslokisivulle, häiriöt ja huollot tänne.

Mitä sivu tarvitsee

Data

Komponenttien tilat ovat yleensä lyhyt kiinteä lista: Toiminnassa, Heikentynyt suorituskyky, Osittainen katkos, Laaja katkos, Huollossa.

Sivut

• Julkinen tilasivu: yleinen banneri („Kaikki järjestelmät toimivat” tai pahin nykytila), jokainen komponentti tiloineen, kaikki aktiiviset häiriöt päivityksineen, tulevat huollot ja 90 päivän historianauha, jos sinulla on tarkistusdataa.
• Häiriösivu: yhden häiriön koko aikajana päivityksineen, omalla URL-osoitteella, jotta tuki voi linkittää siihen.
• Historia: menneet häiriöt kuukausittain.
• Tilaus: sähköpostitilaus vahvistuksella ja komponenttikohtaisilla asetuksilla.
• Ylläpito: luo häiriö, julkaise päivityksiä, vaihda komponenttien tiloja, ajasta huolto.

Oikeudet

Julkinen yleisö näkee kaiken, mikä on julkaistu. Vain tiimisi voi julkaista. Pidä ylläpidon kirjautuminen erillään sovelluksesi kirjautumisjärjestelmästä, jos mahdollista, jotta todennuspalvelusi katkos ei lukitse sinua ulos omalta tilasivultasi.

Tärkein päätös: pidä se riippumattomana

Tässä useimmat kotitekoiset tilasivut epäonnistuvat. Jos tilasivusi:

• toimii samalla palvelimella tai hostingtilillä kuin sovelluksesi,
• lukee samaa tietokantaa,
• on samojen domain-asetusten tai CDN-konfiguraation takana,
• tai julkaistaan samalla putkella,

monet katkokset vievät sen mukanaan juuri silloin, kun ihmiset sitä tarvitsevat. Käytännön askeleet:

• Erillinen hosting. Eri projekti tai palveluntarjoaja kuin pääsovelluksella.
• Oma alidomain, kuten status.esimerkki.fi, osoitettuna erikseen DNS:ssä. Katso miten domainit ja DNS toimivat.
• Oma data. Häiriöt elävät tilasivun omassa tallennustilassa, eivät sovelluksesi tietokannassa.
• Staattinen varasuunnitelma. Jotkut tiimit tekevät julkisesta sivusta staattisen ja rakentavat sen uudelleen jokaisen päivityksen yhteydessä, jolloin rikkoutuvaa on lähes ei mitään.

Manuaaliset päivitykset vai automaattiset tarkistukset

Manuaalinen (aloita tästä)

Tiimisi julkaisee häiriöt ja vaihtaa komponenttien tilat käsin ylläpitosivulta. Näin monet tilasivut käytännössä toimivat, koska ihmisen harkinta („maksut ovat hitaita joillakin korttityypeillä”) on hyödyllisempää kuin automaattinen punainen piste.

Jotta huomaat ongelmat nopeasti, käytä ulkopuolista käytettävyysvalvontaa, joka tarkistaa sovelluksesi noin minuutin välein ja hälyttää sähköpostilla, tekstiviestillä tai chatissa. Monilla valvontapalveluilla on ilmainen taso.

Automaattinen

Automaatio tarkoittaa, että jokin tarkistaa säännöllisesti jokaisen komponentin ja päivittää sen tilan. Tähän tarvitaan koodi, joka ajetaan aikataulun mukaan sovelluksesi infrastruktuurin ulkopuolelta. Kaksi yleistä mallia:

• Ulkoinen valvonta kutsuu tilasivuasi webhookin kautta, kun tarkistus epäonnistuu tai palautuu, ja tilasivu päivittää komponentin.
• Ajastettu työ tilasivun omassa hostingissa tarkistaa jokaisen komponentin ja tallentaa tuloksen. Tarkista, miten hostingisi hoitaa ajastetut tehtävät, ennen kuin luotat tähän. Oppaamme taustatyöiden ajamisesta selittää vaihtoehdot.

Automaattiset muutokset voivat heilahdella (ylös, alas, ylös) hitaassa verkossa. Vaadi kaksi tai kolme epäonnistunutta tarkistusta ennen tilan muuttamista, ja anna ihmisen vahvistaa ennen kuin laaja katkos julkistetaan.

Häiriöpäivitysten kirjoittaminen

• Julkaise varhain. „Tutkimme ilmoituksia epäonnistuneista kirjautumisista” muutaman minuutin sisällä on parempi kuin täydellinen viesti tunnin päästä.
• Kerro, mitä käyttäjät huomaavat, älä sitä, mikä hajosi sisäisesti.
• Lupaa seuraavan päivityksen aika ja pidä lupauksesi.
• Päätä ratkaisun jälkeen lyhyellä yhteenvedolla: mitä tapahtui, kauanko se kesti ja mitä muutat.

Ensimmäinen toimiva kehote

Rakenna itsenäinen tilasivu sovellukselle Parcelio, pystytettynä erikseen osoitteeseen status.parcelio.com. Komponentit: Verkkosivu, Seurannan rajapinta, Ilmoitukset, Maksut, jokaisella tila Toiminnassa, Heikentynyt suorituskyky, Osittainen katkos, Laaja katkos tai Huollossa. Julkinen sivu näyttää yleisen bannerin pahimman nykytilan mukaan, jokaisen komponentin tilan, aktiiviset häiriöt aikaleimattuine päivityksineen uusin ensin, tulevat huollot ja luettelon aiemmista häiriöistä kuukausittain. Jokaisella häiriöllä on oma sivu. Lisää salasanalla suojattu ylläpitosivu häiriöiden luomiseen (otsikko, vaikutus, vaikuttavat komponentit), päivitysten julkaisuun (viesti ja tila: Tutkitaan, Tunnistettu, Seurataan, Ratkaistu), komponenttien tilojen vaihtamiseen ja huoltojen ajastamiseen. Lisää POST /api/check-result -päätepiste, joka hyväksyy komponentin nimen ja ylös/alas-tiedon ulkoiselta valvonnalta, suojattuna salaisella tunnuksella, ja merkitsee komponentin Heikentyneeksi vasta kolmen peräkkäisen epäonnistumisen jälkeen. Tallenna kaikki tämän sovelluksen omaan tietokantaan. Yksinkertainen, rauhallinen muotoilu, joka latautuu nopeasti puhelimilla.

Rakennusvaiheet

1. Julkinen sivu ja ylläpito manuaalisilla häiriöillä. Tämä yksin on jo toimiva tilasivu.
2. Pystytä se erikseen ja osoita alidomain sille.
3. Häiriösivut ja historia.
4. Huoltoikkunat.
5. Tilaukset. Kaksinkertainen vahvistus sähköpostilla ja ilmoitukset uusista häiriöistä ja päivityksistä. Sähköposti tarvitsee palveluntarjoajan; katso miten lähetät sähköposteja sovelluksestasi.
6. Valvonnan webhook, jos haluat automaattisia tilamuutoksia.
7. Tee harjoitus. Luo harjoitushäiriö, julkaise päivityksiä, ratkaise se, tarkista sähköpostit ja poista se.

Yleisiä virheitä

• Hosting samassa paikassa sovelluksen kanssa. Yleisin ja vakavin virhe.
• Sivu, joka aina sanoo „Kaikki järjestelmät toimivat”. Jos se ei koskaan näytä ongelmia, käyttäjät lakkaavat luottamasta siihen.
• Ei aikaleimoja tai aikavyöhykettä. Näytä aina ajat aikavyöhykkeen kanssa.
• Luottaminen pääsovelluksen kirjautumiseen ylläpitosivulla.
• Hiljaisuus päivitysten välissä. „Ei muutosta, työskentelemme edelleen” on pätevä päivitys.
• Heiluvat automaattiset tilat. Vaadi toistuvia epäonnistumisia ennen muutosta.

Milloin valmis tilasivupalvelu on parempi valinta

Valmiit tilasivupalvelut on rakennettu riippumattomuusongelman ympärille: ne toimivat erillisellä infrastruktuurilla, hoitavat tilaajien ilmoitukset sähköpostilla ja tekstiviestillä ja sisältävät usein valvonnan sekä integraatiot häiriötyökaluihin. Jos käytettävyys on osa sitä, mitä asiakkaasi maksavat, tai sinulla on sopimusvelvoitteita raportoida häiriöistä, erillinen palvelu on yleensä sen arvoinen. Monilla on ilmainen tai edullinen taso pienille tiimeille, joten tarkista ennen kuin rakennat.

Rakenna oma, kun haluat täyden hallinnan ulkoasusta ja sanamuodoista, kun tarpeesi ovat yksinkertaiset (muutama komponentti, manuaaliset päivitykset) tai kun tilasivu on osa tuotetta, jonka rakennat muille.

Rakentaminen Mythexillä

Mythexissä voit rakentaa tilasivun omana projektinaan, erillään pääsovelluksesta. Se antaa erillisen hostingin ja oman tietokannan. Kuvaile se chatissa, tarkista se live-esikatselussa, julkaise ja yhdistä alidomain, kuten status.omadomain.com (mukautetut domainit ovat Pro-tasolla). Huomaa, että julkaistut Mythex-sovellukset ja niiden tietokannat nukkuvat, kun ne ovat käyttämättöminä, ja herävät seuraavalla vierailulla. Ensimmäinen lataus hiljaisen jakson jälkeen voi siis olla hitaampi. Yksinkertainen, kevyt sivu auttaa.

Mythex ei dokumentoi ajastettuja töitä, joten automaattisiin tarkistuksiin käytä ulkoista käytettävyysvalvontaa, joka kutsuu tilasivusi webhook-päätepistettä (katso webhook-resepti). Tilaajille menevät sähköposti-ilmoitukset kulkevat omalla palveluntarjoajallasi, ja avain tallennetaan projektin salaisuutena (sähköpostin lähettämisen resepti).

Kysymykset