创建笔记本

创建笔记本以探索、可视化和处理您的数据。了解如何添加和配置单元格以自定义您的笔记本。要了解笔记本的优势和概念，请参阅笔记本概述。

• 从预设创建笔记本
• 使用数据源单元格
• 使用可视化单元格
• 添加数据源单元格
• 添加验证单元格
• 添加可视化单元格

从预设创建笔记本

要创建新笔记本，请执行以下操作

1. 在左侧的导航菜单中，单击 笔记本。

   笔记本

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

   • 新笔记本：包括查询构建器单元格、验证单元格和可视化单元格。
   • 设置警报：包括查询构建器单元格、验证单元格、可视化单元格和警报构建器单元格。
   • 计划任务：包括Flux 脚本编辑器单元格、验证单元格和任务计划单元格。
   • 编写 Flux 脚本：包括Flux 脚本编辑器单元格和验证单元格。

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

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

   • 选择您的本地时区或 UTC。
   • 为您的数据选择一个时间范围。

5. 您的笔记本应具有 数据源 单元格作为第一个单元格。数据源 单元格为后续单元格提供数据。预设（在步骤 2 中列出）包括 查询构建器 或 Flux 脚本 作为第一个单元格。

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

   • 如果您的笔记本使用 查询构建器 单元格，请选择您的存储桶和任何其他查询过滤器。
   • 如果您的笔记本使用 Flux 脚本 单元格，请输入或粘贴 Flux 脚本。

7. 选择并单击笔记本标题下的 预览（或按 CTRL + Enter）。InfluxDB 在 验证数据 和 可视化结果 中显示查询结果，不写入数据或运行操作。

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

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

10. （可选）配置笔记本操作（警报、任务或 输出到存储桶）。

11. （可选）要运行您的笔记本操作，请选择并单击笔记本标题下的 运行。

12. （可选）要添加新单元格，请按照以下单元格类型之一的步骤操作

    • 添加数据源单元格
    • 添加验证单元格
    • 添加可视化单元格
    • 添加操作单元格

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

使用数据源单元格

将查询构建器转换为 Flux

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

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

   包含原始 Flux 脚本的 Flux 脚本 编辑器单元格将替换 查询构建器 单元格。

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

使用可视化单元格

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

添加数据源单元格

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

要添加数据源单元格，请执行以下操作

1. 单击 。
2. 选择 Flux 脚本 或 查询构建器 作为您的输入，然后选择或输入要从中提取数据的存储桶。
3. 选择筛选器以缩小您的数据范围。
4. 在左上角的下拉列表中选择 预览（CTRL + Enter）或 运行。

添加验证单元格

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

要添加 表格 可视化单元格，请执行以下操作

1. 单击 。
2. 在 可视化 下，单击 表格。

添加可视化单元格

添加可视化单元格以将查询结果呈现为可视化类型。

要添加表格可视化单元格，请执行以下操作

1. 单击 。

2. 在 可视化 下，选择以下可视化单元格类型之一

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

要修改可视化单元格，请参阅使用可视化单元格。有关可用可视化类型以及如何使用它们的详细信息，请参阅可视化类型。

添加操作单元格

添加操作单元格以创建警报，使用任务处理数据，或将数据输出到存储桶。

• 添加警报单元格
• 添加输出到存储桶单元格
• 添加任务单元格

添加警报单元格

要向您的笔记本添加警报，请执行以下操作

1. 输入时间范围以自动检查数据并输入您的查询偏移量。
2. 自定义发送警报的条件。
3. 选择一个端点以接收警报
   • Slack 和 Slack 频道
   • HTTP post
   • PagerDuty
4. （可选）个性化您的消息。默认情况下，消息为

   ${strings.title(v: r._type)} for ${r._source_measurement} triggered at ${time(v: r._source_timestamp)}!
   

5. 单击 测试警报 以向您配置的 端点 发送测试消息。测试不会计划新的警报。
6. 单击 导出警报任务 以创建您的警报。

添加输出到存储桶单元格

要将 数据源 结果写入存储桶，请执行以下操作

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

添加任务单元格

要向您的笔记本添加任务，请执行以下操作

1. 单击 。
2. 单击 任务。
3. 输入时间和偏移量以计划任务。
4. 单击 导出为任务 以保存。