Key takeaway
- M3DB is an open-source distributed time series database for metrics that works with Prometheus and Grafana. See its parts, fit, limits and how to adopt it.
M3DB is the distributed time series database at the centre of the M3 project, an open-source metrics platform. According to its M3 documentation, M3 is "a Prometheus compatible, easy to adopt metrics engine". Teams use it as long-term, scalable storage behind Prometheus and Grafana when a single Prometheus server is no longer enough.
M3DB suits you if you run large volumes of infrastructure or application metrics and want an open-source store you operate yourself. It is not a general database. For the wider category, read our guide to time series databases for real-time analytics.
What is M3DB?
According to the M3 repository on GitHub, the M3 monorepo covers a distributed time series database, an aggregator and query engine, a Prometheus sidecar, Graphite-compatible storage and a wider metrics platform. The repository is released under the Apache License, Version 2.0.
M3DB is the storage part of that stack. The other parts named in the documentation are M3 Coordinator, M3 Query and M3 Aggregator. Each has its own architecture pages, and M3DB itself has pages on sharding, storage and consistency levels.
What are the parts of the M3 stack?
| Component | What the documentation lists it as | Where to read more |
|---|---|---|
| M3DB | The distributed time series database | m3db.io/docs, sharding, storage and consistency level pages |
| M3 Coordinator | A component with its own architecture section; confirm its exact role in the docs | m3db.io/docs, Coordinator pages |
| M3 Query | Query component with its own architecture section | m3db.io/docs, Query pages |
| M3 Aggregator | Aggregation component with its own architecture section | m3db.io/docs, Aggregator pages |
How does M3DB fit with Prometheus, Grafana and Graphite?
The documentation lists integration guides for Prometheus storage, aggregation and query with M3, for aggregation with any Prometheus remote write storage, for Grafana and for Graphite. Read the Prometheus guide first, because it sets the pattern the others follow: Prometheus keeps scraping, M3 holds the long-term data, and Grafana reads from M3.
We have not reproduced configuration here, because settings change between releases. Use the guide that matches the documentation version you deploy. The documentation lists versions 1.3, 1.2, 1.1, 1.0 and 0.15.17.
How do you deploy M3DB?
The documentation has a Kubernetes operator section, with pages on installation, cluster creation, configuration and monitoring. It also has operational guides for running M3. The GitHub README shows a Docker example using the m3dbnode image, so a single-node trial is a sensible first step before a clustered deployment.
Is M3DB still maintained?
The M3 repository on GitHub page showed no archive or deprecation notice when we read it on 13 November 2026, and it lists open issues and pull requests. The page did not show a last commit date or a release list, so we cannot state the latest version. Check the repository, its releases and the documentation yourself before committing to it, and ask your platform team who will own upgrades.

Which time series store should you choose?
| Situation | What fits | Why |
|---|---|---|
| One team, modest metric volume | A single Prometheus server | Least to operate; no extra storage tier |
| Many Prometheus servers and long retention needs, with in-house platform skills | M3, as the documentation describes it | Prometheus compatible, open source, self-operated |
| No appetite to run a database | A managed metrics service from your cloud provider | Operations move to the provider; check its own pages for limits |
| Business events, not metrics | A general time series or analytical database | M3 is built for metrics |
What should enterprise leaders check before adopting it?
| Area | Question to ask |
|---|---|
| Ownership | Who runs upgrades, capacity and on-call for a self-operated database? |
| Project health | What do the repository and releases show today? |
| Cost | What do storage, retention and query load cost at your metric volume? Measure it in a trial. |
| Governance | Who may query which metrics, and are the dashboards that drive decisions reviewed and versioned? |
| Testing | Have failure cases been rehearsed? See database testing types and tools. |
Metrics feed decisions made by people and, increasingly, by AI agents. ElixirData Context OS keeps governed context, versioned policy and decision traces in one decision layer above AI agents, and AgentAnalyst lets teams ask questions of enterprise data in plain language and get real-time insights. For storage design beyond metrics, see data warehouse database design and tools.
To map one metrics-driven decision your agents should make, and the context and policy it depends on, book a Context Workshop. See what happens in the workshop.
Frequently asked questions
What is M3DB?
M3DB is the distributed time series database in the open-source M3 metrics platform. The M3 documentation describes M3 as a Prometheus compatible, easy to adopt metrics engine.
Which licence does M3 use?
The M3 repository README says it is released under the Apache License, Version 2.0.
Does M3DB work with Prometheus and Grafana?
Yes. The M3 documentation lists integration guides for Prometheus, Grafana and Graphite. Follow the guide for the documentation version you deploy.
Is M3DB archived?
The repository page showed no archive notice when we read it on 13 November 2026. It did not show a last commit date, so confirm current activity on GitHub.
Can M3DB run on Kubernetes?
The documentation has a Kubernetes operator section covering installation, cluster creation, configuration and monitoring.
Ready to put AI agents to work? See an ElixirClaw demo: the agentic OS to build, orchestrate and govern AI agents across your enterprise systems.
Explore the XenonStack platform family: ElixirData · ElixirClaw · ElixirHub · NexaStack · MetaSecure · Neural AI · AgentGRC · AgentSRE · AgentAnalyst · AgentInstruct · AgentRAI · AgentScrum · AgentSearch · AgentForce · AI Aviator · SAIF Aviator · CohortIQ · XenonStack AI · XenonStack UAE