Dokumentacija ir informacijos valdymas: „Runbook“, „Pomirtinė“ ir „Corporate Memory“.

Pelnas:

• Gebėjimas dirbtiniu intelektu iš pasklidusių užrašų sukurti runbook, pomirtinių ir architektūrinių dokumentų griaučius
• Gebėjimas laikytis „draudimo gaminti“ disciplinos ir nuodugniai išbandyti bei pažymėti kiekvieną runbook realioje aplinkoje.
• Sugebėjimas suprasti, kad neteisingas „runbook“ yra pavojingesnis už nebuvimą, ir išlaikyti dokumentaciją gyvą per keitimo procesą

Dokumentacija ir informacijos valdymas: „Runbook“, architektūra ir institucinė atmintis su AI

Labiausiai apleista, bet gyvybę gelbstinti sistemos valdymo užduotis yra dokumentacija. Kai sistema sugenda, o ją sukūręs asmuo atostogauja ir nėra rašytinio žodžio, kaip atsigauti, tai ilga naktis visiems. Dokumentacija yra institucinė atmintis, kuri leidžia įrašyti ir padaryti prieinamą, kaip sistema nustatoma, kaip ji veikia ir ką daryti iškilus problemai. Svarbiausias šios atminties tipas yra „runbook“: veikimo vadovas, kuriame žingsnis po žingsnio nurodoma, ką daryti tam tikroje situacijoje (nutrūko paslauga, pilnas diskas, nepavyko sukurti atsarginės kopijos). Čia AI išsprendžia „tuščio puslapio“ ir „tinginystės“ problemas, kurios yra didžiausi dokumentacijos rašymo priešai: iš jūsų išsklaidytų užrašų jis sukuria sutvarkytą runbook, komandų istorijos procedūrą, architektūros aprašymą. Tačiau esminis principas: AI gamina brėžinius ir skeletus; Jūs tikrinate ir patvirtinate kiekvieną veiksmą, kad pamatytumėte, ar jis iš tikrųjų teisingas – neteisingas „runbook“ yra pavojingesnis nei jo nebuvimas.

Šiame skyriuje rengia knygą, pomirtinį (po įvykio tyrimo ataskaitą), architektūrinę dokumentaciją ir žinių bazės rašymą; Juodraščių generavimas naudojant AI; ir, svarbiausia, sužinosite apie nepatikrintos dokumentacijos riziką.

Kodėl netinkamas „Runbook“ yra blogesnis nei „runbook“?

Tai yra svarbiausia šio įrenginio koncepcija. Komanda be runbook yra atsargi ir įtaringa panikos metu; du kartus pagalvoja apie kiekvieną komandą. Tačiau kažkas, turintis „oficialią“ vadovo knygą, ja pasitiki aklai – vidury nakties, patiriamas stresas, be jokių abejonių atlieka veiksmus. Jei ta vykdymo knyga išleidžiama AI nepagaminus ir neišbandžius ir joje yra vienas žingsnis klaidingas (netinkama komanda, trūkstama būtina sąlyga, praleistas atsarginis veiksmas), rezultatas bus pražūtingas. Štai kodėl kiekvienas su AI sukurtas runbook turi būti paleistas nuo pradžios iki pabaigos realioje aplinkoje ir kiekvienas veiksmas turi būti patikrintas prieš jį paskelbiant. Neišbandytas runbook yra tarsi raminantis, bet tuščias pažadas.

Atsargiai: „Runbook“ antspaudu pažymėkite „išbandyta: [data], [asmuo]“. Aiškiai pažymėkite neišbandytus juodraščius etikete „JUODRAŠTAS – NEPATIKRINTA“. Taigi niekas saugiai netaikys nepatikrintų veiksmų realios krizės metu.

Geros knygos anatomija

Gerą vykdymo knygą sudaro tam tikros dalys, o dirbtinis intelektas yra tinkamas kuriant šį skeletą: pavadinimas ir tikslas (kokiai situacijai), būtinos sąlygos (kokia prieiga, koks įrankis reikalingas), simptomai (kada naudoti šią runbook), žingsniai (su sunumeruotomis, kopijuojamomis komandomis), patvirtinimas (kaip atpažinti sėkmę po kiekvieno veiksmo), atšaukimas (kaip anuliuoti, jei veiksmas nepavyksta) ir aš išsiaiškinu, jei galiu padaryti. Galite pateikti AI savo išsibarsčiusius užrašus ir paprašyti įdėti jį į šią struktūrą; Jūs tik užtikrinate turinio tikslumą.

Žingsnis po žingsnio: dokumentų kūrimas naudojant AI

