Upravljanje dokumentacijom i informacijama: Runbook, post-mortem i korporativna memorija

Dobici:

• Sposobnost izrade runbooka, post mortem i kostura arhitektonskog dokumenta iz razbacanih bilješki s umjetnom inteligencijom
• Sposobnost provođenja discipline nametanja 'zabrane proizvodnje' i temeljitog testiranja i označavanja svakog runbooka u stvarnom okruženju
• Sposobnost razumijevanja da je pogrešan runbook opasniji od nikakvog i održavanje dokumentacije na životu kroz proces promjene

Upravljanje dokumentacijom i informacijama: Runbook, arhitektura i institucionalna memorija s umjetnom inteligencijom

Najzanemareniji, ali spasonosni zadatak upravljanja sustavom je dokumentacija. Kada se sustav sruši, a osoba koja ga je izgradila je na odmoru i nema pisane riječi o tome kako se oporaviti, to je duga noć za sve. Dokumentacija je institucionalna memorija koja čini zapisano i dostupno kako je sustav postavljen, kako radi i što učiniti ako se pojavi problem. Najkritičnija vrsta ove memorije je runbook: operativni vodič koji vam korak po korak govori što učiniti u određenoj situaciji (usluga se srušila, disk pun, sigurnosna kopija nije uspjela). Ovdje AI rješava problem "prazne stranice" i "lijenosti", koji su najveći neprijatelji pisanja dokumentacije: proizvodi organizirani runbook iz vaših razbacanih bilješki, postupak iz povijesti naredbi, opis iz arhitekture. Ali kritično načelo: AI proizvodi nacrte i kosture; Vi ste taj koji testira i potvrđuje svaki korak kako biste vidjeli je li doista ispravan — pogrešan runbook opasniji je od nepostojanja runbooka.

U ovoj jedinici, runbook, post mortem (izvješće o istrazi nakon događaja), arhitektonska dokumentacija i pisanje baze znanja; Generiranje nacrta pomoću AI; i što je najvažnije naučit ćete rizike neprovjerene dokumentacije.

Zašto je krivi runbook gori od nedostatka runbooka?

Ovo je najvažniji koncept ove jedinice. Momčad bez popisa je oprezna i sumnjičava u vrijeme panike; dva puta razmisli o svakoj naredbi. Ali netko sa "službenom" knjižicom slijepo joj vjeruje - usred noći, pod stresom, izvršava korake bez pitanja. Ako se taj runbook izda, a da ga AI nije proizveo i testirao i ima jedan pogrešan korak (pogrešna naredba, preduvjet koji nedostaje, preskočeni rezervni korak), rezultat je katastrofalan. Zato se svaki runbook proizveden s AI mora pokrenuti od početka do kraja u stvarnom okruženju i svaki korak mora biti verificiran prije nego što se objavi. Netestirani runbook je poput ohrabrujućeg, ali praznog obećanja.

Oprez: označite runbook s "testirano: [datum], [osoba]". Jasno označite neprovjerene nacrte oznakom "NACRT — NIJE PROVJEREN". Dakle, nitko ne bi sigurno primijenio neprovjerene korake u stvarnoj krizi.

Anatomija dobrog runbooka

Dobar runbook sastoji se od specifičnih dijelova, a AI je dobar u izgradnji tog kostura: naslov i svrha (za koju situaciju), preduvjeti (kakav pristup, koji alat je potreban), simptomi (kada trebam koristiti ovaj runbook), koraci (s numeriranim naredbama koje se mogu kopirati), provjera valjanosti (kako prepoznati uspjeh nakon svakog koraka), vraćanje (kako poništiti ako korak krene loše) i eskalacija (koga da nazovem ako ne mogu shvatiti). Možete dati AI svoje razbacane bilješke i zamoliti ga da ih stavi u ovu strukturu; Vi samo osiguravate točnost sadržaja.

Korak po korak: Izrada dokumentacije s AI

