Dokumentatsioon ja teabehaldus: käsiraamat, surmajärgne mälu ja ettevõtte mälu

Kasu:

• Võimalus toota tehisintellektiga hajutatud märkmetest runbooki, surmajärgseid ja arhitektuurilisi dokumente
• Võime jõustada väljamõeldud keelu kehtestamise distsipliini ning iga runbooki põhjalikku testimist ja märgistamist reaalses keskkonnas
• Oskus mõista, et vale käsiraamat on ohtlikum kui mitte ükski ja hoida dokumentatsiooni muudatuse käigus elus

Dokumentatsioon ja teabehaldus: käsiraamat, arhitektuur ja institutsionaalne mälu koos tehisintellektiga

Süsteemihalduse kõige tähelepanuta jäetud, kuid elupäästvam ülesanne on dokumenteerimine. Kui süsteem jookseb kokku ja selle ehitaja on puhkusel ning taastumise kohta pole kirjalikku sõna, on see kõigi jaoks pikk öö. Dokumentatsioon on institutsionaalne mälu, mis teeb kirjalikuks ja kättesaadavaks, kuidas süsteem on üles seatud, kuidas see töötab ja mida teha probleemi ilmnemisel. Selle mälu kõige kriitilisem tüüp on runbook: kasutusjuhend, mis ütleb teile samm-sammult, mida antud olukorras teha (teenus jooksis kokku, ketas täis, varundamine ebaõnnestus). Siin lahendab tehisintellekt "tühja lehe" ja "laiskuse" probleemi, mis on dokumentatsiooni kirjutamise suurimad vaenlased: see loob teie hajutatud märkmetest korrastatud käsiraamatu, käsuajaloost protseduuri, arhitektuuri kirjelduse. Kuid kriitiline põhimõte: AI toodab jooniseid ja skelette; Teie olete see, kes testib ja kinnitate iga sammu, et näha, kas see on tegelikult õige – vale runbook on ohtlikum kui selle puudumine.

Selles üksuses käsiraamatu, surmajärgse (sündmusejärgse uurimise aruande), arhitektuurse dokumentatsiooni ja teadmistebaasi kirjutamine; Mustandite genereerimine tehisintellektiga; ja mis kõige tähtsam, saate teada kontrollimata dokumentatsiooniga seotud riskidest.

Miks on vale käsiraamat hullem kui selle puudumine?

See on selle üksuse kõige olulisem kontseptsioon. Ilma juhendita meeskond on paanika ajal ettevaatlik ja kahtlustav; mõtleb iga käsu peale kaks korda. Kuid keegi, kellel on "ametlik" käsiraamat, usaldab seda pimesi – keset ööd, stressis, sooritades samme kahtlemata. Kui see käsiraamat avaldatakse ilma AI poolt tootmata ja testimata ning selles on üks samm valesti (vale käsk, puuduv eeltingimus, vahele jäetud varuetapp), on tulemus katastroofiline. Seetõttu tuleb iga tehisintellektiga toodetud käsiraamatut algusest lõpuni käivitada reaalses keskkonnas ja iga samm tuleb enne avaldamist kontrollida. Testimata runbook on nagu rahustav, kuid tühi lubadus.

Ettevaatust: tembeldage käsiraamatule tekst "testitud: [kuupäev], [isik]". Märgistage testimata mustandid selgelt sildiga „MUSTANN – EI KINNITA”. Nii et keegi ei rakendaks tõelises kriisis kontrollimata samme turvaliselt.

Hea käsiraamatu anatoomia

Hea käsiraamat koosneb kindlatest osadest ja tehisintellekt on selle luustiku loomisel hea: pealkiri ja eesmärk (millise olukorra jaoks), eeldused (milline juurdepääs, millist tööriista vaja), sümptomid (millal seda käsiraamatut kasutada), sammud (nummerdatud, kopeeritavate käskudega), valideerimine (kuidas pärast iga sammu edu tuvastada), tagasivõtmine (kuidas samm tagasi võtta, kui samm läheb halvasti) ja ma mõtlen välja, kui ma saan hakkama. Saate anda tehisintellektile oma hajutatud märkmed ja paluda see sellesse struktuuri lisada; Teie tagate ainult sisu täpsuse.

Samm-sammult: dokumentide koostamine AI-ga

