How to Write a Capacity Planning Doc in English

Документ планування обсягу, який просто каже «з часом нам знадобиться більше серверів» не дає нікому рішення, яке потрібно прийняти — цей посібник охоплює структуру, яка перетворює планування обсягу на конкретні цифри, які команда може фактично бюджетувати і планувати.

Ключовий словник

** Поточне використання ** — базовий показник того, скільки існуючих об’ єктів використовується зараз, наприклад, відсоток процесора, пам’ яті або об’ єктів зберігання, зафіксований з достатньою точністю, щоб служити достовірною початковою точкою для прогнозів.

• “Почніть з поточного використання, яке буде ясно вказано: наша основна база даних використовує 65% процесорного часу під час пікового навантаження, а обсяг зберігання становить 70% від обумовленої ємності. Все інше в цьому документі складається з цих двох чисел.”*

** Прогноз зростання ** — явна, обґрунтована оцінка того, як попит збільшиться за визначений період, заснована на історичних даних про тенденції або відомих майбутніх подіях, а не на непояснених припущеннях. “Прогноз зростання тут не є припущенням - він заснований на наших останніх дванадцяти місяцях зростання користувачів, яке становило приблизно 8% місяць у місяць, екстраполювалося вперед з поміткою, що це не передбачає великого запуску продукту, що прискорює його далі.”

** Headroom target ** — буфер над прогнозованим піковим попитом, для якого слід забезпечити обсяг, обраний навмисно на основі того, наскільки команда готова прийняти ризик, порівняно з тим, наскільки дорого коштує неактивний обсяг. “Ми встановлюємо мету 40% над прогнозованим піком, а не лише 10%, тому що ця служба історично бачила раптові піки трафіку навколо запусків продуктів, і тонкий буфер спричиняв переривання для нас раніше.”

** Поріг спуску** — певний відсоток використання, який повинен спонукати до забезпечення більшої пропускної здатності, визначений заздалегідь, щоб рішення про масштабування не було прийнято реактивно під час інциденту. *“Ми встановлюємо тригерний поріг на рівні 75% тривалого використання - як тільки ми перетнути це послідовно, це повинно автоматично викликати перегляд ємності, а не чекати, поки ми будемо на 95% і перевертаючи під тиском.” *

Звичайні фрази

• «Що таке сучасна експлуатація на піку, а не просто середня?»
• Чи є це прогнозування зростання засноване на історичних даних, або це груба оцінка?»
• «Яка головна ціль, з якою ми комфортно, враховуючи вартість додаткових можливостей?»
• «На якому тригерному порозі ми насправді повинні забезпечити більшу потужність?»
• Чи відповідає ця проекція відомим майбутнім подіям, таким як запланований запуск?

Приклади висловлювань

Поточне використання вказати точно:

• “Поточне використання: служба оплати працює на 55% ЦП у середньому, але досягає піку на 82% під час щоденного піку навантаження між 18: 00 і 20: 00. Будь-який план пропускної здатності повинен бути побудований навколо цього пікового числа, а не середнього.»*

Виправдання проекції зростання:

• “Наш прогноз зростання передбачає 10% зростання користувачів з місяця в місяць, що відповідає останнім двом кварталам, плюс додаткові 25% одноразового удару навколо запланованого запуску мобільного додатку у вересні, на основі порівнянних запусків, які ми бачили раніше.” *

Встановлення порогу тригера: *“Ми пропонуємо порог тригера 70% тривалого використання протягом тижня - перетин, який повинен автоматично відкрити квиток перегляду ємності, тому ми забезпечуємо перед кризою, а не реагуємо на неї під час інциденту.” *

Професійні поради

• Звітувати про ** поточне використання ** у піковій, а не середній точці — середня оцінка використання може виглядати комфортно, якщо періоди піку вже близькі до обмеження пропускної здатності.
• Засновані на кожному ** прогнозу зростання ** на фактичних історичних даних і відомих майбутніх подій, і зазначте ці припущення явно - непояснене число запрошує скептицизм і важко переглянути пізніше.
• Виберіть ** цільовий обсяг ** навмисно, на основі вартості відключення порівняно з вартістю неактивної потужності, а не довільне число — різні служби потребують різних рівнів буфера.
• Визначте конкретний ** пороговий рівень тригера ** заздалегідь, щоб рішення про забезпечення більшої пропускної здатності було прийнято спокійно заздалегідь, а не реактивно під час піку або інциденту.

Практичні вправи

1. Написати звіти про поточне використання, які міститимуть середні і максимальні значення.
2. Сформулюйте речення проекції зростання, яке явно говорить про його основне припущення.
3. Написати клаузулу про порог тригера, у якій буде вказано точний відсоток і результат дії.

Наприклад, англ. browsing: перегляд, пошук

Документи планування потужностей - це не просто технічні специфікації; вони є важливими засобами комунікації. Погано сформулований документ може призвести до нерозуміння потреб у ресурсах, марних зусиль або навіть невдалого проекту. Тому звернення уваги на фрази і отримання конструктивного зворотнього зв’язку є надзвичайно важливим, особливо для тих, хто розвиває свою професійну англійську. Давайте поглянемо, як це відбувається в звичайних сценаріях на робочому місці.

Уявіть, що ви щойно надіслали черговий план обсягів для перегляду за допомогою Pull Request на GitHub. Під час перегляду коду старший інженер залишає коментар: «Чи можете ви пояснити припущення про «пікове навантаження»? Сказати «ми очікуємо удвічі поточного використання» є неясним - було б корисніше вказати * коли * цей пік відбувається (наприклад, під час конкретних маркетингових кампаній або сезонних подій) і що викликає ескалацію. “Це не про критику вашого письма; це про вдосконалення ясності вашого спілкування, що безпосередньо впливає на ефективність плану. Інженер по суті просить вас вийти за рамки простого висловлювання і надати контекст - конкретно, * чому * ця цифра 2x є актуальною. Більш гладка фраза може бути: «Ми прогнозуємо 2x пікове навантаження під час маркетингових кампаній Q4, що обумовлено очікуваним придбанням користувачів. Цей прогноз передбачає лінійне зростання трафіку до листопада, після чого буде поступове повернення до базового рівня в грудні»

Аналогічно, розгляньте розмову Slack з вашим лідером команди. Ви обговорюєте потребу у збільшенні обсягу сервера: « Нам дійсно потрібно більше оперативної пам’ яті на серверах баз даних ». Менш ефективною відповіддю було б просто зауважити про необхідність. Замість цього ви можете написати: « Щоб забезпечити відповідність прогнозованому зростанню користувачів і підтримувати прийнятну продуктивність під час періодів пік — як це описано у черговому плані збільшення обсягу — ми запитуємо збільшення на 32 ГБ ОЗУ для основного рівня бази даних. » Ця фраза показує, що ви розглянули ширший контекст плану і висловили * обґрунтування * свого запиту. Це показує, що ви розумієте наслідки недостатніх ресурсів і активно вирішуєте потенційні проблеми ще до того, як вони виникнуть. Пам’ятайте, ефективне спілкування не просто про передачу інформації; це про створення консенсусу і забезпечення того, щоб кожен був вирівняний з цілями. Сфокусування на точній мові, особливо навколо таких показників, як «пікова навантаження», «прогнози зростання» і «цілі вільних ресурсів» - всі ключові елементи сильного плану потужностей - значно зміцнить вашу загальну документацію і комунікаційну стратегію.