前言
在实际工作中，我们常常需要将应用程序的日志记录到日志中心，以便于分析和排查问题。其中，logstash 是一个非常强大的日志收集引擎，而 egg-ms-logstash 这个 npm 包则提供了一种简单方便的集成方式。本文将详细介绍如何使用 egg-ms-logstash 包将 Egg.js 应用程序的日志集成到 logstash 中。
准备工作
在使用 egg-ms-logstash 之前，需要安装以下软件：
- Logstash：https://www.elastic.co/downloads/logstash
- Elasticsearch：https://www.elastic.co/downloads/elasticsearch
- Kibana (可选)：https://www.elastic.co/downloads/kibana
其中，Logstash 负责收集、处理和转发日志，Elasticsearch 负责存储和索引日志，Kibana 则提供了一个友好的 Web UI，方便我们进行日志查询和分析。
安装 egg-ms-logstash
使用 npm 安装 egg-ms-logstash：
npm i egg-ms-logstash --save
使用 egg-ms-logstash
1. 配置 egg-ms-logstash
在 Egg.js 项目中的 config 目录下新建一个 logstash.js 文件，填写以下内容：
-- -------------------- ---- -------
---- --------
-------------- - -
------- -
----- -----------
----- ------------
----- -----
-------- -
----------- ------
--- -----
---- -----
----- -----
-------------- -----
--
--
-其中，type 表示使用的日志记录类型，这里填写 logstash；host 和 port 则分别是 logstash 服务的主机名和端口号；options 则是一些可选项。
2. 使用 egg-ms-logstash
在 Egg.js 项目中的 app.js 文件中添加以下内容：
-- -------------------- ---- -------
---- --------
----- ------------------- - ---------------------------
-------------- - --- -- -
-- -------
--------------------- - ---
---------------------------- -
--- -------------------------
---
--3. 使用 logstash
使用 Egg.js 的 logger 记录日志时，日志将会被自动发送到 logstash。在 logstash 的配置文件中，可以使用如下配置对日志进行过滤和处理：
-- -------------------- ---- -------
----- -
--- -
---- -- ----
----- -- ----------
-
-
------ -
-- ------ -- ----- -
---- -
----- -- - --------- -- ------------- ------------ ----------------- ------------------- -
-
---- -
----- -- - ------- ------------ -
-
-
-
------ -
------------- -
----- -- ----------------------
----- -- --------------------
-
-其中，input 部分配置了 tcp 协议的端口号，并使用了 json_lines 解析器；filter 部分则是使用 grok 解析器对日志进行过滤和处理；output 部分则是将处理后的日志存储到 Elasticsearch 中。
示例代码
完整的示例代码可以参考以下项目：
- Egg.js 示例项目：https://github.com/eggjs/examples/tree/master/ms-logstash
- Logstash 配置文件示例：https://github.com/eggjs/examples/blob/master/ms-logstash/logstash.conf
总结
通过使用 egg-ms-logstash 这个 npm 包，我们可以简单方便地将 Egg.js 应用程序的日志集成到 logstash 中，方便进行日志分析和排查问题。同时，本文也介绍了如何配置和使用 logstash。希望本文能够对您有所帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60067354890c4f72775839da