MCPcopy
hub / github.com/grafana/mimir

github.com/grafana/mimir @mimir-distributed-6.2.0-weekly.401 sqlite

repository ↗ · DeepWiki ↗ · release mimir-distributed-6.2.0-weekly.401 ↗
25,700 symbols 123,180 edges 1,676 files 5,508 documented · 21%
README

Grafana Mimir

Grafana Mimir logo

Grafana Mimir is an open source software project that provides a scalable long-term storage for Prometheus. Some of the core strengths of Grafana Mimir include:

  • Easy to install and maintain: Grafana Mimir’s extensive documentation, tutorials, and deployment tooling make it quick to get started. Using its monolithic mode, you can get Grafana Mimir up and running with just one binary and no additional dependencies. Once deployed, the best-practice dashboards, alerts, and runbooks packaged with Grafana Mimir make it easy to monitor the health of the system.
  • Massive scalability: You can run Grafana Mimir's horizontally-scalable architecture across multiple machines, resulting in the ability to process orders of magnitude more time series than a single Prometheus instance. Internal testing shows that Grafana Mimir handles up to 1 billion active time series.
  • Global view of metrics: Grafana Mimir enables you to run queries that aggregate series from multiple Prometheus instances, giving you a global view of your systems. Its query engine extensively parallelizes query execution, so that even the highest-cardinality queries complete with blazing speed.
  • Cheap, durable metric storage: Grafana Mimir uses object storage for long-term data storage, allowing it to take advantage of this ubiquitous, cost-effective, high-durability technology. It is compatible with multiple object store implementations, including AWS S3, Google Cloud Storage, Azure Blob Storage, OpenStack Swift, as well as any S3-compatible object storage.
  • High availability: Grafana Mimir replicates incoming metrics, ensuring that no data is lost in the event of machine failure. Its horizontally scalable architecture also means that it can be restarted, upgraded, or downgraded with zero downtime, which means no interruptions to metrics ingestion or querying.
  • Natively multi-tenant: Grafana Mimir’s multi-tenant architecture enables you to isolate data and queries from independent teams or business units, making it possible for these groups to share the same cluster. Advanced limits and quality-of-service controls ensure that capacity is shared fairly among tenants.

Migrating to Grafana Mimir

If you're migrating to Grafana Mimir, refer to the following documents:

Deploying Grafana Mimir

For information about how to deploy Grafana Mimir, refer to Deploy Grafana Mimir.

Getting started

If you’re new to Grafana Mimir, read the Get started guide.

Before deploying Grafana Mimir in a production environment, read:

  1. An overview of Grafana Mimir’s architecture
  2. Configure Grafana Mimir
  3. Run Grafana Mimir in production

Documentation

Refer to the following links to access Grafana Mimir documentation:

Contributing

To contribute to Grafana Mimir, refer to Contributing to Grafana Mimir.

Join the Grafana Mimir discussion

If you have any questions or feedback regarding Grafana Mimir, join the Grafana Mimir Discussion. Alternatively, consider joining the monthly Grafana Mimir Community Call.

Your feedback is always welcome, and you can also share it via the #mimir Slack channel.

License

Grafana Mimir is distributed under AGPL-3.0-only.

Extension points exported contracts — how you extend this code

SymbolIterator (Interface)
SymbolIterator iterates through all symbols in the index. [10 implementers]
tools/tsdb-index-header/reader.go
SplitCodec (Interface)
SplitCodec handles serialization of intermediate results for query splitting. [258 implementers]
pkg/streamingpromql/optimize/plan/rangevectorsplitting/cache/cache.go
SeriesSet (Interface)
SeriesSet is a set of series and their corresponding chunks. The set is sorted by the label sets. Chunks may be overlapp [56 …
pkg/storegateway/storepb/custom.go
MetricsQueryHandler (Interface)
MetricsQueryHandler is like http.Handler, but specifically for Prometheus query and query_range calls. [26 implementers]
pkg/frontend/querymiddleware/roundtrip.go
Error (Interface)
Error is a marker interface for the errors returned by distributor. [11 implementers]
pkg/distributor/errors.go
Client (Interface)
Client is the interface that should be implemented by any client used to read/write data to an alertmanager via GRPC. [8 …
pkg/alertmanager/alertmanager_client.go
SymbolsReader (Interface)
SymbolsReader sequentially reads symbols from a TSDB block index. [16 implementers]
pkg/storage/indexheader/index/symbols.go
MetadataSupplier (Interface)
MetadataSupplier is the metadata specific part of the Distributor interface. It exists to allow us to wrap the default i [12 …
pkg/querier/metadata_handler.go

Core symbols most depended-on inside this repo

Add
called by 3171
pkg/storage/chunk/chunk.go
Run
called by 2763
pkg/util/test/tb.go
New
called by 1355
tools/trafficdump/main.go
Len
called by 1048
pkg/storage/chunk/chunk.go
Get
called by 914
pkg/util/requestbuffers.go
WithLabelValues
called by 852
pkg/storage/tsdb/block/fetcher.go
Time
called by 808
pkg/util/time.go
Cleanup
called by 726
pkg/usagetracker/tenantshard/map.go

Shape

Method 13,992
Function 8,364
Struct 2,659
Interface 319
TypeAlias 209
FuncType 125
Class 32

Languages

Go99%
TypeScript1%
Python1%

Modules by API surface

pkg/ingester/client/ingester.pb.go811 symbols
pkg/mimirpb/mimir.pb.go693 symbols
pkg/storegateway/storepb/rpc.pb.go457 symbols
pkg/streamingpromql/planning/core/core.pb.go435 symbols
pkg/api/static/bootstrap-5.1.3.bundle.min.js334 symbols
pkg/compactor/scheduler/compactorschedulerpb/compactorscheduler.pb.go331 symbols
pkg/querier/querierpb/querier.pb.go323 symbols
pkg/usagetracker/usagetrackerpb/usagetracker.pb.go293 symbols
pkg/scheduler/schedulerpb/scheduler.pb.go269 symbols
pkg/streamingpromql/optimize/plan/rangevectorsplitting/functions.pb.go245 symbols
pkg/frontend/querymiddleware/model.pb.go208 symbols
pkg/distributor/distributor_test.go203 symbols

Dependencies from manifests, versioned

buf.build/gen/go/bufbuild/bufplugin/protocolbuffers/gov1.36.11-20250718181 · 1×
buf.build/gen/go/bufbuild/protodescriptor/protocolbuffers/gov1.36.11-20250109164 · 1×
buf.build/gen/go/bufbuild/protovalidate/protocolbuffers/gov1.36.11-20260415201 · 1×
buf.build/gen/go/bufbuild/registry/connectrpc/gov1.20.0-202606101349 · 1×
buf.build/gen/go/bufbuild/registry/protocolbuffers/gov1.36.11-20260610134 · 1×
buf.build/gen/go/pluginrpc/pluginrpc/protocolbuffers/gov1.36.11-20241007202 · 1×
buf.build/go/appv0.2.1-0.20260407195 · 1×
buf.build/go/bufpluginv0.10.0 · 1×
buf.build/go/bufprivateusagev0.1.0 · 1×
buf.build/go/interruptv1.1.0 · 1×
buf.build/go/protovalidatev1.2.0 · 1×
buf.build/go/protoyamlv0.7.0 · 1×

For agents

$ claude mcp add mimir \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact