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部分渲染