文档

开始使用 InfluxDB Cloud Dedicated

InfluxDB 是专为收集、存储和查询时间序列数据而构建的平台。InfluxDB Cloud Dedicated 由 InfluxDB 3.0 存储引擎提供支持,该引擎提供几乎无限的数据系列基数,提高了查询性能,并且与广泛使用的数据处理工具和平台互操作。

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

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

本多部分教程将指导您如何将时间序列数据写入 InfluxDB Cloud Dedicated,查询,然后可视化这些数据。

开始之前的关键概念

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

数据组织

InfluxDB Cloud Dedicated 数据模型将时间序列数据组织到数据库和表中。

一个数据库可以包含多个表。表包含多个标签和字段。

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

关于桶和测量怎么办?

如果来自InfluxDB云无服务器或由TSM存储引擎驱动的InfluxDB,您可能熟悉测量这两个概念。TSM或InfluxDB云无服务器中的与InfluxDB云专用中的数据库同义。测量在TSM或InfluxDB云无服务器中与InfluxDB云专用中的同义。

写入时模式

当您向InfluxDB写入数据时,数据定义了表模式。您不需要创建表或显式定义表模式。

重要定义

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

  • :由其测量、标签键、标签值、字段键和时间戳标识的单个数据记录。
  • 系列:具有相同测量、标签键和值以及字段键的一组点。
  • 主键:用于在表中唯一标识每行的列。行通过其时间戳和标签集唯一标识。一行的主键标签集不包括具有null值的标签。
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云专用交互的工具。本教程涵盖了其中许多推荐工具。

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

避免使用influx CLI与InfluxDB云专用一起使用。虽然它可能偶然工作,但不受支持。

influxctl CLI

influxctl 命令行界面 (CLI)可以写入、查询并执行管理任务,例如在集群中管理数据库和授权令牌。

influx3 data CLI

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

InfluxDB HTTP API

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

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

InfluxDB客户端库

InfluxDB客户端库是社区维护的、特定语言的客户端,可以与InfluxDB API交互。

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

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

InfluxDB v1客户端库可以写入InfluxDB云专用数据。

授权

InfluxDB Cloud Dedicated需要使用以下其中一种令牌类型进行身份验证

  • 数据库令牌:一种允许读取和写入InfluxDB数据库的令牌。

  • 管理令牌:由influxctl CLI生成的Auth0身份验证令牌,用于管理您的InfluxDB集群。管理令牌授权用户执行以下相关任务

    • 账户管理
    • 数据库管理
    • 数据库令牌管理
    • 定价

默认情况下,管理令牌是

  • 短暂有效的
  • 针对特定用户发行
  • 由OAuth2身份提供者发行
  • influxctl管理,不需要用户管理

但是,出于自动化的目的,influxctl用户可以手动创建一个长期有效管理令牌,以用于InfluxDB Cloud Dedicated管理API。手动创建的管理令牌将直接与您的InfluxDB集群进行身份验证,不需要与身份提供者进行人工交互。


这个页面有帮助吗?

感谢您的反馈!


Flux的未来

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

阅读更多

InfluxDB v3增强和InfluxDB Clustered现已上市

包括更快查询性能和管理工具在内的新功能,推动了InfluxDB v3产品线的进步。InfluxDB Clustered现已上市。

InfluxDB v3性能和功能

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

了解v3新增强功能


InfluxDB Clustered上市

InfluxDB Clustered现已上市,为您的自托管堆栈提供了InfluxDB v3的功能。

与我们谈谈InfluxDB Clustered