davradocker/ruban-ms-dataapi

数据API镜像文档

镜像概述

该镜像提供数据API服务，主要功能是作为KairosDB（时序数据库）的调用代理，接收并转发请求至KairosDB，同时从Tagstore（元数据存储）获取相关标签数据，对KairosDB返回的结果进行装饰，实现时序数据与元数据的整合，增强数据可用性。

核心功能与特性

• KairosDB调用代理：接收客户端请求，转发至KairosDB并返回处理结果
• Tagstore数据装饰：自动从Tagstore获取标签元数据，对KairosDB返回的时序数据进行补充和增强
• 数据整合：无缝融合时序数据与元数据，提供更丰富的查询结果
• 轻量级部署：基于Docker容器化部署，配置简单，易于集成到现有系统

使用场景与适用范围

• 需要从KairosDB获取时序数据并结合元数据进行分析的场景
• 监控系统中需展示时序指标与相关标签信息的场景
• 数据分析平台需整合多源数据（时序数据+元数据）的场景
• 对KairosDB查询结果进行二次处理和增强的中间件需求

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name data-api \
  -p 8080:8080 \
  -e KAIROSDB_URL=http://kairosdb-host:8080 \
  -e TAGSTORE_URL=http://tagstore-host:8080 \
  data-api:latest

Docker Compose配置

yaml
version: '3'
services:
  data-api:
    image: data-api:latest
    ports:
      - "8080:8080"
    environment:
      - KAIROSDB_URL=http://kairosdb:8080
      - TAGSTORE_URL=http://tagstore:8080
    depends_on:
      - kairosdb
      - tagstore

  kairosdb:
    image: kairosdb/kairosdb:latest
    ports:
      - "8080:8080"

  tagstore:
    image: tagstore:latest
    ports:
      - "8080:8080"

环境变量配置

接口使用示例

发送GET请求至数据API获取装饰后的时序数据：

bash
curl http://localhost:8080/api/v1/query?metric=system.cpu.usage&start=1h-ago

返回结果将包含KairosDB的时序数据及Tagstore提供的相关标签信息。