Monoscope lets you ingest and explore your logs, traces and metrics. We store these in S3 compatible buckets. Query in natural language via LLMs. https://monoscope.tech
  • Haskell 59.1%
  • HTML 13.4%
  • TypeScript 12.2%
  • JavaScript 11.6%
  • PLpgSQL 1.5%
  • Other 2.2%
Find a file
History 2025-07-16 11:26:25 +02:00
.github/workflows speed up compilation by skiping rust installation if it already exists 2025-07-15 14:38:22 +02:00
app otel waterman 2025-04-04 01:25:58 +00:00
docs/notes enable -Weverything ghc options and fixing code to remove some warnings 2022-02-24 01:23:08 +01:00
proto/opentelemetry/proto checkpoint, generating the haskell files for the proto correctly 2025-04-18 02:31:25 +02:00
rust-interop speed up compilation by skiping rust installation if it already exists 2025-07-15 14:38:22 +02:00
src add zerostate to metrics list 2025-07-16 11:26:25 +02:00
static internal logs that can extract service name. 2025-07-16 11:26:25 +02:00
test update deps and fix build 2025-07-13 21:39:21 +02:00
web-components fix issue of blue background colors in charts on first load 2025-07-14 19:59:40 +02:00
.editorconfig use widgets for explorer and implement event listening for filter element add and update queries 2025-03-03 03:47:41 +01:00
.env.example checkpoint 2025-05-28 01:42:12 -07:00
.ghci updates to use lsp 2024-11-18 22:49:24 +01:00
.ghcid add .ghcid 2024-11-18 22:49:25 +01:00
.gitignore support sending widgetJson as query param 2025-07-03 14:36:22 +00:00
.hlint.yaml fix aeson imports 2024-11-21 04:24:52 +01:00
.prettierrc New editor and AI query support (#172) 2025-05-25 07:53:20 +02:00
.rusty-hook.toml initialized FFI and now breaking down Routes into smaller modular routes to ease compile times 2024-04-30 23:49:04 +02:00
apitoolkit-server.cabal pass context spans around the application better. 2025-07-15 17:06:15 +02:00
auto-instrument-config.toml improve tracing and integrate more observability 2025-07-15 16:01:24 +02:00
cabal.project checkpoint towards functioning and passing doctests 2025-07-02 01:41:14 +02:00
CHANGELOG.md application compiles with cabal at this point 2024-07-17 02:04:33 +02:00
Dockerfile fix-ci: include static in package assets 2025-07-15 01:15:28 +02:00
fourmolu.yaml make fmt. and improve github actions to compile rust and copy .so files 2025-07-07 01:08:49 +02:00
hie.yaml hspec discover 2022-01-29 22:36:51 +01:00
LICENSE application compiles with cabal at this point 2024-07-17 02:04:33 +02:00
Makefile checkpoint fairly functioning metrics 2025-07-07 00:21:05 +02:00
package-lock.json summarize by, query langauge support to match the kql language (#176) 2025-06-04 05:33:23 +02:00
package.json summarize by, query langauge support to match the kql language (#176) 2025-06-04 05:33:23 +02:00
package.yaml pass context spans around the application better. 2025-07-15 17:06:15 +02:00
README.md update readme 2025-07-10 01:43:48 +02:00
Setup.hs checkpoint, generating the haskell files for the proto correctly 2025-04-18 02:31:25 +02:00
stack.yaml checkpoint 2025-06-13 19:39:55 -07:00
stack.yaml.lock upgrade pg-entity 2025-05-25 00:23:59 -07:00
tailwind.config.js New editor and AI query support (#172) 2025-05-25 07:53:20 +02:00
weeder.toml fix endpoints inbox count indicator and fix broken pagination 2024-08-23 23:41:39 +02:00
workbox-config.js self host inter and jetbrains mono to prevent cdn issues 2025-04-21 01:15:56 +02:00

Monoscope

Advanced Monitoring & Observability Platform

Haskell S3 Compatible LLM Powered

Monoscope is a powerful monitoring and observability platform that leverages LLMs to intelligently identify anomalies in your systems. With efficient data storage to S3-compatible buckets and real-time analytics powered by our custom timefusion storage engine, Monoscope provides deep insights into your infrastructure and applications.


Table of Contents


Features

  • 🤖 AI-Powered Anomaly Detection: Leverages LLMs to automatically identify and alert on unusual patterns
  • ☁️ S3-Compatible Storage: Store logs, metrics and traces in any S3-compatible object storage
  • 🚀 High Performance: Written in Haskell and rust for reliability and performance
  • 📈 Real-Time Analytics: Monitor your systems with minimal latency
  • 🔌 Extensible: Easy to integrate with existing monitoring infrastructure

Getting Started

Prerequisites

Before installing Monoscope, ensure you have the following dependencies:

  • Haskell: Install via GHCup
  • PostgreSQL with TimescaleDB: For time-series data storage
  • LLVM: Required for compilation
  • Google Cloud SDK: For GCP integration (if using GCP)

Installation

  1. Install Haskell via GHCup
curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh
  1. Clone the Repository
git clone https://github.com/apitoolkit/apitoolkit-server.git monoscope
cd monoscope
  1. Install System Dependencies

For macOS:

# Install LLVM
brew install llvm

# Install PostgreSQL with TimescaleDB
brew install postgresql
brew install timescaledb

# Install libpq
brew install libpq

For Linux (Ubuntu/Debian):

# Install LLVM
sudo apt-get install llvm

# Install PostgreSQL and TimescaleDB
# Follow instructions at: https://docs.timescale.com/install/latest/

# Install libpq
sudo apt-get install libpq-dev
  1. Configure Google Cloud (Optional)

If using Google Cloud integration:

gcloud auth application-default login
  1. Run Monoscope
stack run

Development Setup

Database Setup with Docker

  1. Create a Docker volume for PostgreSQL data:
docker volume create pgdata
  1. Run TimescaleDB in Docker:
make timescaledb-docker
  1. Configure pg_cron extension:

Add the following to your PostgreSQL configuration:

ALTER system SET cron.database_name = 'apitoolkit';
ALTER system SET shared_preload_libraries = 'pg_cron';

Then restart the TimescaleDB Docker container.

Development Tools

Install code formatting and linting tools:

# Code formatter
brew install ormolu

# Linter
brew install hlint

Useful commands:

# Format code
make fmt

# Run linter
make lint

💡 Tip: For better IDE support, compile Haskell Language Server locally to avoid crashes, especially on macOS. See issue #2391.

Service Worker

To build the service worker:

workbox generateSW workbox-config.js

Testing

Run all tests

make test
# OR
stack test --ghc-options=-w

Run only unit tests

Unit tests don't require a database connection and run much faster. They include doctests and pure function tests.

make test-unit
# OR
stack test apitoolkit-server:unit-tests --ghc-options=-w

Run unit tests with file watching for development

make live-test-unit
# OR
stack test apitoolkit-server:unit-tests --ghc-options=-w --file-watch

Run a specific individual test

stack test --test-arguments "--match=SeedingConfig" apitoolkit-server:tests
# OR
stack test --ta "--match=SeedingConfig" apitoolkit-server:tests

Contributing

We welcome contributions to Monoscope! Please feel free to:

  • Report bugs and request features via GitHub Issues
  • Submit pull requests for bug fixes and new features
  • Improve documentation and examples
  • Share your use cases and feedback

Before contributing, please read our contributing guidelines and ensure your code passes all tests and linting checks.

License

Monoscope is open source software. Please see the LICENSE file for details.