OpenTSDB

GreptimeDB supports ingesting OpenTSDB via HTTP API.

Insert

HTTP API

GreptimeDB also supports inserting OpenTSDB metrics via HTTP endpoints. We use the request and response format described in OpenTSDB’s /api/put.

The HTTP endpoint in GreptimeDB for handling metrics is /opentsdb/api/put

Note: remember to prefix the path with GreptimeDB’s http API version, v1.

Starting GreptimeDB, the HTTP server is listening on port 4000 by default.

Use curl to insert one metric point:

  1. curl -X POST http://127.0.0.1:4000/v1/opentsdb/api/put -d '
  2. {
  3. "metric": "sys.cpu.nice",
  4. "timestamp": 1667898896,
  5. "value": 18,
  6. "tags": {
  7. "host": "web01",
  8. "dc": "hz"
  9. }
  10. }
  11. '

Or insert multiple metric points:

  1. curl -X POST http://127.0.0.1:4000/v1/opentsdb/api/put -d '
  2. [
  3. {
  4. "metric": "sys.cpu.nice",
  5. "timestamp": 1667898896,
  6. "value": 1,
  7. "tags": {
  8. "host": "web02",
  9. "dc": "hz"
  10. }
  11. },
  12. {
  13. "metric": "sys.cpu.nice",
  14. "timestamp": 1667898897,
  15. "value": 9,
  16. "tags": {
  17. "host": "web03",
  18. "dc": "sh"
  19. }
  20. }
  21. ]
  22. '