菜单
文档breadcrumb arrow Grafana 文档breadcrumb arrow Grafana 开源版入门breadcrumb arrow Grafana 和 InfluxDB 入门
Enterprise Open source

Grafana 和 InfluxDB 入门

InfluxDB 是由 InfluxData 开发的一个开源时序数据库 (TSDB)。它经过优化,可用于快速、高可用地存储和检索时序数据,适用于运营监控、应用指标、IoT 传感器数据和实时分析等领域。

获取 InfluxDB

您可以下载 InfluxDB 并本地安装,也可以注册 InfluxDB Cloud。某些版本的 InfluxDB 不提供 Windows 安装程序。

安装其他 InfluxDB 软件

安装 Telegraf。该工具是一个代理,可帮助您将指标导入 InfluxDB。更多信息,请参阅Telegraf 文档

如果您选择使用 InfluxDB Cloud,则应下载并安装 InfluxDB Cloud CLI。该工具允许您向您的云帐户发送命令行指令。更多信息,请参阅Influx CLI 文档

将数据导入 InfluxDB

如果您在本地计算机上下载并安装了 InfluxDB,请使用快速入门功能来可视化 InfluxDB 指标。

如果您正在使用云帐户,则向导会引导您完成初始过程。更多信息,请参阅配置 Telegraf

给 Windows 用户的说明

Windows 用户可能需要进行额外的调整。请查阅 InfluxData 文档和《在 Windows 上使用 Telegraf》博客文章中的特殊说明。InfluxDB Cloud 中的常规系统监控模板与 Windows 不兼容。使用 InfluxDB Cloud 监控系统的 Windows 用户需要使用Windows 系统监控模板

将您的 InfluxDB 数据源添加到 Grafana

您可以在 Grafana 中定义多个 InfluxDB 数据源。

  1. 按照一般说明添加数据源
  2. 决定您将使用 InfluxQL 还是 Flux 作为查询语言。
    • 为选择的查询语言配置数据源。每种查询语言都有其独特的数据源设置。
    • 有关每种语言特有的查询功能,请参阅数据源的查询编辑器文档
InfluxDB 指南

InfluxDB 发布了关于如何将不同版本的产品连接到 Grafana 的指南。

重要提示
  • 确保您的 Grafana token 具有读取权限。如果没有,您将收到认证错误,无法连接 Grafana 到 InfluxDB。
  • 避免在桶和 token 名称中使用撇号及其他非标准字符。
  • 如果组织或桶的文本名称不起作用,请尝试使用 ID 号码。
  • 如果您在 InfluxDB 中更改了桶名称,那么在 Grafana 和您的 Telegraf .conf 文件中也必须进行更改。

添加查询

此步骤取决于您在 Grafana 中设置数据源时选择的查询语言。

InfluxQL 查询语言

在查询编辑器中,点击选择测量 (select measurement)。

InfluxQL query

Grafana 会显示可能的系列列表。点击其中一个进行选择,Grafana 会绘制任何可用数据。如果没有数据可显示,请尝试其他选项或检查您的数据源。

Flux 查询语言

创建一个简单的 Flux 查询。

  1. 添加面板.
  2. 在查询编辑器中,选择您的 InfluxDB-Flux 数据源。更多信息,请参阅查询
  3. 选择表格可视化。
  4. 在查询编辑器文本字段中,输入 buckets(),然后点击查询编辑器之外。

这个通用查询会返回一个桶列表。

Flux query

您也可以在 InfluxDB 的 Explore 视图中创建 Flux 查询。

  1. 在浏览器中,登录 InfluxDB 原生 UI(OSS 通常是 https://:8086,对于 InfluxDB Cloud 使用:https://cloud2.influxdata.com)。

  2. 点击探索以打开数据浏览器。

  3. InfluxDB 数据浏览器提供了两种创建 Flux 查询的机制:图形化查询编辑器和脚本编辑器。使用图形化查询编辑器创建一个查询。它将看起来像这样

    InfluxDB Explore query

  4. 点击脚本编辑器查看查询文本,然后复制所有 Flux 代码行,它将看起来像这样

    InfluxDB Explore Script Editor

  5. 在 Grafana 中,添加一个面板,然后将您的 Flux 代码粘贴到查询编辑器中。

  6. 点击应用。您的新面板应该会显示 Flux 查询的数据。

在 Grafana Explore 中检查 InfluxDB 指标

在您的 Grafana 实例中,转到探索视图,构建查询以尝试您想要监控的指标。您也可以在这里调试与收集指标相关的问题。

开始构建仪表盘

就是这样!使用 Explore 和 Data Explorer 尝试您的数据,并将您喜欢的查询作为面板添加到您的仪表盘中。尽情享受吧!

以下是一些资源供您了解更多信息