{"id":13827502,"url":"https://github.com/square/metrics","last_synced_at":"2025-06-13T01:40:08.778Z","repository":{"id":30723178,"uuid":"34279409","full_name":"square/metrics","owner":"square","description":"Metrics Query Engine","archived":false,"fork":false,"pushed_at":"2023-05-26T19:41:40.000Z","size":2397,"stargazers_count":170,"open_issues_count":8,"forks_count":32,"subscribers_count":30,"default_branch":"master","last_synced_at":"2024-04-13T17:52:13.402Z","etag":null,"topics":["go","metrics","timeseries"],"latest_commit_sha":null,"homepage":"","language":"Go","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/square.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-04-20T18:43:35.000Z","updated_at":"2024-06-18T21:26:20.746Z","dependencies_parsed_at":"2024-06-18T21:26:17.840Z","dependency_job_id":"4f95792e-ad3c-4287-936f-0462aaad1327","html_url":"https://github.com/square/metrics","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/square%2Fmetrics","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/square%2Fmetrics/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/square%2Fmetrics/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/square%2Fmetrics/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/square","download_url":"https://codeload.github.com/square/metrics/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225486317,"owners_count":17481873,"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","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":["go","metrics","timeseries"],"created_at":"2024-08-04T09:01:59.763Z","updated_at":"2024-11-20T07:30:31.438Z","avatar_url":"https://github.com/square.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"[![license](https://img.shields.io/badge/license-apache_2.0-red.svg?style=flat)](https://raw.githubusercontent.com/square/metrics/master/LICENSE)\n[![Build Status](https://travis-ci.org/square/metrics.svg?branch=master)](https://travis-ci.org/square/metrics)\n\n#### Metrics Query Engine [(Version 1.0)](https://github.com/square/metrics/releases/tag/v1.0)\n\n```\ngo get \"github.com/square/metrics\"\n```\n\nMetrics Query Engine(MQE) provides SQL-like interface to time series data with powerful functions to aggregate, filter and analyze.\n\nFor example, to find which 10 endpoints have the highest HTTP latency on your web application farm:\n\n```\nselect connection.http.latency\n| aggregate.sum(group by endpoint)\n| filter.highest_mean(10)\nwhere application = 'httpd'\nfrom -2hr to now\n```\n\nOr maybe you want to compare cpus used vs allocated across your cluster for a particular application\n\n```\ninspect.cgroup.cpustat.usage | aggregate.sum,\ninspect.cgroup.cpustat.total | aggregate.sum\nwhere service match 'blueflood'\nfrom -10m to now\n```\n\nOr you want to see how many cumulative seconds have been spent serving an API request.\n\n```\ntransform.integral(\n aggregate.sum(transform.rate(`framework.actions.service-api.response_codes.X00`[type='200'])\n *\n`framework.actions.service-api.response_times.histogram`[distribution='mean'])\n)\n\nwhere app = 'secretapp' and service = 'SecretService' and api = 'GetSecret'\n\nfrom -1w to now\n```\n\n##### Why\nSquare collects millions of signals every few seconds from application servers and datacenters. The large volume of unstructured metric names makes it difficult to search for and discover metrics relevant to a particular host, app, service, connection type, or data center. Metrics Query Engine uses tagged metrics as a way to structure metric names so that they can be more easily queried and discovered.\n\n#### Go Version\n\nMQE supports Go 1.7 and up.\n\n\n###### See wiki for installation, setup and development.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsquare%2Fmetrics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsquare%2Fmetrics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsquare%2Fmetrics/lists"}