文档

开始使用 InfluxDB Cloud Serverless

InfluxDB Cloud Serverless 是一个专门构建的平台,用于收集、存储、处理和可视化时序数据。InfluxDB v3.0 存储引擎提供了一系列好处,包括近乎无限的序列基数、改进的查询性能,以及与广泛使用的数据处理工具和平台的互操作性。

时序数据 是按时间顺序索引的数据点的序列。数据点通常由同一来源的连续测量组成,用于跟踪随时间的变化。时序数据的例子包括

  • 工业传感器数据
  • 服务器性能指标
  • 每分钟的心跳次数
  • 大脑的电活动
  • 降雨量测量
  • 股票价格

本教程分为几个部分,将指导您将时序数据写入 InfluxDB Cloud Serverless,查询,然后可视化这些数据。

开始之前的关键概念

在开始使用 InfluxDB 之前,了解时序数据如何在 InfluxDB 中组织和存储,以及本文档中使用的某些关键定义非常重要。

数据组织

InfluxDB Cloud Serverless 数据模型将时序数据组织到桶和测量中。一个桶可以包含多个测量。测量包含多个标签和字段。

  • :存储时序数据的命名位置。一个桶可以包含多个 测量
    • 测量:时序数据的逻辑分组。给定测量中的所有 应具有相同的 标签。测量包含多个 标签字段
      • 标签:为每个点提供元数据的键值对——例如,用于标识数据来源或上下文的东西,如主机、位置、站等。标签值可以为空。
      • 字段:具有随时间变化的值的键值对——例如,温度、压力、股票价格等。字段值可以为空,但任何给定行上至少有一个字段值不为空。
      • 时间戳:与数据关联的时间戳。在磁盘上存储和查询时,所有数据都按时间排序。时间戳永远不会为空。

写入时模式

在使用 InfluxDB 时,您在写入数据时定义您的模式。您不需要创建测量(相当于关系表)或显式定义测量的模式。测量模式由写入测量的数据模式定义。

重要定义

以下定义在使用 InfluxDB 时非常重要

  • :由其 测量、标签键、标签值、字段键和时间戳 标识的单个数据记录。
  • 系列:具有相同的 测量、标签键和值、字段键 的点的集合。
  • 主键:用于唯一识别表中的每行的列。行通过其 时间戳和标签集 唯一标识。行的主键 标签集 不包括值为空的标签。
示例 InfluxDB 查询结果

name: weather

timecitycountrytemperaturehumidity
2022-01-01T12:00:00ZLondonUK12.088.4
2022-01-01T12:00:00ZCologneDE13.288.5
2022-02-01T12:00:00ZLondonUK12.194.0
2022-02-01T12:00:00ZCologneDE11.587.8
2022-03-01T12:00:00ZLondonUK11.582.1
2022-03-01T12:00:00ZCologneDE10.276.4
2022-04-01T12:00:00ZLondonUK5.987.6
2022-04-01T12:00:00ZCologneDE7.993.3

可用的工具

以下表格比较了您可以使用来与 InfluxDB Cloud Serverless 交互的工具。本教程涵盖了推荐的许多工具。

工具管理写入查询
Chronograf--
influx CLI-
influx3 data CLI*-
influxctl CLI---
InfluxDB HTTP API
InfluxDB 用户界面 *-
InfluxDB v3 客户端库*-
InfluxDB v1 客户端库-
InfluxDB v2 客户端库-
Telegraf--
第三方工具
Flight SQL 客户端--
Grafana--
Superset--
Tableau--
* 本教程涵盖

influxctl 管理命令行界面在 InfluxDB Cloud Serverless 中不可用。它仅与 InfluxDB Cloud Dedicated 和 InfluxDB Clustered 一起工作。

InfluxDB 用户界面

InfluxDB 用户界面(UI)提供了一个基于网页的图形界面,用于与 InfluxDB 交互和管理。要访问 InfluxDB Cloud Serverless UI,请登录您的 InfluxDB Cloud 账户

influx CLI

influx 命令行界面允许您从命令行管理 InfluxDB Cloud Serverless 并写入数据。不支持查询 InfluxDB Cloud Serverless。

有关详细的 CLI 安装说明,请参阅influx CLI 参考

influx3 数据 CLI

influx3 数据 CLI 是一个由社区维护的工具,允许您从命令行在 InfluxDB Cloud Serverless 中写入和查询数据。它使用 HTTP API 来写入数据,并使用 Flight gRPC 来查询数据。

InfluxDB HTTP API

InfluxDB HTTP API 提供了一种简单的方法,允许您使用 HTTP(S) 客户端管理 InfluxDB Cloud Serverless 以及写入和查询数据。本教程中的示例使用 cURL,但任何 HTTP(S) 客户端都适用。

/write/query v1 兼容端点与用户名/密码认证方案以及现有的 InfluxDB 1.x 工具和代码一起工作。v2 兼容的 /api/v2/write 端点与现有的 InfluxDB 2.x 工具和代码一起工作。

InfluxDB 客户端库

InfluxDB 客户端库是由社区维护的语言特定客户端,用于与 InfluxDB API 交互。

InfluxDB v3 客户端库 是写入和查询 InfluxDB Cloud Serverless 数据的推荐客户端库。它们使用 HTTP API 来写入数据,并使用 Flight gRPC 来查询数据。

InfluxDB v2 客户端库 可以使用 /api/v2 HTTP 端点来管理资源,如桶和 API 令牌,并在 InfluxDB Cloud Serverless 中写入数据。

InfluxDB v1 客户端库 可以将数据写入 InfluxDB Cloud Serverless。

授权

InfluxDB Cloud Serverless 需要使用 API 令牌进行认证,请参阅API 令牌。每个 API 令牌都与一个用户和 InfluxDB 资源的一组特定权限相关联。您可以使用 InfluxDB UI、influx CLI 或 InfluxDB HTTP API 等管理工具来创建和管理 API 令牌。


这个页面有帮助吗?

感谢您的反馈!


Flux 的未来

Flux 正在进入维护模式。您可以继续按照当前方式使用它,无需对代码进行任何更改。

了解更多信息

InfluxDB v3 增强功能和 InfluxDB 集群版现已上市

新功能包括更快的查询性能和管理工具,推进了 InfluxDB v3 产品线。InfluxDB 集群版现已上市。

InfluxDB v3 性能和功能

InfluxDB v3 产品线在查询性能方面取得了重大提升,并提供了新的管理工具。这些增强包括一个操作仪表板,用于监控 InfluxDB 集群的健康状况,InfluxDB Cloud 专用版中的单点登录(SSO)支持,以及用于令牌和数据库的新管理 API。

了解新 v3 增强功能


InfluxDB 集群版上市

InfluxDB 集群版现已上市,为您在自行管理的堆栈中提供 InfluxDB v3 的功能。

与我们讨论 InfluxDB 集群版

InfluxDB 云无服务器