Ieguvumi:
- Spēja izgatavot runbook, pēcnāves un arhitektūras dokumentu skeletu no izkaisītām piezīmēm ar mākslīgo intelektu
- Spēja īstenot disciplīnu, kas attiecas uz "izgatavošanas aizliegumu" un rūpīgi pārbaudīt un atzīmēt katru runbook reālā vidē
- Spēja saprast, ka nepareiza izpildgrāmata ir daudz bīstamāka nekā neviena, un saglabāt dokumentāciju izmaiņu procesā
Dokumentācija un informācijas pārvaldība: rokasgrāmata, arhitektūra un institucionālā atmiņa ar AI
Visvairāk novārtā atstātais, bet dzīvību glābjošais sistēmas vadības uzdevums ir dokumentēšana. Kad sistēma avarē un persona, kas to uzbūvēja, ir atvaļinājumā un nav rakstīta vārda par to, kā atgūties, visiem ir gara nakts. Dokumentācija ir institucionālā atmiņa, kas padara rakstītu un pieejamu, kā sistēma ir iestatīta, kā tā darbojas un kā rīkoties, ja rodas problēma. Vissvarīgākais šīs atmiņas veids ir izpildgrāmata: darbības rokasgrāmata, kurā soli pa solim ir norādīts, kā rīkoties konkrētā situācijā (pakalpojums avarēja, disks ir pilns, dublēšana neizdevās). Šeit mākslīgais intelekts atrisina "tukšas lapas" un "slinkuma" problēmu, kas ir lielākie dokumentācijas rakstīšanas ienaidnieki: tas izveido sakārtotu izpildgrāmatu no jūsu izkaisītajām piezīmēm, procedūru no komandu vēstures, aprakstu no arhitektūras. Bet kritiskais princips: AI ražo rasējumus un skeletus; Jūs esat tas, kurš pārbauda un apstiprina katru darbību, lai noskaidrotu, vai tas tiešām ir pareizs — nepareiza izpildgrāmata ir daudz bīstamāka nekā tā, lai tā nebūtu vispār.
Šajā nodaļā izpildgrāmata, pēcnāves (pēcnotikuma izmeklēšanas ziņojums), arhitektūras dokumentācijas un zināšanu bāzes rakstīšana; Melnrakstu ģenerēšana ar AI; un pats galvenais, jūs uzzināsit riskus, ko rada nepārbaudīta dokumentācija.
Kāpēc nepareiza izpildgrāmata ir sliktāka nekā neviena runbook?
Šī ir šīs vienības vissvarīgākā koncepcija. Komanda bez runbook ir piesardzīga un aizdomīga panikas laikā; pārdomā katru komandu divreiz. Bet kāds, kam ir “oficiāla” rokasgrāmata, tam akli uzticas — nakts vidū, stresa apstākļos, bez šaubām izpilda darbības. Ja šī izpildgrāmata tiek izlaista, to neizgatavojot un nepārbaudot AI, un tajā ir viena kļūda (nepareiza komanda, trūkstošs priekšnoteikums, izlaists atkāpšanās solis), rezultāts ir postošs. Tāpēc katrs ar AI izveidots runbook ir jāpalaiž no sākuma līdz beigām reālā vidē, un katrs solis ir jāpārbauda pirms tā publicēšanas. Nepārbaudīts runbook ir kā pārliecinošs, bet tukšs solījums.
Uzmanību! Runbook apzīmogojiet ar "pārbaudīts: [datums], [persona]". Skaidri atzīmējiet nepārbaudītus melnrakstus ar iezīmi “MELNS — NAV PĀRBAUDĪTS”. Tātad neviens droši neveiktu nepārbaudītus soļus reālā krīzē.
Labas rokasgrāmatas anatomija
Laba izpildgrāmata sastāv no konkrētām daļām, un mākslīgais intelekts labi spēj izveidot šo skeletu: nosaukums un mērķis (kādai situācijai), priekšnosacījumi (kāda piekļuve, kāds rīks ir nepieciešams), simptomi (kad izmantot šo izpildgrāmatu), darbības (ar numurētām, kopējamām komandām), validācija (kā atpazīt panākumus pēc katras darbības), atcelšana (kā atsaukt darbību, ja darbība ir neveiksmīga) un eskalācija (kas varu darīt). Jūs varat dot AI savas izkaisītās piezīmes un lūgt to ievietot šajā struktūrā; Jūs garantējat tikai satura precizitāti.
Soli pa solim: dokumentācijas veidošana ar AI
- Savāc izejvielu. Jūsu komandu vēsture, jūsu piezīmes, vecs e-pasts, tērzēšanas žurnāls — īsts materiāls, pat ja tas ir netīrs, ir labāks par mākslīgā intelekta izgudrojumu.
- Jautājiet par struktūru. “Padariet šo rokasgrāmatu ar šādiem virsrakstiem: mērķis, priekšnoteikums, simptoms, darbības, verifikācija, atcelšana, eskalācija.”
- Aizliegt safabricēšanu. "Nepievienojiet komandas, IP, versijas vai darbības, kuras es jums neesmu devis; atzīmējiet visas trūkstošās daļas kā [TO BE FILLED]." Tas novērš visbīstamāko kļūdu — šķietami ticamos izdomātos soļus.
- Maska. Izmantojiet vietturi, nevis faktisko resursdatoru, IP, lietotāju; Ja dokuments tiek koplietots, noslēpums nedrīkst tikt nopludināts.
- Pārbaudi to. Palaidiet izpildgrāmatu no sākuma līdz beigām reālā (vēlams testa) vidē. Labojiet visas darbības, kas nedarbojas, trūkst vai ir neskaidras.
- Apzīmogojiet un publicējiet. Pievienojiet pārbaudes datumu, testētāju un pēdējo atjauninājumu. Dokumentācija ir dzīva; Tas ir jāatjaunina, kad sistēma mainās.
trīs mini futrāļi
1. gadījums — 2 stundas darba, 15 minūtes. Administrators mēnešiem ilgi atlika dublējuma atjaunošanas procedūras dokumentēšanu. Viņš sniedza termināļa komandu vēsturi (maskētu) un dažas izkliedētas piezīmes AI un ievietoja to runbook ietvarā. AI 15 minūtēs izveidoja glītu kontūru. Administrators pavadīja nākamās 45 minūtes, palaistot melnrakstu no sākuma līdz beigām testa serverī un labojot divus trūkstošos soļus. Rezultāts: pārbaudīts, uzticams rokasgrāmata.
2. gadījums — pieķerts nepatiesi. Kādai komandai AI lika rakstīt pakalpojuma restartēšanas rokasgrāmatu, taču tā aizmirsa aizliegt "izgatavošanu". YZ pievienoja komandu "vispirms notīrīt kešatmiņu", kas šķiet loģiska, bet nepastāv šajā pakalpojumā. Par laimi, inženieris palaida runbook testa vidē; Šī komanda radīja kļūdu. Testa solis bija izdomāts solis, kas radītu apjukumu reālā krīzē.
3. gadījums — paātrināta pēcnāves pārbaude. Pēc liela pārtraukuma komandai vajadzēja uzrakstīt pēcnāves ziņojumu, taču neviens nevarēja sākt. Viņi nodeva AI notikuma laika skalu un maskētos žurnālus un lūdza nevainojamu pēcnāves skeletu — kopsavilkumu, ietekmi, laika grafiku, galveno cēloni, koriģējošās darbības. AI projekts samazināja stundas darbu līdz desmit minūtēm; Komanda veltīja savu enerģiju faktu pārbaudei un darbības jautājumu precizēšanai.
Četras kopējamas veidnes
1) Runbook skeleta ģenerēšana:
Jūsu loma: vecākais SRE. Izveidojiet izpildgrāmatu no tālāk norādītajām maskētajām piezīmēm/komandu vēstures. Virsraksti: Mērķis, Priekšnosacījumi, Simptomi (kad lietot), Soļi (numurēti, var kopēt), Verifikācija katrā solī, Atcelšana, Eskalācija. NOTEIKUMS: Neveidojiet nevienu komandu/IP/versiju/soli, ko es jums nedodu; uzrakstiet trūkstošās daļas [JĀAIZPILDZ]. Materiāls: [maskas piezīme]
2) Pēcnāves bez vainas:
Jūsu loma: incidentu izmeklēšanas koordinators. Uzrakstiet pēcnāves skici bez vainas, izmantojot šādu maskētu laika grafiku un žurnālus: kopsavilkums, ietekme (ilgums/tvērums), laika skala, galvenais iemesls (ja tas ir pārbaudīts), veicinošie faktori, koriģējošās darbības (īpašnieks + prioritāte). Nevainojiet cilvēku, koncentrējieties uz sistēmu. Nerakstiet galveno iemeslu bez pierādījumiem. Dati: [...]
3) Arhitektūra/pakalpojuma apraksts:
Uzrakstiet pakalpojuma dokumentu no šādas maskētas konfigurācijas/diagrammas informācijas: ko pakalpojums dara, no kādiem komponentiem tas sastāv, kādas ir tā atkarības, kā notiek datu plūsma, kādi porti/protokoli. Saglabājiet to tehnisku, bet lasāmu. Atzīmējiet attiecības, par kurām neesat pārliecināts, kā “nepieciešama pārbaude”. Informācija: [maskēts]
4) Dokumentācijas atsvaidzināšanas audits:
Pārskatiet šo esošo dokumentu un pārbaudiet valūtu: (1) kuras sadaļas trūkst/neskaidras, (2) kādas darbības šķiet nepārbaudītas, (3) kāda informācija varētu būt novecojusi? Pierakstiet, kas man būtu jājautā/pārbauda par katru atradumu. Dokuments: [maskēts dokuments]
Vāja uzvedne / spēcīga uzvedne
Vāja uzvedne:
Uzrakstiet man servera uzturēšanas rokasgrāmatu.
Nav īsta materiāla. AI veido tekstu, pilnībā pamatojoties uz savām vispārējām zināšanām, kas neatbilst jūsu videi vai satur pat izdomātas darbības. Tas ir bīstams viltus pārliecības avots.
Spēcīga uzvedne:
Jūsu loma: vecākais SRE. Tālāk ir redzama maskēto komandu vēsture un manas piezīmes, kuras es ieviesu notikumā "maksājumu pakalpojuma disks pilns". Izveidojiet izpildgrāmatu no šiem: mērķis, priekšnoteikums (piekļuve/rīks), simptomi, numurēti soļi (ar manām komandām), pārbaude katrā solī, atcelšana, eskalācija. Neliec man izpildīt pavēli, kuru es neesmu devis; Aizpildiet tukšu laukumu [JĀAIZPILDZ]. Beigās ievietojiet brīdinājumu "nav pārbaudīts". Materiāls: [maskētu komandu vēsture]
Dokumenta veids
AI ieguldījums
Cilvēka obligātais ieguldījums
runbook
Skelets + izkārtojums
Testēšana reālā vidē, precizitāte
Pēcnāves
Kontūra + struktūra
Pārbaudiet faktus un galveno cēloni
arhitektūras dokuments
Apraksts + plūsma
Apstipriniet attiecības un atkarības
Zināšanu bāzes raksts
ātrs melnraksts
Aktualitātes un precizitātes pārbaude
Biežas kļūdas
- Nepārbaudītu runbook publicēšana. Nepārbaudīti soļi tiek akli īstenoti krīzes apstākļos; Nepareiza rokasgrāmata ir katastrofa.
- Neuzlikt safabricēšanas aizliegumu. Ja jūs neteiksiet AI "nepievienojiet to, ko neesmu devis", tas radīs saprātīgus, bet nereālus soļus.
- Maskēšanas izlaišana. Noslēpums tiek nopludināts, kad tiek koplietots dokuments, kurā ir īsts saimniekdators, IP un lietotājs.
- Dokuments netiek atjaunināts. Dokumenti, kas netiek atjaunināti, mainoties sistēmai, laika gaitā kļūst maldinoši.
- Izdošana bez zīmoga. Nav skaidrs, vai dokuments bez pārbaudes datuma un statusa ir uzticams vai melnraksts.
Padoms. Labākais veids, kā uzturēt dokumentāciju “dzīvu”, ir saistīt to ar izmaiņu procesu: mainoties sistēmai, ļaujiet attiecīgās izpildgrāmatas atjaunināšanai būt vienam no izmaiņu pabeigšanas kritērijiem. AI paātrina atjaunināšanu, taču jūs esat iedarbināšanas process.
Rezumējot
Dokumentācija ir institucionālā atmiņa; Runbook ir darbības rokasgrāmata, kas glābj dzīvības krīzes laikā. AI izveido sakārtotus melnrakstus no jūsu nekārtīgajām piezīmēm, atrisinot tukšo lapu un slinkuma problēmu. Bet viskritiskākā patiesība ir šāda: nepareiza rokasgrāmata ir daudz bīstamāka nekā neviena, jo tā tiek akli piemērota krīzes situācijā. Tāpēc aizliedziet AI “izgatavošanu”, maskējiet to un rūpīgi pārbaudiet un apzīmogojiet katru runbook reālā vidē. Saglabājiet dokumentu dzīvu, kad sistēma mainās. AI veido ietvaru; Jūs esat tas, kurš garantē precizitāti un pārbaudi.
Lietojumprogrammas uzdevums
Izvēlieties procedūru, kas jūsu komandā nav dokumentēta (piemēram, pakalpojuma restartēšana vai dublējuma atjaunošana). Maskējiet savu atbilstošo komandu vēsturi un piezīmes un ļaujiet AI izveidot melnrakstu, izmantojot iepriekš redzamo veidni "Runbook skeleton generation"; Noteikti nosakiet izdomājumu aizliegumu. Izpildiet melnrakstu testa vidē un atzīmējiet un izlabojiet visas bojātās/trūkstošās darbības. Pievienojiet testa datumu un testētāja informāciju izpildgrāmatai. Pierakstiet atšķirības, ko rada AI, un šajā procesā izlabojiet 5 punktos.
kontrolsaraksts
- [ ] Es izveidoju runbook no reāla materiāla (piezīme, komandu vēsture), vai es to neizveidoju no nulles?
- [ ] Vai esmu aizliedzis AI “pievienot komandas/IP/soļus, ko neesmu devis”?
- [ ] Vai esmu maskējis sensitīvu informāciju, piemēram, resursdatoru, IP un lietotāju?
- [ ] Vai esmu palaidis un apstiprinājis izpildgrāmatu reālā/testa vidē?
- [ ] Vai esmu pievienojis pārbaudes datumu, testētāju un pēdējās atjaunināšanas informāciju?
- [ ] Vai esmu plānojis saistīt dokumentu ar sistēmas izmaiņu procesu un atjaunināt to?