{"id":31939709,"url":"https://github.com/alibaba/metrics","last_synced_at":"2025-10-14T08:45:08.056Z","repository":{"id":43478320,"uuid":"167330257","full_name":"alibaba/metrics","owner":"alibaba","description":"The metrics library for Apache Dubbo and any frameworks or systems.","archived":false,"fork":false,"pushed_at":"2023-04-13T03:39:17.000Z","size":1000,"stargazers_count":561,"open_issues_count":30,"forks_count":144,"subscribers_count":50,"default_branch":"master","last_synced_at":"2025-07-29T11:28:20.907Z","etag":null,"topics":["java","metrics"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alibaba.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2019-01-24T08:20:52.000Z","updated_at":"2025-07-09T09:49:59.000Z","dependencies_parsed_at":"2024-01-13T17:49:16.515Z","dependency_job_id":"6bac1280-871b-4a80-b078-9c8af9d07e9d","html_url":"https://github.com/alibaba/metrics","commit_stats":null,"previous_names":["dubbo/metrics"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/alibaba/metrics","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Fmetrics","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Fmetrics/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Fmetrics/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Fmetrics/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alibaba","download_url":"https://codeload.github.com/alibaba/metrics/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Fmetrics/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279018302,"owners_count":26086345,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","metrics"],"created_at":"2025-10-14T08:45:05.882Z","updated_at":"2025-10-14T08:45:08.046Z","avatar_url":"https://github.com/alibaba.png","language":"Java","readme":"# Metrics简介\n\n[![Build Status](https://travis-ci.org/alibaba/metrics.svg?branch=master)](https://travis-ci.org/alibaba/metrics)\n[![codecov](https://codecov.io/gh/alibaba/metrics/branch/master/graph/badge.svg)](https://codecov.io/gh/alibaba/metrics)\n![license](https://img.shields.io/github/license/alibaba/metrics.svg)\n\n随着微服务的兴起，如何对微服务进行监控，了解微服务当前的运行指标和健康状态，已经成为必备的能力。Metrics作为微服务中的重要的组件，为微服务的监控提供了数据基础。Metrics是一套标准度量库， 用于提供对从操作系统， 虚拟机， 容器，到应用的全方位, 多维度, 实时, 准确的度量服务。\n\nMetrics（原Alibaba Metrics）是阿里巴巴集团内部广泛使用的度量埋点基础类库，内部有Java和Node.js两个版本，目前开源的是Java版本。内部版本诞生于2016年，经历过近三年的发展，经历三年双十一考验，已经成为阿里巴巴集团内部微服务监控度量的事实标准，覆盖了从系统，JVM，中间件，应用各层的度量指标，并且从命名规则，数据格式，埋点方式，计算规则等方便形成了一套统一的规范。\n\n## 全面的指标统计\n\nmetrics全面支持了从操作系统，JVM，中间件，再到应用层面的各级指标，并且对统一了各种命名指标，可以做到开箱即用，并支持通过配置随时开启和关闭某类指标的收集。\n\n目前支持的指标主要包括  \n\n### 操作系统\n\n支持Linux/Windows/Mac，包含cpu, load, disk, nettraffic, tcp。\n\n### JVM\n\n支持classload, gc次数和时间, 文件句柄，young/old区占用，线程状态, 堆外内存，编译时间，部分指标支持自动差值计算。\n\n### 中间件\n\n- Tomcat: 请求数，失败次数，处理时间，发送接收字节数，线程池活跃线程数等\n- Druid: sql执行次数，错误数，执行时间，影响行数等\n- Nginx: 接受，活跃连接数，读，写请求数，排队数，请求qps，平均rt等\n\n更详细的指标可以参考[这里](https://github.com/alibaba/metrics/wiki/supported-metrics-list),  后续会陆续添加对Dubbo, Nacos, Sentinel, Fescar等的支持。\n\n\n\n## REST支持\n\nmetrics提供了基于JAX-RS的REST接口暴露，可以轻松查询内部的各种指标，既可以独立启动HTTP Server提供服务（默认提供了一个基于Jersey+ sun Http server的简单实现)，也可以嵌入已有的HTTP Server进行暴露指标。具体的接口可以参考[这里](https://github.com/alibaba/metrics/wiki/query-from-http)   \n\n### 如何使用\n\n使用方式很简单，和日志框架的Logger获取方式一致。\n\n```\nCounter hello = MetricManager.getCounter(\"test\", MetricName.build(\"test.my.counter\"));\nhello.inc();\n```\n\n支持的度量器包括：\n\n- Counter（计数器）\n- Meter（吞吐率度量器）\n- Histogram（直方分布度量器）\n- Gauge(瞬态值度量器)\n- Timer（吞吐率和响应时间分布度量器）\n- Compass(吞吐率， 响应时间分布， 成功率和错误码度量器)\n- FastCompass(一种快速高效统计吞吐率，平均响应时间，成功率和错误码的度量器)\n- ClusterHistogram(集群分位数度量器)     \n\n具体各个度量器的使用方式可以参考[这里](https://github.com/alibaba/metrics/wiki/quick-start)\n\n默认收集的指标，以及使用http接口进行查看，可以参考[metrics-demo](https://github.com/alibaba/metrics/wiki/demo)\n","funding_links":[],"categories":["指标库"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falibaba%2Fmetrics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falibaba%2Fmetrics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falibaba%2Fmetrics/lists"}