Управљање документацијом и информацијама: Рунбоок, пост мортем и корпоративно памћење

Добици:

• Способност израде скелета рунбоока, пост-мортем и архитектонског документа од раштрканих белешки са вештачком интелигенцијом
• Способност спровођења дисциплине наметања 'забране фабрикације' и темељног тестирања и обележавања сваког приручника у стварном окружењу
• Способност да се разуме да је погрешан рунбоок опаснији од никаквог и да се документација одржава живом током процеса промене

Управљање документацијом и информацијама: Рунбоок, архитектура и институционална меморија са АИ

Најзапостављенији, али спасоносни задатак управљања системом је документовање. Када се систем сруши, а особа која га је изградила је на одмору и нема написаних речи о томе како да се опорави, то је дуга ноћ за све. Документација је институционална меморија која чини записано и доступном како је систем постављен, како функционише и шта треба учинити ако се појави проблем. Најкритичнији тип ове меморије је рунбоок: оперативни водич који вам говори корак по корак шта да радите у датој ситуацији (услуга је пала, диск пун, резервна копија није успела). Овде АИ решава проблем „празне странице“ и „лењости“, који су највећи непријатељи писања документације: производи организовани рунбоок из ваших раштрканих белешки, процедуру из историје команди, опис из архитектуре. Али критични принцип: АИ производи нацрте и скелете; Ви сте тај који тестира и потврђује сваки корак да бисте видели да ли је заиста исправан — погрешан рунбоок је опаснији него никакав.

У овој јединици, рунбоок, пост мортем (извештај о истрази након догађаја), писање архитектонске документације и базе знања; Генерисање нацрта са АИ; и што је најважније научићете ризике непроверене документације.

Зашто је погрешан рунбоок гори од непостојања рунбоока?

Ово је најважнији концепт ове јединице. Тим без рунбоока је опрезан и сумњичав у временима панике; двапут размисли о свакој команди. Али неко са „званичним“ рунбоок-ом му слепо верује — усред ноћи, под стресом, извршава кораке без питања. Ако је тај рунбоок објављен, а да га АИ није произвео и тестирао и ако је један корак погрешан (погрешна команда, недостајући предуслов, прескочен резервни корак), резултат је катастрофалан. Зато се сваки рунбоок произведен са АИ мора изводити од почетка до краја у стварном окружењу и сваки корак мора бити верификован пре него што буде објављен. Нетестирани рунбоок је као умирујуће, али празно обећање.

Опрез: Означите рунбоок са „тестирано: [датум], [особа]“. Непроверене нацрте јасно означите ознаком „НАЦРТ — НИЈЕ ВЕРИФИКОВАНО“. Дакле, нико не би безбедно применио непроверене кораке у правој кризи.

Анатомија доброг приручника

Добар рунбоок се састоји од специфичних делова, а АИ је добар у изградњи тог скелета: наслов и сврха (за коју ситуацију), предуслови (који приступ, који алат је потребан), симптоми (када да користим овај рунбоок), кораци (са нумерисаним командама које се могу копирати), валидација (како препознати успех након сваког корака), враћање уназад (како да поништим ако корак пође лоше) и како да урадим. Можете дати АИ своје разбацане белешке и замолити га да их стави у ову структуру; Ви само осигуравате тачност садржаја.

Корак по корак: Израда документације са АИ

1. Сакупите сировину. Ваша историја команди, ваше белешке, стара е-пошта, дневник ћаскања—прави материјал, чак и ако је неуредан, бољи је од АИ измишљотина.
2. Питајте за структуру. „Нека ово буде рунбоок са следећим насловима: сврха, предуслов, симптом, кораци, верификација, враћање, ескалација.“
3. Забранити измишљотине. „Немојте додавати ниједну команду, ИП адресе, верзије или кораке које вам нисам дао; означите све делове који недостају као [ТО БЕ ФИЛЛЕД].“ Ово спречава најопаснију грешку — наизглед уверљиве измишљене кораке.
4. Маска. Користите чувар места уместо стварног хоста, ИП адресе, корисника; Ако се документ дели, тајна не би требало да процури.
5. Тестирајте то. Покрените рунбоок од почетка до краја у стварном (пожељно тестном) окружењу. Поправите све кораке који не раде, недостају или нису јасни.
6. Штампајте и објавите. Додајте датум тестирања, тестер и последње ажурирање. Документација је жива; Мора се ажурирати када се систем промени.

три мини кофера

Случај 1 — 2 сата рада, 15 минута. Администратор је месецима одлагао документовање поступка враћања резервне копије. Дао је историју команди терминала (маскирану) и неколико раштрканих белешки АИ и убацио их у оквир рунбоок-а. АИ је направио уредан обрис за 15 минута. Администратор је провео наредних 45 минута радећи нацрт од почетка до краја на тест серверу и поправљајући два недостајућа корака. Резултат: тестиран, поуздан рунбоок.

Случај 2 — Лажно ухваћен. Тим је натерао АИ да напише рунбоок за поновно покретање сервиса, али је заборавио да забрани „фабрикацију“. ИЗ је додао команду „прво обриши кеш“, што изгледа логично, али не постоји у тој услузи. На срећу, инжењер је покренуо рунбоок у тестном окружењу; Та команда је дала грешку. Тестни корак је обухватио измишљени корак који би створио забуну у правој кризи.

Случај 3 — Убрзана обдукција. Након великог прекида, тим је морао да напише обдукцију, али нико није могао да почне. Предали су временску линију догађаја и маскиране дневнике АИ и тражили беспрекорни пост-мортем костур - резиме, утицај, временску линију, основни узрок, корективне мере. АИ план је смањио рад од сат времена на десет минута; Тим је своју енергију посветио верификацији чињеница и разјашњавању акција.

