Grafana官方文档翻译

欢迎来到Grafana文档

Grafana是一个开源指标分析和可视化套件。 它最经常使用于可视化基础设施和应用程序分析的时间序列数据，但许多应用于其余领域，包括工业传感器，家庭自动化，天气和过程控制。

基本概念

本文档是对Grafana中基本概念的“自下而上”介绍，能够用做开始熟悉核心功能的起点。

数据源

Grafana支持您的时间序列数据（数据源）的许多不一样的存储后端。 每一个数据源都有一个特定的查询编辑器，该编辑器针对特定数据源公开的功能和功能进行自定义。如下数据源正式支持：Graphite，InfluxDB，OpenTSDB，Prometheus，Elasticsearch，CloudWatch。每一个数据源的查询语言和功能显然是很是不一样的。 您能够未来自多个数据源的数据合并到单个仪表板上，但每一个Panel都与属于特定组织的特定数据源相关联。

组织

Grafana支持多个组织，以支持各类部署模型，包括使用单个Grafana实例为多个可能不受信任的组织提供服务。

在许多状况下，Grafana将部署一个组织。

每一个组织能够有一个或多个数据源。

全部信息中心由特定组织全部。

注意：重要的是要记住，大多数度量数据库不提供任何种类的每用户系列认证。 所以，在Grafana中，数据源和仪表板对特定组织中的全部用户可用。

有关Grafana用户模型的更多详细信息，请参阅管理员

用户

用户是Grafana中的命名账户。 用户能够属于一个或多个组织，而且能够经过角色分配不一样级别的权限。

Grafana支持各类内部和外部方式让用户验证本身。 这些包括来自其本身的集成数据库，来自外部SQL服务器或外部LDAP服务器。

有关详细信息，请参阅用户身份验证

行

行是仪表板中的逻辑分区，用于将面板组合在一块儿。

行老是12“单位”宽。 这些单位会根据浏览器的水平分辨率自动缩放。 您能够经过设置本身的宽度来控制行内的面板的相对宽度。

咱们使用单位抽象，使Grafana在全部的小和巨大的屏幕看起来不错。

注意：使用MaxDataPoint功能时，不管您的分辨率或时间范围如何，Grafana均可以显示完美的数据点数量。

使用重复行功能根据所选的模板变量动态建立或删除整个行（可使用面板填充）。

经过单击行标题能够折叠行。 若是保存带有折叠行的信息中心，它将保存在该状态，而且不会预加载这些图形，直到行展开。

面板

面板是Grafana的基本可视化构建块。每一个面板都提供一个查询编辑器（取决于在面板中选择的数据源），容许您经过使用查询编辑器提取要显示在面板上的完美可视化

每一个Panel都有各类各样的样式和格式选项，能够建立完美的图片。

面板能够在仪表板上拖放和从新排列。它们也能够调整大小。

目前有四种面板类型：图形，单词，Dashlist，表和文本。

面板（如“图表”面板）容许您根据须要绘制多个指标和系列。其余面板如Singlestat须要将单个查询减小为单个数字。 Dashlist和Text是不链接到任何数据源的特殊面板。

经过在面板配置（包括经过查询编辑器配置的数据源的查询）中使用Dashboard模板变量字符串，可使面板更具动态性。

利用重复面板功能，根据所选的模板变量动态建立或删除面板。

面板上的时间范围一般是仪表板时间选择器中设置的时间范围，但这能够经过利用面板特定时间覆盖来覆盖。

面板（或整个信息中心）能够经过多种方式轻松共享。您能够发送连接到有登陆您的Grafana的人。您可使用快照功能将当前正在查看的全部数据编码到静态和交互式JSON文档中;它是如此优于电子邮件截图！

查询编辑器

查询编辑器公开了数据源的功能，并容许您查询其包含的指标。

使用查询编辑器在时间序列数据库中构建一个或多个查询（对于一个或多个系列）。 面板将即时更新，您能够实时有效地浏览您的数据，并为该特定面板构建完美的查询。

您能够在查询编辑器中的查询自己内使用模板变量。 这提供了一种强大的方法来根据在仪表板上选择的模板变量动态地探索数据。

Grafana容许您在查询编辑器中按照它们所在的行引用查询。 若是您向图表添加第二个查询，则能够经过键入#A来引用第一个查询。 这提供了一种构建复合查询的简单方便的方法。

仪表板

仪表板是全部的一切。 仪表板能够被认为是一组一个或多个面板的组织和排列成一个或多个行。

仪表板的时间段能够经过仪表板右上角的仪表板时间选择器进行控制。

仪表板能够利用模板来使它们更加动态和交互。

仪表板可使用注释来显示面板中的事件数据。 这能够帮助将Panel中的时间序列数据与其余事件相关联。

仪表板（或特定面板）能够经过多种方式轻松共享。 您能够发送连接到有登陆您的Grafana的人。 您可使用快照功能将当前正在查看的全部数据编码到静态和交互式JSON文档中; 它是如此优于电子邮件截图！

能够对仪表板进行标记，仪表板选择器能够快速，可搜索地访问特定组织中的全部仪表板

 

dashboard界面最上面一行解释

上图显示了信息中心的顶部标题。

1侧面菜单切换：切换侧边菜单，容许您专一于仪表板中显示的数据。侧面菜单提供对与仪表板无关的功能（如用户，组织和数据源）的访问。

2信息中心下拉菜单：此下拉菜单显示您当前正在查看的信息中心，并容许您轻松切换到新的信息中心。从这里，您还能够建立新的信息中心，导入现有的信息中心和管理信息中心播放列表。

3星型仪表板：对当前仪表板执行星号（或取消星标）。加星标的信息中心在默认状况下会显示在您本身的主页信息中心上，而且是标记您感兴趣的信息中心的便捷方式。

4共享仪表板：经过建立连接或建立其静态快照来共享当前仪表板。在共享前确保信息中心已保存。

5保存仪表板：当前仪表板将与当前仪表板名称一块儿保存。

6设置：管理仪表板设置和功能，如模板和注释。

 

仪表板，面板，行，Grafana的构建块...¶

仪表板是Grafana所关注的核心。 仪表板由排列在多个行上的各个面板组成。 Grafana配有各类面板。 Grafana能够轻松地构建正确的查询，并自定义显示属性，以便您能够为您的须要建立完美的仪表板。 每一个Panel能够与来自任何配置的Grafana数据源（目前为InfluxDB，Graphite，OpenTSDB，Prometheus和Cloudwatch）的数据进行交互。 基本概念指南详细探讨了这些关键思想。

 

 

Graph Panel

Grafana的主面板简称为Graph。 它提供了一组很是丰富的图形选项。

通用选项卡容许自定义面板的外观和菜单选项。

General

general选项卡容许自定义面板的外观和菜单选项。

通常选项

title- 仪表板上的面板标题

span- 列中的面板宽度

height- 面板内容高度（以像素为单位）

Drilldown / detail link

Drilldown部分容许向能够连接到其余信息中心或网址的面板添加动态连接

每一个连接都有一个标题，一个类型和参数。连接能够是仪表板或绝对连接。若是它是仪表板连接，则仪表板值必须是仪表板的名称。若是它是绝对连接，则URL是要连接的URL。

params容许向连接添加其余URL参数。格式是名称=值，多个参数用＆分隔。模板变量可使用$ myvar做为值添加。

当连接到使用模板变量的另外一个仪表板时，可使用var-myvar = value将连接中的模板变量填充到所需的值。

Axes

“轴和网格”选项卡控制轴，网格和图例的显示。

 

Legend

经过选中显示复选框隐藏图例手。 若是显示，能够经过选中表复选框将其显示为值表。 没有值的系列可使用隐藏空复选框从图例中隐藏。

 

Display styles

Thresholds

阈值容许您向图中添加任意线或部分，以便在图形跨越特定阈值时更容易查看。

Draw Options

Draw Modes

•  - 以条形图显示值
•  - 将值显示为线形图
•  - 显示值的点

Mode Options

•  - 颜色填充透明度，0是无，10是实
•  - 线的粗度
•  - 绘制成柱状图

Series specific overrides部分渲染