KairosDB新手求助：创建Metric后无法找到，RESTful API方法是否有误？

核心误区：无需预先创建Metric #

KairosDB 不需要手动创建Metric，当你通过API写入第一条数据时，Metric会自动生成。如果你尝试先“创建Metric”再写入数据，这本身就是错误的思路。

正确操作步骤（自动生成Metric） #

• 发送POST请求到KairosDB的/api/v1/datapoints端点
• 请求头需设置Content-Type: application/json
• 请求体示例（JSON格式）：

[
    {
        "name": "my_custom_metric",
        "timestamp": 1718000000000,
        "value": 25.5,
        "tags": {
            "host": "server01",
            "env": "production"
        }
    }
]

验证Metric是否存在 #

写入数据后，发送GET请求到/api/v1/metricnames，返回的列表里就能看到自动生成的Metric。

问题排查方向 #

1. 确认Postman请求的端点是否为/api/v1/datapoints，而非不存在的“创建Metric”端点
2. 检查请求体格式是否合规，尤其是timestamp必须是毫秒级时间戳
3. 查看KairosDB服务日志，确认请求是否被正常处理、有无报错
4. 不要用传统数据库“查表”的思路找Metric，KairosDB的存储结构不是关系型表，需通过/api/v1/metricnames接口查询

内容的提问来源于stack exchange，提问作者Toki