1. Surinkite žaliavą. Jūsų komandų istorija, užrašai, senas el. laiškas, pokalbių žurnalas – tikra medžiaga, net jei ir netvarkinga, yra geriau nei dirbtinio intelekto sukūrimas.
2. Klauskite struktūros. „Padarykite tai „runbook“ su šiomis antraštėmis: tikslas, būtina sąlyga, simptomas, veiksmai, patvirtinimas, atšaukimas, eskalavimas.
3. Uždrausti gaminti. „Nepridėkite jokių komandų, IP, versijų ar veiksmų, kurių aš jums nedaviau; visas trūkstamas dalis pažymėkite kaip [TOBE FILLED]“. Taip išvengiama pavojingiausios klaidos – iš pažiūros tikėtinų sugalvotų žingsnių.
4. Kaukė. Vietoj faktinio kompiuterio, IP, vartotojo naudokite rezervuotąją vietą; Jei dokumentas yra bendrinamas, paslaptis neturėtų būti nutekinta.
5. Išbandykite. Vykdykite „runbook“ nuo pradžios iki pabaigos tikroje (geriausia bandomojoje) aplinkoje. Ištaisykite visus neveikiančius, trūkstamus arba neaiškius veiksmus.
6. Antspauduoti ir paskelbti. Pridėkite bandymo datą, testerį ir paskutinį atnaujinimą. Dokumentacija gyva; Jis turi būti atnaujintas pasikeitus sistemai.

trys mini dėklai

1 atvejis – 2 valandos darbo, 15 minučių. Administratorius kelis mėnesius atidėliojo atsarginės kopijos atkūrimo procedūros dokumentavimą. Jis AI pateikė terminalo komandų istoriją (užmaskuotą) ir keletą išsklaidytų pastabų ir įterpė ją į „runbook“ sistemą. AI per 15 minučių sukūrė tvarkingą kontūrą. Kitas 45 minutes administratorius paleido juodraštį nuo pradžios iki pabaigos bandomajame serveryje ir ištaisė du trūkstamus veiksmus. Rezultatas: patikrinta, patikima runbook.

2 atvejis – sugauta klaidingai. Komanda turėjo dirbtinį intelektą parašyti paslaugos iš naujo paleidimo rinkinį, tačiau pamiršo uždrausti „gaminti“. YZ pridėjo komandą „pirmiausia išvalyti talpyklą“, kuri atrodo logiška, bet toje tarnyboje neegzistuoja. Laimei, inžinierius paleido runbook bandymo aplinkoje; Ta komanda davė klaidą. Bandomasis žingsnis buvo sugalvotas žingsnis, kuris tikros krizės metu sukeltų painiavą.

3 atvejis – pomirtinis pagreitintas. Po didelio gedimo komandai reikėjo parašyti pomirtinį aktą, bet niekas negalėjo pradėti. Jie perdavė įvykio laiko juostą ir užmaskuotus žurnalus AI ir paprašė nepriekaištingo pomirtinio skeleto – santraukos, poveikio, laiko juostos, pagrindinės priežasties, taisomųjų veiksmų. AI planas sutrumpino valandos darbą iki dešimties minučių; Komanda savo energiją skyrė faktų patikrinimui ir veiksmų punktų paaiškinimui.

Keturi kopijuojami šablonai

1) „Runbook“ skeleto generavimas:

Jūsų vaidmuo: vyresnysis SRE. Sukurkite „runbook“ iš toliau pateiktų užmaskuotų užrašų / komandų istorijos. Antraštės: Paskirtis, Būtinos sąlygos, Simptomai (kada naudoti), Žingsniai (sunumeruoti, galima kopijuoti), Patikrinimas kiekviename žingsnyje, Atšaukimas, Eskalacija. TAISYKLĖ: Nesugalvokite jokios komandos/IP/versijos/veiksmo, kurių aš jums neduodu; parašykite trūkstamas dalis [PILDYTI]. Medžiaga: [užmaskuotas užrašas]

2) Postmortem be kaltės:

Jūsų vaidmuo: incidento tyrimo tarpininkas. Parašykite BE kaltės eskizą iš šios užmaskuotos laiko juostos ir žurnalų: santrauka, poveikis (trukmė / apimtis), laiko juosta, pagrindinė priežastis (jei patikrinta), prisidedantys veiksniai, taisomieji veiksmai (savininkas + prioritetas). Nekaltink žmogaus, susitelk į sistemą. Nerašykite pagrindinės priežasties be įrodymų. Duomenys: [...]

3) Architektūra / paslaugos aprašymas:

Parašykite paslaugos dokumentą iš šios užmaskuotos konfigūracijos/schemos informacijos: ką paslauga veikia, iš kokių komponentų ji susideda, kokios jos priklausomybės, kaip vyksta duomenų srautas, kokie prievadai/protokolai. Laikykite jį techniniu, bet skaitomu. Pažymėkite santykius, dėl kurių nesate tikri, kaip „reikia patvirtinimo“. Informacija: [užmaskuotas]

4) Dokumentų atnaujinimo auditas:

Peržiūrėkite šį esamą dokumentą ir patikrinkite, ar nėra valiutos: (1) kokių skilčių trūksta/neaiškių, (2) kokie veiksmai atrodo neišbandyti, (3) kokia informacija gali būti pasenusi? Užrašykite, ko turėčiau paklausti / patikrinti dėl kiekvieno radinio. Dokumentas: [užmaskuotas dokumentas]

Silpnas raginimas / Stiprus raginimas

Silpnas raginimas:

Parašykite man serverio priežiūros vadovą.

Tikros medžiagos nėra. AI sukuria tekstą, visiškai remdamasis savo bendromis žiniomis, kuris netinka jūsų aplinkai ar netgi apima sugalvotus veiksmus. Tai pavojingas klaidingo pasitikėjimo šaltinis.

Galingas raginimas:

Jūsų vaidmuo: vyresnysis SRE. Žemiau yra užmaskuotų komandų istorija ir mano pastabos, kurias įdiegiau įvykyje „mokėjimo paslaugos diskas pilnas“. Sukurkite vykdymo knygą iš šių: tikslas, būtina sąlyga (prieiga / įrankis), simptomas, sunumeruoti žingsniai (su mano komandomis), patvirtinimas kiekviename žingsnyje, grąžinimas, eskalavimas. Neversk manęs vykdyti komandos, kurios nedaviau; Padarykite tuščią laukelį [PILDYTI]. Pabaigoje įdėkite įspėjimą „neišbandyta“. Medžiaga: [užmaskuotų komandų istorija]

Dokumento tipas

AI indėlis

Privalomas žmogaus indėlis

runbook

Skeletas + maketas

Testavimas realioje aplinkoje, tikslumas

Pomirtinis

Kontūras + struktūra

Patikrinkite faktus ir pagrindinę priežastį

architektūros dokumentas

Aprašymas + srautas

Patvirtinkite ryšius ir priklausomybes

Žinių bazės straipsnis

greitas juodraštis

Aktualumo ir tikslumo patikrinimas

Dažnos klaidos

• Neišbandytų runbookų publikavimas. Krizės metu aklai įgyvendinami nepatikrinti žingsniai; Neteisingas vadovas yra katastrofa.
• Neuždrausti gaminti. Jei nesate AI „nepridėk to, ko nedaviau“, tai imsis pagrįstų, bet nerealių veiksmų.
• Maskavimo praleidimas. Paslaptis nutekinama, kai bendrinamas dokumentas, kuriame yra tikrasis pagrindinis kompiuteris, IP ir vartotojas.
• Neatnaujinamas dokumentas. Dokumentai, kurie neatnaujinami pasikeitus sistemai, laikui bėgant tampa klaidinantys.
• Leidyba be antspaudo. Neaišku, ar dokumentas be patikrinimo datos ir statuso yra patikimas, ar juodraštis.

Patarimas: geriausias būdas išlaikyti dokumentaciją „aktyviai“ yra susieti ją su pakeitimo procesu: pasikeitus sistemai, atitinkamos vykdymo knygos atnaujinimas bus vienas iš pakeitimo užbaigimo kriterijų. AI pagreitina atnaujinimą, bet jūs esate paleidimo procesas.

Apibendrinant

Dokumentacija yra institucinė atmintis; Runbook yra veiklos vadovas, kuris gelbsti gyvybes krizės metu. AI sukuria organizuotus juodraščius iš jūsų netvarkingų užrašų, išspręsdama tuščių puslapių ir tinginystės problemą. Tačiau svarbiausia tiesa yra tokia: neteisingas „runbook“ yra pavojingesnis nei joks iš viso, nes krizės metu jis taikomas aklai. Taigi uždrauskite dirbtinį intelektą „gaminti“, užmaskuokite jį ir kruopščiai patikrinkite ir pažymėkite kiekvieną „runbook“ realioje aplinkoje. Išsaugokite dokumentą, kai keičiasi sistema. AI sukuria pagrindą; Jūs esate tas, kuris garantuoja tikslumą ir testavimą.

Taikymo užduotis

Pasirinkite procedūrą, kuri nėra dokumentuota jūsų komandoje (pvz., paslaugos paleidimas iš naujo arba atsarginės kopijos atkūrimas). Užmaskuokite savo atitinkamų komandų istoriją ir pastabas ir leiskite dirbtiniam intelektui sukurti juodraštį naudodami anksčiau pateiktą šabloną „Runbook skeleto generavimas“; Būtinai uždrauskite prasimanymus. Vykdykite juodraštį bandomojoje aplinkoje ir pažymėkite bei pataisykite visus neveikiančius / trūkstamus veiksmus. Pridėkite bandymo datą ir bandytojo informaciją į vykdymo knygą. Užrašykite skirtumus, kuriuos sukuria AI, ir ištaisykite 5 punktuose.

kontrolinis sąrašas

• [ ] „Runbook“ sukūriau iš tikros medžiagos (pastaba, komandų istorija), ar ne nuo nulio?
• [ ] Ar uždraudiau dirbtiniam intelektui „pridėti komandas/IP/veiksmus, kurių nesu davęs“?
• [ ] Ar užmaskavau slaptą informaciją, tokią kaip priegloba, IP ir naudotojas?
• [ ] Ar paleidau ir patvirtinau runbook realioje / bandomojoje aplinkoje?
• [ ] Ar pridėjau bandymo datą, bandytoją ir paskutinio atnaujinimo informaciją?
• [ ] Ar planavau susieti dokumentą su sistemos keitimo procesu ir nuolat jį atnaujinti?