monoscope 仓库中文介绍文档

monoscope 是一款开源的可观测性平台，通过 S3 存储您的日志、追踪和指标数据，并利用大语言模型实现自然语言查询，由 monoscope-tech 提供，汇聚日志、追踪、指标、会话回放等多维度数据。

要点：

开头就要说清楚：这是什么工具、解决什么问题
包含Stars数（如有）、维护者信息
1-3句话，简洁有力

示例： OpenBB 是一款面向金融分析师、量化交易员与 AI 智能体的开源金融数据平台，以"一次连接、随处消费"为核心架构，统一接入股票、期权、加密等多资产数据。

一、核心信息速览

维度	详情
:---	:---
仓库地址	[monoscope](https://github.com/monoscope-tech/monoscope)
许可证	AGPL-3.0
核心定位	将日志、追踪和指标存储在 S3 兼容存储中，并支持自然语言查询
主要语言	Haskell
适用人群	开发人员、运维工程师、数据分析师、AI 研究者
关键亮点	S3 存储；自然语言查询；AI 代理；邮件报告；OpenTelemetry 原生支持

二、核心功能

功能模块	描述	典型场景
:---	:---	:---
S3 存储	支持将日志、追踪和指标存储在 S3 兼容存储中	长期存储日志和指标
自然语言查询	使用大语言模型进行自然语言查询	快速检索日志和指标
AI 代理	创建定时运行的 AI 代理来检测异常和提供洞察	自动监控系统异常
邮件报告	定期发送重要事件和异常的摘要报告	监控系统健康状态
OpenTelemetry 原生支持	支持 750+ 积分	快速集成现有系统
实时尾随	实时流式处理日志和追踪	即时监控系统行为
统一视图	整合日志、指标、追踪和会话回放	多维度分析系统状态

三、快速上手

1. 环境准备

Docker 和 Docker Compose

2. 安装方式

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

3. 基础配置

访问 http://localhost:8080，默认用户名 admin，密码 changeme

4. 核心示例

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

# 发送测试追踪数据
telemetrygen traces --otlp-endpoint=http://localhost:8080/v1/traces --api-key=YOUR_API_KEY

四、核心亮点

S3 存储：使用 S3 兼容存储，可以长期存储日志、指标和追踪数据。
自然语言查询：通过大语言模型实现自然语言查询，降低使用门槛。
AI 代理：创建定时运行的 AI 代理，自动检测异常并提供洞察。
邮件报告：定期发送重要事件和异常的摘要报告，便于及时响应。
OpenTelemetry 原生支持：支持 750+ 集成，方便快速接入现有系统。
统一视图：整合日志、指标、追踪和会话回放，提供全面的可观测性。

五、适用场景

系统监控：用于监控系统性能和异常情况。
日志分析：对日志数据进行高效查询和分析。
故障排查：通过统一视图快速定位和解决系统问题。
开发调试：实时查看日志和追踪数据，辅助开发调试。
数据审计：对历史数据进行审计和分析。

六、优缺点

优势

支持 S3 存储，成本低廉。
自然语言查询功能降低了使用门槛。
AI 代理能够自动检测异常。
提供邮件报告功能，便于日常监控。

不足

主要语言为 Haskell，可能对部分开发者不够友好。
需要自行管理自托管版本的计算资源。

七、与同类工具对比（可选）

工具	类型	核心差异
:---	:---	:---
本工具	开源可观测性平台	免费开源、支持自然语言查询、AI 代理
类似工具A	商业可观测性平台	闭源、价格较高、功能更复杂