原生 JSON 接入

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

{ "accepted": 1, "rejected": 0, "errors": [] }

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

{ "accepted": 1, "rejected": 0, "errors": [] }

POST /api/v1/intake/{type}/{stream}

向数据流 POST 一个记录对象，或一组记录。数据流在首次写入时创建，schema 会随新字段出现而演进。该调用需要 streams.write 权限，默认接入 Token 以及具备写入角色的服务账号 Token 都可以使用。 路径参数

参数	类型	说明
`type`	string	`logs`、`metrics` 或 `traces`，其他值返回 `404`。
`stream`	string	数据流名称，可包含字母、数字、`_`、`-` 与 `.`。名称 `_molesignal` 为保留名称，返回 `403`。

请求体 一个 JSON 对象，或一组 JSON 对象，每个元素都必须是对象。请求体上限为 2 MiB，并且不会被解压，因此不要向该端点发送 Content-Encoding: gzip。

字段	说明
`_timestamp`	事件时间，自 Unix 纪元起的微秒数。缺省时使用服务端接收时间。
`metric_name`	对 `metrics`，记录所属的指标。一个指标数据流装一个来源的全部指标；没有 `metric_name` 的记录属于与数据流同名的指标。
其他任意字段	作为数据流的字段保存。之后的记录必须使用数据流中该字段已有的类型。

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

{ "accepted": 1, "rejected": 0, "errors": [] }

与 schema 冲突的记录会单独被拒绝，同一批中的其他记录仍会被接收：

{
  "accepted": 1,
  "rejected": 1,
  "errors": [
    { "index": 0, "reason": "type mismatch on field `level`: expected Utf8, got Number" }
  ]
}

错误

状态码	原因
`400`	数据流名称无效、JSON 无效，或数组元素不是对象（`event #1 must be a JSON object`）。
`401`	Token 缺失或无效。
`403`	Token 缺少 `streams.write`，或数据流为 `_molesignal`。
`413`	请求体超过 2 MiB。
`429`	触发了 router 的速率限制。

最后修改于 2026年10月26日

概览

身份验证

数据采集

查询

APM

用户体验

数据流

告警

关联与 Web

平台与管理