Egg-prometheus NPM

egg-prometheus

为 egg 提供 Prometheus 功能支持

安装

npm i egg-prometheus --save

用法

开启插件

通过 ${app_root}/config/plugin.js 配置启动 Prometheus 插件:

exports.prometheus = {
  enable: true,
  package: "egg-prometheus",
};

配置

exports.prometheus = {
  timeout: 3000,
  scrapePort: 3000,
  scrapePath: '/metrics',
  defaultHttpMetricsFilter: ({ method, status, routerName, path }) => true,
  defaultLabels: { ... },
};

timeout: metrics 数据的拉取超时时间
scrapePort: 监听的用于采集 metrics 的端口
scrapePath: 监听的采集 metrics 的服务路径
defaultLabels: 默认的 metrics 标签，全局生效
defaultHttpMetricsFilter: 默认的 http metrics 的过滤函数，自定义过滤逻辑，返回 true 就是不过滤，返回 false 就是过滤

内置的 Metrics

http_response_time_ms summary: http 请求耗时
http_request_rate counter: http 请求数

当 egg-rpc-base 插件开启时，还会提供下面 metrics

rpc_consumer_response_time_ms summary: rpc 客户端请求耗时
rpc_consumer_request_rate counter: rpc 客户端请求数
rpc_consumer_fail_response_time_ms summary: rpc 客户端失败的请求耗时
rpc_consumer_request_fail_rate counter: rpc 客户端失败的请求数
rpc_consumer_request_size_bytes summary: rpc 请求大小统计
rpc_consumer_response_size_bytes summary: rpc 响应大小统计
rpc_provider_response_time_ms summary: rpc 服务端处理时间
rpc_provider_request_rate counter: rpc 服务端收到请求数
rpc_provider_fail_response_time_ms summary: rpc 服务端失败的请求处理时间
rpc_provider_request_fail_rate counter: rpc 服务端失败的请求数

自定义 Metrics

可以通过下面 API 自定义业务 metrics

const counter = new app.prometheus.Counter({
  name: "xxx_total",
  help: "custom counter",
  labelNames: ["xxx"],
});

const gauge = new app.prometheus.Gauge({
  name: "xxx_gauge",
  help: "custom gauge",
  labelNames: ["xxx"],
});

const histogram = new app.prometheus.Histogram({
  name: "xxx_histogram",
  help: "custom histogram",
  labelNames: ["xxx"],
});

const summary = new app.prometheus.Summary({
  name: "xxx_summary",
  help: "custom summary",
  labelNames: ["xxx"],
});