Як зрозуміти, що застосунок за останні три дні працював справно?

Повне пояснення

Що це і навіщо

Під «працював справно» розуміємо, що всі критичні процеси виконувалися без помилок і відповідають вимогам SLA. Для перевірки потрібні дані про виконання запитів, логування та моніторинг.

Ключові принципи

• Логи – запис всіх помилок, попереджень і інформаційних повідомлень.
• Метрики – час відповіді, кількість запитів, використання ресурсів.
• Health‑check – endpoint (наприклад, /health) що повертає статус 200 при нормальній роботі.
• Моніторинг – інструменти (Prometheus, Grafana, Datadog) що збирають метрики.
• CI/CD – статус деплойментів, автоматичні тести.

Як це працює

1. Логи збираються через Winston/PM2 і зберігаються у файловій системі або в ELK‑стек.
2. Метрики збираються через prom-client у Node.js і експортуються на /metrics.
3. Health‑check повертає JSON: {status:'ok', uptime:123456}.
4. Моніторинг підключає ці точки, створює графіки і алерти.
5. CI/CD запускає unit/integration тести після кожного коміту.

Практика і реалізація (Node.js/Express)

// health-check
app.get('/health', (req, res) => {
  res.json({status: 'ok', uptime: process.uptime()});
});

// metrics with prom-client
const client = require('prom-client');
app.get('/metrics', async (req, res) => {
  res.set('Content-Type', client.register.contentType);
  res.end(await client.register.metrics());
});

Тестування

• Unit: Jest + supertest для /health.
• Integration: перевірка, що всі маршрути повертають 200.
• E2E: Playwright, що запускає реальний сервер і перевіряє uptime.

Безпека

• Логи не містять конфіденційних даних (паролі, токени).
• Метрики доступні лише внутрішньому мережі.

Оптимізація

• Кешування результатів health‑check (наприклад, 5 секунд).
• Підключення cluster або PM2 для масштабування.

Часті помилки

1. Логи не збираються – перевірте конфіг Winston.
2. Health‑check повертає 500 – перевірте залежності (DB, Redis).
3. Метрики не експортуються – переконайтеся, що /metrics доступний.
4. CI/CD не запускає тести – перевірте скрипти в package.json.
5. Моніторинг не підключений – налаштуйте Prometheus.
6. Uptime > 0, але помилки – перевірте error‑middleware.
7. Відсутність алертів – налаштуйте пороги в Grafana.
8. Логи зберігаються лише у пам’яті – використайте winston-daily-rotate-file.

Cheatsheet

Follow‑up питання

• Як налаштувати алерти в Grafana для health‑check?
• Які метрики найважливіші для моніторингу Node.js сервера?