{"id":13451618,"url":"https://github.com/m3db/m3","last_synced_at":"2025-04-23T20:51:35.819Z","repository":{"id":37493108,"uuid":"61153677","full_name":"m3db/m3","owner":"m3db","description":"M3 monorepo - Distributed TSDB, Aggregator and Query Engine, Prometheus Sidecar, Graphite Compatible, Metrics Platform","archived":false,"fork":false,"pushed_at":"2025-04-23T08:37:40.000Z","size":105821,"stargazers_count":4820,"open_issues_count":223,"forks_count":462,"subscribers_count":113,"default_branch":"master","last_synced_at":"2025-04-23T08:39:47.302Z","etag":null,"topics":["aggregator","graphite","kubernetes","m3","metrics","prometheus","query-engine","tsdb"],"latest_commit_sha":null,"homepage":"https://m3db.io/","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/m3db.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"GOVERNANCE.md","roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-06-14T20:29:45.000Z","updated_at":"2025-04-20T08:21:59.000Z","dependencies_parsed_at":"2023-07-13T14:25:18.462Z","dependency_job_id":"23055499-b243-4ea2-976c-38815a517580","html_url":"https://github.com/m3db/m3","commit_stats":null,"previous_names":["m3db/m3db"],"tags_count":101,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m3db%2Fm3","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m3db%2Fm3/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m3db%2Fm3/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m3db%2Fm3/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/m3db","download_url":"https://codeload.github.com/m3db/m3/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250514755,"owners_count":21443208,"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":["aggregator","graphite","kubernetes","m3","metrics","prometheus","query-engine","tsdb"],"created_at":"2024-07-31T07:00:57.112Z","updated_at":"2025-04-23T20:51:35.789Z","avatar_url":"https://github.com/m3db.png","language":"Go","readme":"# M3\n\n[![GoDoc][doc-img]][doc] [![Build Status][ci-img]][ci] [![FOSSA Status][fossa-img]][fossa]\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"site/static/images/logo-square.png\" alt=\"M3 Logo\" width=\"256\" height=\"270\"\u003e\u003c/p\u003e\n\n[Distributed TSDB](https://m3db.io/docs/reference/m3db/) and [Query Engine](https://m3db.io/docs/how_to/query/), [Prometheus Sidecar](https://m3db.io/docs/integrations/prometheus/), [Metrics Aggregator](https://m3db.io/docs/overview/reference/#m3-aggregator), and more such as [Graphite storage and query engine](https://m3db.io/docs/integrations/graphite/).\n\n## Table of Contents\n\n- [More Information](#more-information)\n- [Install](#install)\n  - [Dependencies](#dependencies)\n- [Usage](#usage)\n- [Contributing](#contributing)\n\n## More Information\n\n-   [Documentation](https://m3db.io/docs)\n-   [Contributing](CONTRIBUTING.md)\n-   [Slack](http://bit.ly/m3slack)\n-   [Forum (Google Group)](https://groups.google.com/forum/#!forum/m3db)\n\n### Community Meetings\n\nYou can find recordings of past meetups here: \u003chttps://vimeo.com/user/120001164/folder/2290331\u003e.\n\n## Install\n\n### Dependencies\n\nThe simplest and quickest way to try M3 is to use Docker, read [the M3 quickstart section](https://m3db.io/docs/quickstart) for other options.\n\nThis example uses [jq](https://stedolan.github.io/jq/) to format the output of API calls. It is not essential for using M3DB.\n\n## Usage\n\nThe below is a simplified version of the [M3 quickstart guide](https://m3db.io/docs/quickstart/docker/), and we suggest you read that for more details.\n\n1.  Start a Container\n\n```shell\ndocker run -p 7201:7201 -p 7203:7203 --name m3db -v $(pwd)/m3db_data:/var/lib/m3db quay.io/m3db/m3dbnode:v1.0.0\n```\n\n2.  Create a Placement and Namespace\n\n```shell\n#!/bin/bash\ncurl -X POST http://localhost:7201/api/v1/database/create -d '{\n  \"type\": \"local\",\n  \"namespaceName\": \"default\",\n  \"retentionTime\": \"12h\"\n}' | jq .\n```\n\n3.  Ready a Namespace\n\n```shell\ncurl -X POST http://localhost:7201/api/v1/services/m3db/namespace/ready -d '{\n  \"name\": \"default\"\n}' | jq .\n```\n\n4.  Write Metrics\n\n```shell\n#!/bin/bash\ncurl -X POST http://localhost:7201/api/v1/json/write -d '{\n  \"tags\": \n    {\n      \"__name__\": \"third_avenue\",\n      \"city\": \"new_york\",\n      \"checkout\": \"1\"\n    },\n    \"timestamp\": '\\\"$(date \"+%s\")\\\"',\n    \"value\": 3347.26\n}'\n```\n\n5.  Query Results\n\n**Linux**\n\n```shell\ncurl -X \"POST\" -G \"http://localhost:7201/api/v1/query_range\" \\\n  -d \"query=third_avenue\" \\\n  -d \"start=$(date \"+%s\" -d \"45 seconds ago\")\" \\\n  -d \"end=$( date +%s )\" \\\n  -d \"step=5s\" | jq .  \n```\n\n**macOS/BSD**\n\n```shell\ncurl -X \"POST\" -G \"http://localhost:7201/api/v1/query_range\" \\\n  -d \"query=third_avenue \u003e 6000\" \\\n  -d \"start=$(date -v -45S \"+%s\")\" \\\n  -d \"end=$( date +%s )\" \\\n  -d \"step=5s\" | jq .\n```\n\n## Contributing\n\nYou can ask questions and give feedback in the following ways:\n\n-   [Create a GitHub issue](https://github.com/m3db/m3/issues)\n-   [In the public M3 Slack](http://bit.ly/m3slack)\n-   [In the M3 forum (Google Group)](https://groups.google.com/forum/#!forum/m3db)\n\nM3 welcomes pull requests, read [contributing guide](CONTRIBUTING.md) to help you get setup for building and contributing to M3.\n\n\u003chr\u003e\n\nThis project is released under the [Apache License, Version 2.0](LICENSE).\n\n[doc-img]: https://godoc.org/github.com/m3db/m3?status.svg\n\n[doc]: https://godoc.org/github.com/m3db/m3\n\n[ci-img]: https://badge.buildkite.com/5509d9360bfea7f99ac3a07fd029feb1aafa5cff9ed5ab667b.svg?branch=master\n\n[ci]: https://buildkite.com/uberopensource/m3-monorepo-ci\n\n[cov-img]: https://codecov.io/gh/m3db/m3/branch/master/graph/badge.svg\n\n[cov]: https://codecov.io/gh/m3db/m3\n\n[fossa-img]: https://app.fossa.io/api/projects/custom%2B4529%2Fgithub.com%2Fm3db%2Fm3.svg?type=shield\n\n[fossa]: https://app.fossa.io/projects/custom%2B4529%2Fgithub.com%2Fm3db%2Fm3?ref=badge_shield\n","funding_links":[],"categories":["7. Storage","Go","著名的公开 monorepos","High Availability","其他_大数据","Databases"],"sub_categories":["\"Meta Projects\" (data storage, multi-tenant, aggregation, high availability, etc)","Code ownership","Miscellaneous","资源传输下载"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm3db%2Fm3","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fm3db%2Fm3","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm3db%2Fm3/lists"}