1. Skupite sirovinu. Vaša povijest naredbi, vaše bilješke, stara e-pošta, dnevnik chata - pravi materijal, čak i ako je neuredan, bolji je od AI izmišljotina.
2. Zatražite strukturu. "Napravite ovo runbook sa sljedećim naslovima: svrha, preduvjet, simptom, koraci, provjera, vraćanje, eskalacija."
3. Zabraniti izmišljanje. "Nemojte dodavati nikakve naredbe, IP-ove, verzije ili korake koje vam nisam dao; označite sve dijelove koji nedostaju kao [TO BE FILLED]." Time se sprječava najopasnija pogreška — naizgled uvjerljivi izmišljeni koraci.
4. Maska. Koristite rezervirano mjesto umjesto stvarnog hosta, IP-a, korisnika; Ako se dokument dijeli, tajna ne bi trebala procuriti.
5. Testirajte ga. Pokrenite runbook od početka do kraja u stvarnom (po mogućnosti testnom) okruženju. Popravite sve korake koji ne rade, nedostaju ili su nejasni.
6. Pečatirati i objaviti. Dodajte datum testa, testera i zadnje ažuriranje. Dokumentacija je živa; Mora se ažurirati kada se sustav promijeni.

tri mini kućišta

Slučaj 1 — 2 sata rada, 15 minuta. Administrator je mjesecima odgađao dokumentiranje postupka vraćanja sigurnosne kopije. Dao je povijest naredbi terminala (maskiranu) i nekoliko razbacanih bilješki AI-u i umetnuo to u okvir runbook-a. AI je proizveo uredan obris za 15 minuta. Administrator je proveo sljedećih 45 minuta izvodeći nacrt od početka do kraja na testnom poslužitelju i popravljajući dva nedostajuća koraka. Rezultat: testiran, pouzdan runbook.

Slučaj 2 — Lažno uhvaćen. Tim je zamolio AI da napiše runbook za ponovno pokretanje usluge, ali je zaboravio zabraniti "izmišljanje". YZ je dodao naredbu "prvo izbriši predmemoriju", koja se čini logičnom, ali ne postoji u toj usluzi. Srećom, inženjer je pokrenuo runbook u testnom okruženju; Ta je naredba dala pogrešku. Testni korak je uhvatio izmišljeni korak koji bi stvorio zbrku u stvarnoj krizi.

Slučaj 3 — Ubrzano post-mortem. Nakon velikog kvara, tim je trebao napisati obdukciju, ali nitko nije mogao započeti. Predali su vremenski slijed događaja i maskirane zapisnike AI-u i zatražili besprijekoran post mortem kostur — sažetak, utjecaj, vremenski slijed, glavni uzrok, korektivne radnje. AI nacrt smanjio je jedan sat rada na deset minuta; Tim je svoju energiju posvetio provjeri činjenica i razjašnjavanju radnji.

Četiri predloška za kopiranje

1) Generiranje kostura runbook-a:

Vaša uloga: viši SRE. Stvorite runbook iz maskiranih bilješki/povijesti naredbi u nastavku. Naslovi: Svrha, Preduvjeti, Simptomi (kada koristiti), Koraci (numerirani, mogu se kopirati), Provjera u svakom koraku, Vraćanje, Eskalacija. PRAVILO: Nemojte izmišljati nijednu naredbu/IP/verziju/korak koji vam ja ne dam; napišite dijelove koji nedostaju [TO BE FILLED]. Materijal: [maskirana bilješka]

2) Post mortem bez krivnje:

Vaša uloga: voditelj istrage incidenta. Napišite post mortem skicu BEZ KRIVICE sa sljedeće maskirane vremenske trake i zapisa: Sažetak, Utjecaj (trajanje/opseg), Vremenska crta, Glavni uzrok (ako je potvrđen), Čimbenici koji doprinose, Korektivne radnje (vlasnik + prioritet). Ne krivite osobu, fokusirajte se na sustav. Ne piši temeljni uzrok bez dokaza. Podaci: [...]

3) Opis arhitekture/usluge:

Napišite dokument usluge iz sljedećih maskiranih informacija o konfiguraciji/dijagramu: što usluga radi, od kojih se komponenti sastoji, koje su njezine ovisnosti, kako teku podaci, koji priključci/protokoli. Neka bude tehnički, ali čitljivo. Odnos u koji niste sigurni označite kao "potrebna je provjera". Info: [maskiran]

4) Revizija osvježavanja dokumentacije:

Pregledajte sljedeći postojeći dokument i provjerite aktualnost: (1) koji odjeljci nedostaju/nejasne su, (2) koji koraci izgledaju neprovjereni, (3) koje bi informacije mogle biti zastarjele? Za svaki nalaz napišite što trebam pitati/provjeriti. Dokument: [maskirani dokument]

Slab upit / Jak upit

Slab upit:

