exp 计量
简单包装 打开几何 与 API 相同的参数 舞会客户, (中文(简体) ),
过渡 prom-client 简单,并添加功能
OpenTeleometry 缺少 .
指标类型和API
- 计数器
inc([labels,] [value])
- 高盖
set([labels,] value)inc([labels,] [value])dec([labels,] [value])
- 摘要(以 OpenTelection 术语表示的图像)
observe([labels,] value)或者说observe(value[, labels])
创建一个已存在名称的公尺返回现有的公尺, 所以 metrics.counter({ name: "x" }) 每一个请求都可以安全呼叫.
一个测量器每个标签集保持一个值,即:. gauge.set({ queue: "a" }, 1) 财务报告和审定财务报表 gauge.set({ queue: "b" }, 2) 报告为两个系列.
安装
npm install @bonniernews/exp-metrics
使用量
const expMetrics = require("@bonniernews/exp-metrics");
metrics = expMetrics("my-service-name", {
// optional overrides, see more below
});
const myCounter = metrics.counter({
name: "my_counter",
help: "My counter",
})
myCounter.inc(2);
myCounter.inc({ foo: "bar" }, 3);
更多见于 舞会客户 文档.
包含类型脚本.
选项
enabled(默认)true:false保持相同的API, 但输出无任何信息, 也从未调用 Google Cloud, 例如用于测试和当地开发buckets:每个摘要的直方图桶,见 直方图桶
任何其他密钥被设置为 OpenTelemetry 资源属性, 压倒默认值(gcp.project_id, (中文(简体) ), service.name, (中文(简体) ), service.namespace, (中文(简体) ), service.instance.id) (中文(简体) ).
见 OpenTeleometry 文档。 。 。 .
直方图桶
摘要默认导出为指数直方图 。 每个系列的分辨率都很好, 但每个系列都选取自己的桶布局,因此"云监测"(Cloud Monitoring)中跨系列集合的百分位数(例如所有情况下的p95)可能非常粗糙.
明晰的"桶"给每个系列都提供了相同的布局,所以它们精确地聚合,精度的"桶"宽:
// one summary
metrics.summary({ name: "my_summary", buckets: [ 10, 50, 100, 250, 500, 1000 ] });
// every summary, including http_response_time_milliseconds
// true = OpenTelemetry defaults [ 0, 5, 10, 25, 50, 75, 100, 250, 500, 750, 1000, 2500, 5000, 7500, 10000 ]
expMetrics("my-service-name", { buckets: true });
expMetrics("my-service-name", { buckets: [ 10, 50, 100, 250, 500, 1000 ] });
附有其自己的摘要 buckets 带有仪器范围的导出 exp-metrics-buckets 改为 exp-metrics。 。 。 .
关闭
度量衡每60秒出口一次. 在进程退出前将剩余度量标准流出 :
process.on("SIGTERM", async () => {
await metrics.shutdown();
process.exit(0);
});
谷歌云号
计量器每60秒通过OTLP输出一次 谷歌云遥测 API, (中文(简体) ),
以应用程序默认身份验证 。 项目由证书解决(或 GOOGLE_CLOUD_PROJECT, (中文(简体) ),
和被制服 "gcp.project_id" 在配置中.
所需经费:
- 启用了遥测 API :
gcloud services enable telemetry.googleapis.com - 服务账户有:
roles/telemetry.writer角色
量子出现在云监测中 prometheus.googleapis.com/<name>/<counter|gauge|histogram> 编辑 prometheus_target 资源,
譬如说. prometheus.googleapis.com/http_responses_total/counter。 。 。 .