机器数据分析平台

    • 机器数据分析平台 > API 文档 > 数据打点

    数据打点

    最近更新时间：2020-03-02 15:13:10

    请求路径：/api/v1/data

    请求方法： POST

    请求体示例：

    POST /api/v1/data?host=<hostname>&repo=<test_repo>&sourcetype=
<test_sourcetype>&origin=<origin>&collectTime=<collectTime>
Header: Content-Type: application/json
[
    {
        "raw": "this is a log",
        "repo": "test_repo",
        "sourcetype": "test_sourcetype",
        "host": "hostname",
        "origin": "origin",
        "collectTime": 1582619883000,
        "timestamp": 1582619883000
    },
 ...
]

    请求体参数说明：

    字段名称 类型 含义 必选 说明
    raw string 数据内容 是 日志内容
    repo string 仓库名称 否 当数据中省略该字段时，必须在 url 中增加该字段默认值
    sourcetype string 来源类型 否 当数据中省略该字段时，必须在 url 中增加该字段默认值
    host string hostname 否 辅助字段，数据来源机器的 hostname
    origin string origin 否 辅助字段，数据来源，⽐如⽂件名等
    collectTime long 收集时间 否 ⽇志收集时间，必须为 13 位时间戳
    timestamp long 数据时间 否 当为空时，会根据 sourcetype 的配置从数据中提取

    响应体示例：

    {
    "total": 123,
    "success": 121,
    "failure": 2,
    "detail": [
        {
            "startPos": 2,
            "endPos": 3,
            "status": 404,
            "message": "sourcetype not found"
        }, {
            "startPos": 10,
            "endPos": 11,
            "status": 404,
            "message": "repo not found"
        }
    ]
}

    响应体参数说明：

    字段名称 类型 含义 说明
    total int 请求中的日志总数 数量与请求中的数组元素个数相同
    success int 成功条数 成功被索引的数据条数
    failure int 失败条数 无法被索引的数据条数
    detail array 失败数据详情 数组⻓度应与 failure 相同
    startPos int 失败数据下标 该数值对应请求中数组的元素位置
    endPos int - 该字段忽略
    status int 失败 code 404、500 等
    message string 失败原因 失败具体原因
    以上内容是否对您有帮助？
    • Qvm free helper
    Close