Napišite mi priručnik za održavanje poslužitelja.

Pravog materijala nema. AI proizvodi tekst, u potpunosti iz vlastitog općeg znanja, koji ne odgovara vašem okruženju ili čak sadrži izmišljene korake. Ovo je opasan izvor lažnog samopouzdanja.

Snažan upit:

Vaša uloga: viši SRE. Ispod se nalazi maskirana povijest naredbi i moje bilješke koje sam implementirao u događaju "disk usluge plaćanja pun". Stvorite runbook od ovih: Svrha, Preduvjet (pristup/alat), Simptom, Numerirani koraci (s mojim naredbama), Provjera na svakom koraku, Vraćanje, Eskalacija. Ne tjeraj me da slijedim zapovijed koju nisam dao; Napravite prazninu [TO BE FILLED]. Na kraju stavite upozorenje "nije testirano". Materijal: [maskirana povijest naredbi]

Vrsta dokumenta

Doprinos AI

Obavezan doprinos čovjeka

runbook

Kostur + raspored

Testiranje u stvarnom okruženju, točnost

Post mortem

Obris + struktura

Provjerite činjenice i glavni uzrok

arhitektonski dokument

Opis + tijek

Potvrdite odnose i ovisnosti

Članak baze znanja

brzi nacrt

Provjera aktualnosti i točnosti

Uobičajene greške

• Objavljivanje neprovjerenih runbookova. U krizi se slijepo provode neprovjereni koraci; Pogrešna knjiga je katastrofa.
• Ne nameću zabranu izmišljanja. Ako ne kažete umjetnoj inteligenciji "nemoj dodavati ono što ja nisam dao", proizvest će razumne, ali nerealne korake.
• Preskakanje maskiranja. Tajna procuri kada se podijeli dokument koji sadrži pravi host, IP i korisnika.
• Dokument se ne ažurira. Dokumenti koji se ne ažuriraju kada se sustav promijeni s vremenom postaju pogrešni.
• Izdavanje bez žiga. Nije jasno je li dokument bez datuma testiranja i statusa pouzdan ili je nacrt.

Savjet: najbolji način da održite dokumentaciju "živom" je da je povežete s postupkom promjene: kada se sustav promijeni, neka ažuriranje relevantnog runbooka bude jedan od kriterija završetka promjene. AI ubrzava ažuriranje, ali vi ste pokretač procesa.

Ukratko

Dokumentacija je institucionalna memorija; Runbook je operativni vodič koji spašava živote u kriznim vremenima. AI proizvodi organizirane nacrte iz vaših neurednih bilješki, rješavajući problem praznih stranica i lijenosti. Ali najkritičnija istina je sljedeća: pogrešan priručnik opasniji je od nikakvog jer se u krizi primjenjuje naslijepo. Stoga zabranite umjetnoj inteligenciji da se "izrađuje", maskirajte je i temeljito testirajte i označite svaki runbook u stvarnom okruženju. Održavajte dokument živim dok se sustav mijenja. AI gradi okvir; Vi ste ti koji jamčite točnost i testiranje.

Zadatak aplikacije

Odaberite postupak koji nije dokumentiran u vašem timu (na primjer, ponovno pokretanje usluge ili vraćanje sigurnosne kopije). Maskirajte svoju relevantnu povijest naredbi i bilješke i neka AI stvori nacrt pomoću gornjeg predloška "Runbook skeleton generation"; Svakako uvedite zabranu izmišljotina. Provedite nacrt u testnom okruženju i označite i popravite sve pokvarene korake/korake koji nedostaju. Dodajte datum testiranja i podatke o ispitivaču u runbook. Zapišite razlike koje AI proizvodi i ispravite u procesu u 5 stavki.

popis za provjeru

• [ ] Napravio sam runbook iz stvarnog materijala (napomena, povijest naredbi), nisam li ga napravio od nule?
• [ ] Jesam li zabranio AI-u da "dodaje naredbe/IP-ove/korake koje nisam dao"?
• [ ] Jesam li maskirao osjetljive podatke kao što su host, IP i korisnik?
• [ ] Jesam li pokrenuo i potvrdio runbook u stvarnom/testnom okruženju?
• [ ] Jesam li dodao podatke o datumu testiranja, ispitivaču i posljednjem ažuriranju?
• [ ] Jesam li planirao povezati dokument s procesom promjene sustava i održavati ga ažurnim?