快速开始

本指南将在本地启动 MoleSignal，通过认证后的 HTTP API 写入一条日志事件并完成查询。

前置条件

Docker 与 Docker Compose（沙箱会拉起 Postgres + MinIO + MoleSignal）。
standalone profile 大约需要 2 GB 空闲内存。

启动沙箱

克隆并启动

git clone https://github.com/molesignal/molesignal
cd molesignal

# 一条命令的沙箱：Postgres + MinIO + MoleSignal standalone
docker compose -f deploy/docker/docker-compose.yaml --profile standalone up

启动后：

UI： http://localhost:5080
S3 控制台（MinIO）： http://localhost:9001 —— minioadmin / minioadmin

登录拿 token

认证以获取 JWT 和对应的 org_id：

curl -X POST http://localhost:5080/api/v1/auth/signin \
  -H 'content-type: application/json' \
  -d '{"email":"[email protected]","password":"admin"}'

响应中包含 JWT 与 org_id。导出两个值供后续步骤使用：

export MS_JWT="<响应里的 jwt>"
export MS_ORG="<响应里的 org_id>"

发送第一条数据

原生 HTTP JSON 接入开箱即用，适配 curl、应用 SDK、Vector、Fluent Bit。时间戳为 Unix 纪元起的微秒数，放在 _timestamp 字段。

curl -X POST http://localhost:5080/api/v1/intake/logs/app \
  -H "authorization: Bearer $MS_JWT" \
  -H 'content-type: application/json' \
  -d '[{"_timestamp":1700000000000000,"level":"error","msg":"db pool exhausted","trace_id":"abc123"}]'

查询事件

通过 HTTP API 查询 app 日志流：

curl -X POST http://localhost:5080/api/v1/query \
  -H "authorization: Bearer $MS_JWT" \
  -H 'content-type: application/json' \
  -d "{\"org_id\":\"$MS_ORG\",\"language\":\"sql\",
       \"statement\":\"SELECT * FROM app WHERE trace_id = 'abc123'\",
       \"time_range\":{\"start\":0,\"end\":2000000000000000},
       \"stream\":{\"name\":\"app\",\"stream_type\":\"logs\"}}"

结果包含 columns、rows、scanned_rows 和 took_ms。

下一步

从现有技术栈接入

接入 OpenTelemetry、Prometheus、Loki JSON 发送端、Filebeat 与云数据源。

跨信号关联

用共享上下文关联日志、指标、链路、性能剖析和 RUM。

正式部署

从沙箱走向多角色或 Kubernetes 部署。

配置

TOML 配置与 MS_* 环境变量覆盖。

快速上手

观察

可靠性

AI 运维

数据

协作

管理

部署与运维

前置条件

启动沙箱

下一步

从现有技术栈接入

跨信号关联

正式部署

配置

​前置条件

​启动沙箱

​下一步

从现有技术栈接入

跨信号关联

正式部署

配置

前置条件

启动沙箱

下一步