Skip to content

madesroches/micromegas

Repository files navigation

Micromegas Logo
A unified observability platform for logs, metrics, and traces, built for high-volume environments.

Crates.io Apache licensed Build Status

DocumentationRust API DocsGrafana PluginPresentations


Micromegas is an observability system designed to provide unified insights into complex applications. It allows you to collect and analyze logs, metrics, and traces in a single, scalable database. Our goal is to help you spend less time reproducing bugs and more time understanding and improving your software's quality and performance.

Objectives

  • Empower developers with comprehensive insights, eliminating time-consuming bug reproduction.
  • Quantify issue frequency and severity to allow better priority management.
  • Provide detailed traces based on high-frequency telemetry to enable a deep understanding of every issue.

Key Features

  • 🚀 Unified Observability: Store and query logs, metrics, and traces together to get a complete picture of your application's behavior.
  • ⚡ Low-Overhead Instrumentation: Client-side instrumentation adds minimal overhead, averaging just 20 ns per event in the calling thread.
  • 🌊 High-Frequency Data Collection: Built to handle up to 100,000 events per second from a single instrumented process.
  • ☁️ Scalable & Cloud-Native: The backend is designed to scale horizontally, capable of ingesting data from millions of concurrent processes using object storage (S3) and PostgreSQL.
  • 💰 Cost-Efficient by Design: Keep costs low with tail sampling and on-demand ETL. Raw data is stored cheaply and only processed when you need to query it.
  • 🔍 Powerful SQL Interface: Query your data using a powerful and familiar SQL interface, powered by Apache DataFusion and accessible via Apache Arrow FlightSQL.
  • 🔐 Enterprise Authentication: Secure your data with OIDC authentication supporting both human users (browser-based login) and service accounts (OAuth 2.0 client credentials).

How It Works

Micromegas consists of several key components:

  1. Instrumentation Libraries: Lightweight libraries for your applications (available in Rust and Unreal Engine) to send telemetry data.
  2. Ingestion Service (telemetry-ingestion-srv): A scalable service that receives telemetry data and writes it to blob storage.
  3. Analytics Service (flight-sql-srv): A DataFusion-powered service that exposes a FlightSQL endpoint for running queries against your data.
  4. PostgreSQL Database: Stores metadata about processes, streams, and data blocks, keeping the object storage indexable and fast to query.
  5. Object Storage (S3/GCS): Stores all raw telemetry payloads and materialized query results in Parquet format.

Cost-Effectiveness

Unlike traditional observability platforms with opaque and often escalating costs, Micromegas offers a transparent and orders of magnitude more efficient solution. With Micromegas, you can afford to record billions of events without relying heavily on sampling, gaining a complete and accurate picture of your systems. By leveraging your own cloud infrastructure, Micromegas drastically reduces your observability spend, especially at scale.

Discover how Micromegas achieves this unparalleled cost efficiency and compare it with traditional solutions in our detailed Cost Effectiveness document.

Presentations

Learn more about Micromegas through our technical presentations:

Getting Started

To get started with Micromegas, please refer to the Getting Started guide.

Current Status & Roadmap

v0.18.0 (In Progress)

  • Tracing & Instrumentation:
    • spawn_with_context helper for proper async span parenting
    • Improved #[span_fn] rustdoc documentation
  • Analytics & Performance:
    • Global LRU metadata cache for faster partition queries
    • New jsonb_object_keys UDF for JSON exploration
  • Analytics Web App:
    • Migrated from Next.js to Vite for dynamic base path support
    • Improved navigation and UI cleanup
  • Unreal Engine:
    • Additional metrics and process info in telemetry

December 2025 - v0.17.0

  • Analytics Web App - Complete UI redesign with dark theme and Micromegas branding:
    • SQL Query Editor with syntax highlighting, query history, and macros that integrate with UI controls
    • Performance Analytics - Visualize thread activity timelines and export traces to Perfetto for deep performance analysis
    • Grafana-style time range picker with relative and absolute time support
    • Process metrics screen with time-series charting
    • Multi-word search for process list and logs
  • Per-service Docker images and modernized build scripts
  • BASE_PATH and MICROMEGAS_PORT env vars for reverse proxy deployments
  • Unreal Engine: scalability and VSync context in telemetry

For a detailed history of changes, please see the CHANGELOG.md file.

Contributing

We welcome contributions from the community! If you're interested in helping improve Micromegas, please see our Contribution Guidelines for more details on how to get involved.

Whether it's bug reports, feature requests, or code contributions, your input is valuable.

License

Micromegas is licensed under the Apache License, Version 2.0.