1. Koguge tooraine kokku. Teie käsuajalugu, märkmed, vana e-kiri, vestluslogi – tõeline materjal, isegi kui see on segane, on parem kui tehisintellekti väljamõeldis.
2. Küsi struktuuri. "Tehke sellest käsiraamat järgmiste pealkirjadega: eesmärk, eeltingimus, sümptom, sammud, kinnitamine, tagasivõtmine, eskalatsioon."
3. Keelake väljamõeldis. "Ärge lisage käske, IP-sid, versioone ega samme, mida ma pole teile andnud; märkige puuduolevad osad kui [TO BE FILLED]." See hoiab ära kõige ohtlikuma vea — näiliselt usutavate väljamõeldud sammude.
4. Mask. Kasutage tegeliku hosti, IP, kasutaja asemel kohatäit; Kui dokumenti jagatakse, ei tohiks saladus välja lekkida.
5. Katsetage seda. Käivitage runbook algusest lõpuni reaalses (eelistatavalt test) keskkonnas. Parandage kõik toimingud, mis ei tööta, puuduvad või on ebaselged.
6. Tempel ja avalda. Lisage testimise kuupäev, tester ja viimane värskendus. Dokumentatsioon on elav; Seda tuleb süsteemi muutumisel värskendada.

kolm minikarpi

Juhtum 1 — 2 tundi tööd, 15 minutit. Administraator oli mitu kuud varukoopia taastamise protseduuri dokumenteerimist edasi lükanud. Ta andis AI-le terminali käskude ajaloo (maskeeritud) ja mõned hajutatud märkmed ning sisestas selle runbooki raamistikku. AI koostas 15 minutiga kena kontuuri. Administraator kulutas järgmised 45 minutit mustandi algusest lõpuni testserveris jooksmisele ja kahe puuduva sammu parandamisele. Tulemus: testitud ja usaldusväärne käsiraamat.

2. juhtum – tabati valesti. Meeskond lasi AI-l kirjutada teenuse taaskäivitamise käsiraamatu, kuid unustas "tootmise" keelata. YZ lisas käsu "esmalt tühjenda vahemälu", mis tundub loogiline, kuid seda selles teenuses ei eksisteeri. Õnneks käivitas insener runbooki testkeskkonnas; See käsk andis vea. Testetapp tabas väljamõeldud sammu, mis tekitaks tõelises kriisis segadust.

Juhtum 3 – tapajärgne kiirendatud. Pärast suurt katkestust pidi meeskond kirjutama surmajärgse aruande, kuid keegi ei saanud alustada. Nad andsid tehisintellektile üle sündmuse ajaskaala ja maskeeritud logid ning palusid laitmatut surmajärgset luustikku – kokkuvõtet, mõju, ajaskaala, algpõhjus, parandusmeetmed. AI-projekt vähendas tunni töö kümne minutini; Meeskond pühendas oma energia faktide kontrollimisele ja tegevuspunktide selgitamisele.

Neli kopeeritavat malli

1) Runbooki skeleti loomine:

Sinu roll: vanem SRE. Looge allolevatest maskeeritud märkmetest/käskude ajaloost runbook. Pealkirjad: Eesmärk, Eeltingimused, Sümptomid (millal kasutada), Sammud (nummerdatud, saab kopeerida), Kontrollimine igal etapil, Tagasivõtmine, Eskalatsioon. REEGEL: ära mõtle välja ühtegi käsku/IP-d/versiooni/sammu, mida ma sulle ei anna; kirjutage puuduvad osad [TOBE FILLED]. Materjal: [maskeeritud märkus]

2) Post mortem ilma süüdistamiseta:

Teie roll: juhtumi uurimise abistaja. Kirjutage SÜÜDISTUSVABA surmajärgne visand järgmistest maskeeritud ajaskaaladest ja logidest: kokkuvõte, mõju (kestus/ulatus), ajaskaala, algpõhjus (kui see on kinnitatud), kaasaaitavad tegurid, parandusmeetmed (omanik + prioriteet). Ärge süüdistage inimest, keskenduge süsteemile. Ärge kirjutage algpõhjust ilma tõenditeta. Andmed: [...]

3) Arhitektuur/teenuse kirjeldus:

Koostage hooldusdokument järgmisest maskeeritud konfiguratsiooni/skeemi teabest: mida teenus teeb, millistest komponentidest see koosneb, millised on selle sõltuvused, kuidas toimub andmete liikumine, millised pordid/protokollid. Hoidke see tehniline, kuid loetav. Märkige suhe, milles te pole kindel, kui "vajab kinnitamist". Info: [maskeeritud]

4) Dokumentide täiendusaudit:

Vaadake üle järgmine olemasolev dokument ja kontrollige valuutat: (1) millised jaotised puuduvad / ebaselged, (2) millised sammud näivad olevat testimata, (3) milline teave võib olla aegunud? Kirjutage üles, mida peaksin iga leiu kohta küsima/kontrollima. Dokument: [maskeeritud dokument]

Nõrk viip / Tugev viip

Nõrk viip:

Kirjutage mulle serveri hoolduse käsiraamat.

Päris materjali pole. AI loob teksti, mis põhineb täielikult oma üldistel teadmistel ja mis ei sobi teie keskkonda või sisaldab isegi väljamõeldud samme. See on vale kindlustunde ohtlik allikas.

Võimas viip:

Sinu roll: vanem SRE. Allpool on maskeeritud käskude ajalugu ja minu märkmed, mille rakendasin sündmuse "makseteenuse ketas täis" puhul. Looge nendest käsiraamat: eesmärk, eeldus (juurdepääs/tööriist), sümptom, nummerdatud sammud (minu käskudega), kinnitamine igal etapil, tagasivõtmine, eskalatsioon. Ära sunni mind täitma käsku, mida ma pole andnud; Tehke tühi [TO BE FILLED]. Pange lõppu hoiatus "mitte testitud". Materjal: [maskeeritud käsu ajalugu]

Dokumendi tüüp

AI panus

Inimese kohustuslik panus

käsiraamat

Skelett + paigutus

Testimine reaalses keskkonnas, täpsus

Surmajärgne

Kontuur + struktuur

Kontrollige fakte ja algpõhjust

arhitektuuridokument

Kirjeldus + vool

Kinnitage suhteid ja sõltuvusi

Teadmistebaasi artikkel

kiire mustand

Ajakohasuse ja täpsuse kontroll

Levinud vead

• Testimata käsiraamatute avaldamine. Kontrollimata samme rakendatakse kriisis pimesi; Vale käsiraamat on katastroof.
• Mitte kehtestada fabritseerimiskeeldu. Kui te ei ütle tehisintellektile "ära lisa seda, mida ma pole andnud", teeb see mõistlikke, kuid ebareaalseid samme.
• Maskeerimise vahelejätmine. Saladus lekib, kui jagatakse tõelist hosti, IP-d ja kasutajat sisaldavat dokumenti.
• Dokumenti ei värskendata. Dokumendid, mida süsteemi muutmisel ei värskendata, muutuvad aja jooksul eksitavaks.
• Avaldamine ilma margita. Pole selge, kas ilma testimiskuupäeva ja -olekuta dokument on usaldusväärne või mustand.

Näpunäide. Parim viis dokumentatsiooni aktiivsena hoidmiseks on siduda see muudatusprotsessiga: kui süsteem muutub, olgu asjakohase runbooki värskendamine üks muudatuse lõpuleviimise kriteeriume. AI kiirendab värskendamist, kuid käivitaja olete teie.

Kokkuvõttes

Dokumentatsioon on institutsionaalne mälu; Käsiraamat on tegevusjuhend, mis päästab elusid kriisiaegadel. AI toodab teie segasetest märkmetest organiseeritud mustandeid, lahendades tühjade lehtede ja laiskuse probleemi. Kuid kõige kriitilisem tõde on järgmine: vale käsiraamat on ohtlikum kui üldse mitte, sest seda rakendatakse kriisiolukorras pimesi. Seega keelake tehisintellektil "tootmine", maskeerige see ning testige ja tembeldage iga runbook reaalses keskkonnas põhjalikult. Hoidke dokumenti elus, kui süsteem muutub. AI loob raamistiku; Teie olete see, kes tagab täpsuse ja testimise.

Rakenduse ülesanne

Valige protseduur, mis pole teie meeskonnas dokumenteeritud (nt teenuse taaskäivitamine või varukoopia taastamine). Maskeerige oma asjakohane käskude ajalugu ja märkmed ning laske tehisintellektil ülaltoodud malli "Runbooki skeleti genereerimine" abil mustand luua; Kindlasti kehtestage väljamõeldistele keeld. Käivitage mustand testkeskkonnas ja märgistage ning parandage kõik katkised/puuduvad sammud. Lisage käsiraamatusse testimise kuupäev ja testija teave. Kirjutage AI tekitatud erinevused üles ja parandate selle käigus 5 punktis.

kontrollnimekiri

• [ ] Ma lõin runbooki päris materjalist (märkus, käsuajalugu), kas ma ei koostanud seda nullist?
• [ ] Kas ma olen keelanud AI-l "käskude/IP-de/sammude lisamise, mida ma pole andnud"?
• [ ] Kas olen varjanud tundlikku teavet, nagu host, IP ja kasutaja?
• [ ] Kas olen käivitanud ja kinnitanud runbooki reaalses/testkeskkonnas?
• [ ] Kas olen lisanud testimise kuupäeva, testija ja viimase värskenduse teabe?
• [ ] Kas olen plaaninud dokumendi siduda süsteemi muutmise protsessiga ja hoida seda ajakohasena?