Documentation

创建一个笔记本

创建一个笔记本来探索、可视化和处理您的数据。 学习如何添加和配置单元格以自定义您的笔记本。 要了解笔记本的好处和概念,请参见 笔记本概述.

从预设创建笔记本

要创建一个新的笔记本,请执行以下操作:

  1. 在左侧的导航菜单中,点击 笔记本

  2. 笔记本页面中,在创建笔记本下选择以下选项之一:

  3. 未命名笔记本字段中输入笔记本的名称。

  4. 在页面的顶部执行以下操作:

    • 选择您所在的本地时区或UTC。
    • 为您的数据选择一个时间 范围
  5. 您的笔记本应该将 数据源 单元格作为第一个单元格。 数据源 单元格为后续单元格提供数据。预设(在步骤2中列出)包括在第一个单元格中使用 查询构建器Flux 脚本

  6. 要定义您的数据源查询,请执行以下任一操作:

    • 如果您的笔记本使用查询构建器单元,请选择您的存储桶和任何额外的查询过滤器。
    • 如果您的笔记本使用Flux Script单元,请输入或粘贴一个Flux script
  7. 选择并点击 预览(或按 CTRL + Enter)在笔记本标题下。 InfluxDB 在 验证数据可视化结果 中显示查询结果 而不写入数据或运行操作

  8. (可选) 使用下拉菜单和 配置按钮更改您的可视化设置,位于可视化结果单元格的顶部。

  9. (可选) 切换演示开关以显示可视化单元格并隐藏所有其他单元格。

  10. (可选) 配置笔记本操作 (警报, 任务, 或 输出到存储桶)

  11. (可选) 要运行你的笔记本操作,请在笔记本标题下选择并点击运行

  12. (可选) 要添加一个新单元格,请按以下单元格类型的步骤操作:

  13. (可选) 将查询构建器单元转换为原始 Flux 脚本 以查看和编辑代码。

使用数据源单元格

将查询构建器转换为Flux

要编辑查询构建器单元的原始Flux脚本,请将单元转换为Flux。

您无法将Flux Script编辑器单元格转换为查询构建器单元格。 一旦您将查询构建器单元格转换为Flux Script编辑器单元格,您就无法再将其转换回去。

  1. 单击您要作为 Flux 编辑的 查询生成器 单元格中的 图标,然后选择 转换为 |> Flux。您将无法撤消此步骤。

    一个 Flux 脚本 编辑单元包含原始 Flux 脚本,取代 查询构建器 单元。

  2. 根据需要查看和编辑Flux脚本。

使用可视化单元格

  • 要更改您的 可视化类型,请在单元格顶部的下拉列表中选择一个新类型。
  • (仅限直方图) 要指定值,请点击 选择
  • 要配置可视化,请点击 配置
  • 要将结果下载为带注释的CSV文件,请点击CSV按钮。
  • 要导出到仪表板,请单击 导出到仪表板

添加数据源单元格

添加一个 数据源单元格 以将信息导入您的笔记本。

要添加数据源单元格,执行以下操作:

  1. 点击 .
  2. 选择 Flux 脚本查询构建器 作为你的输入,然后选择或输入要从中提取数据的桶。
  3. 选择过滤器以缩小您的数据范围。
  4. 选择 预览 (CTRL + Enter) 或 运行 在左上角下拉列表中。

添加验证单元

验证单元使用表格可视化类型显示来自数据源单元的查询结果。

要添加一个 表格 可视化单元格,请执行以下操作:

  1. 点击 .
  2. 可视化 下,点击 表格

添加可视化单元

添加一个可视化单元,以将查询结果呈现为可视化类型

要添加一个表格可视化单元,请执行以下步骤:

  1. 点击 .

  2. 可视化下,选择以下可视化单元类型之一:

    • 表格: 以表格格式显示数据。
    • 图表: 使用InfluxDB可视化工具可视化数据。
    • 注意: 使用Markdown为您的笔记本添加注释或其他信息。

要修改可视化单元,请参阅 使用可视化单元。有关可用可视化类型及其使用方法的详细信息,请参阅 可视化类型

添加一个操作单元

添加一个 动作单元 来创建一个 警报 , 用一个 任务 处理数据,或者将数据输出到一个桶中.

如果您的单元格包含自定义脚本,使用任何输出函数将数据写入InfluxDB(例如:to()函数)或将数据发送到第三方服务,点击预览将写入数据。

添加一个警报单元

要在您的笔记本中添加一个 alert,请执行以下操作:

  1. 输入一个时间范围以自动检查数据并输入您的查询偏移量。
  2. 自定义发送警报的条件。
  3. 选择一个接收警报的端点:
    • Slack 和一个 Slack 频道
    • HTTP POST
    • 值班响应
  4. (可选) 个性化您的消息。默认消息为:
    ${strings.title(v: r._type)} 为 ${r._source_measurement} 在 ${time(v: r._source_timestamp)} 触发!
    
  5. 单击 测试警报 以向您配置的 终端 发送测试消息。该测试将不会调度新的警报。
  6. 点击 导出警报任务 创建您的警报。

向 Bucket 单元格添加输出

要将 数据源 结果写入一个存储桶,请执行以下操作:

  1. 点击 .
  2. 点击 输出到 Bucket.
  3. 选择一个存储桶下拉列表中,选择或创建一个存储桶。
  4. 点击 预览 以查看验证单元格中的查询结果。
  5. 选择并点击 运行 在左上角将查询结果写入存储桶。

添加任务单元

要将一个 任务 添加到您的笔记本,请执行以下操作:

  1. 点击 .
  2. 点击 任务.
  3. 输入一个时间和一个偏移量来调度任务。
  4. 点击 导出为任务 以保存。


Flux的未来

Flux 正在进入维护模式。您可以像现在一样继续使用它,而无需对您的代码进行任何更改。

阅读更多

InfluxDB 3 开源版本现已公开Alpha测试

InfluxDB 3 Open Source is now available for alpha testing, licensed under MIT or Apache 2 licensing.

我们将发布两个产品作为测试版的一部分。

InfluxDB 3 核心,是我们新的开源产品。 它是一个用于时间序列和事件数据的实时数据引擎。 InfluxDB 3 企业版是建立在核心基础之上的商业版本,增加了历史查询能力、读取副本、高可用性、可扩展性和细粒度安全性。

有关如何开始的更多信息,请查看: