● ХАРДКОДИНГ PRO

Гайд №12.
Логи, мониторинг и диагностика

Как видеть, что происходит внутри твоего проекта, замечать проблемы раньше пользователей и давать ИИ реальные данные для диагностики. Без необходимости становиться программистом.

Логи простыми словамиМониторинг 24/7УведомленияИИ-диагностика6 промптов25 проверок

Обложка: Гайд №12. Логи, мониторинг и диагностика

1. Зачем вообще нужны логи и мониторинг

Когда бот или сайт перестал работать, без данных ты видишь только результат: «не работает». Но не понимаешь, когда началась проблема, что произошло перед ней и какая часть системы виновата.

Главная идея: логи дают историю событий, а мониторинг постоянно смотрит на текущее состояние проекта.

Без логов

Ты спрашиваешь ИИ: «Почему бот не отвечает?» И он вынужден гадать.

С логами

ИИ видит: в 20:14 внешний API вернул ошибку 429, после чего ответы перестали отправляться.

2. Что такое логи

Лог — это запись о событии внутри проекта. Представь обычный дневник или историю операций в банковском приложении.

Что такое логи простыми словами — исправленный визуал без лишней руки — Что такое логи простыми словами

21:14:02  INFO     Бот запущен
21:14:08  INFO     Получено сообщение пользователя
21:14:09  INFO     Запрос к ИИ выполнен
21:14:10  INFO     Ответ отправлен
21:17:31  WARNING  Внешний сервис отвечает медленно
21:19:04  ERROR    Не удалось сохранить данные

Тебе не нужно читать логи вручную каждый день. Они нужны в первую очередь ИИ и системе мониторинга, чтобы быстро найти причину проблемы.

3. Логи — это не только ошибки

Одна из самых частых ошибок новичка: записывать в лог только то, что сломалось. Тогда невозможно понять, что происходило до сбоя.

Логи записывают и нормальную работу, и проблемы

Нормальные события

пользователь вошёл;
запрос выполнен;
платёж подтверждён;
файл сохранён;
бот успешно отправил сообщение.

Проблемы

ошибка внешнего API;
таймаут;
база недоступна;
не хватает памяти;
сервис неожиданно остановился.

INFOОбычное важное событие. Всё идёт по плану.

WARNINGЧто-то необычно, но сервис пока работает.

ERRORКонкретная операция не выполнилась как нужно.

CRITICALСерьёзная проблема: сервис или ключевая функция недоступны.

4. Два режима логирования

Обычный режим

Работает постоянно. Записывает важные события, предупреждения и ошибки без лишнего шума.

Расширенный режим

Временно записывает намного больше технических деталей, чтобы поймать сложную проблему. После отладки его выключаем.

Аналогия: обычный режим — приборная панель автомобиля. Расширенный — компьютерная диагностика на сервисе.

Что нельзя писать в лог

пароли;
API-ключи и Telegram-токены;
приватные SSH-ключи;
полные данные банковских карт;
лишние персональные данные пользователей;
секретные строки из файла .env.

5. Что такое мониторинг

Если лог — это история событий, то мониторинг — автоматический наблюдатель, который постоянно спрашивает: «Сервис ещё жив? Всё в норме?»

По-человечески: тебе не нужно каждые 10 минут открывать сайт и проверять его вручную. Система делает это сама.

6. Какие показатели смотреть новичку

Что смотрим	Что это значит	Когда беспокоиться
Доступность	Можно ли открыть сайт или получить ответ от бота	Несколько проверок подряд не проходят
Время ответа	Как быстро сервис отвечает пользователю	Ответы стали заметно медленнее обычного
Процессор	Насколько загружен сервер вычислениями	Долго держится возле максимума
Оперативная память	Хватает ли серверу рабочей памяти	Память почти закончилась
Место на диске	Есть ли куда писать файлы, базу и логи	Осталось мало свободного места
Ошибки	Сколько операций завершилось проблемой	Количество резко выросло

7. Проверка здоровья сервиса (health check)

Health check — специальная простая проверка состояния. Вместо сотен технических строк она даёт короткий ответ.

HEALTHY

Всё основное работает.

DEGRADED

Есть проблема, но сервис пока выполняет главную функцию.

UNHEALTHY

Критичная часть проекта недоступна.

{
  "status": "healthy",
  "app": "ok",
  "database": "ok",
  "disk": "ok"
}

8. Уведомления: чтобы проблема сама пришла к тебе

Хорошее уведомление

🔴 Сервис недоступен 6 минут.
Начало: 20:14.
Не отвечает: серверная часть.
База данных: доступна.
Последняя ошибка: соединение с внешним API.
Следующее действие: проверить последние ERROR-логи.

Не превращай мониторинг в спам. Если одна проблема длится час, не нужно присылать 60 одинаковых сообщений.

9. Дашборд: вся картина на одном экране

Дашборд — экран, где собраны главные показатели. Он не обязателен для первого маленького бота, но становится полезным, когда сервис растёт.

Дашборд: вся картина проекта на одном экране

Твоя цель: за 10 секунд понять «всё зелёное» или увидеть, где нужна проверка.

10. ИИ как диагност

Логи→Метрики→ИИ анализирует→Гипотеза→Проверка→Исправление

Получить конкретную ошибку.
Посмотреть события до и после неё.
Проверить связанные метрики.
Сопоставить проблему с последними изменениями.
Сформулировать вероятную причину.
Проверить гипотезу.
Только потом исправлять.
Повторно протестировать.

Не давай ИИ чинить по одной случайной строке. Пусть сначала докажет причину фактами.

11. Где и сколько хранить логи

Маленький проект

Для старта логи могут храниться обычными файлами на VPS. Главное — автоматическое удаление старых файлов и ограничение размера.

Проект растёт

Позже можно отправлять логи в специализированное хранилище и строить по ним поиск, графики и автоматические отчёты.

Для учебных и небольших проектов хорошее базовое правило — хранить подробные логи примерно 30 дней, если бизнес или закон не требуют другого срока.

Почему нужна очистка: бесконечные логи однажды заполнят диск сервера.

12. Готовые промпты для ИИ

Копируй их в ChatGPT, Codex или Claude Code. Они специально написаны так, чтобы ИИ сначала разобрался, а потом действовал.