Як написати резюме інциденту після смерті англійською мовою
Вивчіть англійські фрази для написання розділу резюме інциденту після смерті: ясно, фактично і без звинувачень.
Резюме в верхній частині постмортуму часто є єдиною частиною, яку більшість читачів побачать, тому воно повинно передати вплив, причину і рішення в декількох чітких реченнях - без мінімізації інциденту або призначення окремої звинувачення.
Визначити значення значення
Поясніть, що сталося з користувачами або бізнесом, в конкретних термінах.
- Між 14:02 і 14:47 UTC, користувачі відчували підвищений рівень помилок при оплате, що вплинуло приблизно на 8% транзакцій
- Цей інцидент спричинив повний відключення служби сповіщення; інші системи не були вражені
- «Втрата даних під час цього інциденту не була, хоча підмножина запитів отримала запізнені відповіді»
Причина смерті невідома, не виключена грабіж
Описати причину як помилку системи або процесу, а не як помилку людини.
- «Коренева причина була зміна конфігурації, яка вилучала необхідний тайм-аут, який не був виявлений існуючими перевірками перевірки»
- «Міграція бази даних працювала без очікуваного індексу, що призвело до того, що час запиту різко знизився під час виробничої навантаження»
- «Конвейєр розгортання дозволив несумісну версію залежності, яку існуючі тести не охоплюють.»
Визначення і опис
Поясніть, як була виявлена проблема і як швидко команда відповіла.
- “Проблема була вперше виявлена автоматичним попередженням через 6 хвилин після того, як зміна була розгорнута, і інженер по телефону почав розслідування протягом 2 хвилин.”
- «Виявлення покладалося на звіт клієнта, а не на внутрішній моніторинг, який ми позначили як прогалини, які потрібно закрити»
- Команда виявила помилкову зміну і відновила її протягом 18 хвилин після першої попередження
Пояснення резолюції
Визначте, що виправило проблему.
- «Інцидент був вирішений шляхом повернення розгортання до попередньої стабільної версії.»
- «Ми вирішили проблему, вручну перезапустивши втрачену службу і застосувавши тимчасове обмеження швидкості, поки не буде відправлено постійне виправлення»
- «Відновлення відсутнього тайм-ауту було розгорнуто і підтверджено, щоб вирішити підвищений рівень помилок.»
Наступні кроки
Завершується конкретними, власними діями, а не неясними намірами.
- «Ми додаємо перевірку підтвердження до конвеєра розгортання, щоб вловити цей клас помилок конфігурації, перш ніж він досягне виробництва»
- «Дії, що слідують, включають поліпшення покриття моніторингу для цієї служби і додавання етапу розгортання канарії»
- «Кожен елемент дії нижче має присвоєного власника і дату мети; це резюме буде оновлено, як тільки вони будуть завершені.»
Словник-довідник
| Term | Meaning |
|---|---|
| Root cause | The underlying factor that triggered an incident, distinct from its symptoms |
| Blameless postmortem | A postmortem focused on systemic causes rather than individual fault |
| Time to detect (TTD) | The time between an issue starting and it being identified |
| Time to resolve (TTR) | The time between an issue starting and it being fully resolved |
| Action item | A specific, owned follow-up task intended to prevent recurrence |
Ключеві моменти
- Підсумуйте з конкретним впливом - хто був вражений, наскільки довго і наскільки серйозно.
- Описуйте основну причину як прогалини в системі або процесі, ніколи як помилку людини.
- Визначте фактичні часи виявлення і відповіді, використовуючи їх для підсвічування прогалин, а не для приписування вини.
- Поясніть розв’ язання простими, конкретними словами, щоб нетехнічний читач міг зрозуміти його.
- Закрити з власними, конкретними пунктами дій, а не неясними зобов’язаннями «пізнайомитися з моніторингом»
Навигація: мова розглядів для постмортемів
Написання ефективного постмортного висновку не просто про документування того, що сталося; це про передачу цієї інформації чітко і конструктивно. Для не рідних англомовних носіїв це може бути особливо складним, особливо коли справа доходить до формальної мови, часто використовуваної в технічній документації і звітах про інциденти. Важливо вийти за рамки простого перекладу своїх ідей на англійську мову і натомість вивчати конкретний словниковий запас і фрази, що сприяють продуктивній постмодерній дискусії. Поширеною пасткою є використання надмірно драматичної або емоційно зарядженої мови - фрази на кшталт “ми повністю зіпсували це” негайно вводять звинувачення, що перемагає мету вивчення помилок. Замість цього, зосередьтеся на точності та об’єктивності.
Одна з областей, де тонкі відмінності в англійській мові можуть викликати плутанину, це опис причини проти наслідку. У багатьох мовах пряме твердження про причинність може бути більш поширеним. Однак, в професійних постмортних, ми використовуємо такі фрази, як «в результаті», «через», або «зумовлені» для підтримки неупередженого тону. Наприклад, замість того, щоб сказати « Аварія бази даних була спричинена оновленням », ви можете написати « Аварія бази даних * сталася * через розгортання нового оновлення ». Ця фраза уникає приписування вини і зосереджується на послідовності подій. Аналогічно, визнання того, що простого «ми зробили це неправильно» недостатньо — його потрібно замінити більш детальним поясненням — є ключовим.
Давайте поглянемо на деякі практичні сценарії. Розглянемо коментар перегляду коду: « Ця функція надто складна і важко зрозуміти ». Людина, для якої мова є рідною, може сказати щось на зразок: « Логіку цієї функції можна було б спростити ». Ця переглянута формулювання є менш обвинувачувальною і містить конструктивні пропозиції щодо поліпшення. Або уявіть повідомлення Slack під час постмортемної дискусії: «Ми повинні з’ясувати, чому це сталося». Краще було б сказати: «Давайте проаналізуємо журнали, щоб визначити кореневу причину проблеми» - це більше зосереджено на розслідуванні, ніж на приписуванні відповідальності. Метою завжди є розглянути ситуацію як можливість для навчання і вдосконалення.
Нарешті, зверніть увагу на структуру речення. Довші, складніші речення часто звучать менш професійно. Розбиття їх на коротші, ясніші вислови покращує читабельність і зменшує неоднозначність. Пам’ятайте, що головною функцією постмортуму є полегшення розуміння - ясність мови безпосередньо сприяє досягненню цієї мети. Сфокусировались на том, чтобы передать “что” случилось, “как” это случилось и “почему”, без введения личных суждений или предположений.