Skip to content

monoscope-tech/monoscope

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Monoscope Logo

Open-source observability platform with S3 storage

Ingest and explore logs, traces, and metrics stored in your S3 buckets. Query with natural language. Create AI agents that detect anomalies and send daily/weekly reports to your inbox.

GitHub Release License Haskell Discord

WebsitePlaygroundDiscordTwitterDocumentation


Monoscope Dashboard

What is Monoscope?

Monoscope is an open-source observability platform that stores your telemetry data in S3-compatible storage. Self-host it or use our cloud offering.

Core capabilities:

  • 💰 S3 storage — Store years of logs, metrics, and traces affordably in your own S3 buckets
  • 💬 Natural language queries — Search your data using plain English via LLMs
  • 🤖 AI agents — Create agents that run on a schedule to detect anomalies and surface insights
  • 📧 Email reports — Receive daily/weekly summaries of important events and anomalies
  • 🔭 OpenTelemetry native — 750+ integrations out of the box
  • Live tail — Stream logs and traces in real-time
  • 🕵️ Unified view — Correlate logs, metrics, traces, and session replays in one place

Cloud vs Self-hosted

In both options, you bring your own S3 buckets—your data stays yours.

Cloud Self-hosted
Storage Your S3 buckets Your S3 buckets
Compute Managed by us You manage
Auth & SSO Built-in DIY
Alert channels Slack, PagerDuty, etc. Basic email
Pricing Usage-based Free (AGPL-3.0)

Start free on Cloud or continue below to self-host.


Quick Start

git clone https://github.com/monoscope-tech/monoscope.git
cd monoscope
docker-compose up

Visit http://localhost:8080 (default: admin/changeme)

Send Test Data

Populate your dashboard with test telemetry:

# Install telemetrygen
go install github.com/open-telemetry/opentelemetry-collector-contrib/cmd/telemetrygen@latest

# Send test traces (replace YOUR_API_KEY from the UI)
telemetrygen traces --otlp-endpoint localhost:4317 --otlp-insecure \
  --otlp-header 'Authorization="Bearer YOUR_API_KEY"' --traces 10

Integration

Auto-instrument your apps

Python
pip install opentelemetry-distro opentelemetry-exporter-otlp
opentelemetry-bootstrap -a install
OTEL_SERVICE_NAME="my-app" \
OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4317" \
opentelemetry-instrument python myapp.py
Node.js
npm install --save @opentelemetry/auto-instrumentations-node
OTEL_SERVICE_NAME="my-app" \
OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4317" \
node --require @opentelemetry/auto-instrumentations-node/register app.js
Java
curl -L https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/latest/download/opentelemetry-javaagent.jar -o otel-agent.jar
OTEL_SERVICE_NAME="my-app" \
OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4317" \
java -javaagent:otel-agent.jar -jar myapp.jar
Kubernetes
# Install OpenTelemetry Operator
kubectl apply -f https://github.com/open-telemetry/opentelemetry-operator/releases/latest/download/opentelemetry-operator.yaml

# Configure auto-instrumentation
kubectl apply -f - <<EOF
apiVersion: opentelemetry.io/v1alpha1
kind: Instrumentation
metadata:
  name: my-instrumentation
spec:
  exporter:
    endpoint: http://monoscope:4317
  propagators:
    - tracecontext
    - baggage
EOF

# Annotate your deployments for auto-instrumentation
kubectl patch deployment my-app -p \
  '{"spec":{"template":{"metadata":{"annotations":{"instrumentation.opentelemetry.io/inject-java":"my-instrumentation"}}}}}'

Natural Language Queries

Query your telemetry data in plain English:

  • "Show me all errors in the payment service in the last hour"
  • "What caused the spike in response time yesterday?"
  • "Which endpoints have the highest p99 latency?"

AI Agents & Reports

Create AI agents that monitor your systems on a schedule:

  • Scheduled analysis — Agents run at intervals you define (hourly, daily, weekly)
  • Anomaly detection — Automatically surface unusual patterns in logs, metrics, and traces
  • Email reports — Receive summaries of important events and insights directly in your inbox
  • Customizable focus — Configure agents to watch specific services, error types, or metrics

Architecture

graph LR
    A[Your Apps] -->|Logs/Metrics/Traces| B[Ingestion API]
    B --> C[TimeFusion Engine]
    C --> D[(S3 Storage)]
    D --> E[Query Engine]
    E --> F[Dashboards]
    D --> G[AI Agent Scheduler]
    G -->|LLM Analysis| H[Anomaly Detection]
    H --> I[Email Reports]
    H --> J[Alert Channels]
Loading

Powered by TimeFusion

Monoscope is built on TimeFusion, our open-source time-series database for observability workloads.

🗄️ S3-native Data lives in your S3 buckets—no vendor lock-in
🐘 PostgreSQL compatible Use any Postgres client or driver
500K+ events/sec Columnar storage with Apache Arrow
💵 Pay only for S3 No expensive proprietary storage fees

How It Compares

Feature Monoscope Datadog Elastic Prometheus
S3/Object Storage ✅ Native
Natural Language Query
AI Agents & Reports ✅ Built-in ❌ Add-on
Open Source ✅ AGPL-3.0
Self-hostable

Screenshots

Log Explorer - Unified View

Logs and trace spans displayed together in context for complete observability.

Log Explorer Main View

Trace Context Integration

See detailed trace information alongside logs for debugging complex distributed systems.

Log Explorer with Trace Context

Dashboard Analytics

Real-time metrics and performance monitoring with AI-powered insights.

Dashboard Analytics View

Trusted by Leading Companies

Andela Partna GrovePay SameDay
Platnova PayFonte ThePeer BlockRadar

"Monoscope notifies us about any slight change on the system. Features that would cost us a lot more elsewhere." — Samuel Joseph, Woodcore


Documentation


Roadmap

  • Custom dashboards builder
  • More out-of-the-box dashboards
  • AIOps workflow builder
  • Full migration to TimeFusion storage engine
  • Metrics aggregation rules
  • Multi-tenant workspace support
  • More alert channel integrations

See our public roadmap for details and to vote on features.


Community

💬 Discord • 🐛 Issues • 🐦 Twitter


License

AGPL-3.0. See LICENSE for details.

For commercial licensing options, contact us at hello@monoscope.tech.


Star on GitHub

About

Monoscope lets you ingest and explore your logs, traces and metrics. We store these in S3 compatible buckets. Query in natural language via LLMs.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages