跳转到主要内容
本指南带你从零开始，接入遥测数据，并运行一个把日志、追踪、主机指标串起来的查询 —— 全在你自己的 机器上。

​
前置条件

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

​
启动沙箱

1

克隆并启动

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

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

登录拿 token

认证以获取 JWT 和你的 org_id：
curl -X POST http://localhost:5080/api/v1/auth/login \
  -H 'content-type: application/json' \
  -d '{"email":"[email protected]","password":"admin"}'
响应中包含 JWT 与 org_id。导出它们供后续步骤使用：
export MS_JWT="<响应里的 jwt>"
export MS_ORG="<响应里的 org_id>"
3

发送第一条数据

原生 HTTP JSON 接入开箱即用，适配 curl、应用 SDK、Vector、Fluent Bit。时间戳为 Unix 纪元起 的微秒数，放在 _timestamp 字段。
curl -X POST http://localhost:5080/api/v1/ingest/logs/app \
  -H "authorization: Bearer $MS_JWT" \
  -H 'content-type: application/json' \
  -d '[{"_timestamp":1700000000000000,"level":"error","msg":"db pool exhausted","trace_id":"abc123"}]'
4

查询 —— 看着信号连起来

同一个 trace_id 把日志、追踪、主机指标串起来，因为它们共享同一存储：
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\"}}"
结果包含 rows、columns、scanned_rows、took_ms、cache_hit。

​
下一步

从你的技术栈接入

把 OpenTelemetry、Prometheus、Loki、Filebeat 指向 MoleSignal，无需改造。

跨信号关联

杀手级特性：在信号间跳转，不用复制粘贴 trace id。

正式部署

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

配置

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