monoscope-tech / monoscope

### 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.
**Website** • **Playground** • **Discord** • **Twitter** • **Documentation**
 What is Monoscope? • Cloud vs Self-hosted • Quick Start • AI Agents • Roadmap 
## 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.
The Cloud Free plan supports one user: the project owner (the first member added
when the project is created). Other members can access the project after an
upgrade. This limit does not apply to self-hosted Open Source projects.
## Quick Start
 [code] 
Visit `http://localhost:8080` (default: admin/changeme)
### Send Test Data
Populate your dashboard with test telemetry:
 [code] 
## CLI
Manage your Monoscope project from the terminal — search logs, query metrics, manage monitors and dashboards, triage issues, and more.
 [code] 
See the CLI reference for the full command list.
### Agentic pipeline
Every CLI command emits a stable JSON envelope, so you can chain discovery →
search → triage without manual munging. This is the same pipeline a Claude
Code skill runs end-to-end:
 [code] 
Each step's output shape is documented and stable:
| Command | Envelope |
|---|---|
| `facets [FIELD]` | `{ : [{value, count}, ...]}` |
| `events search` (and `logs`/`traces`) | `{events: [...], count, has_more, cursor}` |
| `events context --summary` | `{events, count, traces: [{trace_id, services, span_count, error_count}]}` |
| `issues list`, `monitors list`, ... | `{data: [...], pagination: {has_more, total, cursor, page, per_page}}` |
| `auth status` (agent mode) | `{authenticated, method, api_url, project}` |
Set `MONOSCOPE_AGENT_MODE=1` (or run with `--agent`) to force JSON output and
disable inter