Graylog: 使用 Winston GELF 套件將 Node.js 日誌傳送到 Graylog

本文件是與 Node.js 搭配使用指南的一部分。請在此處查看完整指南:如何將 Node.js 的日誌傳送到 Graylog

👋 歡迎來到 Stackhero 文件!

Stackhero 提供一個即用型的 Graylog cloud 解決方案,帶來多項好處,包括:

  • 包含無限和專用的 SMTP 電郵伺服器
  • 只需一鍵即可輕鬆更新
  • 使用 HTTPS 保護的可自訂域名(例如,https://logs.your-company.com)。
  • 專用私有 VM提供的最佳性能和強大安全性

節省時間簡化您的生活:只需 5 分鐘即可嘗試 Stackhero 的 Graylog cloud hosting 解決方案!

warning 除非您的專案已經使用 Winston,否則建議優先使用 graylog2 套件。如果已經有 Winston,您可以改用 winston-gelf

要安裝 Winston GELF 套件,請執行:

npm install winston-gelf

如果您的專案尚未安裝 Winston,可以加上:

npm install winston

以下是一個基本設定範例:

const winston = require('winston');
const winstonGelf = require('winston-gelf');
const process = require('process');

const logger = winston.createLogger({
  transports: [
    new winston.transports.Console(),
    new winstonGelf({
      // 所有 gelfPro 選項請參考:https://www.npmjs.com/package/gelf-pro
      gelfPro: {
        fields: {
          env: process.env.NODE_ENV || 'development'
        },
        adapterName: 'udp',
        adapterOptions: {
          host: '<XXXXXX>.stackhero-network.com', // 請替換為您的 Graylog 網域
          port: 12201,
        }
      }
    })
  ]
});

// 記錄資訊性日誌範例
logger.info('This is a log information');

// 記錄錯誤日誌範例
try {
  throw Error('This is an example error');
}
catch(error) {
  logger.warn({ message: 'Error triggered', error });
}

請勿忘記設定您的 Graylog Input(詳情請見下方)。