Grafana 仪表盘教程：如何开始

作者：社区 / 开发者，入门
2023年12月8日

Grafana 是一个开源的网页应用程序，用于数据可视化。您可以查询数据、创建可视化并接收警报，以更好地理解您所拥有的内容。有些人认为 Grafana 是一个仅适用于 Kubernetes 的工具，但实际上，它只是一个在 Kubernetes 生态系统中变得流行起来的数据可视化工具，尤其是在与 Prometheus 结合使用时。

在这篇文章中，我将专注于 Grafana 的一个非常具体的部分：仪表盘。为了做到这一点，我将使用 Grafana 的 教程环境设置，以帮助您快速入门并学习如何使用 Docker Compose 来使用仪表盘。

在深入具体细节之前，让我们先了解一下您可以使用 Grafana 仪表盘做什么。

Grafana 仪表盘能做什么？

总的来说，仪表盘是数据的可视化表示。原始数据本身可能不会告诉你太多，但当你使用仪表盘时，你可以获得有价值的信息。比如说，你正在运营一个关于最新游戏行业新闻的网站。不时地，你会收到客户投诉网站无法加载或加载时间过长。你该如何识别问题？一种方法可能是登录服务器并读取一些日志。如果你只有几个服务器或容器，这是可行的。但是，当你有几十个时，你需要更好的方法。

InfluxDB 仪表盘可以帮助你提前更好地了解正在发生的事情。您可以配置 Grafana 使用您想要的任何数据源，仪表盘将帮助您进行可视化，以便您可以更快地解决问题。您还可以注释事件并解释在执行某些操作（如最近发布或营销活动）之后会发生什么。我将在下一部分向您展示如何做到这一点。

我该如何使用 Grafana 仪表盘？

设置

让我们给您一些使用 Grafana 的示例应用程序的动手经验。为此，您需要安装 Git、Docker 和 Docker Compose。然后克隆存储库以在本地拥有所有文件。

git clone github.com/grafana/tutorial-environment

进入存储库文件夹并启动您将要使用的所有服务。这可能需要几分钟。

cd tutorial-environment
docker-compose up -d

您现在可以在本地主机上浏览新闻网站的示例应用，地址为localhost:8081，以及Grafana在localhost:3000。Grafana的用户名和密码都是“admin”。第一次登录时，您需要更改密码。请确保您可以浏览这两个服务和新闻，因为您将使用它们作为仪表板的数据源。

导入数据

在您开始创建仪表板之前，您需要通知Grafana您希望使用哪些数据源。您可以添加多种类型的数据源，例如时间序列数据库、日志和文档数据库、分布式跟踪、SQL数据库和云提供商。一个常见的数据源是Prometheus，我们将今天使用它。

注意：您可以使用Telegraf插件轻松将Prometheus数据发送到InfluxDB。这使得您可以将Prometheus数据与其他数据源结合，以创建更全面的视角。InfluxDB与Grafana本机兼容，允许您在一个地方查询和可视化所有数据。

在Grafana中，点击侧边栏打开设置菜单，然后点击“连接”下的“数据源”。

接下来，点击“添加数据源”按钮，然后点击“Prometheus”。在“Prometheus服务器URL”文本框中输入：http://prometheus:9090。滚动到页面底部，然后点击“保存 & 测试”按钮。

您将使用Prometheus来获取新闻网站的指标，例如延迟和请求数量。为了丰富您的仪表板，您可以添加另一个数据源以获取新闻网站的日志。

再次转到“数据源”页面，点击“添加新数据源”按钮，向下滚动一点，然后在“日志 & 文档数据库”部分点击“Loki”。

一旦进入，请在URL文本框中输入http://loki:3100。滚动到页面底部，然后点击“保存 & 测试”按钮。

打开新闻网站的示例应用，通过添加新链接、投票或简单地刷新浏览器来模拟流量。我们需要一些新数据来在仪表板中看到一些内容。

创建仪表板

现在您已经有了两个数据源，并且已经从新闻网站中生成了一些数据，您可以通过可视化数据来获取更多关于正在发生什么的见解。返回Grafana网站，在侧边栏菜单中点击“仪表板”。接下来，点击右上角的“新建”按钮，然后在下拉列表中选择“新建仪表板”。现在点击“+ 添加可视化”按钮。您应该看到您之前添加的两个数据源，Prometheus和Loki。首先通过点击“Prometheus”选项添加度量数据源。

下面的屏幕有几个按钮、文本框和一个您应该看到图形的大区域。按照步骤配置此屏幕以创建您的第一个Prometheus数据可视化。点击图下的“查询”标签，然后点击屏幕右侧的“代码”选项。接下来，在“度量浏览器”文本框中输入以下查询

sum(rate(tns_request_duration_seconds_count[5m])) by(route)

现在点击“运行查询”按钮——您应该在屏幕上看到查询的可视表示。

您可以在屏幕右侧自定义图表标题。转到“面板选项”，在“标题”文本框中输入如“流量”之类的标题。请注意，可视化标题现在已不同。要完成创建仪表板，请点击右上角的“应用”按钮。

事件注释

Grafana仪表板允许您添加注释。当事情出错时，此工具特别有用。您可以自动或手动创建注释。每次您发布网站的新版本或营销活动开始时，都可以添加注释。有了注释，如果延迟降低，您将有更多背景信息。

假设您几分钟前启动了部署，并想手动将此注释添加到仪表板。在您可以对事件进行注释之前，您需要保存仪表板。为此，请点击仪表板标题中的齿轮图标。 接下来，在“名称”文本框中为仪表板输入一个名称，然后点击“保存仪表板”按钮。 在仪表板中单击图表的任何位置，然后单击“添加注释”按钮。

添加描述和标签，然后单击“保存”按钮。

当您将鼠标悬停在注释的底部，即在x轴上方的线条上时，您将看到注释。每当仪表板中存在注释时，您都会获得有关应用程序中发生的事情的额外背景信息。这些信息可以帮助您做出决策，例如回滚或快速推送修复。

当您玩够了Grafana后，可以使用以下命令停止所有容器服务

docker-compose down -v

总结

在Grafana中创建仪表板非常简单。确保您拥有所需的数据源，然后构建查询以可视化这些数据。添加多个数据源可以帮助您丰富仪表板，并且您可以将所有这些数据存储在InfluxDB中。此外，当您对事件进行注释时，更容易找到问题的根本原因并更快地解决问题。

本文由David Snatch撰写。David是一位专注于使用Terraform、Kubernetes和其他任何有助于客户交付结果的出色技术的云架构师。