re:re:actable
Урок 051 минута чтения

Как использовать console и structured logging?

На этой странице
Кратко

console подходит для простого вывода и отладки, но production-серверам часто нужен structured logging: JSON-записи с уровнем, временем, request id и контекстом ошибки.

Вопрос

Как использовать console и structured logging в Node.js?

console

console.log('Обычное сообщение');
console.info('Информация');
console.warn('Предупреждение');
console.error('Ошибка');

Для быстрых скриптов этого достаточно.

console.time

console.time('db');
 
await loadUsers();
 
console.timeEnd('db');

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

Почему structured logging полезнее?

Строки тяжело искать и агрегировать. JSON-лог проще отправить в ELK, Datadog, Grafana Loki или другой инструмент.

console.log(JSON.stringify({
  level: 'info',
  message: 'request completed',
  method: req.method,
  url: req.url,
  statusCode: res.statusCode,
  requestId: req.headers['x-request-id'],
}));

Что не логировать?

Не пиши в логи:

  • пароли;
  • access tokens;
  • refresh tokens;
  • приватные ключи;
  • полные cookie;
  • персональные данные без необходимости.

Что важно помнить

  • Structured logging — логи в формате JSON с полями level, msg, time, requestId.
  • В production используют pino или winston; pino почти не нагружает event loop.
  • Не логируйте пароли, токены и персональные данные.
  • console.time / console.timeEnd и console.table полезны для локальной отладки.

Мини-шпаргалка

  • console.log хорош для разработки.
  • console.error пишет в stderr.
  • Production-логи лучше делать структурированными.
  • Добавляй request id для трассировки.
  • Секреты и токены в логи не пишут.

Документация

Node.js: Console, pino.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам