m3db /m3

M3 monorepo - Distributed TSDB, Aggregator and Query Engine, Prometheus Sidecar, Graphite Compatible, Metrics Platform

★ 4,909⑂ 463👁 105⑃ 3,794● 651▤ 88
GoApache-2.0Created 2016-06-14m3db.io/
下载:v1.6.0v1.6.0 ↓1.6.02026-09-25
+1
日增长
4,909
stars
463
forks
105
watchers
3,794
prs
651
issues
88
releases

README

M3

[![GoDoc][doc-img]][doc] [![Build Status][ci-img]][ci] [![FOSSA Status][fossa-img]][fossa]



Distributed TSDB and Query Engine, Prometheus Sidecar, Metrics Aggregator, and more such as Graphite storage and query engine.

 Table of Contents

- More Information
- Install
  - Dependencies
- Usage
- Contributing

 More Information

-   Documentation
-   Contributing
-   Slack
-   Forum (Google Group)

 Community Meetings

You can find recordings of past meetups here: .

 Install

 Dependencies

The simplest and quickest way to try M3 is to use Docker, read the M3 quickstart section for other options.

This example uses jq to format the output of API calls. It is not essential for using M3DB.

 Usage

The below is a simplified version of the M3 quickstart guide, and we suggest you read that for more details.

1.  Start a Container

shell
docker run -p 7201:7201 -p 7203:7203 --name m3db -v $(pwd)/m3db_data:/var/lib/m3db quay.io/m3db/m3dbnode:v1.0.0


2.  Create a Placement and Namespace

shell
!/bin/bash
curl -X POST http://localhost:7201/api/v1/database/create -d '{
  "type": "local",
  "namespaceName": "default",
  "retentionTime": "12h"
}' | jq .


3.  Ready a Namespace

shell
curl -X POST http://localhost:7201/api/v1/services/m3db/namespace/ready -d '{
  "name": "default"
}' | jq .


4.  Write Metrics

shell
!/bin/bash
curl -X POST http://localhost:7201/api/v1/json/write -d '{
  "tags": 
    {
      "__name__": "third_avenue",
      "city": "new_york",
      "checkout": "1"
    },
    "timestamp": '\"$(date "+%s")\"',
    "value": 3347.26
}'


5.  Query Results

Linux

shell
curl -X "POST" -G "http://localhost:7201/api/v1/query_range" \
  -d "query=third_avenue" \
  -d "start=$(date "+%s" -d "45 seconds ago")" \
  -d "end=$( date +%s )" \
  -d "step=5s" | jq .  


macOS/BSD

shell
curl -X "POST" -G "http://localhost:7201/api/v1/query_range" \
  -d "query=third_avenue  6000" \
  -d "start=$(date -v -45S "+%s")" \
  -d "end=$( date +%s )" \
  -d "step=5s" | jq .


 Contributing

You can ask questions and give feedback in the following ways:

-   Create a GitHub issue
-   In the public M3 Slack
-   In the M3 forum (Google Group)

M3 welcomes pull requests, read contributing guide to help you get setup for building and contributing to M3.



This project is released under the Apache License, Version 2.0.

[doc-img]: https://godoc.org/github.com/m3db/m3?status.svg

[doc]: https://godoc.org/github.com/m3db/m3

[ci-img]: https://badge.buildkite.com/8e65c098f9619dd46b99813c7cca0d1f0de591d943c3bf7ef2.svg?branch=master

[ci]: https://buildkite.com/uberopensource/m3-monorepo-ci-uber-oss

[cov-img]: https://codecov.io/gh/m3db/m3/branch/master/graph/badge.svg

[cov]: https://codecov.io/gh/m3db/m3

[fossa-img]: https://app.fossa.io/api/projects/custom%2B4529%2Fgithub.com%2Fm3db%2Fm3.svg?type=shield

[fossa]: https://app.fossa.io/projects/custom%2B4529%2Fgithub.com%2Fm3db%2Fm3?ref=badge_shield

Top issues

Discussions

Latest release

v1.6.0 v1.6.0 2026-09-25
Backwards Incompatible Changes

These affect users who import M3 as a Go library. Deployed binaries, on-disk formats and wire formats are unchanged.

- All: Metrics scopes now use github.com/uber-go/tally/v4; the github.com/m3db/prometheus_ forks are no longer used and the instrument package exposes a single upstream prometheus/client_golang registry type ([4423])
- All: github.com/m3db/stackmurmur3 is replaced by github.com/twmb/murmur3 (bit-identical output, verified by a parity test) ([4420], [4422])
- All: Minimum Go version is now 1.26 ([4410], [4416], [4425])
- All: etcd dependency moved

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON