HTTP API 概览
下表列出了 TSDB 提供的与数据读写和管理相关的所有 API。关于如何使用每个 API 的具体说明，请点击描述中提供的链接查看相应文档。API 描述/api/put 写入数据/api/query 查询数据/api/query/last 查询时间线最新数据点/api/mput 多值写入/...
日志说明
TSDB的日志样例 下述示例展示了在ActionTrail中记录的创建TSDB实例的日志信息，该条日志记录了TSDB的API事件 CreateHiTSDBInstance 的操作记录。{"eventId":"DC53ABB0-27D6-43D5-B33D-161AA25FC0F0","eventVersion":1,"responseElements":{...
快速入门
刚开始没有任何数据写入时，写入的TPS为0，当TPS开始从0变为正数时，则说明Prometheus已经将数据上报到了TSDB中。查询验证 本文提供Prometheus的示例配置中Prometheus监控指标采集目标是prometheus本身，因此这里以Prometheus采集到自身的...
SDK 常用类概览
本文按照 SDK 包名罗列了 TSDB SDK 中常用的类。关于某些重要的常用类的详细信息和方法说明，请单击它们的类名链接查看相应文档。包名：com.aliyun.hitsdb.client 类名 描述 TSDBConfig TSDB 配置类；所有的客户端选项都在这个类中进行配置...
欠费和付费类型转换
欠费说明 下表列出了TSDB实例到期或欠费后，TSDB 实例和其数据被保留的期限。计费方式 到期欠费说明 预付费 实例到期 7 天后会被释放，同时在线数据（实例中被访问的数据）也会被删除且不能恢复。按量付费 账户欠费后，该账户下所有按量...
数据清空
本文介绍如何进行时序数据库清空...如果包含，则表示truncate的失败导致了TSDB集群内不同节点间的状态不一致。若不解决该不一致，则会造成向TSDB执行的写操作出现部分失败。因此，当该现象出现时，请提交该错误消息给阿里云运维团队进行处理。
关键概念
一个保留策略描述了TSDB For InfluxDB®保存数据的时间（DURATION）以及存储在集群中数据的副本数量（REPLICATION）。说明 复制系数（replication factors）不适用于单节点实例。在示例数据中，census 中的所有数据属于保留策略 autogen。...
相比OpenTSDB优势
根据OpenTSDB的官网API Endpoints（HTTP API ),下表列举了TSDB的兼容程度。OpenTSDB 协议API TSDB是否兼容/s 否/api/aggregators 是/api/annotation 否/api/config 是/api/dropcaches 否/api/put 是/api/rollup 否/api/histogram 否/api/...
专业术语
retention policy（保留策略，简称RP）TSDB For InfluxDB®数据结构中的一部分，描述了TSDB For InfluxDB®保存数据的时间（duration）以及shard group覆盖的时间范围（shard group duration）。在每个数据库（database）里面，RP是唯一的...
FAQ
示例 预设时间段 以下查询计算 sunflowers 在6:15pm到7:45pm之间的平均值，并将这些平均值按一小时进行分组：SELECT mean("sunflowers")FROM"flower_orders"WHERE time>='2016-08-29T18:15:00Z' AND time(1h)下面的结果展示了TSDB For ...
HTTP API
头部字段 X-Influxdb-Version 显示了TSDB For InfluxDB®的版本。curl-sl-I https://<网络地址>:3242/ping?u=<账号名称>&p=<密码>...
GROUP BY子句
time(time_interval)：子句中的 time_interval（时间间隔）是一个持续时间（duration），决定了TSDB For InfluxDB®按多大的时间间隔将查询结果进行分组。例如，当 time_interval 为 5m 时，那么在 WHERE 子句中指定的时间范围内，将查询...
选择函数
第二个查询展示了TSDB For InfluxDB®将tag location 保留为measurement bottom_water_levels 中的tag。SELECT BOTTOM("water_level","location",2)INTO"bottom_water_levels"FROM"h2o_feet"name:result time written-1970-01-01T00:00:00Z...
关闭客户端
客户端在关闭过程中会被阻塞住，直到服务器处理完所有请求。建议您使用优雅关闭功能，以防数据丢失。示例代码 tsdb.close();等价于 tsdb.close(false);强制关闭 若不需要使用优雅关闭功能，可以直接关闭客户端。示例代码 tsdb.close(true);
Prometheus Remote Write配置
阿里云提供不同规格的TSDB实例，设置了不同的最大写入TPS，避免过大TPS导致TSDB实例不可用，保护TSDB实例正常运行。当写入TPS超过TSDB实例允许的最大TPS时，将触发TSDB实例限流保护规则，会造成写入失败异常。因此需要根据TSDB实例规格来...
功能介绍
TSDB for Prometheus是阿里云时间序列数据库TSDB为Prometheus提供的一种高性能，低成本，稳定可靠的在线远端存储服务，提供高效读写，高压缩比存储。TSDB for Prometheus可无缝被Prometheus集成，在协议上原生支持Prometheus远端存储对接至...
常见问题
本文介绍TSDB的常见问题。如何选择 TSDB 的实例规格？您可根据以下两个指标选择 TSDB 的实例规格：时间线数：对应设备上的采集点数。一个采集点可以是某个设备上需要上传数据的一个传感器。计算公式：设备规模（总设备数）×单个设备的采集...
查询数据
示例代码 使用query方法同步的查询数据：List<QueryResult>result=tsdb.query(query);System.out.println("返回结果："+result);异步查询 TSDB SDK提供了线程异步的数据查询。示例代码 使用query方法异步的查询数据，并通过设置回调来设置...
写入数据
TSDB SDK 使用 Point 类，表示一个时间点。一个 Point 对象表示一个时间序列（时间线）某个时刻上的数据。构造时间点 Point（时间点）有多种构造方法，形式比较多样化。本节提供三种构造时间点的方法示例。注意 Point 的构建至少需要一个 ...
Prometheus对接阿里云TSDB For InfluxDB®️服务
本文将介绍如何使用阿里云的TSDB For InfluxDB®服务来对接Prometheus，构建监控数据的高效存储方案。背景信息 Prometheus是一套监控和告警系统，最初由SoundCloud公司开发，2016年加入CNCF，成为流行的开源项目。Prometheus支持多维数据...
创建导出任务
本文档主要介绍了如何创建TSDB日志导出任务。背景信息 阿里云日志服务提供了从各种云产品进行日志采集并深度处理的完善服务，TSDB支持从日志服务导入日志记录，并映射为时间点进行时序存储。前提条件 用户需要同时购买阿里云日志服务和TSDB...
通过HTTP API写入数据
有很多方法可以向TSDB For InfluxDB®写入数据，包括通过命令行界面（command line interface）和客户端（client libraries）。在这一章中，我们将向您展示如何使用内嵌的HTTP API写入数据。说明 本章节中的示例使用了curl,一种通过URL来...
版本说明
TSDB时间线没有限制住增长的问题修复。修复删除时间线失败时多值 schema 信息删除遗漏的问题。V2.5.0 2019年4月13日 时序结构化查询语言TSQL 重磅发布。开发更简单，时序计算覆盖全面，支持多metric join，提供更强大的多业务指标分析能力...
云监控和报警
TSDB 已经接入了 云监控，您可以通过云监控为实例指标设置监控和报警。操作步骤 登录 TSDB 控制台，进入 实例列表 页面。在单击目标实例右侧操作列中的 管理 按钮，进入该实例的 实例详情 页面。单击左侧操作列的 实例告警，即可跳转到该...
从 Prometheus 到 TSDB 的数据迁移
本文介绍如何使用阿里巴巴的开源工具Datax 实现从 Prometheus 到 TSDB 的数据迁移。背景 本文介绍如何使用阿里巴巴的开源工具Datax 实现从 Prometheus 到 TSDB 的数据迁移。DataX相关使用介绍请参阅 DataX 的 README 文档。下面将首先介绍 ...
从 MySQL 到 TSDB 的数据迁移
本文主要介绍如何使用阿里巴巴的开源工具Datax 实现从 MySQL 到 TSDB 的数据迁移。背景 本文主要介绍如何使用阿里巴巴的开源工具Datax 实现从 MySQL 到 TSDB 的数据迁移。DataX相关使用介绍请参阅 DataX 的 README 文档。下面将首先介绍 ...
客户端
开源社区提供了多种语言的TSDB For InfluxDB®客户端SDK，列举如下。Elixir Instream(instream)Erlang Erlang InfluxDB UDP Writer Go InfluxDB Client Haskell influxdb-haskell Java influxdb-java JavaScript/Node.js node-influx Lisp ...
从采集到分析-TSDB For InfluxDB®让你的数据产生价值
了解我们-TSDB For InfluxDB® TSDB For InfluxDB®是一款专门处理高写入和查询负载的时序数据库，用于存储大规模的时序数据并进行实时分析，包括来自DevOps监控、应用指标和IoT传感器上的数据。它的主要特点如下：专为时间序列数据量身订...
获取 SDK
下载下列链接中的 JAR 包：httpasyncclient-4.1.3 httpclient httpcore httpcore-nio fastjson slf4j-api 下载 TSDB-Client 的 JAR 包（推荐选择最新版本）:请到 SDK 版本说明 中下载最新版本的 JAR 包。将这些 JAR 包放到工程下即可使用 ...
从OpenTSDB到TSDB的数据迁移
本文主要介绍如何使用阿里巴巴的开源工具Datax实现从OpenTSDB到TSDB的数据迁移。背景信息 下面将首先介绍DataX工具本身，以及本次迁移工作涉及到的两个插件（OpenTSDB Reader和TSDB Writer）。DataX相关使用介绍请参阅DataX的 README 文档...
使用限制
TSDB目前提供的最大实例规格为旗舰版 II。如果您需要超过该规格的实例，请提交工单申请开通。背景信息 使用限制 TSDB出于实例保护的目的，根据不同的实例规格的资源情况，对某些具体使用量进行了约束，您在使用TSDB时注意不要超过相应的...
修改导出任务
任务更新 用户通过在日志服务控制台创建TSDB导出任务，创建过程中可以配置将采集到的日志导出到哪一个TSDB实例，从什么时间导出，导出到TSDB中哪一个Topic等任务细节。接来下按照步骤演示任务更新过程。日志服务控制台 进入到日志服务控制...
慢查询日志
在一些业务场景中，用户会向TSDB发起高流量的查询，造成较高的负载，从而使TSDB的整体性能无法达到预期。在这种情况下为方便用户定位引发性能问题的查询。TSDB的管理控制台上提供了查找慢查询日志的功能。操作方法 登录 TSDB控制台。在TSDB...
TSDB开源生态概述
时间序列数据库TSDB以其强大的功能和兼容性，对于当前的一些开源解决方案实现了较好的适配。以下是TSDB与一些开源组件或开源项目对接的方法。Grafana如何对接TSDB Quick BI如何接入TSDB
请求结构
请求结构 TSDB 实例访问链接 TSDB 实例地址在实例详情页可以查到，例如“ts-xxx.hitsdb.rds.aliyuncs.com:8242”。通信协议 支持通过 HTTP 通道进行请求通信。请求方法 TSDB 支持 HTTP POST 方法发送请求。请求路径 每个请求必须指定请求的...
开发指南
本文介绍TSDB for Prometheus支持的label运算符和聚合运算。PromQL参考 PromQL是Prometheus提供的一种功能查询语言，允许用户实时选择和汇总时间序列数据。如要了解更多有关PromQL的内容，请参考Prometheus官方提供的 PromQL文档。TSDB for...
Grafana如何对接TSDB
将TSDB接入Grafana后，您可以利用Grafana的丰富易用的可视化工具，更好地监控和分析来自TSDB的数据。环境准备 下文以ECS服务器上搭建Grafana服务，并通过VPC网络连接到TSDB实例为示例。关于ECS的使用，详细请参见 什么是云服务器ECS。需要...
云实例监控
操作步骤 登录 TSDB控制台。在 实例列表 界面，选择目标实例操作列的 管理。在左侧导航栏，单击 云实例监控。创建监控项。单击 创建实例监控，设置如下参数。参数 说明 选择引擎 选择引擎类型。目前支持MySQL、Redis、MongoDB。实例ID 选择...
基础版
使用Influx CLI（命令行界面）连接TSDB For InfluxDB® 从采集到分析-TSDB For InfluxDB®让你的数据产生价值 Grafana接入阿里云时序数据库TSDB For InfluxDB®️服务 Prometheus对接阿里云TSDB For InfluxDB®️服务 Grafana监控可视化 ...
功能和优势
TSDB for Prometheus在服务端内置实现的Prometheus remote storage adapter，只需在Prometheus的配置文件prometheus.yaml中修改下远程读写配置，即可原生支持Prometheus直接读写TSDB，集成程度高，无需额外单独部署adapter，极大地降低了...
- 产品推荐
- 这些文档可能帮助您