Overview

qyl - Question Your Logs: AI-first observability platform with persistent storage

qyl Observability Platform

Question Your Logs - observe everything, judge nothing, document perfectly.

qyl is an AI-first observability platform that combines the best of .NET Aspire Dashboard with persistent DuckDB storage and zero-config GenAI instrumentation.

Why qyl?

Feature	Aspire Dashboard	qyl
Storage	In-memory (lost on restart)	Persistent DuckDB
GenAI Setup	Manual configuration	Zero-config auto-instrumentation
Deployment	AppHost required	Standalone container
MCP Support	Built-in	Full Aspire parity

Architecture

                      +------------------+
                      |   qyl.dashboard  |
                      |    (React 19)    |
                      +--------+---------+
                               | HTTP
                               v
+-------------+       +------------------+       +-------------+
|  qyl.mcp    |------>|  qyl.collector   |<------|    OTLP     |
| (MCP stdio) | HTTP  |  (ASP.NET Core)  | gRPC  |   Clients   |
+-------------+       +--------+---------+       +-------------+
                               |
                               v
                      +------------------+
                      |     DuckDB       |
                      | (columnar store) |
                      +------------------+

Quick Start

Docker (Recommended)

docker run -d \
  -p 5100:5100 \
  -p 4317:4317 \
  -v ~/.qyl:/data \
  ghcr.io/ancplua/qyl:latest

Then open http://localhost:5100 to view the dashboard.

Key Features

Persistent Storage

DuckDB columnar storage survives restarts. Query historical telemetry.

GenAI Analytics

Built-in views for LLM calls, token usage, costs, and tool invocations.

MCP Server

AI agents can query traces, logs, and metrics via Model Context Protocol.

Zero-Config

Source generator auto-instruments GenAI calls. No manual setup.

Ports

Port	Protocol	Purpose
5100	HTTP	REST API, SSE streaming, Dashboard
4317	gRPC	OTLP traces/logs/metrics
5173	HTTP	Dashboard dev server (development only)

Next Steps

Dashboard

Explore the dashboard features

MCP Server

Connect AI agents to your telemetry

Configuration

Environment variables and options

API Reference

REST API documentation