Четири шаблона за копирање

1) Генерисање рунбоок скелета:

Ваша улога: старији СРЕ. Направите рунбоок од маскираних белешки/историје команди испод. Наслови: Сврха, Предуслови, Симптоми (када користити), Кораци (нумерисани, могу се копирати), Верификација на сваком кораку, Враћање, Ескалација. ПРАВИЛО: Не измишљајте ниједну команду/ИП/верзију/корак који вам ја не дам; напиши делове који недостају [ПОПУЊАТИ]. Материјал: [маскирана белешка]

2) Обдукција без кривице:

Ваша улога: фасилитатор истраге инцидента. Напишите пост мортем скицу БЕЗ КРИВЕ из следеће маскиране временске линије и евиденције: Резиме, Утицај (трајање/обим), Временска линија, Основни узрок (ако је верификован), Фактори који доприносе, Корективне радње (власник + приоритет). Не кривите особу, фокусирајте се на систем. Не пишите основни узрок без доказа. Подаци: [...]

3) Архитектура/опис услуге:

Напишите сервисни документ из следећих маскираних информација о конфигурацији/дијаграму: шта сервис ради, од којих компоненти се састоји, које су његове зависности, како ток података, који портови/протоколи. Нека буде технички, али читљив. Означите везу за коју нисте сигурни као „потребна је верификација“. Информације: [маскиран]

4) Ревизија за освежавање документације:

Прегледајте следећи постојећи документ и проверите валуту: (1) који делови недостају/нејасни, (2) који кораци изгледају непроверени, (3) које информације су можда застареле? Запишите шта треба да питам/потврдим за сваки налаз. Документ: [маскирани документ]

Слаби промпт / Јаки промпт

Слабо обавештење:

Напишите ми приручник за одржавање сервера.

Правог материјала нема. АИ производи текст, у потпуности из сопственог општег знања, који се не уклапа у ваше окружење или чак садржи измишљене кораке. Ово је опасан извор лажног самопоуздања.

Снажан упит:

Ваша улога: старији СРЕ. Испод је маскирана историја команди и моје белешке које сам применио у догађају „диск услуге плаћања је пун“. Направите рунбоок од ових: Сврха, Предуслов (приступ/алат), Симптом, Нумерисани кораци (са мојим командама), Верификација на сваком кораку, Враћање, Ескалација. Не терајте ме да следим заповест коју нисам дао; Направите празно поље [ТО БЕ ФИЛЛЕД]. Ставите упозорење „није тестирано“ на крају. Материјал: [маскирана историја команди]

Врста документа

Допринос АИ

Обавезни допринос човека

рунбоок

Скелет + распоред

Тестирање у реалном окружењу, тачност

Пост мортем

Контура + структура

Проверите чињенице и основни узрок

архитектонски документ

Опис + проток

Потврдите односе и зависности

Чланак из базе знања

брзи нацрт

Провера актуелности и тачности

Уобичајене грешке

• Објављивање непроверених приручника. Непроверени кораци се слепо примењују у кризи; Погрешан рунбоок је катастрофа.
• Да не намећу забрану измишљотина. Ако не кажете АИ „не додај оно што нисам дао“, то ће произвести разумне, али нереалне кораке.
• Прескакање маскирања. Тајна процури када се дели документ који садржи правог домаћина, ИП адресу и корисника.
• Не ажурирање документа. Документи који се не ажурирају када се систем промени временом постају обмањујући.
• Издавање без печата. Није јасно да ли је документ без датума тестирања и статуса поуздан или је нацрт.

Савет: Најбољи начин да одржите документацију „живом“ је да је повежете са процесом промене: када се систем промени, нека ажурирање релевантног рунбоок-а буде један од критеријума за завршетак промене. АИ убрзава ажурирање, али ви сте покретач процеса.

Укратко

Документација је институционална меморија; Рунбоок је оперативни водич који спашава животе у временима кризе. АИ производи организоване нацрте из ваших неуредних белешки, решавајући проблем празних страница и лењости. Али најкритичнија истина је следећа: погрешан приручник је опаснији него никакав јер се слепо примењује у кризи. Зато забраните вештачкој интелигенцији да „фабрикује“, маскирајте је и темељно тестирајте и печатирајте сваки рунбоок у стварном окружењу. Одржавајте документ живим како се систем мења. АИ гради оквир; Ви сте тај који гарантује тачност и тестирање.

Задатак апликације

Изаберите процедуру која није документована у вашем тиму (на пример, поновно покретање услуге или враћање резервне копије). Замаскирајте своју релевантну историју команди и белешке и нека АИ направи нацрт користећи горњи шаблон „Генерација скелета Рунбоок-а“; Обавезно наметните забрану измишљотина. Покрените нацрт у тестном окружењу и означите и поправите све покварене/недостајуће кораке. Додајте датум тестирања и информације о испитивачу у рунбоок. Запишите разлике које АИ производи и исправите у процесу у 5 ставки.

контролна листа

• [ ] Направио сам рунбоок од стварног материјала (напомена, историја команди), зар га нисам направио од нуле?
• [ ] Да ли сам забранио АИ да "додаје команде/ИП-ове/кораке које нисам дао"?
• [ ] Да ли сам маскирао осетљиве информације као што су хост, ИП и корисник?
• [ ] Да ли сам покренуо и потврдио рунбоок у стварном/тестном окружењу?
• [ ] Да ли сам додао датум тестирања, тестер и информације о последњем ажурирању?
• [ ] Да ли сам планирао да повежем документ са процесом промене система и да га ажурирам?