本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用您的 Grafana 工作區
Grafana 工作空間可讓您在專案上建立視覺化效果並探索指標。為您的指標設定和查詢資料來源。在儀表板內建立面板以檢視您的指標。探索您的資料。在指標上建立警示。
本節中的主題說明如何使用 Amazon Managed Grafana 工作區。
**注意**
有些主題會根據您在工作區中擁有的 Grafana 版本而有所不同。如需每個版本的特定文件，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)、 [使用 Grafana 第 9 版](using-grafana-v9.md)和 [使用 Grafana 第 8 版](using-grafana-v8.md)。如需有關將工作區從一個版本升級到另一個版本的資訊，請參閱 [更新您的工作區版本](AMG-workspace-version-update.md)。
**Topics**
+ [什麼是 Grafana？](#what-is-grafana)
+ [連線至您的工作區](connect-to-workspace.md)
+ [使用者、團隊和許可](Grafana-administration-authorization.md)
+ [建立您的第一個儀表板](getting-started-grafanaui.md)
+ [使用外掛程式擴展您的工作區](grafana-plugins.md)
+ [連線至資料來源](AMG-data-sources.md)
+ [使用 Grafana 第 10 版](using-grafana-v10.md)
+ [使用 Grafana 第 9 版](using-grafana-v9.md)
+ [使用 Grafana 第 8 版](using-grafana-v8.md)
+ [變更您的偏好設定](change-your-grafana-preferences.md)
+ [收集支援的資訊](support-bundles.md)
+ [傳統儀表板提醒](old-alerts-overview.md)
## 什麼是 Grafana？
Grafana 是開放原始碼視覺化和分析軟體。您可以使用它來查詢、視覺化、提醒和探索您的指標，無論它們存放在何處。
例如，如果您想要檢視應用程式的指標、日誌和追蹤資料，您可以建立儀表板。如果您是公司的管理員，並且為多個團隊管理 Grafana，您可能需要設定佈建和身分驗證。
下列各節概述您可以使用 Grafana 資料庫和連結執行的操作，以便您進一步了解。
### 探索指標和日誌
透過一次性或臨機操作、查詢和動態向下切入來探索您的資料。您可以分割檢視並並並排比較不同的時間範圍、查詢和資料來源。
如需詳細資訊，請參閱[在 Grafana 第 10 版中探索](v10-explore.md)。
### Alerts (提醒)
如果您使用的是 Grafana 提醒，可以透過不同的提醒通知器傳送提醒，包括下列項目：
+ Amazon SNS
+ PagerDuty
+ VictorOps
+ OpsGenie
+ Slack
如需詳細資訊，請參閱[Grafana 第 10 版中的提醒](v10-alerts.md)。
### 註釋
使用來自不同資料來源的豐富事件來註釋圖形。暫停事件以查看完整的事件中繼資料和標籤。
此功能在 Grafana 中顯示為圖形標記，有助於在發生問題時關聯資料。您可以在選擇圖形時按 **Ctrl** 手動建立註釋，然後輸入一些文字。或者，您可以從任何資料來源擷取資料。
如需詳細資訊，請參閱[註釋視覺化效果](v10-dash-annotations.md)。
### 儀表板變數
使用範本變數來建立儀表板，可用於許多不同的使用案例。使用這些範本時，不會硬式編碼值。這表示您可以針對多個伺服器使用儀表板。例如，如果您有生產伺服器和測試伺服器，則可以對兩者使用相同的儀表板。
範本化可協助您深入了解資料。例如，您可以從所有資料向下切入到北美洲資料、向下切入到德州資料等。您也可以在組織內的團隊之間共用這些儀表板。如果您為熱門資料來源建立絕佳的儀表板範本，您也可以將它提供給整個社群來自訂和使用。
如需詳細資訊，請參閱[Variables](v10-dash-variables.md)。
# 連線至您的工作區
您必須先使用您設定的身分提供者登入，才能使用 Amazon Managed Grafana 工作區進行連線。如果您尚未透過某些身分提供者設定身分驗證方法，請參閱 [驗證 Amazon Managed Grafana 工作區中的使用者](authentication-in-AMG.md) 以取得詳細資訊。
**注意**
如果您嘗試以程式設計方式連接到工作區，則必須使用 API 字符。如需詳細資訊，請參閱[使用字符進行驗證](authenticating-grafana-apis.md)。
**登入 Grafana 工作區**
1. 開啟位於 https：//[https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/) 的 Amazon Managed Grafana 主控台，然後登入。
1. 選擇頁面左上角的功能表圖示，然後選擇**所有工作區**。
1. 選擇您要登入的工作區名稱。
1. 在工作區詳細資訊頁面中，選擇顯示在 **Grafana 工作區 URL 下的 URL**。
1. 選擇工作區 URL 會帶您前往 Grafana 工作區主控台的登陸頁面。選擇**使用 登入 AWS IAM Identity Center**，然後輸入電子郵件地址和密碼。
**注意**
如果您已設定身分提供者的身分驗證，登入按鈕會有不同的文字和要求。
# 使用者、團隊和許可
Amazon Managed Grafana 中的許可會跨 Amazon Managed Grafana 主控台直接在工作區中管理。
+ **使用者** – 使用者會在 IAM Identity Center 或您透過 Amazon Managed Grafana 主控台中的 SAML 設定的身分提供者中進行[身分驗證](authentication-in-AMG.md)。
+ **角色存取** – 您可以使用 `User`、 或 `Admin`角色授予使用者`Editor`或群組[存取權](AMG-manage-users-and-groups-AMG.md)，以使用 Amazon Managed Grafana 主控台將預設許可授予工作區。
+ **群組或團隊** – 您可以建立使用者群組，以兩種方式授予 的存取權。您可以在身分提供者 （或 IAM Identity Center) 中建立群組。然後，您可以在 Amazon Managed Grafana 主控台中授予這些群組存取權，就像使用者一樣。或者，您可以在 Grafana 工作區中建立 [Teams](Grafana-teams.md)，並為他們提供您希望他們擁有的角色。
+ **特定許可** – 如果您想要[覆寫特定儀表板、資料夾或資料來源的角色](Grafana-permissions.md)授予的許可，您可以移除預設許可，並將許可指派給特定使用者或團隊。這會在 Grafana 工作區內完成。
本節說明如何在 Grafana 工作區內執行許可管理。
**Topics**
+ [使用者](Grafana-users.md)
+ [使用者角色](Grafana-user-roles.md)
+ [管理團隊](Grafana-teams.md)
+ [使用許可](Grafana-permissions.md)
# 使用者
在 Amazon Managed Grafana 中，您不要在 Grafana 工作區中新增使用者。反之，您可以使用 IAM Identity Center 或 和身分提供者來驗證使用者，然後授予使用者從 Amazon Managed Grafana 主控台存取 Amazon Managed Grafana 工作區的權限。如需詳細資訊，請參閱[管理 Amazon Managed Grafana 工作區的使用者和群組存取權](AMG-manage-users-and-groups-AMG.md)。
# 使用者角色
在 Amazon Managed Grafana 中，每個啟用使用 Amazon Managed Grafana 工作區的使用者都會指派給 Amazon Managed Grafana 主控台中的三個[角色](AMG-manage-users-and-groups-AMG.md)之一。
+ **管理員角色** — 具有管理員角色的使用者可以執行下列動作：
+ 可以新增、編輯和刪除資料來源。
+ 可以新增和編輯使用者和團隊。
+ 可以新增、編輯和刪除包含儀表板的資料夾。
+ 可以執行編輯器角色允許的所有操作。
+ **編輯器角色** — 具有編輯器角色的使用者可以執行下列動作：
+ 可以在他們有權存取的儀表板中檢視、新增和編輯儀表板、面板和提醒規則。這可在特定資料夾和儀表板上停用。
+ 可以建立、更新或刪除播放清單。
+ 可以存取探索。
+ 可以新增、編輯和刪除通知通道。
+ 無法新增、編輯或刪除資料來源。
+ 可以執行檢視器角色允許的所有動作。
+ **檢視器角色** — 具有檢視器角色的使用者可以執行下列動作：
+ 可以檢視他們有權存取的任何儀表板。這可在特定資料夾和儀表板上停用。
+ 無法建立、更新或刪除播放清單。
+ 無法存取探索。
+ 無法新增、編輯和刪除通知通道。
+ 無法新增、編輯或刪除資料來源。
+ 無法新增、編輯或刪除儀表板或面板。
+ 無法管理其他使用者或團隊。
Amazon Managed Grafana 不支援來自 Grafana 工作區的使用者指派和使用者存取管理。管理使用者和群組存取權的方式取決於您使用 IAM Identity Center 還是 SAML 進行身分驗證：
+ 如果您的工作區使用 IAM Identity Center 進行身分驗證，您可以使用 Amazon Managed Grafana 主控台或 APIs 來指派角色。如需詳細資訊，請參閱[管理 Amazon Managed Grafana 工作區的使用者和群組存取權](AMG-manage-users-and-groups-AMG.md)。
+ 如果您的工作區使用 SAML 進行身分驗證，使用者角色只會由聲明屬性定義。如需詳細資訊，請參閱[聲明映射](authentication-in-AMG-SAML.md#AMG-SAML-Assertion-Mapping)。
# 管理團隊
使用 *團隊*可讓您同時將許可授予使用者群組。您也可以設定團隊同步，在 Grafana 工作區和授權提供者之間自動同步團隊成員資格。
## 建立或移除團隊
建立團隊以管理群組中的使用者。
**建立團隊**
1. 在側邊欄中，選擇**組態** （齒輪） 圖示，然後選擇**團隊**。
1. 選擇**新團隊**。
1. 針對**名稱**，輸入新團隊的名稱，然後選擇**建立**。
**移除團隊**
1. 在邊欄中，選擇**組態** （齒輪） 圖示，然後選擇**團隊**。
1. 在團隊名稱的右側，選擇 **X**。
1. 若要確認，請選擇**刪除**。
## 從團隊新增或移除使用者
使用這些步驟將使用者新增至團隊或從團隊中移除他們。
**將使用者新增至團隊**
1. 在邊欄中，選擇**組態** （齒輪） 圖示，然後選擇**團隊**。
1. 選擇您要將使用者新增至其中的團隊。
1. 選擇**新增成員**。
1. 在**新增團隊成員**方塊中，選取要新增至團隊的使用者，然後選擇**新增至團隊**。
**從團隊中移除使用者**
1. 在邊欄中，選擇**組態** （齒輪） 圖示，然後選擇**團隊**。
1. 選擇您要從中移除使用者的團隊。
1. 在使用者名稱右側，選擇 **X**。
1. 若要確認，請選擇**刪除**。
## 使用團隊同步
透過*團隊同步*，您可以設定授權提供者群組與 Grafana 團隊之間的同步。目前支援的授權提供者為 IAM Identity Center 和 SAML。
**將 Grafana 團隊與外部群組同步。**
1. 在 Grafana 主控台中，導覽至**組態**、**團隊**。
1. 若要與 IAM Identity Center 群組同步，請輸入 IAM Identity Center 群組 ID。若要與 SAML 型身分提供者的群組同步，請輸入 Amazon Managed Grafana 工作區組態頁面上 SAML 組態區段中 **Assersion 屬性群組**欄位中輸入的屬性名稱值。
1. 選擇 **Add group (新增群組)**。
# 使用許可
您可以在 Amazon Managed Grafana 中的 Grafana 工作區中執行的動作，是由與您使用者相關聯的*許可*所定義。
Amazon Managed Grafana 使用三種類型的許可：
+ 以 Grafana 管理員身分授予的許可
+ 與團隊成員資格相關聯的許可
+ 授予特定資料夾或儀表板的許可
您可以根據管理員狀態、指派給使用者的儀表板或資料夾許可，以及資料來源許可來授予許可。
## 儀表板和資料夾許可概觀
透過使用儀表板和資料夾許可，您可以移除編輯器和檢視器的預設角色型許可。然後，您可以將許可指派給特定使用者和團隊。如需詳細資訊，請參閱[儀表板和資料夾許可](dashboard-and-folder-permissions.md)。
## 資料來源許可概觀
根據預設，任何使用者都可以查詢資料來源。例如，具有 `Viewer`角色的使用者可以對資料來源發出任何可能的查詢，而不只是存在於他們有權存取之儀表板上的查詢。
使用資料來源許可，您可以變更資料來源的預設許可，並將查詢許可限制為特定**使用者**和**團隊**。如需詳細資訊，請參閱[資料來源許可](data-source-permissions.md)。
# 儀表板和資料夾許可
對於儀表板和儀表板資料夾，您可以使用**許可**頁面來移除**編輯器**和**檢視器**的預設角色型許可。在此頁面上，您可以為特定**使用者**和**團隊**新增和指派許可。
Amazon Managed Grafana 提供下列許可層級。許可會根據工作區支援的 Grafana 版本而有所不同。
**對於支援第 8 版的工作區：**
+ `Admin`：可以編輯和建立儀表板和編輯許可。也可以新增、編輯和刪除資料夾。
+ `Edit`：可以編輯和建立儀表板。**無法**編輯資料夾或儀表板許可，或新增、編輯或刪除資料夾。
+ `View`：只能檢視現有的儀表板和資料夾。
**對於支援第 9 版及更高版本的工作區：**
+ `Admin`：可以建立、編輯或刪除儀表板。可以新增、編輯或刪除資料夾，並在資料夾中建立儀表板和子資料夾。管理員也可以變更儀表板和資料夾許可。
+ `Edit`：可以建立、編輯或刪除儀表板。可以編輯或刪除資料夾，並在資料夾中建立儀表板和子資料夾。編輯器**無法**變更資料夾或儀表板許可。
+ `View`：只能檢視現有的儀表板和資料夾。
## 授予資料夾許可
**授予資料夾許可**
1. 在邊欄中，將滑鼠游標暫留在**儀表板 **（方形） 圖示上，然後選擇**管理**。
1. 將滑鼠游標暫留在資料夾上，然後選擇**移至資料夾**。
1. 在**許可**索引標籤上，選擇**新增許可**。
1. 在**新增許可給** 對話方塊中，選擇**使用者**、**團隊**或其中一個角色選項。如果您的工作區使用 Grafana 10 版或更新版本，請選擇**使用者、團隊、服務帳戶或角色**。
1. 在第二個方塊中，選取您要新增許可的使用者、團隊、服務帳戶或角色。如果您的工作區使用 Grafana 第 9 版或更早版本，且您在上一個步驟中選取了角色選項，請略過此步驟。
1. 在第三個方塊中，選取您要新增的許可。
1. 選擇**儲存**。
## 授予儀表板許可
**授予儀表板許可**
1. 在儀表板的右上角，選擇齒輪圖示以前往**儀表板設定**。
1. 在**許可**索引標籤上，選擇**新增許可**。
1. 在**新增許可給**對話方塊中，選擇**使用者**、**團隊**或其中一個角色選項。如果您的工作區使用 Grafana 10 版或更新版本，請選擇**使用者、團隊、服務帳戶或角色**。
1. 在第二個方塊中，選取您要新增許可的使用者、團隊、服務帳戶或角色。如果您的工作區使用 Grafana 第 9 版或更早版本，且您在上一個步驟中選取了角色選項，請略過此步驟。
1. 在第三個方塊中，選取您要新增的許可。
1. 選擇**儲存**。
## 限制存取
最高許可一律會獲勝。
+ 您無法覆寫具有 `Admin`角色之使用者的許可。管理員一律可以存取所有項目。
+ 如果具有較高許可層級的更一般規則存在，則具有較低許可層級的更特定許可不會有任何影響。您需要移除或降低更一般規則的許可層級。
## Amazon Managed Grafana 如何解決多個許可 – 範例
下列範例顯示如何解決多個許可。
### 範例 1： `user1`具有 `Editor`角色
儀表板的許可：
+ 每個具有 `Editor`角色的人都可以編輯。
+ `user1` 可以檢視。
結果： `user1`具有編輯許可，因為最高許可一律會獲勝。
### 範例 2： `user1`具有檢視器角色，並且是 的成員 `team1`
儀表板的許可：
+ 每個具有 `Viewer`角色的人都可以檢視。
+ `user1` 具有 `Editor`角色，可以編輯。
+ `team1` 具有 `Admin`角色。
結果： `user1`具有管理員許可，因為最高許可一律會獲勝。
### 範例 3：`user1`具有不同層級的多個許可
儀表板的許可：
+ `user1` 具有 `Admin`角色 （繼承自父資料夾）。
+ `user1` 具有 `Editor`角色，可以編輯。
結果：您無法覆寫至較低的許可。 `user1`具有管理員許可，因為最高許可一律會獲勝。
## 摘要
+ **檢視**：只能檢視現有的儀表板或資料夾。
+ 如果具有較高許可層級的更一般規則存在，則具有較低許可層級的更具體許可將不會有任何影響。
# 資料來源許可
根據預設，任何使用者都可以查詢資料來源。例如，具有 `Viewer`角色的使用者可以對資料來源發出任何可能的查詢，而不只是存在於他們有權存取之儀表板上的查詢。
您可以使用資料來源許可來限制使用者查詢資料來源的存取權。對於每個資料來源，都有一個許可頁面，您可以在其中啟用或停用特定**使用者**和**團隊的**查詢許可。
## 啟用資料來源許可
為資料來源啟用許可時，您預設會將該資料來源的管理員和查詢存取權限制為管理員使用者。您可以選擇性地新增特定使用者和團隊的存取權。
**啟用資料來源的許可**
1. 導覽至**組態**、**資料來源**。對於支援 Grafana 第 10 版的工作區，導覽至**連線**、**資料來源**。
1. 選取您要為其啟用許可的資料來源。
1. 在**許可**索引標籤上，選擇**啟用**。
**警告**
如果您啟用預設資料來源的許可，則未列在許可中的使用者將無法叫用查詢。使用預設資料來源的面板會傳回這些使用者的`Access denied to data source`錯誤。
## 允許使用者和團隊查詢資料來源
啟用資料來源的許可後，根據預設，只有管理員可以存取該資料來源。您可以將查詢許可指派給使用者或團隊。查詢許可將允許存取 來查詢資料來源。
**將查詢許可指派給使用者和團隊**
1. 導覽至**組態**、**資料來源**。對於支援 Grafana 第 10 版的工作區，導覽至**連線**、**資料來源**。
1. 選取您要為其指派查詢許可的資料來源。
1. 在**許可**索引標籤上，選擇**新增許可**。
1. 選取**團隊**或**使用者**。對於支援 Grafana 10 版或更新版本的工作區，您也可以選取**服務帳戶**或**角色**。
1. 選取您要授予查詢存取權的團隊、使用者、服務帳戶或角色，然後選擇**儲存**。
## 停用資料來源許可
如果您已啟用資料來源的許可，並想要將資料來源許可傳回預設值，請遵循下列步驟。
**注意**
為資料來源建立*的所有*現有許可都會遭到刪除。
**停用資料來源的許可**
1. 導覽至**組態**、**資料來源**。對於支援 Grafana 第 10 版的工作區，導覽至**連線**、**資料來源**。
1. 選取您要停用許可的資料來源。
1. 在**許可**索引標籤上，選擇**停用許可**。
# 建立您的第一個儀表板
## 建立儀表板
請依照下列步驟，在 Grafana 主控台中建立儀表板。
**建立您的第一個儀表板**
1. 選擇左側面板上的 \$1 圖示，選擇**建立儀表板**，然後選擇**新增面板**。
1. 在**新儀表板/編輯面板**檢視中，選擇**查詢**索引標籤。
1. 選取您要查詢的資料來源，以設定您的查詢。例如，如果您已將 **TestDB** 新增為資料來源，則會產生名為 Random Walk 儀表板的範例儀表板。
### 時間序列簡介
假設您想要知道外部溫度在一天當中的變化。每小時檢查一次溫度計，並記下時間與目前溫度。一段時間後，您會有類似下列的資料。
| 時間 | Value |
| --- | --- |
| 09：00 | 24°C |
| 10：00 | 26°C |
| 11：00 | 27°C |
像這樣的溫度資料是*時間序列*的一個範例：測量序列，按時間排序。資料表中的每一列代表特定時間的一個個別測量。
當您想要識別個別度量時，資料表非常有用，但它們可能會使得難以看到大局。時間序列的更常見視覺化是*圖形*，它會沿著時間軸放置每個測量。圖形等視覺化呈現方式可讓您更輕鬆地探索難以看到的資料模式和功能。
時間序列的其他範例包括：
+ CPU 和記憶體用量
+ 感應器資料
+ 股票市場索引
雖然每個範例都是依時間順序排序的一系列測量，但它們也會共用其他屬性：
+ 新資料會在結尾以固定間隔附加，例如每小時 09：00、10：00、11：00 等。
+ 很少會在新增後更新測量。例如，昨天的溫度不會變更。
時間序列功能強大。它們可讓您隨時分析系統的狀態，協助您了解過去。時間序列可以告訴您，在可用磁碟空間下降到零之後，伺服器損毀的時刻。
時間序列也可以透過發現資料中的趨勢來協助您預測未來。例如，如果在過去幾個月內，已註冊的使用者數量每月增加 4%，您可以預測您的使用者群在年底將達到多大。
某些時間序列具有在已知期間內自行重複的模式。例如，在夜間下降之前，溫度通常在一天中較高。透過識別這些定期或*季節性*的時間序列，您可以對下一個期間進行可信的預測。如果您知道系統每天大約 18：00 負載峰值，則可以在此之前新增更多機器。
#### 彙總時間序列
視您測量的內容而定，資料可能會有很大的差異。如果您想要比較比測量之間間隔更長的期間，該怎麼辦？ 如果您每小時測量一次溫度，您最後每天會有 24 個資料點。若要比較這幾年 8 月的溫度，您必須將 31 倍 24 個資料點合併為一個。
結合測量的集合稱為*彙總*。有多種方法可以彙總時間序列資料。以下是一些常見的：
+ **平均值**會傳回所有值的總和除以值的總數。
+ **最小值**和**最大值**會傳回集合中的最小和最大值。
+ **總**和會傳回集合中所有值的總和。
+ **Count** 會傳回集合中的值數目。
例如，透過在一個月內彙總資料，您可以判斷 2017 年 8 月平均比前一年更暖。如果您想要查看哪個月份的溫度最高，您可以比較每個月的最高溫度。
如何彙總時間序列資料是一項重要的決策，取決於您想要使用資料來告知的故事。使用不同的彙總以不同方式視覺化相同的時間序列資料是很常見的。
#### 時間序列和監控
在 IT 產業中，通常會收集時間序列資料來監控基礎設施、硬體或應用程式事件等物件。機器產生的時間序列資料通常會以短間隔收集，因此您可以在發生意外變更的時刻做出反應。資料會以快速的速度累積，因此擁有有效存放和查詢資料的方法至關重要。因此，針對時間序列資料最佳化的資料庫近幾年來越來越熱門。
##### 時間序列資料庫
時間序列資料庫 (TSDB) 是專門針對時間序列資料設計的資料庫。雖然可以使用任何一般資料庫來存放測量，但 TSDB 隨附一些有用的最佳化。
現代 TSDBs會利用只附加測量，且很少更新或移除的事實。例如，每個測量的時間戳記會隨著時間而變化很小，這會導致儲存冗餘資料。
下列範例顯示一系列的 Unix 時間戳記。
```
1572524345, 1572524375, 1572524404, 1572524434, 1572524464
```
查看這些時間戳記，它們都從 開始`1572524`，導致磁碟空間使用率不佳。相反地，您可以將每個後續時間戳記儲存為第一個時間戳記的差異或*差異*，如下列範例所示。
```
1572524345, +30, +29, +30, +30
```
您甚至可以透過計算這些差異的差異來進一步採取步驟，如下列範例所示。
```
1572524345, +30, -1, +1, +0
```
如果定期進行測量，這些delta-of-deltas的大部分都會是 0。由於這類最佳化，TSDBs 使用的空間比其他資料庫小得多。
TSDB 的另一個功能是能夠使用*標籤*篩選測量結果。每個資料點都會標記一個標籤，以新增內容資訊，例如測量的位置。
Grafana 支援下列 TSDBs：
+ [石榴](https://graphiteapp.org/)
+ [InfluxDB](https://www.influxdata.com/products/influxdb-overview/)
+ [Prometheus](https://prometheus.io/)
```
weather,location=us-midwest temperature=82 1465839830100400200
| -------------------- -------------- |
| | | |
| | | |
+-----------+--------+-+---------+-+---------+
|measurement|,tag_set| |field_set| |timestamp|
+-----------+--------+-+---------+-+---------+
```
##### 收集時間序列資料
現在您有存放時間序列的位置，如何實際收集測量結果？ 若要收集時間序列資料，您通常會在要監控的裝置、機器或執行個體上安裝*收集器*。有些收集器是以特定資料庫為考量，有些則支援不同的輸出目的地。
以下是收集器的一些範例：
+ [已收集](https://collectd.org/)
+ [統計](https://github.com/statsd/statsd)
+ [Prometheus 匯出工具](https://prometheus.io/docs/instrumenting/exporters/)
+ [Telegraf](https://github.com/influxdata/telegraf)
收集器*會將資料推送*至資料庫，或讓資料庫從收集器*提取*資料。每個方法都有自己的一組優缺點。
| | 優點 | 缺點 |
| --- | --- | --- |
| 推送 | 更輕鬆地將資料複寫到多個目的地。 | TSDB 無法控制傳送的資料量。 |
| 提取 | 進一步控制資料擷取量和資料真實性。 | 防火牆、VPNs或負載平衡器可能會使存取代理程式變得困難。 |
由於將每個測量寫入資料庫效率低，收集器會預先彙總資料，並定期寫入 TSDB。
### 時間序列維度
使用時間序列資料時，資料通常是一組多個時間序列。許多 Grafana 資料來源支援這種類型的資料。
常見案例是以一個或多個額外的屬性做為維度，為測量發出單一查詢。例如，您可以查詢溫度測量以及位置屬性。在此情況下，會從該單一查詢傳回多個序列，而且每個序列都有唯一的位置做為維度。
若要識別一組時間序列內的唯一序列，Grafana 會將維度存放在*標籤*中。
#### 標籤
Grafana 中的每個時間序列都有標籤。標籤是一組用於識別維度的鍵值對。範例標籤為 `{location=us}`或 `{country=us,state=ma,city=boston}`。在一組時間序列中，其名稱和標籤的組合會識別每個序列。例如 `temperature {country=us,state=ma,city=boston}`。
不同的時間序列資料來源具有原生儲存的維度，或可讓資料擷取為維度的常見儲存模式。
通常，TSDBs原生支援維度。Prometheus 會將維度存放在*標籤*中。在 Graphite 或 OpenTSDB 等 TSDBs 中，會改用術語*標籤*。
在 SQL 這類資料表資料庫中，這些維度通常是查詢的`GROUP BY`參數。
#### 資料表格式的多個維度
在傳回資料表回應的 SQL 或類似 SQL 的資料庫中，其他維度通常是查詢回應資料表中的資料欄。
##### 單一維度
例如，請考慮類似下列範例的查詢。
```
SELECT BUCKET(StartTime, 1h), AVG(Temperature) AS Temp, Location FROM T
GROUP BY BUCKET(StartTime, 1h), Location
ORDER BY time asc
```
查詢可能會傳回具有三個資料欄的資料表。
| StartTime | 暫存 | Location |
| --- | --- | --- |
| 09：00 | 24 | 拉瓜迪亞 |
| 09：00 | 20 | BOS |
| 10：00 | 26 | 拉瓜迪亞 |
| 10：00 | 22 | BOS |
資料表格式是*長*格式的時間序列，也稱為*高*。它具有重複的時間戳記，以及位置中的重複值。在這種情況下，集合中的兩個時間序列會識別為 `Temp {Location=LGA}`和 `Temp {Location=BOS}`。
使用下列維度擷取集合中的個別時間序列：
+ 時間類型欄`StartTime`作為時間序列的時間索引
+ `Temp` 做為序列名稱的數字類型欄
+ 要建置標籤之字串類型`Location`資料欄的名稱和值，例如 Location=LGA
##### 多個維度
如果查詢已更新為選取並依多個字串欄分組 （例如 `GROUP BY BUCKET(StartTime, 1h), Location, Sensor`)，則會新增額外的維度。
| StartTime | 暫存 | Location | 感測器 |
| --- | --- | --- | --- |
| 09：00 | 24 | 拉瓜迪亞 | A |
| 09：00 | 24.1 | 拉瓜迪亞 | B |
| 09：00 | 20 | BOS | A |
| 09：00 | 20.2 | BOS | B |
| 10：00 | 26 | 拉瓜迪亞 | A |
| 10：00 | 26.1 | 拉瓜迪亞 | B |
| 10：00 | 22 | BOS | A |
| 10：00 | 22.2 | BOS | B |
在此情況下，代表維度的標籤具有兩個以兩個字串類型欄為基礎的索引鍵，`Location`以及 `Sensor`。資料會產生四個序列：
+ `Temp {Location=LGA,Sensor=A}`
+ `Temp {Location=LGA,Sensor=B}`
+ `Temp {Location=BOS,Sensor=A}`
+ `Temp {Location=BOS,Sensor=B}`
**注意**
**注意：**在 Grafana 中映射到多個提醒的方式不支援多個維度。相反地，它們會被視為單一提醒的多個條件。
##### 多個值
在類似 SQL 的資料來源中，可以選取多個數字資料欄，無論是否使用額外的字串資料欄做為維度；例如 `AVG(Temperature) AS AvgTemp, MAX(Temperature) AS MaxTemp`。如果結合多個維度，這可能會導致許多序列。選取多個值目前只能與視覺化搭配使用。
### 直方圖和熱度圖簡介
直方圖是數值資料分佈的圖形表示法。它會將值分組到儲存貯體 （有時也稱為儲存貯體）。然後，它會計算有多少值落在每個儲存貯體中。
長條圖不是繪製實際值的圖形，而是繪製儲存貯體的圖形。每個長條代表儲存貯體，長條高度代表落在該儲存貯體間隔內的值頻率 （例如計數）。
直方圖只會查看特定時間範圍內*的值分佈*。長條圖的問題是您無法在分佈中看到隨時間變化的任何趨勢或變化。這是熱度圖變得有用的位置。
#### 熱度圖
*熱度圖*就像是長條圖，其中每次配量都代表自己的長條圖。它不是使用長條高度來表示頻率，而是使用儲存格，將儲存格與儲存貯體中的值數量成比例著色。
#### 預先儲存貯體的資料
隨著時間的推移，許多資料來源支援長條圖，包括下列項目：
+ Amazon OpenSearch Service （使用長條圖儲存貯體彙總）
+ Prometheus （將[長條圖](https://prometheus.io/docs/concepts/metric_types/#histogram)指標類型和*格式化設定為***熱度圖**)
一般而言，您可以使用任何傳回序列的資料來源，其名稱代表儲存貯體繫結，或傳回以遞增順序排序的序列。
#### 原始資料與彙總資料
如果您使用熱度圖搭配一般時間序列資料 （非預先儲存貯體），請務必記住，您的資料通常已由時間序列後端彙總。大多數時間序列查詢不會傳回原始範例資料。反之，它們會依時間間隔或 maxDataPoints 限制來包含群組，並搭配彙總函數 （通常為平均值）。
這取決於查詢的時間範圍。重點是了解 Grafana 執行的長條圖儲存貯體可能會在已彙總和平均的資料上執行。如需更準確的熱度圖，最好在指標收集期間執行儲存貯體，或將資料儲存在 OpenSearch 中，或支援對原始資料執行長條圖儲存貯體的其他資料來源中。
如果您在查詢中依時間移除或降低群組 （或提高 maxDataPoints) 以傳回更多資料點，您的熱度圖會更準確。但這也可能會對 CPU 和記憶體造成繁重負載。如果資料點的數量變得不合理，可能會導致停滯和當機。
# 使用外掛程式擴展您的工作區
*Grafana 外掛程式*可新增連線至新資料來源的功能，或將視覺化或其他功能新增至工作區。一般而言，外掛程式有三種類型：
+ **面板外掛程式** – 面板外掛程式新增可用於儀表板的新視覺化類型。這些定義前端中資料的轉譯。
+ **資料來源外掛程式** – 資料來源外掛程式會與外部資料來源通訊，並以 Grafana 可以使用的格式傳回資料。
+ **應用程式外掛程式** – 應用程式，也稱為應用程式外掛程式。其中包括套件資料來源和面板，而且 可以在 Grafana 工作區內提供有凝聚力的體驗。
**注意**
當 Amazon 判斷外掛程式通常失敗或尚未維護時，可能會從主控台的可用外掛程式清單中移除外掛程式。
對於支援第 9 版或更新版本的 Amazon Managed Grafana 工作區，您可以啟用外掛程式管理。這可讓工作區管理員從外掛程式*目錄安裝或解除安裝外掛程式*。
## 使用外掛程式目錄尋找外掛程式
您的 Amazon Managed Grafana 工作區包含顯示所有已安裝外掛程式的頁面，以及可在工作區中安裝的所有外掛程式清單。此頁面是*外掛程式目錄*。除了預設安裝的外掛程式之外，您還可以再安裝最多 50 個外掛程式。
可用的外掛程式大致分為下列類別：
+ **AWS 資料來源** – 這是 Amazon Managed Grafana 提供的應用程式外掛程式，可輕鬆探索 AWS 您帳戶中的資源。預設會安裝此項目。如需詳細資訊，請參閱[使用 AWS 資料來源外掛程式來尋找 AWS 資料](aws-datasources-plugin.md)。
+ **核心外掛程式** – 這些外掛程式預設會在 Grafana 中提供。其中包括熱門的資料來源和面板視覺化。它們在外掛程式目錄中標記為 **Core**。這些預設會安裝，且無法移除。
+ **企業外掛程式** – 這些外掛程式可供具有企業授權的 Grafana 工作區使用。這些預設不會安裝。它們在外掛程式目錄中標記為 **Enterprise**。只有在您擁有有效的企業授權時，才能安裝它們。如需如何將工作區升級至企業授權的詳細資訊，請參閱 [管理對 Amazon Managed Grafana Enterprise 外掛程式的存取](AMG-workspace-manage-enterprise.md)。
+ **社群外掛程式** – 這些外掛程式適用於來自各種來源的 Grafana 工作區，包括 Grafana 實驗室 AWS等。在支援第 9 版或更新版本的 Grafana 工作區中，預設不會安裝這些工作空間 （舊版工作區會自動安裝其中一些）。這些通常是開放原始碼外掛程式。您可以安裝或移除這些外掛程式。
**注意**
使用社群外掛程式由您自行決定。作為您與 之間[共同責任模型](security.md)的一部分 AWS，您應該了解您在工作區中為這些第三方外掛程式安裝的內容。您也必須負責滿足安全需求的外掛程式。
**外掛程式支援**
外掛程式來自各種來源，對這些來源的支援也有所不同。
+ **AWS 資料來源外掛程式** – 此外掛程式由 提供並由 支援 AWS。
+ **企業外掛程式** – AWS 和 Grafana Labs 都支援企業外掛程式，您可以透過任一支援團隊提交問題。
+ **核心外掛程式** – Amazon Managed Grafana 支援 AWS 或 Grafana Labs 提供的核心外掛程式和其他外掛程式 AWS。您可以在 GitHub 中提交錯誤修正或增強功能的問題，或使用 AWS 或 Grafana 實驗室建立票證。
+ **社群外掛程式** – 通常透過 GitHub 問題或其他論壇支援非由 AWS 或 Grafana Labs 建立的社群外掛程式。在這些情況下，支援資訊包含在外掛程式目錄的外掛程式詳細資訊中。
您也可以透過 [Amazon Managed Grafana ](https://github.com/aws/amazon-managed-grafana-roadmap/issues)或 [Grafana](https://github.com/grafana/grafana/issues) 的 GitHub 論壇提交外掛程式的問題。
**外掛程式版本**
大多數外掛程式都會定期更新。Amazon Managed Grafana 工作區中的外掛程式目錄會顯示最新版本的外掛程式，您可以選擇要安裝的版本。當外掛程式具有已知安全問題的過時版本時，過時的版本會從可用性中移除。
您也可以[更新](#update-plugin)已安裝的外掛程式。
**注意**
有時候，會提供新版本的外掛程式，以修正已安裝外掛程式中的安全問題。對於嚴重問題，Amazon Managed Grafana 可能會使用修正程式自動將工作區中的外掛程式更新為 版本。
## 使用外掛程式目錄管理外掛程式
您可以從外掛程式目錄管理 Amazon Managed Grafana 工作區的外掛程式。您只能在工作區中安裝外掛程式目錄中列出的外掛程式。
以下說明使用 外掛程式目錄的先決條件，以及如何尋找外掛程式目錄。
**先決條件**
+ 您必須擁有支援第 9 版的 [Amazon Managed Grafana 工作區](AMG-create-workspace.md)，並擁有可登入該工作區的帳戶。
+ 工作區必須[啟用外掛程式管理](AMG-configure-workspace.md)。
+ 您的使用者帳戶必須是 [Amazon Managed Grafana 工作區的管理員](Grafana-user-roles.md)。
+ 若要安裝和使用 Enterprise 外掛程式，您必須先[升級至 Enterprise 授權](AMG-workspace-manage-enterprise.md)。
**檢視外掛程式目錄**
1. 登入您的 Amazon Managed Grafana 工作區。
1. 從左側功能表中，選擇**管理**，然後選擇**外掛程式**。這會開啟外掛程式目錄。
1. 根據預設，外掛程式目錄會列出已安裝的外掛程式。若要檢視所有可用的外掛程式，請在目錄頂端**的狀態**篩選條件下選擇**全部**。已安裝的外掛程式包含描述**已安裝的**標籤。
## 安裝或移除外掛程式
**注意**
您必須符合上一節的先決條件，否則您將無法修改外掛程式。
**安裝或移除 Grafana 外掛程式**
1. 前往 外掛程式目錄。
1. 根據預設，外掛程式目錄只會列出已安裝的外掛程式。若要檢視所有可用的外掛程式，請在目錄頂端**的狀態**篩選條件下選擇**全部**。已安裝的外掛程式包含一個標籤，指出**已安裝**。
1. 選取要安裝或解除安裝的外掛程式。例如，如果您想要移除 *Datadog* 資料來源，請選取 **Datadog** 外掛程式。
1. 在外掛程式詳細資訊頁面上，選擇解除安裝或安裝選項。
1. 安裝外掛程式後，最多可能需要幾分鐘的時間，才能跨工作區的所有部分同步變更。最好先等待幾分鐘，再使用新的外掛程式。
**注意**
您可以在工作區中安裝 50 個外掛程式 （除了預設的 Core 外掛程式之外）。
## 更新外掛程式
**更新現有的 Grafana 外掛程式**
1. 登入您的 Amazon Managed Grafana 工作區。
1. 從左側功能表中，選擇**管理**，然後選擇**外掛程式**。這會開啟外掛程式目錄，只列出已安裝的外掛程式。
1. 選取要更新的外掛程式。
1. 在外掛程式詳細資訊頁面上，檢查是否有可用的更新。若是如此，請選擇更新外掛程式的選項，然後選擇要更新的版本。
**注意**
如果您看到您無權修改外掛程式的備註，請確認您的工作區[已啟用外掛程式管理](AMG-configure-workspace.md)。您也必須是 Amazon Managed Grafana 工作區的[管理員](Grafana-user-roles.md)。
# 使用 AWS 資料來源外掛程式來尋找 AWS 資料
AWS 提供應用程式外掛程式，讓您更輕鬆地探索並使用 AWS 資源做為 Amazon Managed Grafana 工作區中的資料來源。*AWS 資料來源*外掛程式預設為安裝在新的工作區中。
AWS 資料來源外掛程式需要許可才能存取您的 資源以進行探索。如需詳細資訊，請參閱[所需的許可](#aws-ds-plugin-permissions)。
## 開啟 AWS 資料來源外掛程式
**開啟 AWS 資料來源外掛程式**
1. 登入您的 Amazon Managed Grafana 工作區。
1. 從左上方的**選單**中，選擇**應用程式**，然後選擇**AWS 資料來源**。
AWS 資料來源外掛程式界面會顯示列出您可以搜尋資源 AWS 的服務。
## 探索 資源
**從 中探索資源 AWS 帳戶**
1. 開啟 AWS 資料來源外掛程式。
1. 從 AWS 服務清單中，選取您要尋找資源以做為資料來源的資源。例如，選取 **Amazon Managed Service for Prometheus**。這將帶您前往**資料來源**索引標籤，並為您選取**服務**。
1. 選擇您要尋找資源 AWS 的區域。例如，選取 `US East (N. Virginia)`。
**注意**
若要尋找資源，外掛程式必須具有適當的[許可](#aws-ds-plugin-permissions)，才能在該區域中存取該服務。
1. 某些 服務在一個區域中可以有多個資源。如果區域中有多個資源， AWS 資料來源外掛程式會提供可供選擇的清單。
從資源清單中 （在此情況下為 Amazon Managed Service for Prometheus)，選取您要用作資料來源的資源。例如，選取 Amazon Managed Service for Prometheus 工作區會將該資源設定為資料來源。資料來源已準備好在儀表板中使用，或使用 Amazon Managed Grafana 進行監控。
1. 您佈建的服務和區域中的資源會顯示在頁面底部。
（選用） 您可以選擇**前往設定**以檢視和編輯該資料來源的設定。
**注意**
AWS 資料來源外掛程式取決於您工作區中安裝的個別資料來源外掛程式。例如，如果您想要使用 AWS X-Ray 功能，您必須從外掛程式[目錄安裝 X-Ray 資料來源外掛程式](grafana-plugins.md#manage-plugins)。
## 版本和更新外掛程式
AWS 資料來源外掛程式會定期更新。與新工作區一起安裝的版本通常不是最新版本。較新版本的功能可能比您工作區中安裝的功能更多。例如，較新版本可能支援其他服務 AWS 做為資料來源。
若要查看每個版本的 AWS 資料來源外掛程式的變更，您可以檢視 [Changelog](https://grafana.com/grafana/plugins/aws-datasource-provisioner-app/?tab=changelog)。
若要更新至較新版本的外掛程式，請遵循 的標準指示[更新外掛程式](grafana-plugins.md#update-plugin)。
**注意**
如果您更新至較新版本的 AWS 資料來源外掛程式，則需要為非由 Amazon Managed Grafana 管理的新資料來源提供額外的[許可](#aws-ds-plugin-permissions)。
## 所需的許可
AWS 資料來源外掛程式需要存取 資源 AWS 的許可。最簡單的方法是允許 Amazon Managed Grafana 為您管理許可。若要了解如何設定資料來源的服務受管許可，請參閱 [管理資料來源和通知管道的許可](AMG-datasource-and-notification.md)。根據預設，Amazon Managed Grafana 可以管理 AWS 資料來源外掛程式中包含 AWS 的資源許可。
如果您將 AWS 資料來源外掛程式更新至比您工作區中預設包含的較新版本，則可能會新增對許可不是由 Amazon Managed Grafana 自動管理 AWS 之資源的支援。在這些情況下，您必須自行新增許可。例如， AWS IoT TwinMaker 已新增至最新版本的外掛程式 (1.9.0 版），而這些外掛程式的許可並非由 Amazon Managed Grafana 管理。
若要進一步了解任何特定資料來源的許可，請參閱 [連線至資料來源](AMG-data-sources.md)一節中提供該資料來源的詳細資訊。例如， [連線至 an AWS IoT TwinMaker 資料來源](AMG-iot-twinmaker.md)區段包含授予 Amazon Managed Grafana 存取 AWS IoT TwinMaker 許可的詳細資訊。
# 連線至資料來源
Amazon Managed Grafana 支援許多不同的*資料來源*。資料來源是您可以在 Grafana 中查詢的儲存後端，以執行建置儀表板等操作。每個資料來源都有特定的查詢編輯器，針對特定資料來源公開的特徵和功能進行自訂。
每個資料來源的查詢語言和功能都不同。您可以將來自多個資料來源的資料合併到單一儀表板。
每個使用 Amazon Managed Grafana AWS 的帳戶都有建立或設定許多資料來源的存取權。有些資料來源會要求您安裝該資料來源的個別外掛程式。如果您將工作區升級至 Amazon Managed Grafana Enterprise 外掛程式，您可能還需要安裝企業資料來源的外掛程式。下列各節說明許多可用資料來源的詳細資訊，但 Grafana 社群有時會在工作區的[外掛程式目錄中](grafana-plugins.md#plugin-catalog)新增可用的新資料來源。
**注意**
為了協助您探索帳戶中 AWS 的資源並設定資料來源進行查詢，Amazon Managed Grafana 會提供 [使用 AWS 資料來源外掛程式來尋找 AWS 資料](aws-datasources-plugin.md)。
## 特殊資料來源
Amazon Managed Grafana 包含三個特殊資料來源：
+ **Grafana** （在舊版 Grafana 中稱為 *TestDB* – 使用此內建資料來源來產生隨機步行資料或列出檔案。這對於測試視覺化效果和執行實驗非常有用。
+ **混合** – 用來查詢相同面板中的多個資料來源。當您使用此資料來源時，您可以為每個新增的查詢指定資料來源。第一個查詢會使用您在選取**混合**之前指定的資料來源。
您無法將現有的查詢變更為使用混合資料來源。
+ **儀表板** – 用來使用相同儀表板中另一個面板的結果集。
**重要**
Amazon Managed Grafana 具有資料來源逾時限制，可能會覆寫在資料來源上設定的任何逾時限制。兩個限制中的較低者會取代另一個限制。若要了解 Amazon Managed Grafana 資料來源逾時限制，請參閱《》中的 [Amazon Managed Grafana 服務配額](https://docs.aws.amazon.com/general/latest/gr/grafana-service.html#grafana-quotas)*AWS 一般參考*。
**Topics**
+ [特殊資料來源](#AMG-data-sources-special)
+ [Amazon Managed Grafana 如何使用 AWS Organizations 進行 AWS 資料來源存取](AMG-and-Organizations.md)
+ [連線至內建資料來源](AMG-data-sources-builtin.md)
+ [連線至企業資料來源](AMG-data-sources-enterprise.md)
# Amazon Managed Grafana 如何使用 AWS Organizations 進行 AWS 資料來源存取
使用 AWS Organizations，您可以集中管理多個 AWS 帳戶的資料來源組態和許可設定。在 AWS 帳戶 具有 Amazon Managed Grafana 工作區的 中，您可以指定其他組織單位，使其 AWS 資料來源可在主要帳戶中檢視。
例如，您可以使用組織中的一個帳戶作為 Amazon Managed Grafana *管理帳戶*，並讓此帳戶存取組織中其他帳戶中的資料來源。在管理帳戶中，列出具有您要使用管理帳戶存取之 AWS 資料來源的所有組織單位。這會自動建立設定這些資料來源所需的角色和許可政策，您可以在 Amazon Managed Grafana 工作區的 Grafana 主控台中查看。
如需 Organizations 的詳細資訊，請參閱[什麼是 AWS Organizations](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_introduction.html)。
Amazon Managed Grafana 使用 CloudFormation StackSets 自動建立 Amazon Managed Grafana 連線到整個 AWS 組織之資料來源所需的 AWS Identity and Access Management (IAM) 角色。在 Amazon Managed Grafana 可以管理您的 IAM 政策以存取整個組織的資料來源之前，您必須在組織的管理帳戶中啟用 AWS CloudFormation StackSets。Amazon Managed Grafana 會在第一次需要時自動啟用此功能。
## 與 AWS IAM Identity Center 和 Organizations 整合的部署案例
如果您同時使用 Amazon Managed Grafana 與 AWS IAM Identity Center 和 Organizations，我們建議您使用下列三種案例之一，在組織中建立 Amazon Managed Grafana 工作區。對於每個案例，您需要登入具有足夠許可的帳戶。如需詳細資訊，請參閱[Amazon Managed Grafana 的範例政策](security_iam_id-based-policy-examples.md#security_iam_AMG-id-based-policy-examples)。
**獨立帳戶**
獨立帳戶是不是 Organizations 中組織成員 AWS 的帳戶。如果您 AWS 第一次嘗試，這可能是這種情況。
在此案例中，當您登入具有 AWSGrafanaAccountAdministrator、**AWSSSOMemberAccountAdministrator** AWS IAM Identity Center 和 **AWSSSODirectoryAdministrator** 政策的帳戶時，Amazon Managed Grafana 會自動啟用 和 Organizations。 **AWSGrafanaAccountAdministrator** 如需詳細資訊，請參閱[使用 IAM Identity Center 在單一獨立帳戶中建立和管理 Amazon Managed Grafana 工作區和使用者](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-create-workspace-standalone)。
**已設定 IAM Identity Center 的現有組織的成員帳戶**
若要在成員帳戶中建立工作區，您必須登入具有 **AWSGrafanaAccountAdministrator**、**AWSSSOMemberAccountAdministrator** 和 **AWSSSODirectoryAdministrator** 政策的帳戶。如需詳細資訊，請參閱[使用 IAM Identity Center 的成員帳戶中的 Grafana 管理員](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-admin-member)。
如果您在成員帳戶中建立工作區，並且希望該工作區從組織中的其他 AWS 帳戶存取資源，則必須在工作區中使用客戶受管許可。如需詳細資訊，請參閱[客戶受管許可](AMG-manage-permissions.md#AMG-customer-managed)。
若要使用服務受管許可來允許工作區從組織中的其他 AWS 帳戶存取資源，您必須在組織的管理帳戶中建立工作區。不過，在組織的管理帳戶中建立 Amazon Managed Grafana 工作區或其他資源並非最佳實務。如需 Organizations 最佳實務的詳細資訊，請參閱 [管理帳戶的最佳實務](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_best-practices_mgmt-acct.html)。
**注意**
如果您在 2019 年 11 月 25 日之前 AWS IAM Identity Center 在管理帳戶中啟用 ，您還必須在管理帳戶中啟用 IAM Identity Center 整合的應用程式。或者，您也可以在管理帳戶中執行此操作後，在成員帳戶中啟用 IAM Identity Center 整合的應用程式。若要啟用這些應用程式，請在 IAM Identity Center 整合應用程式區段的 IAM Identity Center **設定**頁面中選擇**啟用存取**。如需詳細資訊，請參閱 [IAM Identity Center 整合的應用程式啟用](https://docs.aws.amazon.com/singlesignon/latest/userguide/app-enablement.html)。
**尚未部署 IAM Identity Center 的現有組織的成員帳戶**
在此案例中，請先以組織管理員身分登入，並在組織中啟用 IAM Identity Center。然後，在組織中的成員帳戶中建立 Amazon Managed Grafana 工作區。
如果您不是組織管理員，您必須聯絡 Organizations 的管理員，並請求他們啟用 IAM Identity Center。啟用 IAM Identity Center 之後，您就可以在成員帳戶中建立工作區。
如果您在成員帳戶中建立工作區，並且希望該工作區從組織中的其他 AWS 帳戶存取資源，則必須在工作區中使用客戶受管許可。如需詳細資訊，請參閱[客戶受管許可](AMG-manage-permissions.md#AMG-customer-managed)。
若要在成員帳戶中建立工作區，您必須登入具有 **AWSGrafanaAccountAdministrator**、**AWSSSOMemberAccountAdministrator** 和 **AWSSSODirectoryAdministrator** 政策的帳戶。如需詳細資訊，請參閱[使用 IAM Identity Center 的成員帳戶中的 Grafana 管理員](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-admin-member)。
# 連線至內建資料來源
每個 Amazon Managed Grafana 工作區都支援下列資料來源。
對於支援第 9 版及更新版本的工作區，根據預設可能不會安裝其中一些資料來源。核心資料來源適用於所有安裝，但不屬於核心集的資料來源可能需要安裝正確的 Grafana 外掛程式。您可以為此處未列出的其他資料來源安裝外掛程式。如需管理外掛程式的詳細資訊，請參閱 [使用外掛程式擴展您的工作區](grafana-plugins.md)。
**Topics**
+ [警示管理員](data-source-alertmanager.md)
+ [Amazon CloudWatch](using-amazon-cloudwatch-in-AMG.md)
+ [Amazon OpenSearch Service](using-Amazon-OpenSearch-in-AMG.md)
+ [AWS IoT SiteWise](using-iotsitewise-in-AMG.md)
+ [AWS IoT TwinMaker](AMG-iot-twinmaker.md)
+ [Prometheus](prometheus-data-source.md)
+ [Amazon Timestream](timestream-datasource.md)
+ [Amazon Athena](AWS-Athena.md)
+ [Amazon Redshift](AWS-Redshift.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Azure 監視器](using-azure-monitor-in-AMG.md)
+ [石榴](using-graphite-in-AMG.md)
+ [Google 雲端監控](using-google-cloud-monitoring-in-grafana.md)
+ [InfluxDB](using-influxdb-in-AMG.md)
+ [Jaeger](jaeger-data-source.md)
+ [Loki](using-loki-in-AMG.md)
+ [Microsoft SQL Server](using-microsoft-sql-server-in-AMG.md)
+ [MySQL](using-mysql-in-AMG.md)
+ [OpenSearch](using-opensearch-in-AMG.md)
+ [OpenTSDB](using-opentsdb-in-AMG.md)
+ [PostgreSQL](using-postgresql-in-AMG.md)
+ [Templ](tempo-data-source.md)
+ [TestData](testdata-data-source.md)
+ [Zipkin](zipkin-data-source.md)
# 連線至 Alertmanager 資料來源
Grafana 包含對 Prometheus Alertmanager 的內建支援。設定 Grafana 提醒後，您可以使用 Grafana 提醒 UI 來管理靜音、聯絡點以及通知政策。這些頁面中的下拉式清單選項可讓您在 Grafana 和任何已設定的 Alertmanager 資料來源之間切換。
**警示管理員實作**
支援 Alertmanager 的 [Prometheus](https://prometheus.io/)、[Cortex](https://cortexmetrics.io/) 和 [Grafana Mimir](https://grafana.com/docs/mimir/latest/) 實作。您可以在資料來源設定頁面中指定實作。Prometheus 聯絡點和通知政策在 Grafana 提醒 UI 中為唯讀，因為它不支援透過 HTTP API 更新組態。
## 設定 Alertmanager 資料來源
您可以設定 Alertmanager 資料來源以搭配 Grafana 警示使用。
**先決條件**
若要設定 Alertmanager，您必須完成下列先決條件：
+ Prometheus 執行個體，具有擷取的指標，並至少設定一個提醒或記錄規則。您需要工作區的 URL。
+ 為 Amazon Managed Grafana 定義的許可，可讓您從 Alertmanager 實作中讀取提醒、提醒群組、靜音和聯絡點。
**設定 Alertmanager 資料來源**
1. 在 Grafana 主控台的 Grafana 功能表中，選擇**組態**下的**資料來源**頁面。
1. 選擇**新增資料來源**，然後從資料來源類型清單中選擇**警示管理員**。
1. 為您的新資料來源提供下列資訊。
+ 針對**名稱**，提供您為資料來源選擇的名稱。
+ 針對**實作**，選擇您的 Alertmanager 實作 – **Prometheus**、**Mimir** 或 **Cortex**。
+ 在 **HTTP** 下，針對 **URL**，提供 Alertmanager URL。對於 Prometheus，這是工作區 URL，已`alertmanager`附加 。例如 `https://myprometheus/workspaces/ws-example-1234-5678-abcd-xyz00000001/alertmanager`。
+ 在**驗證**下，設定存取 Alertmanager 實作所需的身分驗證詳細資訊。
1. 選擇**儲存並測試**以完成資料來源設定。
如果您的資料來源設定正確，您會看到一則訊息，指出**運作狀態檢查已通過**。
# 連線至 Amazon CloudWatch 資料來源
使用 Amazon Managed Grafana，您可以使用 Grafana 工作區主控台中的資料來源組態選項，將 Amazon CloudWatch 新增為 AWS 資料來源。此功能可探索現有的 CloudWatch 帳戶，並管理存取 CloudWatch 所需的身分驗證憑證組態，以簡化將 CloudWatch 新增為資料來源的程序。您可以使用此方法來設定身分驗證，並將 CloudWatch 新增為資料來源。或者，您可以使用與自我管理 Grafana 伺服器上相同的方法，手動設定資料來源和必要的身分驗證憑證。
**Topics**
+ [使用 AWS 資料來源組態將 CloudWatch 新增為資料來源](adding-CloudWatch-AWS-config.md)
+ [手動新增 CloudWatch 做為資料來源](adding--CloudWatch-manual.md)
+ [使用查詢編輯器](CloudWatch-using-the-query-editor.md)
+ [統籌儀表板](CloudWatch-curated-dashboards.md)
+ [範本查詢](cloudwatch-templated-queries.md)
+ [使用 ec2\$1instance\$1attribute 範例](cloudwatch-ec2-instance-attribute-examples.md)
+ [使用 JSON 格式範本變數](cloudwatch-using-json-format-template-variables.md)
+ [定價](cloudwatch-pricing.md)
+ [Service Quotas](cloudwatch-service-quotas.md)
+ [跨帳戶可觀測性](cloudwatch-cross-account.md)
# 使用 AWS 資料來源組態將 CloudWatch 新增為資料來源
若要使用 AWS 資料來源組態，請先使用 Amazon Managed Grafana 主控台來啟用服務受管 IAM 角色，以授予工作區讀取您帳戶或整個組織單位中 CloudWatch 資源所需的 IAM 政策。然後，您可以使用 Amazon Managed Grafana 工作區主控台將 CloudWatch 新增為資料來源。
**使用 AWS 資料來源組態將 CloudWatch 新增為資料來源**
1. 開啟位於 https：//[https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/) 的 Amazon Managed Grafana 主控台。
1. 在導覽窗格中，選擇選單圖示，然後選擇**所有工作區**。
1. 選擇工作區的名稱。
1. 如果您在建立工作空間時未選擇對此工作空間使用服務受管許可，則從使用客戶受管許可變更為使用服務受管許可，以確保在 Grafana 工作空間主控台中使用 AWS 資料來源組態選項啟用適當的 IAM 角色和政策。若要執行此作業，請依 **IAM 角色**選擇編輯圖示，然後選擇**服務受管**、**儲存變更**。如需詳細資訊，請參閱[AWS 資料來源的 Amazon Managed Grafana 許可和政策](AMG-manage-permissions.md)。
1. 選擇**資料來源**索引標籤。
1. 選取 **Amazon CloudWatch** 的核取方塊，然後選擇**動作**、**啟用服務受管政策**。
1. 再次選擇**資料來源**索引標籤。
1. 在 **Amazon CloudWatch 列中選擇在 Grafana 中設定**。 **Amazon CloudWatch**
1. 如有必要，請使用 IAM Identity Center 登入 Grafana 工作區主控台。
1. 在 Grafana 工作區主控台的導覽列上，選擇 AWS 圖示，然後選擇**AWS 服務** **CloudWatch**。
1. 選取您希望 CloudWatch 資料來源查詢的預設區域。
1. 選取您想要的帳戶，然後選擇**新增資料來源**。
# 手動新增 CloudWatch 做為資料來源
**手動新增 CloudWatch 資料來源**
1. 在 Grafana 主控台側邊選單中，將滑鼠游標暫留在**組態** （齒輪） 圖示上，然後選擇**資料來源**。
1. 選擇**新增資料來源**。
1. 選擇 **CloudWatch** 資料來源。如有必要，您可以開始**CloudWatch**在搜尋方塊中輸入 ，以協助您找到它。
## CloudWatch 設定
適用下列 CloudWatch 設定。
| 名稱 | 描述 |
| --- | --- |
| `Name` | 資料來源名稱。這是您在面板和查詢中看到資料來源的方式。 |
| `Default` | 指定要為新面板預先選取的資料來源。 |
| `Default Region` | 在查詢編輯器中設定區域。可以根據每個查詢進行變更。 |
| `Namespaces of Custom Metrics` | 指定自訂指標的 CloudWatch 命名空間。可以包含多個命名空間，以逗號分隔。 |
| `Auth Provider` | 指定要取得登入資料的提供者。 |
| `Assume Role Arn` | 指定要擔任的角色的 Amazon Resource Name (ARN)。 |
| `External ID` | （選用） 指定外部 ID。如果您在使用外部 ID 建立 AWS 帳戶 的另一個 中擔任角色，請使用 。 |
| `Timeout` | 專門為 CloudWatch Logs 查詢設定逾時。 |
| `X-Ray trace links` | 若要在日誌包含 `@xrayTraceId` 欄位時自動新增日誌中的連結，請在資料來源組態的 X-Ray **追蹤連結區段中連結 X-Ray** 資料來源。您必須已設定 [X-Ray 資料來源](x-ray-data-source.md)。 |
### 身分驗證
若要在 Amazon Managed Grafana 和 CloudWatch 之間啟用身分驗證，您可以使用 Amazon Managed Grafana 主控台快速建立所需的政策和許可。或者，您可以使用在自我管理 Grafana 伺服器上使用的一些相同方法手動設定身分驗證。
若要使用 Amazon Managed Grafana 資料來源組態快速設定政策，請遵循中的步驟[使用 AWS 資料來源組態將 CloudWatch 新增為資料來源](adding-CloudWatch-AWS-config.md)。
若要手動設定許可，請使用下節中的其中一個方法。
#### AWS 登入資料
有三種不同的身分驗證方法可用。
+ **AWS SDK 預設** — 使用連接至工作區的角色中定義的許可。如需詳細資訊，請參閱[客戶受管許可](AMG-manage-permissions.md#AMG-customer-managed)。
+ **存取和私密金鑰** — 對應至 適用於 Go 的 AWS SDK `StaticProvider`。使用指定的存取金鑰 ID 和私密金鑰進行身分驗證。此方法沒有任何備用，如果提供的金鑰對無法運作，則 會失敗。
#### IAM 角色
目前，Grafana 後端會使用官方 AWS SDK 完成對 CloudWatch 的所有存取。如果您選擇 *AWS SDK 預設*身分驗證方法，且您的 Grafana 伺服器正在執行 AWS，則可以使用 IAM 角色自動處理身分驗證。
如需詳細資訊，請參閱 [IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)。
#### IAM 政策
Grafana 需要透過 IAM 授予的許可，才能讀取 CloudWatch 指標和 EC2 標籤、執行個體和區域。您可以將這些許可連接到 IAM 角色，並使用內建的 Grafana 支援來擔任角色。
下列程式碼範例顯示最少的政策。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowReadingMetricsFromCloudWatch",
"Effect": "Allow",
"Action": [
"cloudwatch:DescribeAlarmsForMetric",
"cloudwatch:DescribeAlarmHistory",
"cloudwatch:DescribeAlarms",
"cloudwatch:ListMetrics",
"cloudwatch:GetMetricStatistics",
"cloudwatch:GetMetricData",
"cloudwatch:GetInsightRuleReport"
],
"Resource": "*"
},
{
"Sid": "AllowReadingLogsFromCloudWatch",
"Effect": "Allow",
"Action": [
"logs:DescribeLogGroups",
"logs:GetLogGroupFields",
"logs:StartQuery",
"logs:StopQuery",
"logs:GetQueryResults",
"logs:GetLogEvents"
],
"Resource": "*"
},
{
"Sid": "AllowReadingTagsInstancesRegionsFromEC2",
"Effect": "Allow",
"Action": [
"ec2:DescribeTags",
"ec2:DescribeInstances",
"ec2:DescribeRegions"
],
"Resource": "*"
},
{
"Sid": "AllowReadingResourcesForTags",
"Effect": "Allow",
"Action": "tag:GetResources",
"Resource": "*"
},
{
"Sid": "AllowReadingAcrossAccounts",
"Effect": "Allow",
"Action": [
"oam:ListSinks",
"oam:ListAttachedLinks"
],
"Resource": "*"
}
]
}
```
------
#### 擔任角色
`Assume Role ARN` 欄位可讓您指定要擔任的 IAM 角色，如果有的話。如果您將此保留空白，則會直接使用提供的登入資料，且相關聯的角色或使用者應具備必要的許可。如果此欄位不是空白的，則會使用提供的登入資料來執行 `sts:AssumeRole` 呼叫。
# 使用查詢編輯器
Amazon Managed Grafana 中的 CloudWatch 資料來源提供強大的查詢編輯器，可讓您從將資料傳送至 CloudWatch 的各種 AWS 服務擷取和分析指標和日誌。查詢編輯器支援兩種不同的查詢模式：指標搜尋和 CloudWatch Logs。
指標的查詢編輯器模式使用 CloudWatch API 來尋找上傳至 CloudWatch 的指標。日誌的 模式使用 CloudWatch Logs APIs來尋找日誌記錄。每個模式都有自己的專用查詢編輯器。您可以使用編輯器頂端的查詢模式切換來選取要查詢的 API。
**Topics**
+ [使用指標查詢編輯器](CloudWatch-using-the-metric-query-editor.md)
+ [使用 Amazon CloudWatch Logs 查詢編輯器](CloudWatch-using-the-logs-query-editor.md)
# 使用指標查詢編輯器
指標查詢編輯器可讓您建置兩種類型的查詢：**指標搜尋**和**指標查詢**。**指標查詢**選項會使用 CloudWatch Metrics Insights 查詢資料。
## 常見查詢編輯器欄位
**指標搜尋**和**指標查詢**模式都常見三個欄位。
**常見欄位**
**Id**
`GetMetricData` API 要求所有查詢都必須有唯一的 ID。使用此欄位來指定選擇的 ID。ID 可以包含數字、字母和底線，且必須以小寫字母開頭。如果未指定 ID，Amazon Managed Grafana 會使用下列模式產生 ID：`query[refId of the current query row]`。例如， `queryA`代表面板編輯器中的第一個查詢列。
**Period**
期間是與特定 CloudWatch 統計資料相關聯的時間長度。期間是以秒數定義。有效值包括 1、5、10、30 或 60 的任何倍數。如果您將期間欄位保持空白或設定為 `auto`，則會根據時間範圍和 CloudWatch 保留政策自動計算。使用的公式是 `time range in seconds / 2000`，然後在根據保留移除期間之後，在預先定義的期間 【60、300、900、3600、21600、86400】 陣列中移至下一個較高的值。若要查看 Amazon Managed Grafana 使用的期間，請在**查詢編輯器中選擇顯示查詢預覽**。
**Alias (別名)**
適用下列別名模式。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/CloudWatch-using-the-metric-query-editor.html)
# 使用指標搜尋選項
若要在**指標搜尋**中建立有效的查詢，您必須指定命名空間、指標名稱和至少一個統計資料。如果已開啟 **Match Exact**，您也必須指定所查詢指標的所有維度。指標結構描述必須完全相符。如需詳細資訊，請參閱 [CloudWatch 搜尋表達式語法 ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/search-expression-syntax.html)。
如果關閉 **Match Exact**，您可以指定要篩選的任何維度數量。最多傳回 100 個符合您篩選條件的指標。
## 使用維度萬用字元的動態查詢
您可以針對一或多個維度值使用星號 (`*`) 萬用字元來監控指標的動態清單。
這可協助您監控 AWS 資源的指標，例如 EC2 執行個體或容器。例如，當新執行個體建立為自動擴展事件的一部分時，它們會自動出現在圖形中，而不必追蹤新的執行個體 IDs。此功能目前限制為擷取最多 100 個指標。您可以選擇**顯示查詢預覽**，以查看為支援萬用字元而自動建置的搜尋表達式。
根據預設，搜尋表達式的定義方式是查詢的指標必須完全符合定義的維度名稱。這表示在範例中，只會`InstanceId`傳回具有完全相同名稱維度的指標。
若要包含已定義其他維度的指標，您可以關閉 **Match Exact**。關閉 **Match Exact** 也會建立搜尋表達式，即使您不使用萬用字元。Grafana 會搜尋任何至少符合命名空間、指標名稱和所有定義維度的指標。
## 多值範本變數
根據多值範本變數定義維度值時，系統會使用搜尋表達式來查詢相符指標。這可在單一查詢中使用多個範本變數。您也可以將範本變數用於關閉 **Match Exact** 選項的查詢。
搜尋表達式目前限制為 1024 個字元，因此如果您有長的值清單，您的查詢可能會失敗。如果您想要查詢具有特定維度名稱任何值的所有指標，建議您使用星號 (`*`) 萬用字元，而非 `All`選項。
只有維度值支援使用多值範本變數。`Metric Name` 不支援對 `Region`、 `Namespace`或 使用多值範本變數。
## 指標數學表達式
您可以使用數學函數在 CloudWatch 指標上操作，以建立新的時間序列指標。支援算術運算子、無索引減法和其他函數，並且可以套用至 CloudWatch 指標。如需 CloudWatch 指標數學函數的詳細資訊，請參閱[使用指標數學](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html)。
例如，若要在指標上套用算術操作，請將 ID （唯一字串） 提供給原始指標。然後，您可以使用此 ID，並在新指標的 `Expression` 欄位中對其套用算術操作。
如果您使用 `Expression` 欄位來參考另一個查詢，例如 `queryA * 2`，則無法根據該查詢建立提醒規則。
## Period
期間是與特定 Amazon CloudWatch 統計資料相關聯的時間長度。期間是以秒數定義。有效值包括 1、5、10、30 或 60 的任何倍數。
如果您將期間欄位保留空白或設定為**自動**，則會根據時間範圍自動計算。使用的公式是 `time range in seconds / 2000`，然後移至預先定義期間 陣列中的下一個較高的值`[60, 300, 900, 3600, 21600, 86400]`。若要查看 Amazon Managed Grafana 使用的期間，請在**查詢編輯器中選擇顯示查詢預覽**。
## 從 Grafana 面板深度連結至 CloudWatch 主控台
在面板中選擇時間序列會顯示內容功能表，其中包含在 ** CloudWatch 主控台中檢視**的連結。選擇該連結會開啟新標籤，帶您前往 CloudWatch 主控台，並顯示該查詢的所有指標。如果您目前尚未登入 CloudWatch 主控台，連結會將您轉送至登入頁面。提供的連結適用於任何 ， AWS 帳戶 但只有在您登入對應至 Grafana 中所選資料來源的 時 AWS 帳戶 ，才會顯示正確的指標。
此功能不適用於以指標數學表達式為基礎的指標。
# 使用指標查詢選項來查詢 CloudWatch Metrics Insights 資料
**注意**
Amazon CloudWatch Metrics Insights 處於預覽狀態。CloudWatch Metrics Insights 功能開放給所有 AWS 帳戶。功能可能會有所變更。
您可以在指標查詢**編輯器**中選擇 `metric query` 模式來查詢 CloudWatch Metrics Insights 資料。
CloudWatch Metrics Insights 是功能強大的高效能 SQL 查詢引擎，可用來大規模查詢您的指標。這是一個快速、靈活、以 SQL 為基礎的查詢引擎，您可以用來即時識別所有 CloudWatch 指標中的趨勢和模式。它使用 SQL 的方言。如需 Metrics Insights 查詢語法的詳細資訊，請參閱 [查詢語法和關鍵字](#metrics-insights-syntax-keywords)。
## 查詢語法和關鍵字
CloudWatch Metrics Insights 使用 SQL 方言。下列範例顯示查詢語法。
```
SELECT FUNCTION(metricName)
FROM namespace | [ SCHEMA(namespace[, labelKey [, ...] ]) ]
[ WHERE labelKey OPERATOR labelValue [AND|OR|([...])*] [, ...] ]
[ GROUP BY labelKey [, ...]]
[ ORDER BY FUNCTION() [DESC | ASC] ]
[ LIMIT number]
```
關鍵字不區分大小寫，但識別符區分大小寫。識別符包括指標的名稱、命名空間和維度。
下表提供查詢關鍵字及其描述。
| 關鍵字 | Description |
| --- | --- |
| FUNCTION | 必要. 指定要使用的彙總函數，並指定要查詢的指標名稱。有效值為AVG、COUNT、MAX、MIN、SUM。 |
| MetricName | 必要. 例如 CPUUtilization。 |
| FROM | 必要. 指定指標的來源。您可以指定包含要查詢之指標的指標命名空間，或 SCHEMA 資料表函數。有些命名空間範例是 AWS/EC2和 AWS/Lambda。 |
| SCHEMA | （選用） 篩選查詢結果，以僅顯示完全相符的指標，或不相符的指標。 |
| WHERE | （選用） 篩選結果，以僅顯示符合您指定表達式的指標。例如 WHERE InstanceType \$1= 'c3.4xlarge'。 |
| GROUP BY | （選用） 將查詢結果分組為多個時間序列。例如 GROUP BY ServiceName。 |
| ORDER BY | （選用） 指定要傳回的時間序列順序。選項為 ASC和 DESC。 |
| LIMIT | （選用） 限制要傳回的時間序列數目。 |
下列是一些範例：
+
```
SELECT AVG(CPUUtilization) FROM "AWS/EC2"
```
符合`AWS/EC2`命名空間中的所有`CPUUtilization`指標、忽略其維度，並傳回單一彙總時間序列。
+
```
SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2")
```
僅比對`AWS/EC2`命名空間中未定義任何維度的`CPUUtilization`指標。
+
```
SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2", InstanceId)
```
只比對回報給 CloudWatch 的`CPUUtilization`指標，且只有一個維度 `InstanceId`。
+
```
SELECT SUM(RequestCount) FROM SCHEMA("AWS/ApplicationELB", LoadBalancer,
AvailabilityZone)
```
僅處理從 向 CloudWatch 報告的`RequestCount`指標，`AWS/ApplicationELB`只有兩個維度 `LoadBalancer`和 `AvailabilityZone`。
標籤值必須以單引號括住。
### 逸出字元
在查詢中，標籤值一律必須以單引號括住。 例如 `SELECT MAX(CPUUtilization) FROM "AWS/EC2" WHERE AutoScalingGroupName = 'my-production-fleet'`。
包含字母、數字和底線 (`_`) 以外字元的指標命名空間、指標名稱和標籤索引鍵，必須以雙引號括住。例如 `SELECT MAX("My.Metric")`。如果其中一個包含雙引號本身 （例如 `Bytes"Input"`)，您必須逸出具有反斜線的雙引號，如 所示`SELECT AVG("Bytes\"Input\"")`。如果指標命名空間、指標名稱或標籤索引鍵包含在 Metrics Insights 中保留關鍵字的文字，則這些文字也必須以雙引號括住。例如，如果您的指標名為 `LIMIT`，則您可以使用 `SELECT AVG("LIMIT")`。也可以用雙引號括住任何命名空間、指標名稱或標籤，即使其不包含保留的關鍵字也一樣。
## 建置器模式和程式碼模式
您可以在 `Builder` 模式或 `Code` 模式中建立查詢。
**在 `Builder` 模式下建立查詢**
1. 使用上表中的資訊瀏覽並選取指標命名空間、指標名稱、篩選條件、群組和順序選項。
1. 對於每個選項，請從可能的選項清單中選擇。
**在 `Code` 模式下建立查詢**
1. 在程式碼編輯器中寫入您的查詢。
1. 若要執行查詢，請在程式碼編輯器中選擇**執行查詢**。
若要在 `builder` 模式中建立查詢：
+ 使用上表中的資訊瀏覽並選取指標命名空間、指標名稱、篩選條件、群組和順序選項。
+ 對於每個選項，請從可能的選項清單中選擇。
Grafana 會根據您的選擇自動建構 SQL 查詢。
若要在 `code` 模式中建立查詢：
+ 在程式碼編輯器中寫入您的查詢。
+ 若要執行查詢，請選擇程式碼編輯器上的**執行查詢**。
程式碼編輯器具有內建的自動完成功能，可提供關鍵字、彙總、命名空間、指標、標籤和標籤值的建議。當您輸入空格、逗號或貨幣符號時，會顯示建議。您也可以使用鍵盤組合 `CTRL+Space`。
程式碼編輯器可以自動完成查詢。不過，在程式碼編輯器中使用範本變數可能會干擾自動完成。
## CloudWatch Metrics Insights 範例
**注意**
CloudWatch Metrics Insights 為開放預覽。預覽版開放給所有 AWS 帳戶，您不需要請求存取權。在宣布一般可用性之前，可能會新增或變更功能。
本節包含實用的 CloudWatch Metrics Insights 查詢範例，您可以直接複製和使用，或在查詢編輯器中複製和修改。部分範例已在主控台中提供，您可以藉由在 **Metrics** (指標) 檢視中選擇 **Add query** (新增查詢)，來存取這些範例。
### EC2 範例
檢視每個執行個體指標的 CPU 使用率
```
SELECT AVG(CPUUtilization)
FROM "AWS/EC2"
GROUP BY InstanceId
```
檢視整個機群的平均 CPU 使用率
```
SELECT AVG(CPUUtilization)
FROM SCHEMA("AWS/EC2", InstanceId)
```
檢視平均 CPU 使用率最高的 10 個執行個體
```
SELECT MAX(CPUUtilization)
FROM "AWS/EC2"
GROUP BY InstanceId
LIMIT 10
```
檢視 CPU 使用率最高的 10 個執行個體，依上限排序，以遞減順序排列
```
SELECT AVG(CPUUtilization)
FROM "AWS/EC2"
GROUP BY InstanceId
ORDER BY MAX() DESC
LIMIT 10
```
在此情況下，CloudWatch 代理程式會收集每個應用程式的 CPUUtilization 指標。此查詢會針對特定應用程式名稱篩選此指標的平均值。
```
SELECT AVG(CPUUtilization)
FROM "AWS/CWAgent"
WHERE ApplicationName = 'eCommerce'
SELECT AVG(ConcurrentExecutions)
FROM "AWS/Lambda"
```
檢視前 10 個 Lambda 函數的平均執行時間，依最大值排序，以遞減順序排列
```
SELECT AVG(Duration)
FROM "AWS/Lambda"
GROUP BY FunctionName
ORDER BY MAX() DESC
LIMIT 10
```
檢視 Lambda 執行時間的最大值、平均值和最小值
```
SELECT MAX(Duration)
FROM "AWS/Lambda"
```
### Application Load Balancer 範例
檢視具有 **LoadBalancer** 和 **AvailabilityZone** 維度的指標
```
SELECT SUM(RequestCount)
FROM SCHEMA("AWS/ApplicationELB", LoadBalancer, AvailabilityZone)
```
檢視具有作用中並行 TCP 連線數目的指標
```
SELECT AVG(ActiveConnectionCount)
FROM "AWS/ApplicationELB"
```
### Amazon EBS 範例
依遞減順序檢視每個磁碟區前 10 個平均寫入位元組
```
SELECT AVG(VolumeWriteBytes)
FROM "AWS/EBS"
GROUP BY VolumeId
ORDER BY MAX() DESC
LIMIT 10
```
檢視平均 Amazon EBS 磁碟區寫入時間
```
SELECT AVG(VolumeTotalWriteTime)
FROM "AWS/EBS"
```
檢視平均 Amazon EBS 磁碟區閒置時間
```
SELECT AVG(VolumeIdleTime)
FROM "AWS/EBS"
View average burst balance per volume
SELECT AVG(BurstBalance)
FROM "AWS/EBS"
GROUP BY VolumeId
View average read bytes across Amazon EBS volumes
SELECT AVG(VolumeReadBytes)
FROM "AWS/EBS"
```
檢視跨 Amazon EBS 磁碟區的平均寫入位元組
```
SELECT AVG(VolumeWriteBytes)
FROM "AWS/EBS"
```
### Amazon Simple Storage Service 範例
依儲存貯體名稱檢視平均延遲群組
```
SELECT AVG(TotalRequestLatency)
FROM "AWS/S3"
GROUP BY BucketName
```
檢視所有 Amazon S3 儲存貯體中每個儲存貯體的平均物件數量
```
SELECT AVG(NumberOfObjects)
FROM "AWS/S3"
GROUP BY BucketName
```
### Amazon Simple Notification Service 範例
Amazon-simple-notificaation-service-examples
```
SELECT AVG(NumberOfMessagesPublished)
FROM "AWS/SNS"
```
檢視每個主題名稱的平均失敗訊息數量
```
SELECT AVG(NumberOfNotificationsFailed)
FROM "AWS/SNS"
GROUP BY TopicName
```
### AWS API 用量範例
依您帳戶中的呼叫數量檢視前 20 AWS APIs
```
SELECT COUNT(CallCount)
FROM "AWS/Usage"
WHERE "Type" = 'API'
GROUP BY "Service", "Resource"
ORDER BY SUM() DESC
LIMIT 20
```
## CloudWatch Metrics Insights 限制
CloudWatch Metrics Insights 目前具有下列限制：
+ 您只能查詢最近三個小時的資料。
+ 單一查詢可處理不超過 10,000 個指標。這表示如果 `SELECT`、 `FROM`和 `WHERE`子句符合超過 10，000 個指標，則查詢只會處理前 10，000 個找到的這些指標。
+ 單個查詢可以傳回不超過 500 個時間序列。這表示如果查詢正在處理超過 500 個指標，則並非所有指標都會在查詢結果中傳回。如果您使用 `ORDER BY`子句，則會排序處理的所有指標，並傳回根據您的`ORDER BY`子句具有最高或最低值的 500。如果您不包含 `ORDER BY`子句，則無法控制傳回的 500 個相符指標。
+ 每個`GetMetricData`操作只能有一個查詢，但您可以在儀表板中擁有多個小工具，每個小工具都包含查詢。
# 使用 Amazon CloudWatch Logs 查詢編輯器
若要查詢 CloudWatch Logs，請選取您要查詢的區域和最多 20 個日誌群組。使用主要輸入區域來撰寫查詢。如需詳細資訊，請參閱 [CloudWatch Logs Insights 查詢語法](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html)。
您也可以使用 CloudWatch Logs Insights 中的 `stats`命令，撰寫傳回時間序列資料的查詢。在探索中進行`stats`查詢時，您必須確定您處於指標探索模式。
查詢輸入欄位右側有一個 CloudWatch Logs Insights 連結，可使用您的查詢開啟 CloudWatch Logs Insights 主控台。如有必要，您可以繼續探索。
## 使用範本變數
如同數個其他資料來源，CloudWatch 資料來源支援在查詢中使用範本變數。如需詳細資訊，請參閱[範本和變數](templates-and-variables.md)。
## 從 Grafana 面板深度連結至 CloudWatch Logs 主控台
如果您想要在 CloudWatch Logs Insights 主控台中檢視查詢，請選擇查詢編輯器旁的 **CloudWatch Logs Insights** 按鈕。如果您目前尚未登入 CloudWatch 主控台，連結會將您轉送至登入頁面。提供的連結適用於任何 ， AWS 帳戶 但只有在您登入對應至 Grafana 中所選資料來源的 時 AWS 帳戶 ，才會顯示正確的指標。
## 提醒
由於 CloudWatch Logs 查詢可以傳回數值資料，例如透過使用 `stats`命令，因此支援警示。如需詳細資訊，請參閱[Grafana 提醒](alerts-overview.md)。
# 統籌儀表板
更新的 CloudWatch 資料來源隨附五個最熱門 AWS 服務的預先設定儀表板：
+ Amazon EC2
+ Amazon Elastic Block Store
+ AWS Lambda
+ Amazon CloudWatch Logs
+ Amazon Relational Database Service
若要匯入預先設定的儀表板，請前往 CloudWatch 資料來源的組態頁面，然後選擇**儀表板**索引標籤。針對您要使用的儀表板選擇**匯入**。若要自訂儀表板，建議您以不同的名稱儲存儀表板，否則儀表板會在發行新版本的儀表板時遭到覆寫。
# 範本查詢
您可以在指標查詢中使用變數，而不是硬式編碼詳細資訊，例如伺服器、應用程式和感應器名稱。變數會顯示為儀表板頂端的下拉式清單選取方塊。您可以使用這些下拉式方塊來變更儀表板中顯示的資料。
[範本](templates-and-variables.md#templates) 如需範本功能的簡介和不同類型的範本變數，請參閱 。
## 查詢變數
CloudWatch 資料來源提供下列查詢，您可以在**變數**編輯檢視的**查詢**欄位中指定。您可以使用這些項目來填入變數的選項清單，例如 `region`、`metric names`、 `namespaces`和 `dimension keys/values`。
您可以`region`指定 `default`使用資料來源中設定的預設區域取代 。
| 名稱 | 描述 |
| --- | --- |
| regions() | 傳回所有 AWS 區域的清單。 |
| namespaces() | 傳回 CloudWatch 支援的命名空間清單。 |
| metrics(namespace, [region]) | 傳回 命名空間中的指標清單。（指定區域或"default"用於自訂指標。) |
| dimension\$1keys(namespace) | 傳回 命名空間中的維度索引鍵清單。 |
| dimension\$1values(region, namespace, metric, dimension\$1key, [filters]) | 傳回符合指定 region、metric、 namespace或 的維度值清單dimension\$1key。或者，您可以使用維度filters來取得更具體的結果。 |
| ebs\$1volume\$1ids(region, instance\$1id) | 傳回符合指定 region、 的磁碟區 IDs 清單instance\$1id。 |
| ec2\$1instance\$1attribute(region, attribute\$1name, filters) | 傳回符合指定 region、attribute\$1name、 的屬性清單filters。 |
| resource\$1arns(region, resource\$1type, tags) | 傳回符合指定 region、 resource\$1type和 的 ARNs 清單tags。 |
| statistics() | 傳回所有標準統計資料的清單。 |
如需 CloudWatch 提供的指標詳細資訊，請參閱[AWS 發佈 CloudWatch 指標的 服務](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/aws-services-cloudwatch-metrics.html)。
### 範本化查詢的範例
下表顯示傳回個別 AWS 服務資源清單的範例維度查詢。
| Query | 服務 |
| --- | --- |
| dimension\$1values(us-east-1,AWS/ELB,RequestCount,LoadBalancerName) | Elastic Load Balancing |
| dimension\$1values(us-east-1,AWS/ElastiCache,CPUUtilization,CacheClusterId) | Amazon ElastiCache |
| dimension\$1values(us-east-1,AWS/Redshift,CPUUtilization,ClusterIdentifier) | Amazon Redshift |
| dimension\$1values(us-east-1,AWS/RDS,CPUUtilization,DBInstanceIdentifier) | Amazon RDS |
| dimension\$1values(us-east-1,AWS/S3,BucketSizeBytes,BucketName) | Amazon Simple Storage Service (Amazon S3) |
| dimension\$1values(us-east-1,CWAgent,disk\$1used\$1percent,device,\$1"InstanceId":"\$1instance\$1id"\$1) | CloudWatch 代理程式 |
| resource\$1arns(eu-west-1,elasticloadbalancing:loadbalancer,\$1"elasticbeanstalk:environment-name":["myApp-dev","myApp-prod"]\$1) | Elastic Load Balancing |
| resource\$1arns(eu-west-1,ec2:instance,\$1"elasticbeanstalk:environment-name":["myApp-dev","myApp-prod"]\$1) | Amazon EC2 |
# 使用 ec2\$1instance\$1attribute 範例
## JSON 篩選條件
`ec2_instance_attribute` 查詢`filters`採用 JSON 格式。您可以指定 的預先定義篩選條件`ec2:DescribeInstances`。請注意，實際篩選是在 中進行 AWS，而不是在 Grafana 中進行。
下列程式碼範例顯示篩選條件語法。
```
{ filter_name1: [ filter_value1 ], filter_name2: [ filter_value2 ] }
```
下列範例顯示`ec2_instance_attribute()`查詢。
```
ec2_instance_attribute(us - east - 1, InstanceId, { 'tag:Environment': ['production'] });
```
## 選取屬性
每個執行個體只能傳回一個屬性。您可以選取任何一般屬性 （亦即， 如果屬性具有單一值，且不是物件或陣列）。下列一般屬性可供使用。
+ `AmiLaunchIndex`
+ `Architecture`
+ `ClientToken`
+ `EbsOptimized`
+ `EnaSupport`
+ `Hypervisor`
+ `IamInstanceProfile`
+ `ImageId`
+ `InstanceId`
+ `InstanceLifecycle`
+ `InstanceType`
+ `KernelId`
+ `KeyName`
+ `LaunchTime`
+ `Platform`
+ `PrivateDnsName`
+ `PrivateIpAddress`
+ `PublicDnsName`
+ `PublicIpAddress`
+ `RamdiskId`
+ `RootDeviceName`
+ `RootDeviceType`
+ `SourceDestCheck`
+ `SpotInstanceRequestId`
+ `SriovNetSupport`
+ `SubnetId`
+ `VirtualizationType`
+ `VpcId`
可以透過在標籤名稱前面加上 來選取標籤`Tags`。
下列範例顯示`ec2_instance_attribute()`查詢。
```
ec2_instance_attribute(us - east - 1, Tags.Name, { 'tag:Team': ['sysops'] });
```
# 使用 JSON 格式範本變數
有些查詢接受 JSON 格式的篩選條件，Grafana 支援將範本變數轉換為 JSON。
如果為 `env = 'production', 'staging'`，下列查詢會傳回`Environment`標籤為 `production`或 的 EC2 執行個體 ARNs`staging`。
```
resource_arns(us-east-1, ec2:instance, {"Environment":${env:json}})
```
# 定價
Grafana 的 Amazon CloudWatch 資料來源會使用 `ListMetrics`和 `GetMetricData` CloudWatch API 呼叫來列出和擷取指標。CloudWatch Logs 的定價是以透過 CloudWatch Logs Insights 查詢擷取、封存和分析的資料量為基礎。如需詳細資訊，請參閱 [Amazon CloudWatch 定價](https://aws.amazon.com/cloudwatch/pricing)。
每次在查詢編輯器中選擇維度時，Grafana 都會發出`ListMetrics`請求。每當您變更查詢編輯器中的查詢時，就會向 GetMetricData 發出新的請求。
擷取資料範例的 API 請求會使用 `GetMetricData`操作。此操作可更好地支援 CloudWatch 指標數學。它也支援在使用萬用字元或關閉 **Match Exact** 選項時自動產生搜尋表達式。`GetMetricData` 操作會產生費用。如需詳細資訊，請參閱 [Amazon CloudWatch 定價](https://aws.amazon.com/cloudwatch/pricing)。
# Service Quotas
AWS 定義您 AWS 帳戶中資源、操作和項目的配額或限制。根據儀表板中的查詢數量和存取儀表板的使用者數量，您可能會達到各種 CloudWatch 和 CloudWatch Logs 資源的使用限制。請注意，配額是依帳戶和 AWS 區域定義。如果您使用多個區域，或已設定多個 CloudWatch 資料來源來針對多個帳戶進行查詢，則必須針對每個帳戶和達到限制的每個區域請求增加配額。
如需詳細資訊，請參閱 [ CloudWatch 服務配額](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_limits.html)。
# 跨帳戶可觀測性
**警告**
此功能需要您的 Grafana 工作區為第 9 版或更新版本。
CloudWatch 外掛程式可讓您監控多個區域帳戶之間的應用程式並進行疑難排解。使用跨帳戶可觀測性，您可以無縫搜尋、視覺化和分析指標和日誌，而無需擔心帳戶界限。
若要啟用跨帳戶可觀測性，請先在 CloudWatch 中啟用，然後將適當的 IAM 動作新增至執行外掛程式的角色/使用者。如果您的 Amazon Managed Grafana 工作區在 VPC 中執行，則您也必須有 NAT 閘道以支援網際網路存取。
+ 若要了解如何啟用此功能，請參閱《Amazon [CloudWatch 使用者指南》中的 CloudWatch 跨帳戶可觀測性](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html)。 *Amazon CloudWatch *
+ 下列動作是為執行外掛程式的角色/使用者新增的適當 IAM 動作。
```
{
"Sid": "AllowReadingAcrossAccounts",
"Effect": "Allow",
"Action": [
"oam:ListSinks",
"oam:ListAttachedLinks"
],
"Resource": "*"
}
```
+ CloudWatch 資料來源的跨帳戶可觀測性依賴 Amazon CloudWatch 可觀測性存取管理員。Observability Access Manager 不支援 VPC 端點。如果您的 Amazon Managed Grafana 工作區在 VPC 中執行，則您還必須擁有允許工作區在網際網路上呼叫 APIs的 NAT 閘道。
**注意**
您還必須擁有 IAM 許可，才能讀取您嘗試存取之帳戶中的 CloudWatch 資料。
# 連線至 Amazon OpenSearch Service 資料來源
**注意**
在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
使用 Amazon Managed Grafana，您可以使用 Grafana 工作區主控台中的 AWS 資料來源組態選項，將 Amazon OpenSearch Service 新增為資料來源。此資料來源支援執行 OpenSearch 叢集和舊版 Elasticsearch 叢集的 OpenSearch Service 網域。
AWS 資料來源組態選項可探索現有的 OpenSearch Service 帳戶，簡化將 OpenSearch Service 新增為資料來源的程序，並管理存取 OpenSearch 所需的身分驗證憑證組態。您可以使用此方法設定身分驗證，並將 OpenSearch Service 新增為資料來源，或者您可以使用與自我管理 Grafana 伺服器上相同的方法手動設定資料來源和必要的身分驗證憑證。
OpenSearch Service 資料來源支援管道處理語言 (PPL)。如需 PPL 的詳細資訊，請參閱[使用 Piped Processing Language 查詢 Amazon OpenSearch Service 資料](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/ppl-support.html)。
您可以使用 OpenSearch Service 資料來源來執行許多類型的簡單或複雜的 OpenSearch 查詢，以視覺化儲存在 OpenSearch 中的日誌或指標。您也可以使用儲存在 OpenSearch 中的日誌事件來註釋圖表。
**Topics**
+ [使用 AWS 資料來源組態將 OpenSearch Service 新增為資料來源](ES-adding-AWS-config.md)
+ [手動新增 Amazon OpenSearch Service 作為資料來源](ES-adding-the-data-source.md)
+ [OpenSearch Service 設定](#ES-settings)
+ [使用 Amazon OpenSearch Service 資料來源](ES-use-datasource.md)
+ [Amazon OpenSearch Service Serverless](datasources-opensearch-serverless.md)
+ [追蹤支援](datasources-opensearch-traces.md)
# 使用 AWS 資料來源組態將 OpenSearch Service 新增為資料來源
若要使用 AWS 資料來源組態，請先使用 Amazon Managed Grafana 主控台來啟用服務受管 IAM 角色，以授予工作區讀取您帳戶或整個組織單位中 OpenSearch Service 資源所需的 IAM 政策。然後，您可以使用 Amazon Managed Grafana 工作區主控台將 OpenSearch Service 新增為資料來源。
**使用 AWS 資料來源組態將 OpenSearch Service 新增為資料來源**
1. 開啟位於 https：//[https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/) 的 Amazon Managed Grafana 主控台。
1. 選擇頁面左上角的功能表圖示，然後選擇**所有工作區**。
1. 選擇工作區的名稱。
1. 如果您在建立工作空間時未選擇對此工作空間使用服務受管許可，則從使用客戶受管許可變更為使用服務受管許可，以確保在 Grafana 工作空間主控台中使用 AWS 資料來源組態選項啟用適當的 IAM 角色和政策。若要這樣做，請選擇依 **IAM 角色**編輯圖示，然後選擇**服務受管**、**儲存變更**。如需詳細資訊，請參閱[AWS 資料來源的 Amazon Managed Grafana 許可和政策](AMG-manage-permissions.md)。
1. 選擇**資料來源**索引標籤。然後選取 **Amazon OpenSearch Service** 的核取方塊，然後選擇**動作**、**啟用服務受管政策**。
1. 再次選擇**資料來源**索引標籤，然後在 **Amazon OpenSearch Service** 列中選擇在 **Grafana 中設定**。
1. 如有必要，請使用 IAM Identity Center 登入 Grafana 工作區主控台。
1. 在 Grafana 工作區主控台的左側導覽列中，選擇 AWS 圖示，然後選擇**AWS 服務** **Amazon OpenSearch Service**。
1. 選取您希望 Amazon Managed Grafana 搜尋以探索 OpenSearch Service 資源的區域，然後選取您要新增的帳戶和 OpenSearch Service 網域、設定索引設定，然後選擇**新增資料來源**。
# 手動新增 Amazon OpenSearch Service 作為資料來源
**手動新增 Amazon OpenSearch Service 資料來源**
1. 在 Grafana 主控台側邊選單中，選擇 **AWS** 圖示，然後選擇**資料來源**。
1. 選擇 **Amazon OpenSearch Service** 資料來源。如有必要，您可以開始**OpenSearch**在搜尋方塊中輸入 ，以協助您找到它。
1. 選擇您要從中搜尋資料**的區域**。
1. 選擇**新增資料來源**。
**注意**
如果您在側邊選單中看不到**資料來源**連結，表示您目前的使用者沒有 `Admin`角色。
## OpenSearch Service 設定
| 名稱 | 描述 |
| --- | --- |
| Name | 資料來源名稱。這是您在面板和查詢中查看資料來源的方式。 |
| Default | 預設資料來源表示新面板會預先選取該資料來源。 |
| Url | OpenSearch Service 網域的端點。端點採用下列格式：https：//https://search-my-domain.us-east-1.es.amazonaws.com。 |
| Access | 伺服器 （預設） = URL 必須可從 Grafana 後端/伺服器存取。瀏覽器 = URL 必須可從瀏覽器存取。 |
存取模式控制將如何處理對資料來源的請求。如果未說明其他項目，伺服器應該是偏好的方式。
### 伺服器存取模式 （預設）
所有請求都是從瀏覽器向 Grafana 後端或伺服器提出，其會將請求轉送至資料來源，以規避可能的跨來源資源共享 (CORS) 要求。如果您選擇此存取模式，則必須從 Grafana 後端或伺服器存取 URL。
### 瀏覽器 （直接） 存取
Amazon Managed Grafana 不支援瀏覽器直接存取。
### 索引設定
您可以在這裡為 指定預設值，`time field`並指定 OpenSearch 索引的名稱。您可以使用索引名稱或萬用字元的時間模式。
### OpenSearch/Elasticsearch 版本
在版本下拉式選單中指定您的 OpenSearch 或舊版 Elasticsearch 版本。版本很重要，因為每個版本的查詢撰寫方式有所不同。目前，Grafana 支援 OpenSearch 1.0.x。支援的 Elasticsearch 版本為 `2.0+`、`5.0+`、`6.0+`、 `5.6+`和 `7.0+`。此值`5.6+`表示 5.6 版或更新版本，但低於 6.0。此值`6.0+`表示 6.0 版或更新版本，但低於 7.0。最後， `7.0+`表示 7.0 版或更新版本，但低於 8.0。
### 最短時間間隔
依時間間隔分類的自動群組下限。建議設定為寫入頻率；例如，`1m`如果您的資料每分鐘寫入一次。也可以在資料來源選項下的儀表板面板中覆寫/設定此選項。此值的格式**必須是**數字，後面接著有效的時間識別符；例如 `1m`(1 分鐘） 或 `30s`(30 秒）。支援下列時間識別符。
| 識別符 | Description |
| --- | --- |
| y | 年 |
| M | 月 |
| w | 週 |
| d | 天 |
| h | 小時 |
| m | 分鐘 |
| s | 秒 |
| ms | 毫秒 |
### 日誌
在 中視覺化日誌時`Level field name`，可以從資料來源設定頁面選擇性地設定兩個參數 `Message field name`和 ，以決定哪些欄位將用於日誌訊息和日誌層級[探索](explore.md)。
例如，如果您使用 Filebeat 的預設設定將日誌運送到 OpenSearch Service，則下列組態應該可以運作。
+ **訊息欄位名稱：**訊息
+ **層級欄位名稱：**Fields.level
### 資料連結
資料連結會從可在探索日誌檢視中存取的指定欄位建立連結。
每個資料連結組態都包含下列項目：
+ **欄位** – 資料連結所使用的欄位名稱。
+ **URL/查詢 ** – 如果連結是外部連結，請輸入完整的連結 URL。如果連結是內部連結，則此輸入會做為目標資料來源的查詢。在這兩種情況下，您可以將 欄位的值插入`${__value.raw }`巨集。
+ **內部連結** – 如果連結是內部或外部，請選取此選項。如果連結是內部連結，則資料來源選取器可讓您選取目標資料來源。僅支援追蹤資料來源。
# 使用 Amazon OpenSearch Service 資料來源
## 指標查詢編輯器
OpenSearch 查詢編輯器可讓您依多個詞彙或篩選條件選取多個指標和群組。使用右側的加號和減號圖示，依子句新增/移除指標或群組。有些指標和依子句分組都有選項。選擇選項文字以展開\$1 列，以檢視和編輯指標或依選項分組。
## 使用管道處理語言 (PPL)
Amazon OpenSearch Service 資料來源支援 Piped Processing Language (PPL)，可為 OpenSearch 啟用更簡單但強大的查詢和視覺化功能。PPL 可讓客戶探索和尋找資料，而不必撰寫冗長的 OpenSearch Domain Specific Language (DSL) 陳述式或使用 JSON 物件寫入查詢。使用 PPL，您可以將查詢撰寫為一組以類似 UNIX 管道的管道分隔的命令。
以下列範例 DSL 查詢為範例：
```
GET opensearch_sample_data_logs/_search{"from":0,"size":0,"timeout":"1m","query":{"bool":{"should":[{"term":{"response.keyword":{"value":"404","boost":1}}},{"term":{"response.keyword":{"value":"503","boost":1}}}],"adjust_pure_negative":true,"boost":1}},"sort":[{"_doc":{"order":"asc"}}],"aggregations":{"composite_buckets":{"composite":{"size":1000,"sources":[{"host":{"terms":{"field":"host.keyword","missing_bucket":true,"order":"asc"}}},{"response":{"terms":{"field":"response.keyword","missing_bucket":true,"order":"asc"}}}]},"aggregations":{"request_count":{"value_count":{"field":"request.keyword"}},"sales_bucket_sort":{"bucket_sort":{"sort":[{"request_count":{"order":"desc"}}],"size":10}}}}}}>
```
上述 DSL 查詢可以取代為下列 PPL 命令，該命令簡潔且可人類讀取。
```
source = opensearch_sample_data_logs | where response='404' or response='503' | stats count(request) as request_count by host, response | sort –request_count
```
如需 PPL 的詳細資訊，請參閱[使用 Piped Processing Language 查詢 Amazon OpenSearch Service 資料](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/ppl-support.html)。
## 系列命名和別名模式
您可以使用`Alias`輸入欄位來控制時間序列的名稱。
| 模式 | Description |
| --- | --- |
| \$1\$1term fieldname\$1\$1 | 以 Group By 一詞的值取代。 |
| \$1\$1metric\$1\$1 | 以指標名稱 （例如 平均值、最小值、最大值）。 |
| \$1\$1field\$1\$1 | 以指標欄位名稱取代。 |
## 管道指標
有些指標彙總稱為管道彙總，例如*移動平均*和*衍生*。OpenSearch 管道指標需要根據另一個指標。使用指標旁的眼睛圖示，隱藏指標不出現在圖形中。這對於您在查詢中只有用於管道指標的指標很有用。
## 範本化
您可以在指標查詢中使用變數，而不是硬式編碼，例如伺服器、應用程式和感應器名稱。變數會顯示為儀表板頂端的下拉式清單選取方塊。您可以使用這些下拉式方塊來變更儀表板中顯示的資料。
如需範本和範本變數的詳細資訊，請參閱 [範本和變數](templates-and-variables.md)。
### 查詢變數
OpenSearch Service 資料來源支援兩種類型的查詢，您可以在*查詢*變數的*查詢*欄位中使用。查詢是使用自訂 JSON 字串撰寫。
| Query | Description |
| --- | --- |
| \$1"find": "fields", "type": "keyword"\$1 | 傳回索引類型為 的欄位名稱清單keyword。 |
| \$1"find": "terms", "field": "@hostname", "size": 1000\$1 | 使用詞彙彙總傳回欄位的值清單。查詢將使用目前的儀表板時間範圍做為查詢的時間範圍。 |
| \$1"find": "terms", "field": "@hostname", "query": ''\$1 | 使用詞彙彙總和指定的 Lucene 查詢篩選條件，傳回欄位的值清單。查詢將使用目前的儀表板時間範圍做為查詢的時間範圍。 |
詞彙查詢的預設大小限制為 500。若要設定自訂限制，請在查詢中設定大小屬性。您可以在查詢內使用其他變數。下列程式碼範例顯示名為 之變數的查詢定義`$host`。
```
{"find": "terms", "field": "@hostname", "query": "@source:$source"}
```
在上一個範例中，我們使用在查詢定義`$source`內名為 的另一個變數。每當您使用下拉式清單變更`$source`變數的目前值時，就會啟動`$host`變數的更新。更新之後， `$host`變數只會包含由 篩選的主機名稱，在此情況下為`@source`文件屬性。
預設情況下，這些查詢會依詞彙順序傳回結果 （然後，任何變數都可以按字母或數字排序）。若要產生依文件計數排序的詞彙清單 （前 N 個值清單），請新增 的 `orderBy` 屬性`doc_count`。這會自動選取遞減排序。使用 `asc`搭配 doc\$1count (N 底部清單） 可以透過設定 來完成`order: "asc"`，但不建議這麼做，因為它會增加文件計數的錯誤。若要將術語保留在文件計數順序中，請將變數的**排序**下拉式清單設定為**已停用**。或者，您可能仍然想要使用**字母來**重新排序它們。
```
{"find": "terms", "field": "@hostname", "orderBy": "doc_count"}
```
### 在查詢中使用變數
有兩種語法：
+ `$` 範例：@hostname：\$1hostname
+ `[[varname]]` 範例：@hostname：【【hostname】】
為什麼有兩種方式？ 第一個語法更容易讀取和寫入，但不允許您在單字中間使用變數。啟用*多值*或*包含所有值*選項時，Grafana 會將標籤從純文字轉換為 Lucene 相容條件。
在先前的範例中，我們有使用名為 的變數，根據 `@hostname` 屬性篩選文件的 lucene 查詢`$hostname`。它也在「依欄位輸入分組*」*方塊中使用變數。這可讓您使用變數來快速變更資料的分組方式。
## 註釋
註釋可讓您在圖形上方疊加豐富的事件資訊。您可以使用儀表板功能表或註釋檢視來新增註釋查詢。Grafana 可以查詢註釋事件的任何 OpenSearch 索引。如需詳細資訊，請參閱[註釋](dashboard-annotations.md)。
| 名稱 | 描述 |
| --- | --- |
| Query | 您可以保持搜尋查詢空白，或指定 Lucene 查詢。 |
| Time | 時間欄位的名稱；必須是日期欄位。 |
| Time End | 時間結束欄位的選用名稱必須是日期欄位。如果設定，註釋將標記為時間和結束時間之間的區域。 |
| Text | 事件描述欄位。 |
| Tags | 用於事件標籤的選用欄位名稱 （可以是陣列或 CSV 字串）。 |
## 查詢 日誌
從 OpenSearch 查詢和顯示日誌資料可在探索中取得。若要顯示日誌，請選取 OpenSearch Service 資料來源，然後選擇性地輸入 Lucene 查詢。如需詳細資訊，請參閱[探索](explore.md)。
### 日誌查詢
傳回結果後，日誌面板會顯示日誌資料列清單和長條圖，其中 x 軸顯示時間，y 軸顯示頻率或計數。
### 篩選日誌訊息
或者，在查詢欄位中輸入 Lucene 查詢來篩選日誌訊息。例如，使用預設的 Filebeat 設定，您應該能夠使用 `fields.level:error` 僅顯示錯誤日誌訊息。
# Amazon OpenSearch Service Serverless
**注意**
OpenSearch Service Serverless 支援僅適用於執行 Grafana 9.4 版和更新版本的 Grafana 工作區。
您可以使用 OpenSearch Service 資料來源，透過 Amazon Managed Grafana 存取 Amazon OpenSearch Service Serverless 資料。資料的存取是由資料存取政策所控制。下列範例顯示允許使用者查詢特定集合和索引的政策。請務必*`principal_arn`*將 *`collection_name`*、 *`index_name`*和 取代為您的使用案例的正確值。
```
[
{
"Rules": [
{
"Resource": ["collection/{collection_name}"],
"Permission": ["aoss:DescribeCollectionItems"],
"ResourceType": "collection"
},
{
"Resource": ["index/{collection_name}/{index_name}"],
"Permission": ["aoss:DescribeIndex", "aoss:ReadDocument"],
"ResourceType": "index"
}
],
"Principal": ["principal_arn"],
"Description": "read-access"
}
]
```
# 追蹤支援
OpenSearch 外掛程式支援以資料表形式檢視追蹤清單，並在**追蹤檢視**中檢視單一追蹤，其中顯示追蹤範圍的時間軸。
**注意**
查詢 OpenSearch 追蹤只能使用 Lucene 查詢。
追蹤支援僅適用於支援 9.4 版或更新版本的 Grafana 工作區。
若要建立顯示所有追蹤的查詢，請使用 Lucene 查詢類型`Traces`搭配空白查詢。如有必要，請選取**資料表**視覺化類型。
在資料表中選取追蹤 ID 會在追蹤檢視中開啟該追蹤。
若要建立顯示單一追蹤的查詢，請使用查詢 `traceid: {traceId}`，並視需要選取**追蹤**視覺化類型。
# 連線至 AWS IoT SiteWise 資料來源
**注意**
在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
使用 Amazon Managed Grafana，您可以使用 Grafana 工作區主控台中的 AWS 資料來源組態選項，將 新增 AWS IoT SiteWise 為資料來源。此功能可探索您現有的 AWS IoT SiteWise 帳戶，並管理存取所需的身分驗證憑證組態，以簡化將 AWS IoT SiteWise 新增至資料來源的程序 AWS IoT SiteWise。您可以使用此方法來設定身分驗證並新增 AWS IoT SiteWise 做為資料來源，或者您可以使用與自我管理 Grafana 伺服器上相同的方法手動設定資料來源和必要的身分驗證憑證。
**Topics**
+ [使用 AWS 資料來源組態將 新增 AWS IoT SiteWise 為資料來源](IoTSiteWise-adding-AWS-config.md)
+ [手動新增 AWS IoT SiteWise 資料來源](iotsitewise-add-the-data-source.md)
+ [AWS IoT SiteWise 設定](#iotsitewise-settings)
+ [使用 AWS IoT SiteWise 資料來源](IoTSiteWise-using.md)
# 使用 AWS 資料來源組態將 新增 AWS IoT SiteWise 為資料來源
若要使用 AWS 資料來源組態，請先使用 Amazon Managed Grafana 主控台來啟用服務受管 IAM 角色，以授予工作區讀取帳戶或整個組織單位中 AWS IoT SiteWise 資源所需的 IAM 政策。然後，您可以使用 Amazon Managed Grafana 工作區主控台將 新增 AWS IoT SiteWise 為資料來源。
**使用 AWS 資料來源組態將 新增 AWS IoT SiteWise 為資料來源**
1. 開啟位於 https：//[https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/) 的 Amazon Managed Grafana 主控台。
1. 選擇頁面左上角的功能表圖示，然後選擇**所有工作區**。
1. 選擇工作區的名稱。
1. 如果您在建立工作空間時未選擇對此工作空間使用服務受管許可，則從使用客戶受管許可變更為使用服務受管許可，以確保在 Grafana 工作空間主控台中使用 AWS 資料來源組態選項啟用適當的 IAM 角色和政策。若要這樣做，請選擇依 **IAM 角色**編輯圖示，然後選擇**服務受管**、**儲存變更**。如需詳細資訊，請參閱[AWS 資料來源的 Amazon Managed Grafana 許可和政策](AMG-manage-permissions.md)。
1. 選擇**資料來源**索引標籤。然後選取 **AWS IoT SiteWise** 的核取方塊，然後選擇**動作**、**啟用服務受管政策**。
1. 再次選擇**資料來源**索引標籤，然後在 **AWS IoT SiteWise** 列中選擇**在 Grafana 中設定**。
1. 如有必要，請使用 IAM Identity Center 登入 Grafana 工作區主控台。
1. 在 Grafana 工作區主控台的左側導覽列中，選擇 AWS 圖示，然後選擇**AWS 服務** **IoT SiteWise**。
1. 選取您希望 AWS IoT SiteWise 資料來源查詢的預設區域，選取帳戶，然後選擇**新增資料來源**。
# 手動新增 AWS IoT SiteWise 資料來源
**手動新增 AWS IoT SiteWise 資料來源**
1. 在 Grafana 主控台側邊選單中，暫停**組態** （齒輪） 圖示，然後選擇**資料來源**。
1. 選擇**新增資料來源**。
1. 選擇 **AWS IoT SiteWise** 資料來源。如有必要，您可以開始**SiteWise**在搜尋方塊中輸入 ，以協助您找到它。
## AWS IoT SiteWise 設定
| 名稱 | 描述 |
| --- | --- |
| Name | 資料來源名稱。這是您在面板和查詢中查看資料來源的方式。 |
| 驗證提供者 | 指定要取得登入資料的提供者。 |
| 預設區域 | 用於查詢編輯器以設定區域 （可以根據每個查詢進行變更）。 |
| 登入資料設定檔名稱 | 指定要使用的設定檔名稱 （如果您使用 \$1/.aws/credentials 檔案）；預設請保留空白。 |
| 擔任角色 Arn | 指定要擔任的角色的 ARN。 |
| 端點 （選用） | 如果您必須指定替代服務端點。 |
# 使用 AWS IoT SiteWise 資料來源
如需如何使用 AWS IoT SiteWise 資料來源的資訊，請參閱 Github 上的[AWS IoT SiteWise 資料來源](https://github.com/grafana/iot-sitewise-datasource/blob/main/src/README.md)。
# 連線至 an AWS IoT TwinMaker 資料來源
**注意**
在支援第 9 版或更新版本的工作區中，此資料來源可能需要您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
使用 Amazon Managed Grafana，您可以在 Grafana 工作區中新增強大的工業資料分析服務 AWS IoT TwinMaker，做為應用程式和資料來源。透過 AWS IoT TwinMaker，您可以建立最終使用者 3D 數位分身應用程式來監控工業操作。 AWS IoT TwinMaker 是一種服務，可讓開發人員更快速地建立真實世界系統的數位複本，協助更多客戶實現數位分身的潛力以最佳化操作。 AWS IoT TwinMaker for Grafana 提供自訂面板、儀表板範本和資料來源，以連線至您的數位分身資料。
# 手動新增 AWS IoT TwinMaker 資料來源
## 先決條件
開始之前，請確定您可以從 存取 **AWS IoT TwinMaker** AWS 帳戶。
若要了解如何將許可新增至工作區 IAM 角色以存取 AWS IoT TwinMaker，請參閱 [將 AWS IoT TwinMaker 的許可新增至您的工作區使用者角色](AMG-iot-twinmaker.md#twinmaker-add-permission)。
**若要新增 AWS IoT TwinMaker 資料來源：**
1. 確保您的使用者角色是管理員或編輯器。
1. 在 Grafana 主控台側邊選單中，將滑鼠游標暫留在**組態** （齒輪） 圖示上，然後選擇**資料來源**。
1. 選擇**新增資料來源**。
1. 選擇 **AWS IoT TwinMaker** 資料來源。如有必要，您可以開始**TwinMaker**在搜尋方塊中輸入 ，以協助您找到它。
1. 這會開啟**連線詳細資訊**頁面。請遵循設定 中的步驟[AWS IoT TwinMaker 連線詳細資訊設定](AMG-iot-twinmaker.md#twinmaker-connection-details)。
## 將 AWS IoT TwinMaker 的許可新增至您的工作區使用者角色
**若要將 AWS IoT TwinMaker 許可新增至工作區使用者角色，請擔任 Amazon Managed Grafana 工作區和 TwinMaker 儀表板角色之間的角色許可。**
1. 前往 https：//[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)。
1. 手動建立儀表板角色。如需建立儀表板角色的詳細資訊，請參閱 [手動建立 Grafana AWS IoT TwinMaker 儀表板角色](#iot-twinmaker-dashboard-role)。
## AWS IoT TwinMaker 連線詳細資訊設定
**設定連線詳細資訊設定**
1. 在**連線詳細資訊**功能表中，選取身分驗證提供者 （建議：**工作區 IAM 角色**)。
1. 選擇您要查詢**的預設區域**。
1. 在 **TwinMaker 設定**中，輸入 AWS IoT TwinMaker 工作區名稱。
# 使用 AWS IoT TwinMaker 資料來源
如需有關如何使用 AWS IoT TwinMaker 資料來源的資訊，請參閱 GitHub 上的 [AWS IoT TwinMaker 資料來源](https://github.com/grafana/grafana-iot-twinmaker-app)。
## 手動建立 Grafana AWS IoT TwinMaker 儀表板角色
**手動建立 Grafana AWS IoT TwinMaker 儀表板角色**
1. 登入 IAM 主控台，網址為 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)。
1. 在摘要中尋找您的 Amazon Managed Grafana 工作區角色。它如下所示：
```
AmazonGrafanaServiceRole-random_ID
```
1. 將下列內嵌政策新增至角色：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": {
"Effect": "Allow",
"Action": "sts:AssumeRole",
"Resource": "arn:aws:iam::111122223333:role/TwinMakerDashboardRole"
}
}
```
------
1. 為每個儀表板角色新增內嵌政策。或者，在資源列新增角色 Amazon **Resource** Name (ARNs) 的清單。
1. 在 IAM 主控台中尋找您的儀表板角色。它應該有 `SceneViewer`政策，以及選擇性`VideoPlayer`的政策。
1. 選擇**信任關係**索引標籤。
1. 選擇**編輯信任關係**。
1. 輸入下列政策，將 *AMGWorkspaceRoleArn* 取代為來自您帳戶的 Arn：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "AMGWorkspaceRoleARN"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
## 範例 an AWS IoT TwinMaker 政策
以下是您可以連接到儀表板角色的 minimal AWS IoT TwinMaker 政策。您必須根據自己的資源，取代 AWS IoT TwinMaker 工作區 ARN 和 ID 以及 Amazon S3 儲存貯體 ARN 的值。
# 連線至 Amazon Managed Service for Prometheus 和開放原始碼 Prometheus 資料來源
在 Amazon Managed Grafana 中，Prometheus 資料來源支援使用自我管理的 Prometheus 伺服器和 Amazon Managed Service for Prometheus 工作區作為資料來源。如需 Amazon Managed Service for Prometheus 的詳細資訊，請參閱[什麼是 Amazon Managed Service for Prometheus？](https://docs.aws.amazon.com/prometheus/latest/userguide/what-is-Amazon-Managed-Service-Prometheus.html)
使用 Amazon Managed Grafana，您可以使用 Grafana 工作區主控台中的資料來源組態選項，將 Amazon Managed Service for Prometheus 工作區新增為 AWS 資料來源。此功能可探索您現有的 Amazon Managed Service for Prometheus 帳戶，並管理存取 Amazon Managed Service for Prometheus 所需的身分驗證憑證組態，以簡化將 Amazon Managed Service for Prometheus 新增為資料來源的程序。
**注意**
您可以透過 在統一的 Grafana 警示界面中檢視 Prometheus 警示[設定 Alertmanager 資料來源](data-source-alertmanager.md#data-source-alertmanager-create)。
**Topics**
+ [使用 AWS 資料來源組態將 Amazon Managed Service for Prometheus 新增為資料來源](AMP-adding-AWS-config.md)
+ [手動新增 Prometheus 資料來源](prometheus-manually-adding.md)
+ [使用 Prometheus 資料來源](using-prometheus-datasource.md)
+ [視覺化來自 Amazon Managed Service for Prometheus 的提醒](amp-configure-alerts.md)
+ [設定範例](amp-configure-exemplars.md)
# 使用 AWS 資料來源組態將 Amazon Managed Service for Prometheus 新增為資料來源
若要使用 AWS 資料來源組態，請先使用 Amazon Managed Grafana 主控台來啟用服務受管 IAM 角色，以授予工作區讀取帳戶或整個組織單位中 Amazon Managed Service for Prometheus 資源所需的 IAM 政策。然後，您可以使用 Amazon Managed Grafana 工作區主控台將 Amazon Managed Service for Prometheus 新增為資料來源。
**使用 AWS 資料來源組態將 Amazon Managed Service for Prometheus 新增為資料來源**
1. 開啟位於 https：//[https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/) 的 Amazon Managed Grafana 主控台。
1. 選擇頁面左上角的功能表圖示，然後選擇**所有工作區**。
1. 選擇工作區的名稱。
1. 如果您在建立工作空間時未選擇對此工作空間使用服務受管許可，則從使用客戶受管許可變更為使用服務受管許可，以確保在 Grafana 工作空間主控台中使用 AWS 資料來源組態選項啟用適當的 IAM 角色和政策。若要這樣做，請選擇依 **IAM 角色**編輯圖示，然後選擇**服務受管**、**儲存變更**。如需詳細資訊，請參閱[AWS 資料來源的 Amazon Managed Grafana 許可和政策](AMG-manage-permissions.md)。
1. 選擇**資料來源**索引標籤。然後選取 **Amazon Managed Service for Prometheus** 的核取方塊，然後選擇**動作**、**啟用服務受管政策**。
1. 再次選擇**資料來源**索引標籤，然後在 **Amazon Managed Service for Prometheus** 列中選擇**在 Grafana 中設定**。
1. 如有必要，請使用 IAM Identity Center 登入 Grafana 工作區主控台。
1. 在 Grafana 工作區主控台的左側導覽列中，選擇 AWS 圖示，然後選擇**AWS 服務** **Prometheus**。
1. 選取您要 Amazon Managed Grafana 搜尋的區域，以探索 Amazon Managed Service for Prometheus 工作區，然後選取您要新增的帳戶和 Amazon Managed Service for Prometheus 工作區，然後選擇**新增資料來源**。
# 手動新增 Prometheus 資料來源
**手動新增 Prometheus 資料來源**
1. 在 Grafana 主控台側邊選單中，暫停**管理**選單項目 （或 Grafana v8 中的**組態** （齒輪） 圖示），然後選擇**資料來源**。
1. 選擇**新增資料來源**。
1. 選擇 **Prometheus** 資料來源。如有必要，您可以開始**Prometheus**在搜尋方塊中輸入 ，以協助您找到它。
# 使用 Prometheus 資料來源
## Prometheus 設定
| 名稱 | 描述 |
| --- | --- |
| Name | 資料來源名稱。這是您在面板和查詢中查看資料來源的方式。 |
| Default | 預設資料來源表示新面板會預先選取該資料來源。 |
| Url | Prometheus 伺服器的 URL；例如 https://prometheus.example.org:9090。 |
| Access | 伺服器 （預設） = URL 必須可從 Grafana 後端/伺服器存取。 |
| Basic Auth | 啟用 Prometheus 資料來源的基本身分驗證。 |
| User | 基本身分驗證的使用者名稱。 |
| Password | 基本身分驗證的密碼。 |
| Scrape interval | 將此設定為 Prometheus 中設定的典型湊集和評估間隔。預設為 15 秒。 |
| Disable metrics lookup | 勾選此選項將停用查詢欄位自動完成中的指標選擇器和指標/標籤支援。如果您對更大的 Prometheus 執行個體有效能問題，這很有幫助。 |
| Custom Query Parameters | 將自訂參數新增至 Prometheus 查詢 URL。例如 timeout、dedup、 partial\$1response或 max\$1source\$1resolution。多個參數應與「&」串連。 |
## Prometheus 查詢編輯器
下列各節提供儀表板和探索中 Prometheus 查詢編輯器的資訊和選項。
### 儀表板中的查詢編輯器
選擇標題，然後選擇**編輯** （或在面板上暫停時按下 **e** 鍵），以編輯模式開啟圖形。
| 名稱 | 描述 |
| --- | --- |
| Query expression | 如需 Prometheus 查詢表達式的詳細資訊，請參閱 [Prometheus 文件](https://prometheus.io/docs/querying/basics/)。 |
| Legend format | 使用名稱或模式控制時間序列的名稱。例如， \$1\$1hostname\$1\$1 會取代為標籤 的標籤值hostname。 |
| Min step | [`step` Prometheus 範圍查詢的 參數](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries)以及 \$1\$1\$1interval和 \$1\$1\$1rate\$1interval變數的額外下限。限制是絕對的，不會由解析度設定修改。 |
| Resolution | 1/1 同時設定 Prometheus 範圍查詢的 \$1\$1\$1interval變數和 參數，讓每個像素對應至一個資料點。 [https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries)為了獲得更好的效能，請使用較低的解析度。 1/2只會擷取每隔一個像素的資料點，並1/10擷取每 10 個像素一個資料點。請注意，最短時間間隔和最短步驟都會限制 \$1\$1\$1interval和 的最終值step。 |
| Metric lookup | 在此輸入欄位中搜尋指標名稱。 |
| Format as | 在 Table、 Time series或 之間切換Heatmap。 Table 僅適用於資料表面板。 Heatmap 適用於在熱度圖面板上顯示長條圖類型的指標。它會將累積長條圖轉換為一般長條圖，並依儲存貯體界限排序序列。 |
| Instant | 執行「即時」查詢，只傳回 Prometheus 針對請求的時間序列所抓取的最新值。即時查詢會傳回比正常範圍查詢更快的結果。使用它們來查詢標籤集。 |
| Min time interval | 此值乘以解析設定中的分母，會將下限值設定為 Prometheus 範圍查詢的 \$1\$1\$1interval變數和 參數。 [https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries)預設為擴展間隔，如資料來源選項中所設定。 |
**注意**
Amazon Managed Grafana 會修改查詢的請求日期，使其與動態計算的步驟保持一致。這可確保指標資料的一致性顯示，但它可能會在圖形的右側邊緣造成一小段資料間隙。
#### 儀表板中的即時查詢
Prometheus 資料來源可讓您執行即時查詢，該查詢只會查詢最新的值。您可以在資料表面板中視覺化結果，以查看時間序列的所有可用標籤。
即時查詢結果每個序列僅包含一個資料點。在序列覆寫的協助下，它們可以顯示在圖形面板中。若要在圖形中將其顯示為最新的值點，請新增序列覆寫並選取 `Points > true`。若要顯示整個圖形的水平線，請新增序列覆寫，然後選取 `Transform > constant` 如需序列覆寫的詳細資訊，請參閱[系列覆寫](graph-panel.md#graph-panel-series-overrides)。
### 探索中的查詢編輯器
| 名稱 | 描述 |
| --- | --- |
| Query expression | 如需 Prometheus 查詢表達式的詳細資訊，請參閱 [Prometheus 文件](https://prometheus.io/docs/querying/basics/)。 |
| Step | [`Step` Prometheus 範圍查詢的 參數](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries)。您可以在這裡使用時間單位，例如：5s、1m、3h、1d、1y。如果未指定單位，則預設單位為 s（秒）。 |
| Query type | Range, Instant, 或 Both. 執行範圍查詢時，查詢的結果會顯示在圖形和資料表中。即時查詢只會傳回 Prometheus 針對請求的時間序列所抓取的最新值，並顯示在資料表中。選取兩者時，會同時執行即時查詢和範圍查詢。範圍查詢的結果會顯示在圖表中，而即時查詢的結果會顯示在表格中。 |
## 指標瀏覽器
指標瀏覽器可讓您快速尋找指標，並選取相關標籤來建置基本查詢。當您開啟瀏覽器時，您會看到所有可用的指標和標籤。如果您的 Prometheus 執行個體支援，每個指標都會將其 HELP 和 TYPE 顯示為工具提示。
當您選取指標時，瀏覽器會縮小可用的標籤，僅顯示適用於指標的標籤。然後，您可以選取一或多個標籤，可用標籤值會顯示在底部區段的清單中。為每個標籤選取一或多個值，以縮小查詢範圍。
**注意**
如果您不記得開頭的指標名稱，您也可以先選取幾個標籤，縮小清單範圍，然後尋找相關的標籤值。
指標瀏覽器中的所有清單上方都有搜尋欄位，可快速篩選符合特定字串的指標或標籤。值區段只有一個搜尋欄位。其篩選會套用至所有標籤，以協助您在選取標籤之後跨標籤尋找值，例如，在您的標籤應用程式、任務中，只有 job\$1name 可能具有您要尋找的值。
一旦您對查詢感到滿意，請按一下「使用查詢」來執行查詢。**使用做為速率查詢**按鈕會在查詢周圍新增 rate(...)【\$1\$1\$1interval】，以協助撰寫計數器指標的查詢。「驗證選取器」按鈕會向 Prometheus 檢查該選取器有多少時間序列可用。
### 限制
指標瀏覽器的硬性限制為 10，000 個標籤 （索引鍵） 和 50，000 個標籤值 （包括指標名稱）。如果您的 Prometheus 執行個體傳回更多結果，瀏覽器會繼續運作。不過，結果集會中斷超過這些上限。
## 範本化
您可以在指標查詢中使用變數，而不是硬式編碼，例如伺服器、應用程式和感應器名稱。變數會顯示為儀表板頂端的下拉式清單選取方塊。您可以使用這些下拉式方塊來變更儀表板中顯示的資料。
如需範本和範本變數的詳細資訊，請參閱 [範本和變數](templates-and-variables.md)。
### 查詢變數
*查詢*類型的變數可讓您查詢 Prometheus 以取得指標、標籤或標籤值的清單。Prometheus 資料來源外掛程式提供下列函數，您可以在**查詢**輸入欄位中使用。
| 名稱 | 描述 |
| --- | --- |
| label\$1names() | 傳回標籤名稱的清單。 |
| label\$1values(label) | 傳回每個指標label中 的標籤值清單。 |
| label\$1values(metric, label) | 傳回指定指標label中 的標籤值清單。 |
| metrics(metric) | 傳回符合指定 regex metric 的指標清單。 |
| query\$1result(query) | 傳回 的 Prometheus 查詢結果清單query。 |
如需有關什麼是*指標名稱*、*標籤名稱*和*標籤值*的資訊，請參閱 [Prometheus 文件](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels)。
#### 使用間隔和範圍變數
**注意**
`$__range`、 `$__range_s`和 的支援`$__range_ms`僅適用於 Grafana 5.3 版。
您可以在查詢變數中使用一些全域變數：`$__interval`、`$__interval_ms`、`$__range_s`、 `$__range`和 `$__range_ms`。如需詳細資訊，請參閱[全域變數](variables-types.md#global-variables)。當您因為`query_result`函數不支援查詢而必須篩選變數查詢時，這些可以方便地與`label_values`函數搭配使用。
若要在變更儀表板上的時間範圍時取得正確的執行個體，請務必將變數的`refresh`觸發設定為 `On Time Range Change`。
下列程式碼範例示範如何根據儀表板中顯示的時間範圍內的平均 QPS，以最忙碌的五個請求執行個體填入變數。
```
Query: query_result(topk(5, sum(rate(http_requests_total[$__range])) by (instance)))
Regex: /"([^"]+)"/
```
下列程式碼範例示範如何使用 ，在儀表板中顯示的時間範圍內將具有特定狀態的執行個體填入變數`$__range_s`。
```
Query: query_result(max_over_time([${__range_s}s]) != )
Regex:
```
### 使用 `$__rate_interval` 變數
`$__rate_interval` 變數旨在用於 速率函數。其定義為 max( `$__interval` \$1 *Scrape 間隔*，4 \$1 *Scrape 間隔*)。*縮放間隔*是最小步驟設定 (AKA query\$1interval，每個 PromQL 查詢的設定），如果有設定，否則是 Prometheus 資料來源中設定的*縮放間隔* （但忽略面板中的任何最小間隔設定，因為解析度設定會修改後者）。
### 在查詢中使用變數
有兩種語法：
+ `$` 範例： rate(http\$1requests\$1total\$1job=\$1"\$1job"\$1【5m】)
+ `[[varname]]` 範例： rate(http\$1requests\$1total\$1job=\$1"【【job】】"\$1【5m】)
為什麼有兩種方式？ 第一個語法更容易讀取和寫入，但不允許您在單字中間使用變數。啟用*多值*或*包含所有值*選項時，Grafana 會將標籤從純文字轉換為 regex 相容字串。這表示您必須使用 `=~`而非 `=`。
## 註釋
您可以使用註釋在圖形上方覆蓋豐富的事件資訊。您可以使用儀表板功能表或註釋檢視來新增註釋查詢。如需詳細資訊，請參閱[註釋](dashboard-annotations.md)。
Prometheus 支援兩種查詢註釋的方式。
+ 一般指標查詢
+ 待定和觸發提醒的 Prometheus 查詢。如需詳細資訊，請參閱[在執行時間檢查提醒](https://prometheus.io/docs/prometheus/latest/configuration/alerting_rules/#inspecting-alerts-during-runtime))。
步驟選項有助於限制從查詢傳回的事件數量。
# 視覺化來自 Amazon Managed Service for Prometheus 的提醒
您可以透過為已連線的 Prometheus 資料來源設定 Alertmanager 資料來源，在 Amazon Managed Grafana 中視覺化 Amazon Managed Service for Prometheus 或 Prometheus 提醒。
**先決條件**
若要設定 Alertmanager 以搭配 Amazon Managed Service for Prometheus 使用，您必須完成下列先決條件：
+ [Amazon Managed Service for Prometheus](https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-onboard-create-workspace.html) 執行個體，具有擷取指標，並至少設定一個提醒或記錄規則。您將需要工作區的 URL （從 Amazon Managed Service for Prometheus 中工作區的詳細資訊，您可以看到**端點** URL。 工作區 URl 是端點 URL，結尾沒有 `api/v1/remote_write` )。
+ 使用[設定為資料來源](prometheus-data-source.md)的 Prometheus 執行個體[建立](AMG-create-workspace.md)的 Amazon Managed Grafana 工作區。
+ Amazon Managed Grafana 必須具備下列許可才能使用您的 Prometheus 資源。您必須將這些政策新增至中 [AWS 資料來源的 Amazon Managed Grafana 許可和政策](AMG-manage-permissions.md) 所述的服務管理或客戶管理政策。
+ `aps:ListRules`
+ `aps:ListAlertManagerSilences`
+ `aps:ListAlertManagerAlerts`
+ `aps:GetAlertManagerStatus`
+ `aps:ListAlertManagerAlertGroups`
+ `aps:PutAlertManagerSilences`
+ `aps:DeleteAlertManagerSilence`
**設定與 Amazon Managed Service for Prometheus 搭配使用的 Alertmanager 資料來源**
1. 在 Grafana 主控台的 Grafana 功能表中，選擇**組態**下的**資料來源**頁面。
1. 選擇**新增資料來源**，然後從資料來源類型清單中選擇**警示管理員**。
1. 為您的新資料來源提供下列資訊。
+ 針對**實作**，選擇 **Prometheus**。
+ 在 **HTTP** 下，針對 **URL**，提供`alertmanager`附加的 Prometheus 工作區 URL。例如 `https://aps-workspaces.us-east1.amazonaws.com/workspaces/ws-example-1234-5678-abcd-xyz00000001/alertmanager`。
+ 在**驗證**下，開啟 **SigV4Auth**。這告訴 Grafana 對請求使用[AWS 身份驗證](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html)。
+ 在 **SigV4Auth 詳細資料**下，對於**預設區域**，提供您 Prometheus 執行個體的區域，例如 `us-east-1`。
1. 選擇**儲存並測試**以完成資料來源設定。
如果您的資料來源設定正確，您會看到一則訊息，指出**運作狀態檢查已通過**。
**將新的 Alertmanager 資料來源連線至 Prometheus 資料來源**
1. 在 Grafana 主控台的 Grafana 功能表中，選擇**組態**下的**資料來源**頁面。
1. 選取原始 Amazon Managed Service for Prometheus 資料來源，並透過**警示 UI 切換開關開啟管理提醒**。
1. 選擇**儲存並測試**以完成資料來源的設定。
# 設定範例
**注意**
此功能需要 Prometheus 2.26 版或更新版本。
Amazon Managed Service for Prometheus 不支援範例。
您可以在探索和儀表板中將範例資料與指標一起顯示。範例會將來自特定事件的較高基數中繼資料與傳統時間序列資料建立關聯。
您可以在資料來源設定中設定範例，方法是將連結新增至您的範例。您可以在 URL 中使用巨集。例如，您可以建立 URL，例如 `https://example.com/${__value.raw}`。
# 連線至 Amazon Timestream 資料來源
**注意**
在支援第 9 版或更新版本的工作區中，此資料來源可能需要您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
透過 Amazon Managed Grafana，您可以使用 Grafana 工作區主控台中的資料來源組態選項，將 Amazon Timestream 新增為 AWS 資料來源。此功能可探索現有的 Timestream 帳戶，並管理存取 Timestream 所需的身分驗證憑證組態，以簡化將 Timestream 新增為資料來源的程序。您可以使用此方法設定身分驗證，並將 Timestream 新增為資料來源，也可以使用與自我管理 Grafana 伺服器上相同的方法手動設定資料來源和必要的身分驗證憑證。
# 使用 AWS 資料來源組態將 Timestream 新增為資料來源
若要使用 AWS 資料來源組態，請先使用 Amazon Managed Grafana 主控台來啟用服務受管 IAM 角色，以授予工作區讀取您帳戶或整個組織單位中 Timestream 資源所需的 IAM 政策。然後，您可以使用 Amazon Managed Grafana 工作區主控台將 Timestream 新增為資料來源。
**使用 AWS 資料來源組態將 Timestream 新增為資料來源**
1. 開啟位於 https：//[https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/) 的 Amazon Managed Grafana 主控台。
1. 選擇頁面左上角的功能表圖示，然後選擇**所有工作區**。
1. 選擇工作區的名稱。
1. 如果您在建立工作空間時未選擇對此工作空間使用服務受管許可，則從使用客戶受管許可變更為使用服務受管許可，以確保在 Grafana 工作空間主控台中使用 AWS 資料來源組態選項啟用適當的 IAM 角色和政策。若要這樣做，請選擇依 **IAM 角色**編輯圖示，然後選擇**服務受管**、**儲存變更**。如需詳細資訊，請參閱[AWS 資料來源的 Amazon Managed Grafana 許可和政策](AMG-manage-permissions.md)。
1. 選擇**資料來源**索引標籤。然後選取 **Amazon Timestream** 的核取方塊，然後選擇**動作**、**啟用服務受管政策**。
1. 再次選擇**資料來源**索引標籤，然後在 **Amazon Timestream** 列中選擇在 **Grafana 中設定**。
1. 如有必要，請使用 IAM Identity Center 登入 Grafana 工作區主控台。
1. 在 Grafana 工作區主控台的左側導覽列中，選擇**應用程式**和**AWS 資料來源 **（在 Grafana v8 中，從左側選單中選擇 AWS 圖示）。
1. 選擇**AWS 服務**索引標籤，然後選擇 **Timestream**。
1. 選取您希望 **Timestream** 資料來源查詢的預設區域，選取帳戶，然後選擇**新增資料來源**。
# 手動新增 Timestream 資料來源
**手動新增 Timestream 資料來源**
1. 在 Grafana 主控台側邊選單中，暫停**組態** （齒輪） 圖示，然後選擇**資料來源**。
1. 選擇**新增資料來源**。
1. 選擇 **Amazon Timestream** 資料來源。如有必要，您可以開始**Timestream**在搜尋方塊中輸入 ，以協助您找到它。
## Timestream 設定
| 名稱 | 描述 |
| --- | --- |
| Name | 資料來源名稱。這是您在面板和查詢中看到資料來源的方式。 |
| 驗證提供者 | 指定要取得登入資料的提供者。 |
| 預設區域 | 在查詢編輯器中用於設定區域 （可以根據每個查詢進行變更）。 |
| 登入資料設定檔名稱 | 指定要使用的設定檔名稱 （如果您使用 \$1/.aws/credentials 檔案），預設請保留空白。 |
| 擔任角色 Arn | 指定要擔任的角色的 ARN。 |
| 端點 （選用） | 如果您必須指定替代服務端點。 |
### 身分驗證
本節涵蓋可用於 Amazon Timestream 資料來源的不同身分驗證類型。
#### AWS 登入資料範例
您無法在 Amazon Managed Grafana 中使用登入資料檔案驗證方法。
# 使用 Timestream 資料來源
## 查詢編輯器
除了先前列出的巨集和任何儀表板範本變數之外，查詢編輯器接受 Timestream 語法。
按 **Ctrl\$1Space** 開啟 IntelliSense 建議。
## 巨集
為了簡化語法並允許動態部分，例如日期範圍篩選條件，查詢可以包含巨集。
| 巨集範例 | Description |
| --- | --- |
| *\$1\$1\$1 資料庫* | 將指定選取的資料庫。這會使用資料來源組態中的預設值，或查詢編輯器中的明確值。 |
| *\$1\$1\$1table* | 將指定選取的資料庫。這會使用資料來源組態中的預設值，或查詢編輯器中的明確值。 |
| *\$1\$1\$1量值* | 將指定選取的量值。這會使用資料來源組態中的預設值，或查詢編輯器中的明確值。 |
| *\$1\$1\$1timeFilter* | 將由將時間限制在儀表板範圍的表達式取代 |
| *\$1\$1\$1interval\$1ms* | 將由代表圖形中單一像素應涵蓋的時間量的數字取代。 |
# 連線至 Amazon Athena 資料來源
**注意**
在支援第 9 版或更新版本的工作區中，此資料來源可能需要您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
**注意**
本指南假設在使用 Athena 資料來源之前，您已熟悉 Amazon Athena 服務。
透過 Amazon Managed Grafana，您可以使用 Grafana 工作區主控台中的資料來源組態選項，將 Athena 新增為 AWS 資料來源。此功能可探索現有的 Athena 帳戶，並管理存取 Athena 所需的身分驗證憑證組態，以簡化將 Athena 新增為資料來源的程序。您可以使用此方法來設定身分驗證，並將 Athena 新增為資料來源，也可以使用與自我管理 Grafana 伺服器上相同的方法手動設定資料來源和必要的身分驗證憑證。
Athena 有先決條件可供 Amazon Managed Grafana 存取。如需使用 Athena 資料來源與 相關聯的先決條件，請參閱 [先決條件](Athena-prereq.md)。
# 先決條件
若要使用 Amazon Managed Grafana for Athena 的受管政策，請先完成下列任務，再設定 Athena 資料來源：
+ 使用 標記您的 Athena 工作群組`GrafanaDataSource: true`。
+ 建立名稱開頭為 的 S3 儲存貯體`grafana-athena-query-results-`。此政策提供將查詢結果寫入具有該命名慣例的 S3 儲存貯體的許可。
此受管政策不包含存取 Athena 查詢基礎資料來源的 Amazon S3 許可。您必須根據case-by-case手動新增 Amazon S3 儲存貯體的必要許可。如需詳細資訊，請參閱本指南[中 Amazon Managed Grafana 中的身分型政策範例](https://docs.aws.amazon.com/grafana/latest/userguide/security_iam_id-based-policy-examples.html)。
# 使用 AWS 資料來源組態將 Amazon Athena 新增為資料來源
## 先決條件
+ [AWS CLI ](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) 已安裝並設定在您的環境中。
+ 您可以從您的帳戶存取 Athena。
若要使用 AWS 資料來源組態，請先前往 Amazon Managed Grafana 主控台，以啟用服務受管 IAM 角色，將讀取您帳戶或整個組織單位中 Athena 資源所需的 IAM 政策授予工作區。然後，您可以使用 Amazon Managed Grafana 工作區主控台將 Athena 新增為資料來源。
# 使用 AWS 資料來源組態將 Athena 新增為資料來源
1. 確保您的使用者角色是管理員或編輯器。
1. 從 Amazon Managed Grafana 主控台選取您要使用的工作區，網址為 https：//[https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)。
1. 如果您在建立工作空間時未選擇對此工作空間使用服務受管許可，則從使用客戶受管許可變更為使用服務受管許可，以確保在 Grafana 工作空間主控台中使用 AWS 資料來源組態選項啟用適當的 IAM 角色和政策。若要這樣做，請選擇依 **IAM 角色**編輯圖示，然後選擇**服務受管**、**儲存變更**。如需詳細資訊，請參閱[AWS 資料來源的 Amazon Managed Grafana 許可和政策](AMG-manage-permissions.md)。
1. 選擇**資料來源**索引標籤。然後選取 **Amazon Athena** 的核取方塊，然後選擇**動作**、**啟用服務受管政策**。
1. 再次選擇**資料來源**索引標籤，然後在 **Amazon Athena** 列中選擇在 **Grafana 中設定**。
1. 如有必要，請使用 IAM Identity Center 登入 Grafana 工作區主控台。使用者應該將 Athena 存取政策連接到使用者/角色，才能存取 Athena 資料來源。如需更多詳細資訊，請參閱 [AWS 受管政策：AmazonGrafanaAthenaAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaAthenaAccess)。
1. 在 Grafana 工作區主控台的左側導覽列中，選擇下方 AWS 圖示 （有兩個），然後從**資料來源**功能表中選擇 **Athena**。
1. 選取您希望 Athena 資料來源查詢的預設區域，然後選取您想要的帳戶，然後選擇**新增資料來源**。
1. 依照步驟在 中設定 **Athena 詳細資訊** [**Athena 詳細資訊**設定](#Athena-settings)
## **Athena 詳細資訊**設定
**設定 **Athena 詳細資訊**設定**
1. 在**連線詳細資訊**功能表中，選取身分驗證提供者 （建議：**工作區 IAM 角色**)。
1. 選取您擁有 Athena 帳戶的目標 Athena 資料來源。如果您未選取任何資料來源，則下拉式清單中會有預設資料來源。
若要建立新的 Athena 帳戶，請遵循 [Athena 入門](https://docs.aws.amazon.com/athena/latest/ug/getting-started.html)中的指示
1. 在上述選取的資料來源中選取目標 Athena 資料庫。
1. 選取工作群組。**主要** 預設為 。
1. 如果您的工作群組尚未設定輸出位置，請指定要用於查詢結果的 S3 儲存貯體和資料夾。例如 `s3://grafana-athena-plugin-test-data/query-result-output/ `
1. 選取**儲存並測試**。
# 手動新增 Athena 資料來源
## 先決條件
+ [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) 已安裝並設定在您的環境中。
+ 您可以從您的帳戶存取 **Amazon Athena**。
**若要手動新增 Athena 資料來源：**
1. 在 Grafana 主控台側邊選單中，暫停**組態** （齒輪） 圖示，然後選擇**資料來源**。
1. 選擇**新增資料來源**。
1. 選擇 **AWS Athena** 資料來源。如有必要，您可以開始**Athena**在搜尋方塊中輸入 ，以協助您找到它。
1. 在**連線詳細資訊**功能表中，設定身分驗證提供者 （建議：**工作區 IAM 角色**)
1. 選取目標 Athena 資料來源、資料庫和工作群組。
若要建立新的 Athena 帳戶，請遵循 [Athena 入門](https://docs.aws.amazon.com/athena/latest/ug/getting-started.html)中的指示。
1. 如果您的工作群組尚未設定輸出位置，請指定要用於查詢結果的 S3 儲存貯體和資料夾。例如 `s3://grafana-athena-plugin-test-data/query-result-output/ `。
1. 選取**儲存並測試**。
以下是 **Athena 詳細資訊**設定的範例。
![\[Athena 詳細資訊範例\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/images/athena.png)
# 使用 Athena 資料來源
## IAM 政策
Grafana 需要透過 IAM 授予的許可，才能讀取 Athena 指標。您可以將這些許可連接到 IAM 角色，並利用 Grafana 的內建支援來擔任角色。請注意，您必須先設定角色[所需的政策，](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)才能將資料來源新增至 Grafana。您需要管理員或編輯器角色來新增資料來源。內建 Amazon Grafana Athena 存取政策在 [AWS 受管政策：AmazonGrafanaAthenaAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaAthenaAccess)區段中定義。
## 查詢 Athena 資料
Athena 資料來源提供標準 SQL 查詢編輯器。Amazon Managed Grafana 包含一些巨集，可協助撰寫更複雜的時間序列查詢。
巨集
| 巨集 | Description | 範例 | 輸出範例 |
| --- | --- | --- | --- |
| \$1\$1\$1dateFilter(column) | \$1\$1\$1dateFilter 會根據面板的日期範圍，建立條件式篩選條件來選取資料 （使用 column)。 | \$1\$1\$1date(my\$1date) | my\$1date BETWEEN date '2017-07-18' AND date '2017-07-18' |
| \$1\$1\$1parseTime(column,format) | \$1\$1\$1parseTime 會將 varchar 轉換為具有指定格式的時間戳記。 | \$1\$1\$1parseTime(eventtime, 'yyyy-MM-dd''T''HH:mm:ss''Z') | parse\$1datetime(time,'yyyy-MM-dd''T''HH:mm:ss''Z') |
| \$1\$1\$1timeFilter(column,format) | \$1\$1\$1timeFilter 會建立條件式，根據面板的時間範圍篩選資料 （使用 column )。第二個引數用於選擇性地將資料欄從 varchar 剖析為具有特定格式的時間戳記。 | \$1\$1\$1timeFilter(time, 'yyyy-MM-dd HH:mm:ss') | TIMESTAMP time BETWEEN TIMESTAMP '2017-07-18T11:15:52Z' AND TIMESTAMP '2017-07-18T11:15:52Z' |
| \$1\$1\$1timeFrom() | \$1\$1\$1timeFrom 會使用引號輸出面板範圍的目前開始時間。 | \$1\$1\$1timeFrom() | TIMESTAMP '2017-07-18 11:15:52' |
| \$1\$1\$1timeTo() | \$1\$1\$1timeTo 會使用引號輸出面板範圍的目前結束時間。 | \$1\$1\$1timeTo() | TIMESTAMP '2017-07-18 11:15:52' |
| \$1\$1\$1timeGroup(column, '1m', format) | \$1\$1\$1timeGroup 群組時間戳記，因此圖形上的每個期間只有 1 點。第三個引數用於選擇性地將資料欄從 varchar 剖析為具有特定格式的時間戳記。 | \$1\$1\$1timeGroup(time,'5m','yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z') | FROM\$1UNIXTIME(FLOOR(TO\$1UNIXTIME(parse\$1datetime(time,'yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z'))/300)\$1300) |
| \$1\$1\$1table | \$1\$1\$1table 傳回在資料表選取器中選取的資料表。 | \$1\$1\$1table | my\$1table |
| \$1\$1\$1column | \$1\$1\$1column 傳回在資料欄選取器中選取的資料欄 （需要資料表）。 | \$1\$1\$1column | col1 |
**視覺化**
Athena 中的大多數查詢最好以資料表視覺化呈現。查詢會在資料表中顯示傳回資料。如果可以查詢，則可以將其顯示為資料表。
此範例會傳回資料表視覺化的結果：
```
SELECT {column_1}, {column_2} FROM {table};
```
**時間序列/圖形視覺化 **
對於時間序列和圖形視覺化，您必須：
+ 選取具有 `date`或 `datetime`類型的資料欄。資料`date`欄必須依遞增順序排列 （使用 `ORDER BY column ASC`)。
+ 也會選取數值欄。
**檢查查詢 **
Amazon Managed Grafana 支援 Athena 不支援的巨集，這表示直接複製並貼入 Athena 時，查詢可能無法運作。若要檢視直接在 Athena 中運作的完整插補查詢，請按一下**查詢檢查器**按鈕。完整查詢會顯示在**查詢**索引標籤下。
## 範本和變數
如需新增 Athena 查詢變數的詳細資訊，請參閱 [新增查詢變數](variables-types.md#add-a-query-variable)。使用 Athena 資料來源做為可用查詢的資料來源。
從 Athena 資料表查詢的任何值都可以用作變數。避免選取太多值，因為這可能會導致效能問題。
建立變數之後，您可以使用 在 Athena 查詢中使用它[變數語法](templates-and-variables.md#variable-syntax)。如需變數的詳細資訊，請參閱 [範本和變數](templates-and-variables.md)。
## 註釋
[註釋](dashboard-annotations.md) 可讓您在圖形上方疊加豐富的事件資訊。您可以透過選取面板或使用**儀表板**功能表註釋檢視新增註釋查詢來新增**註釋**。
自動新增註釋的範例查詢：
```
SELECT
time as time,
environment as tags,
humidity as text
FROM
tableName
WHERE
$__dateFilter(time) and humidity > 95
```
下表代表可用於轉譯註釋的資料欄描述：
| 名稱 | 描述 |
| --- | --- |
| Time | 日期/時間欄位的名稱。可以是具有原生 SQL 日期/時間資料類型或 epoch 值的資料欄。 |
| Timeend | 結束日期/時間欄位的選用名稱。可以是具有原生 SQL 日期/時間資料類型或 epoch 值的資料欄。(Grafana v6.6\$1) |
| Text | 事件描述欄位。 |
| Tags | 用於事件標籤的選用欄位名稱，做為逗號分隔字串。 |
## 非同步查詢資料支援
Amazon Managed Grafana 中的 Athena 查詢會以非同步方式處理，以避免逾時。非同步查詢使用單獨的請求來啟動查詢，然後檢查其進度，最後擷取結果。這可避免長時間執行的查詢逾時。
## 查詢結果重複使用
您可以重複使用先前查詢的結果，以改善查詢效能。若要啟用查詢重複使用，請在查詢編輯器的**查詢結果重複使用**區段中啟用 。這必須針對您要重複使用查詢的每個查詢完成。
**注意**
此功能需要您的 Athena 執行個體位於引擎版本 3。如需詳細資訊，請參閱《*Amazon Athena * [Athena 使用者指南》中的變更 Athena 引擎版本](https://docs.aws.amazon.com/athena/latest/ug/engine-versions-changing.html)。
# 連線至 Amazon Redshift 資料來源
**注意**
在支援第 9 版或更新版本的工作區中，此資料來源可能需要您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
**注意**
本指南假設使用者在使用 Amazon Redshift 資料來源之前熟悉 Amazon Redshift 服務。
使用 Amazon Managed Grafana，您可以使用 Grafana 工作區主控台中的 AWS 資料來源組態選項，將 Amazon Redshift 新增為資料來源。此功能可探索現有的 Amazon Redshift 帳戶，並管理存取 Amazon Redshift 所需的身分驗證憑證組態，以簡化將 Amazon Redshift 新增為資料來源的程序。您可以使用此方法來設定身分驗證，並將 Amazon Redshift 新增為資料來源，也可以使用與自我管理 Grafana 伺服器上相同的方法來手動設定資料來源和必要的身分驗證憑證。
Amazon Managed Grafana 有存取 Amazon Redshift 的先決條件。如需使用 Amazon Redshift 資料來源與 相關聯的先決條件，請參閱 [先決條件](Redshift-prereq.md)。
# 先決條件
若要使用 Amazon Managed Grafana 的 AWS 受管政策，請先完成下列任務，再設定 Amazon Redshift 資料來源：
+ 使用 標記您的 Amazon Redshift 叢集`GrafanaDataSource: true`。否則，將無法存取。
+ 以下列其中一個互斥方式建立資料庫登入資料：
+ 如果您想要使用預設機制 （臨時登入資料選項） 對 Redshift 資料庫進行身分驗證，您必須建立名為 的資料庫使用者`redshift_data_api_user`。
+ 如果您想要使用 Secrets Manager 的登入資料，您必須使用 標記秘密`RedshiftQueryOwner: true`。如需詳細資訊，請參閱本指南[中 Amazon Managed Grafana 中的身分型政策範例](https://docs.aws.amazon.com/grafana/latest/userguide/security_iam_id-based-policy-examples.html)。
# 使用 AWS 資料來源組態將 Amazon Redshift 新增為資料來源
# 使用 AWS 資料來源組態將 Amazon Redshift 新增為資料來源
1. 確保您的使用者角色是管理員或編輯器。
1. 從 Amazon Managed Grafana 主控台選取您要使用的工作區，網址為 https：//[https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)。
1. 如果您在建立工作空間時未選擇對此工作空間使用服務受管許可，則從使用客戶受管許可變更為使用服務受管許可，以確保在 Grafana 工作空間主控台中使用 AWS 資料來源組態選項啟用適當的 IAM 角色和政策。若要這樣做，請選擇依 **IAM 角色**編輯圖示，然後選擇**服務受管**、**儲存變更**。如需詳細資訊，請參閱[AWS 資料來源的 Amazon Managed Grafana 許可和政策](AMG-manage-permissions.md)。
1. 選擇**資料來源**索引標籤。然後選取 **Amazon Redshift** 的核取方塊，然後選擇**動作**、**啟用服務受管政策**。
1. 再次選擇**資料來源**索引標籤，然後在 **Amazon Redshift** 資料列中選擇**在 Grafana 中設定**。
1. 如有必要，請使用 IAM Identity Center 登入 Grafana 工作區主控台。
1. 在 Grafana 工作區主控台的左側導覽列中，選擇下方 AWS 圖示 （有兩個），然後選擇 **Redshift**。
1. 選取您希望 Amazon Redshift 資料來源查詢的預設區域，然後選取您想要的帳戶，然後選擇**新增資料來源**。
1. 依照步驟在 中設定**連線詳細資訊**[**連線詳細資訊**設定](Redshift-config.md#Redshift-connection-details)。
# 手動新增 Amazon Redshift 資料來源
## 先決條件
+ 您可以從您的帳戶存取 **Amazon Redshift**。
**若要新增 Amazon Redshift 資料來源：**
1. 將 [AmazonRedshiftAccessPolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaRedshiftAccess) 連接至工作區使用者角色。
1. 確保您的使用者角色是管理員或編輯器。
1. 從 Amazon Managed Grafana 主控台選取您要使用的工作區，網址為 https：//[https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)。
1. 在 Grafana 主控台側邊選單中，暫停**組態** （齒輪） 圖示，然後選擇**資料來源**。
1. 選擇**新增資料來源**。
1. 選擇 **AWS Redshift** 資料來源。如有必要，您可以開始**Redshift**在搜尋方塊中輸入 ，以協助您找到它。
1. 這會開啟**連線詳細資訊**頁面。請遵循設定 的步驟[**連線詳細資訊**設定](Redshift-config.md#Redshift-connection-details)。
# 設定 Amazon Redshift
將 Amazon Redshift 資料來源新增至工作區後，請設定 Amazon Redshift 設定，如下所示：
## 先決條件
+ 您可以從您的帳戶存取 **Amazon Redshift**。
## **連線詳細資訊**設定
**設定連線詳細資訊設定**
1. 在**連線詳細資訊**功能表中，選取身分驗證提供者 （建議：**工作區 IAM 角色**)。
1. 選擇您要查詢**的預設區域**。
## **身分驗證**設定
**設定**身分驗證**設定**
1. 在**身分驗證**功能表中，選擇**暫時登入**資料或 **AWS Secrets Manager** 索引標籤做為您的存取登入資料提供者。如需暫時登入資料和 AWS Secrets Manager 的詳細資訊，請參閱 [AWS 受管政策：AmazonGrafanaRedshiftAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaRedshiftAccess)
1. 如果您選擇預設的**暫時登入**資料，請遵循下列步驟。如果您選擇 **AWS Secrets Manager**，請在輸入欄位中輸入 **AWS Secrets Manager** 登入資料。
1. 選擇您在 Amazon Redshift 中建立之叢集的**叢集識別符**。
如需 Redshift 叢集的詳細資訊，請參閱 [ Redshift 連線](https://docs.aws.amazon.com/redshift/latest/gsg/connection.html)。
1. 選擇您的目標 Redshift 資料庫。
1. 選取您為上述叢集建立的資料庫使用者。
1. 選擇**儲存並測試**。
以下是**暫時登入**資料設定的範例。
![\[暫時登入資料範例\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/images/redshift.png)
以下是 **AWS Secrets Manager** 功能表的範例。
![\[Secrets Manager 範例\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/images/secretsmanager.png)
# 使用 Amazon Redshift 資料來源
## IAM 政策
Grafana 需要使用 IAM 授予的許可，才能讀取 Redshift 指標。您可以將這些許可連接到 IAM 角色，並利用 Grafana 的內建支援來擔任角色。內建 Amazon Grafana Redshift 存取政策在 [AWS 受管政策：AmazonGrafanaRedshiftAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaRedshiftAccess)區段中定義。
## 查詢 Amazon Redshift 資料
Amazon Redshift 資料來源提供標準 SQL 查詢編輯器。Amazon Managed Grafana 包含一些巨集，以協助撰寫更複雜的時間查詢。
巨集
| 巨集 | Description | 輸出範例 |
| --- | --- | --- |
| \$1\$1\$1timeEpoch(column) | \$1\$1\$1timeEpoch 將由表達式取代，以轉換為 UNIX 時間戳記，並將資料欄重新命名為時間 | UNIX\$1TIMESTAMP(dateColumn) as "time" |
| \$1\$1\$1timeFilter(column) | \$1\$1\$1timeFilter會根據面板的時間範圍建立條件式來篩選資料 （使用 column) | time BETWEEN '2017-07-18T11:15:52Z' AND '2017-07-18T11:15:52Z' |
| \$1\$1\$1timeFrom() | \$1\$1\$1timeFrom 會使用引號輸出面板範圍的目前開始時間 | '2017-07-18T11:15:52Z' |
| \$1\$1\$1timeTo() | \$1\$1\$1timeTo 會使用引號輸出面板範圍的目前結束時間 | '2017-07-18T11:15:52Z' |
| \$1\$1\$1timeGroup(column, '1m') | \$1\$1\$1timeGroup 群組時間戳記，因此圖形上的每個期間只有 1 點 | floor(extract(epoch from time)/60)\$160 AS "time" |
| \$1\$1\$1schema | \$1\$1\$1schema 使用選取的結構描述 | public |
| \$1\$1\$1table | \$1\$1\$1table 從指定的 輸出資料表 \$1\$1\$1schema（預設使用公有結構描述） | sales |
| \$1\$1\$1column | \$1\$1\$1column 從目前的 輸出資料欄 \$1\$1\$1table | date |
| \$1\$1\$1unixEpochFilter(column) | \$1\$1\$1unixEpochFilter 使用指定的資料欄名稱取代為時間範圍篩選條件，時間以 Unix 時間戳記表示 | column >= 1624406400 AND column <= 1624410000 |
| \$1\$1\$1unixEpochGroup(column) | \$1\$1\$1unixEpochGroup 與 相同，\$1\$1\$1timeGroup但時間儲存為 Unix 時間戳記 | floor(time/60)\$160 AS "time" |
**視覺化**
Redshift 中的大多數查詢最好以資料表視覺化呈現。任何查詢都會在資料表中顯示資料。如果可以查詢，則可以放在資料表中。
此範例會傳回資料表視覺化的結果：
```
SELECT {column_1}, {column_2} FROM {table};
```
**時間序列和圖形視覺化 **
對於時間序列和圖形視覺化，有幾個需求：
+ 必須選取具有 `date`或 `datetime`類型的資料欄。
+ 資料`date`欄必須按遞增順序 （使用 `ORDER BY column ASC`)。
+ 您必須選取數值欄。
若要建立更合理的圖形，請務必使用 `$__timeFilter`和 `$__timeGroup`巨集。
**範例 timeeries 查詢：**
```
SELECT
avg(execution_time) AS average_execution_time,
$__timeGroup(start_time, 'hour'),
query_type
FROM
account_usage.query_history
WHERE
$__timeFilter(start_time)
group by
query_type,start_time
order by
start_time,query_type ASC;
```
**填充模式**
Grafana 也會自動完成沒有預設值的影格。若要設定此值，請在查詢編輯器中變更**填滿值**。
**檢查查詢**
由於 Grafana 支援 Redshift 不支援的巨集，因此可以直接複製並貼入 Redshift 的完整轉譯查詢會顯示在查詢檢查器中。若要檢視完整插補查詢，請選擇**查詢檢查器**功能表，而完整查詢會顯示在**查詢**索引標籤上。
## 範本和變數
如需如何新增 Redshift 查詢變異的詳細資訊，請參閱 [新增查詢變數](variables-types.md#add-a-query-variable)。使用 Redshift 資料來源做為可用查詢的資料來源。
從 Amazon Redshift 資料表查詢的任何值都可以用作變數。請務必避免選取太多值，因為這可能會導致效能問題。
建立變數之後，您可以使用 在 Redshift 查詢中使用它[變數語法](templates-and-variables.md#variable-syntax)。如需變數的詳細資訊，請參閱 [範本和變數](templates-and-variables.md)。
## 註釋
[註釋](dashboard-annotations.md) 可讓您在圖形上方疊加豐富的事件資訊。您可以透過選取面板或使用從儀表板****功能表開啟的註釋檢視新增註釋查詢來新增**註釋**。
自動新增註釋的查詢範例：
```
SELECT
time as time,
environment as tags,
humidity as text
FROM
$__table
WHERE
$__timeFilter(time) and humidity > 95
```
下表代表考量到轉譯註釋的資料欄值：
| 名稱 | 描述 |
| --- | --- |
| Time | 日期或時間欄位的名稱。可以是具有原生 SQL 日期或時間資料類型或 epoch 值的資料欄。 |
| Timeend | 結束日期或時間欄位的選用名稱。可以是具有原生 SQL 日期或時間資料類型或 epoch 值的資料欄。 |
| Text | 事件描述欄位。 |
| Tags | 用於事件標籤的選用欄位名稱，做為逗號分隔字串。 |
# 連線至 AWS X-Ray 資料來源
**注意**
在支援第 9 版或更新版本的工作區中，此資料來源可能需要您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
新增 AWS X-Ray 做為資料來源，然後建置儀表板或使用 探索搭配 X-Ray 來查看追蹤、分析或洞見。
使用 Amazon Managed Grafana，您可以使用 Grafana 工作區主控台中的 AWS 資料來源組態選項，將 X-Ray 新增為資料來源。此功能可探索您現有的 X-Ray 帳戶，並管理存取 X-Ray 所需的身分驗證憑證組態，以簡化將 X-Ray 新增為資料來源的程序。您可以使用此方法來設定身分驗證，並將 X-Ray 新增為資料來源，也可以使用與自我管理 Grafana 伺服器上相同的方法來手動設定資料來源和必要的身分驗證憑證。
**Topics**
+ [使用 AWS 資料來源組態將 X-Ray 新增為資料來源](xray-adding-AWS-config.md)
+ [手動新增 X-Ray 資料來源](xray-add-the-data-source.md)
+ [X-Ray 設定](#xray-settings)
+ [使用 X-Ray 資料來源](xray-using.md)
# 使用 AWS 資料來源組態將 X-Ray 新增為資料來源
若要使用 AWS 資料來源組態，請先使用 Amazon Managed Grafana 主控台來啟用服務受管 IAM 角色，以授予工作區讀取您帳戶或整個組織單位中 X-Ray 資源所需的 IAM 政策。然後，您可以使用 Amazon Managed Grafana 工作區主控台將 X-Ray 新增為資料來源。
**使用 AWS 資料來源組態將 X-Ray 新增為資料來源**
1. 開啟位於 https：//[https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/) 的 Amazon Managed Grafana 主控台。
1. 選擇頁面左上角的功能表圖示，然後選擇**所有工作區**。
1. 選擇工作區的名稱。
1. 如果您在建立工作空間時未選擇對此工作空間使用服務受管許可，則從使用客戶受管許可變更為使用服務受管許可，以確保在 Grafana 工作空間主控台中使用 AWS 資料來源組態選項啟用適當的 IAM 角色和政策。若要執行此作業，請依 **IAM 角色**選擇編輯圖示，然後選擇**服務受管**、**儲存變更**。如需詳細資訊，請參閱[AWS 資料來源的 Amazon Managed Grafana 許可和政策](AMG-manage-permissions.md)。
1. 選擇**資料來源**索引標籤。然後選取 的核取方塊**AWS X-Ray**，然後選擇**動作**、**啟用服務受管政策**。
1. 再次選擇**資料來源**索引標籤，然後在資料**AWS X-Ray**列中選擇在 **Grafana 中設定**。
1. 如有必要，請使用 IAM Identity Center 登入 Grafana 工作區主控台。
1. 在 Grafana 工作區主控台的左側導覽列中，選擇 AWS 圖示，然後選擇**AWS 服務** **X-Ray**。
1. 選取您希望 X-Ray 資料來源查詢的預設區域，選取帳戶，然後選擇**新增資料來源**。
# 手動新增 X-Ray 資料來源
**手動新增 X-Ray 資料來源**
1. 在 Grafana 主控台側邊選單中，暫停**組態** （齒輪） 圖示，然後選擇**資料來源**。
1. 選擇**新增資料來源**。
1. 選擇 **X-Ray** 資料來源。如有必要，您可以開始**X-Ray**在搜尋方塊中輸入 ，以協助您找到它。
## X-Ray 設定
| 名稱 | 描述 |
| --- | --- |
| Name | 資料來源名稱。這是您在面板和查詢中查看資料來源的方式。 |
| 預設 | 預設資料來源表示將針對新面板預先選取。 |
| 預設區域 | 在查詢編輯器中用於設定區域 （可以根據每個查詢進行變更）。 |
| 驗證提供者 | 指定要取得登入資料的提供者。 |
| 登入資料設定檔名稱 | 指定要使用的設定檔名稱 （如果您使用 \$1/.aws/credentials 檔案），預設請保留空白。 |
| 擔任角色 Arn | 指定要擔任的角色的 ARN。 |
| 外部 ID | 如果您在另一個帳戶中擔任角色，而該帳戶已使用外部 ID 建立，請在此處指定外部 ID。 |
### 身分驗證
本節涵蓋可用於 X-Ray 資料來源的不同身分驗證類型。
#### IAM 角色
目前，Grafana 工作區後端會使用官方 AWS SDK 完成對 X-Ray 的所有存取。如果您的 Grafana 伺服器正在執行 AWS，您可以使用 IAM 角色，且會自動處理身分驗證。
如需詳細資訊，請參閱 [IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)。
### IAM 政策
Grafana 需要透過 IAM 授予的許可，才能讀取 X-Ray 資料和 EC2 tags/instances/regions。您可以將這些許可連接到 IAM 角色，並使用內建的 Grafana 支援來擔任角色。
下列程式碼範例顯示最少的政策。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"xray:BatchGetTraces",
"xray:GetTraceSummaries",
"xray:GetTraceGraph",
"xray:GetGroups",
"xray:GetTimeSeriesServiceStatistics",
"xray:GetInsightSummaries",
"xray:GetInsight",
"ec2:DescribeRegions"
],
"Resource": "*"
}
]
}
```
------
#### AWS 登入資料範例
您無法在 Amazon Managed Grafana 中使用登入資料檔案方法。
# 使用 X-Ray 資料來源
## 查詢編輯器
編輯器中最重要的欄位是查詢類型。有四種查詢類型：
+ 追蹤清單 ( 中的追蹤 AWS)
+ 追蹤統計資料
+ 追蹤分析 ( 中的分析 AWS)
+ 洞見
## 追蹤清單
追蹤清單類型可讓您搜尋顯示在資料表中的追蹤。在第一欄中選擇追蹤 ID 會在右側開啟追蹤。請注意編輯器中的查詢欄位。您可以撰寫查詢、篩選表達式，也可以插入將在追蹤檢視中顯示的單一追蹤 ID。如需篩選條件表達式的詳細資訊，請參閱 [AWS X-Ray 文件](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-filters.html)。
**注意**
追蹤清單只會顯示前 1000 個追蹤。
## 追蹤統計資料
在追蹤統計資料中，您可以看到圖表和資料表，其中顯示錯誤、故障、調節、成功和總計數的相關資訊。您可以使用查詢編輯器中的資料欄欄位，只查看指定的資料欄。
## Trace Analytics
在 Trace Analytics 中，您可以視覺化下列資料表。
+ 根本原因
+ 回應時間
+ 根本原因服務 （路徑中的最後一個服務）
+ 路徑 （多個路徑）
+ 錯誤
+ 根本原因服務 （路徑中的最後一個服務）
+ 路徑
+ 錯誤訊息
+ 故障
+ 根本原因服務 （路徑中的最後一個服務）
+ 路徑
+ 錯誤訊息
+ 最終使用者影響
+ URL
+ HTTP 狀態碼
## 洞見
在 Insights 中，您可以查看 Insights 的摘要資料表。選擇 InsightId 將帶您前往 AWS 管理主控台。
## 提醒
由於 X-Ray 查詢可以傳回數值資料，因此支援提醒。如需詳細資訊，請參閱[Grafana 提醒](alerts-overview.md)。
# 連線至 Azure Monitor 資料來源
Azure Monitor 資料來源支援 Azure 雲端中的多項服務：
+ **Azure Monitor 服務**是平台服務，提供單一來源來監控 Azure 資源。如需詳細資訊，請參閱[查詢 Azure Monitor 服務](#query-the-azure-monitor-service)。
+ **Application Insights 伺服器**是適用於多個平台上 Web 開發人員的可擴展應用程式效能管理 (APM) 服務，可用於監控即時 Web 應用程式，它會自動偵測效能異常。如需詳細資訊，請參閱[查詢 Application Insights Analytics 服務](#query-the-application-insights-analytics-service)。
+ **Azure Log Analytics** （或 Azure Logs) 可讓您存取 Azure Monitor 所收集的日誌資料。如需詳細資訊，請參閱[查詢 Azure Log Analytics 服務](#querying-the-azure-log-analytics-service)。
+ 使用 **Application Insights Analytics 服務**，使用與 Azure Log Analytics 相同的查詢語言來查詢 [Application Insights 資料](https://docs.microsoft.com/en-us/azure/azure-monitor/app/analytics)。如需詳細資訊，請參閱[查詢 Application Insights Analytics 服務](#query-the-application-insights-analytics-service)。
## 新增資料來源
資料來源可以從四個不同的服務存取指標。您可以設定對您所用服務的存取。如果這是您在 Azure Entra ID 中設定的方式，也可以對多個服務使用相同的登入資料。
+ [註冊 Microsoft Entra 應用程式並建立服務主體](https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-create-service-principal-portal)
1. 從 Grafana 主選單存取，新安裝的資料來源可以立即新增到資料來源區段中。接著，選擇右上角的**新增資料來源**按鈕。Azure Monitor 資料來源將可在資料來源清單中的雲端區段中選擇。
1. 在名稱欄位中，Grafana 會自動填入資料來源的名稱： `Azure Monitor`或 等。 `Azure Monitor - 3`如果您要設定多個資料來源，請將名稱變更為資訊更豐富的名稱。
1. 如果您使用的是 Azure Monitor，則需要 Azure 入口網站的四項資訊 （如需詳細說明，請參閱先前提供的連結）：
+ **租用戶 ID **(Azure Entra ID、屬性、目錄 ID)
+ **用戶端 ID **(Azure Entra ID、應用程式註冊、選擇您的應用程式、應用程式 ID)
+ **用戶端秘密** (Azure Entra ID、應用程式註冊、選擇您的應用程式、金鑰）
+ **預設訂閱 ID **（訂閱、選擇訂閱、概觀、訂閱 ID)
1. 將這四個項目貼到 Azure Monitor API 詳細資訊區段中的欄位。
+ 每個查詢都可以變更訂閱 ID。儲存資料來源並重新整理頁面，以查看指定用戶端 ID 可用的訂閱清單。
1. 如果您也使用 Azure Log Analytics 服務，則必須指定這兩個組態值，或重複使用上一個步驟的用戶端 ID 和秘密。
+ 用戶端 ID (Azure Entra ID、應用程式註冊、選擇您的應用程式、應用程式 ID)
+ 用戶端秘密 (Azure Entra ID、應用程式註冊、選擇您的應用程式、金鑰、建立金鑰、使用用戶端秘密）
1. 如果您使用的是 Application Insights，則需要來自 Azure 入口網站的兩項資訊 （如需詳細說明，請參閱先前提供的連結）：
+ 應用程式 ID
+ API 金鑰
1. 將這兩個項目貼到 Application Insights API 詳細資訊區段中的適當欄位。
1. 選擇**儲存與**測試按鈕，測試組態詳細資訊是否正確。
或者，在步驟 4 中，如果您要建立新的 Azure Entra ID 應用程式，請使用 [Azure CLI](https://docs.microsoft.com/en-us/cli/azure/?view=azure-cli-latest)：
```
az ad sp create-for-rbac -n "http://localhost:3000"
```
## 選擇服務
在面板的查詢編輯器中，選擇 Azure Monitor 資料來源之後，第一個步驟是選取服務。有四個選項：
+ `Azure Monitor`
+ `Application Insights`
+ `Azure Log Analytics`
+ `Insights Analytics`
查詢編輯器會根據您選取的選項而變更。Azure Monitor 是預設值。
## 查詢 Azure Monitor 服務
Azure Monitor 服務會為您執行的所有 Azure 服務提供指標。它可協助您了解 Azure 上的應用程式如何執行，並主動找出影響應用程式的問題。
如果您的 Azure Monitor 登入資料可讓您存取多個訂閱，請先選擇適當的訂閱。
您可以從服務取得的指標範例如下：
+ `Microsoft.Compute/virtualMachines - Percentage CPU`
+ `Microsoft.Network/networkInterfaces - Bytes sent`
+ `Microsoft.Storage/storageAccounts - Used Capacity`
查詢編輯器可讓您查詢支援它們的指標的多個維度。支援多個維度的指標是 [Azure Monitor 支援的指標清單中列出的指標](https://docs.microsoft.com/en-us/azure/azure-monitor/platform/metrics-supported)，這些指標在指標的**維度**欄中列出一或多個值。
### 使用 Azure Monitor 的別名格式化圖例金鑰
Azure Monitor API 的預設圖例格式為：
`metricName{dimensionName=dimensionValue,dimensionTwoName=DimensionTwoValue}`
這些長度可能很長，但您可以使用別名來變更此格式。在**圖例格式**欄位中，您可以任意組合下列別名。
Azure Monitor 範例：
+ `Blob Type: {{ blobtype }}`
+ `{{ resourcegroup }} - {{ resourcename }}`
### Azure Monitor 的別名模式
+ `{{ resourcegroup }}` = 以資源群組的值取代
+ `{{ namespace }}` = 以命名空間的值取代 （例如 Microsoft.Compute/virtualMachines)
+ `{{ resourcename }}` = 以資源名稱的值取代
+ `{{ metric }}` = 以指標名稱取代 （例如， 百分比 CPU)
+ `{{ dimensionname }}` = *7.1\$1 的舊版 （用於回溯相容性）*，以第一個維度的索引鍵/標籤取代 （依索引鍵/標籤排序） （例如 blobtype)
+ `{{ dimensionvalue }}` = *7.1\$1 的舊版 （用於回溯相容性）*，以第一個維度的值取代 （依索引鍵/標籤排序） （例如 BlockBlob)
+ `{{ arbitraryDim }}` = *提供 7.1\$1 版本*，以對應維度的值取代。（例如， `{{ blobtype }}` 成為 BlockBlob)
### 建立 Azure Monitor 的範本變數
您可以在指標查詢中使用變數，而不是硬式編碼，例如伺服器、應用程式和感應器名稱。變數會顯示為儀表板頂端的下拉式清單選取方塊。您可以使用這些下拉式方塊來變更儀表板中顯示的資料。
請注意，Azure Monitor 服務尚不支援多個值。若要視覺化多個時間序列 （例如，伺服器 1 和伺服器 2 的指標），請新增多個查詢，以便在相同的圖形或相同的資料表中檢視它們。
Azure Monitor 資料來源外掛程式提供下列查詢，您可以在變數編輯檢視的**查詢**欄位中指定。您可以使用它們來填入變數的選項清單。
| 名稱 | 描述 |
| --- | --- |
| Subscriptions() | 傳回訂閱清單。 |
| ResourceGroups() | 傳回資源群組的清單。 |
| ResourceGroups(12345678-aaaa-bbbb-cccc-123456789aaa) | 傳回指定訂閱的資源群組清單。 |
| Namespaces(aResourceGroup) | 傳回指定資源群組的命名空間清單。 |
| Namespaces(12345678-aaaa-bbbb-cccc-123456789aaa, aResourceGroup) | 傳回指定資源群組和訂閱的命名空間清單。 |
| ResourceNames(aResourceGroup, aNamespace) | 傳回資源名稱的清單。 |
| ResourceNames(12345678-aaaa-bbbb-cccc-123456789aaa, aResourceGroup, aNamespace) | 傳回指定訂閱的資源名稱清單。 |
| MetricNamespace(aResourceGroup, aNamespace, aResourceName) | 傳回指標命名空間的清單。 |
| MetricNamespace(12345678-aaaa-bbbb-cccc-123456789aaa, aResourceGroup, aNamespace, aResourceName) | 傳回指定訂閱的指標命名空間清單。 |
| MetricNames(aResourceGroup, aNamespace, aResourceName) | 傳回指標名稱的清單。 |
| MetricNames(12345678-aaaa-bbbb-cccc-123456789aaa, aResourceGroup, aNamespace, aResourceName) | 傳回指定訂閱的指標名稱清單。 |
範例：
+ 資源群組查詢： `ResourceGroups()`
+ 在指標名稱變數中傳遞： `Namespaces(cosmo)`
+ 鏈結範本變數： `ResourceNames($rg, $ns)`
+ 請勿引用參數： `MetricNames(hg, Microsoft.Network/publicIPAddresses, grafanaIP)`
如需範本和範本變數的詳細資訊，請參閱 [範本](templates-and-variables.md#templates)。
### 支援的 Azure Monitor 指標清單
並非所有 Azure Monitor API 傳回的指標都有值。為了讓建立查詢更容易，Grafana 資料來源具有支援的 Azure Monitor 指標清單，而且會忽略永遠不會有值的指標。當新的服務和指標新增至 Azure 雲端時，此清單會定期更新。
### Azure Monitor 提醒
Azure Monitor 服務支援 Grafana 提醒。這不是 Azure Alerts 支援。如需 Grafana 提醒的詳細資訊，請參閱 [Grafana 提醒](alerts-overview.md)。
## 查詢 Application Insights 服務
### 使用 Application Insights 的別名格式化圖例金鑰
預設圖例格式為：
`metricName{dimensionName=dimensionValue,dimensionTwoName=DimensionTwoValue}`
在圖例格式欄位中，下列別名可以任意組合。
Application Insights 範例：
+ `city: {{ client/city }}`
+ `{{ metric }} [Location: {{ client/countryOrRegion }}, {{ client/city }}]`
### Application Insights 的別名模式
+ `{{ groupbyvalue }}` = *Grafana 7.1\$1 的舊版 （用於回溯相容性）*，以第一個維度的索引鍵/標籤取代 （依索引鍵/標籤排序）
+ `{{ groupbyname }}` = *Grafana 7.1\$1 的舊版 （用於回溯相容性）*，以第一個維度的值取代 （依索引鍵/標籤排序） （例如 BlockBlob)
+ `{{ metric }}` = 以指標名稱取代 （例如， 請求/計數）
+ `{{ arbitraryDim }}` = *提供 7.1\$1 版本*，以對應維度的值取代。（例如， `{{ client/city }}` 變成芝加哥）
### Application Insights 的篩選條件表達式
篩選條件欄位採用 OData 篩選條件表達式。
範例：
+ `client/city eq 'Boydton'`
+ `client/city ne 'Boydton'`
+ `client/city ne 'Boydton' and client/city ne 'Dublin'`
+ `client/city eq 'Boydton' or client/city eq 'Dublin'`
### 使用 Application Insights 的變數進行範本化
在變數編輯檢視的**查詢**欄位中，使用下列其中一個查詢。
如需範本和範本變數的詳細資訊，請參閱 [範本](templates-and-variables.md#templates)。
| 名稱 | 描述 |
| --- | --- |
| AppInsightsMetricNames() | 傳回指標名稱的清單。 |
| AppInsightsGroupBys(aMetricName) | 傳回指定指標名稱的group by子句清單。 |
範例：
+ 指標名稱查詢： `AppInsightsMetricNames()`
+ 在指標名稱變數中傳遞： `AppInsightsGroupBys(requests/count)`
+ 鏈結範本變數： `AppInsightsGroupBys($metricnames)`
### Application Insights 提醒
Application Insights 支援 Grafana 提醒。這不是 Azure Alerts 支援。如需 Grafana 提醒的詳細資訊，請參閱 [Grafana 提醒](alerts-overview.md)。
## 查詢 Azure Log Analytics 服務
查詢是以新的 [Azure Log Analytics （或 KustoDB) 查詢語言](https://docs.microsoft.com/en-us/azure/azure-monitor/log-query/query-language)撰寫。Log Analytics 查詢可以格式化為時間序列資料或資料表資料。
如果您的登入資料可讓您存取多個訂閱，請在輸入查詢之前選擇適當的訂閱。
### 時間序列查詢
時間序列查詢適用於圖形面板和其他面板，例如 SingleStat 面板。每個查詢必須至少包含一個日期時間資料欄和一個數值資料欄。結果必須依日期時間資料欄遞增排序。
下列程式碼範例顯示的查詢會傳回依小時分組的彙總計數。
```
Perf
| where $__timeFilter(TimeGenerated)
| summarize count() by bin(TimeGenerated, 1h)
| order by TimeGenerated asc
```
查詢也可以有一或多個非數值/非日期時間資料欄，這些資料欄會被視為維度，並在回應中成為標籤。例如，查詢會傳回依小時、電腦和 CounterName 分組的彙總計數。
```
Perf
| where $__timeFilter(TimeGenerated)
| summarize count() by bin(TimeGenerated, 1h), Computer, CounterName
| order by TimeGenerated asc
```
您也可以選取額外的數值欄 （有或沒有多個維度）。例如，按小時、Computer、CounterName 和 InstanceName 取得計數和平均值：
```
Perf
| where $__timeFilter(TimeGenerated)
| summarize Samples=count(), ["Avg Value"]=avg(CounterValue)
by bin(TimeGenerated, $__interval), Computer, CounterName, InstanceName
| order by TimeGenerated asc
```
**注意**
**秘訣**：在上一個查詢中，Kusto 語法 和 `Samples=count()``["Avg Value"]=...`用於重新命名這些欄 — 允許空格的第二個語法。這會變更 Grafana 使用的指標名稱。因此，序列圖例和資料表資料欄等物件將符合您指定的內容。在此範例中，`Samples`會顯示 而非 `_count`。
### 資料表查詢
資料表查詢主要用於資料表面板，並顯示資料欄和資料列的清單。此範例查詢會傳回具有六個指定資料欄的資料列。
```
AzureActivity
| where $__timeFilter()
| project TimeGenerated, ResourceGroup, Category, OperationName, ActivityStatus, Caller
| order by TimeGenerated desc
```
### 格式化 Log Analytics 的顯示名稱
預設顯示名稱格式為：
`metricName{dimensionName=dimensionValue,dimensionTwoName=DimensionTwoValue}`
這可以透過使用顯示名稱欄位選項來自訂。
### Azure Log Analytics 巨集
為了讓撰寫查詢更容易，Grafana 提供數個巨集，您可以在查詢的 子句中使用：
+ `$__timeFilter()` – 展開至 `TimeGenerated ≥ datetime(2018-06-05T18:09:58.907Z) and` `TimeGenerated ≤ datetime(2018-06-05T20:09:58.907Z)` Grafana 時間挑選器的往返日期時間。
+ `$__timeFilter(datetimeColumn)` – 展開至 `datetimeColumn ≥ datetime(2018-06-05T18:09:58.907Z) and` `datetimeColumn ≤ datetime(2018-06-05T20:09:58.907Z)` Grafana 時間挑選器的往返日期時間。
+ `$__timeFrom()` – 從 Grafana 挑選器傳回起始日期時間。範例：`datetime(2018-06-05T18:09:58.907Z)`。
+ `$__timeTo()` – 從 Grafana 挑選器傳回起始日期時間。範例：`datetime(2018-06-05T20:09:58.907Z)`。
+ `$__escapeMulti($myVar)` – 用於包含非法字元的多值範本變數。如果 `$myVar`具有下列兩個值做為字串 `'\\grafana-vm\Network(eth0)\Total','\\hello!'`，則會展開為：`@'\\grafana-vm\Network(eth0)\Total', @'\\hello!'`。如果使用單一值變數，則不需要此巨集，請改為內嵌逸出變數：`@'\$myVar'`。
+ `$__contains(colName, $myVar)` – 要與多值範本變數搭配使用。如果 `$myVar`的值為 `'value1','value2'`，則會展開為：`colName in ('value1','value2')`。
如果使用**全部**選項，請勾選**包含全部選項**核取方塊，然後在**自訂所有值**欄位中，輸入下列值：**all**。如果 `$myVar`的值為 `all`，則巨集會改為擴展到 `1 == 1`。對於具有許多選項的範本變數，這會透過不建置大型 "where..in" 子句來提高查詢效能。
### Azure Log Analytics 內建變數
還有一些 Grafana 變數可用於 Azure Log Analytics 查詢：
+ `$__interval` - Grafana 會計算可用於在查詢中依時間分組的最短時間粒度。它傳回`1h`可在 bin 函數中使用的時間粒度，例如 `5m`或 ；例如 `summarize count() by bin(TimeGenerated, $__interval)`。如需間隔變數的詳細資訊，請參閱 [新增間隔變數](variables-types.md#add-an-interval-variable)。
### 使用 Azure Log Analytics 的變數進行範本化
傳回值清單的任何 Log Analytics 查詢都可以在變數編輯檢視的**查詢**欄位中使用。Log Analytics 也有一個 Grafana 函數可傳回工作區清單。
如需範本和範本變數的相關資訊，請參閱 [範本和變數](templates-and-variables.md)。
| 名稱 | 描述 |
| --- | --- |
| workspaces() | 傳回預設訂閱的工作區清單。 |
| workspaces(12345678-aaaa-bbbb-cccc-123456789aaa) | 傳回指定訂閱的工作區清單 （可以引用或取消引用 參數）。 |
下表顯示變數查詢範例。
| Query | Description |
| --- | --- |
| subscriptions() | 傳回 Azure 訂閱的清單。 |
| workspaces() | 傳回預設訂閱的工作區清單。 |
| workspaces("12345678-aaaa-bbbb-cccc-123456789aaa") | 傳回指定訂閱的工作區清單。 |
| workspaces("\$1subscription") | 使用 訂閱參數的範本變數。 |
| workspace("myWorkspace").Heartbeat \$1\$1 distinct Computer | 傳回虛擬機器的清單。 |
| workspace("\$1workspace").Heartbeat \$1\$1 distinct Computer | 傳回具有範本變數的虛擬機器清單。 |
| workspace("\$1workspace").Perf \$1\$1 distinct ObjectName | 從 Perf 資料表傳回物件清單。 |
| workspace("\$1workspace").Perf \$1\$1 where ObjectName == "\$1object" \$1\$1 distinct CounterName | 傳回 Perf 資料表中的指標名稱清單。 |
下列程式碼 xample 顯示使用變數的時間序列查詢。
```
Perf
| where ObjectName == "$object" and CounterName == "$metric"
| where TimeGenerated >= $__timeFrom() and TimeGenerated <= $__timeTo()
| where $__contains(Computer, $computer)
| summarize avg(CounterValue) by bin(TimeGenerated, $__interval), Computer
| order by TimeGenerated asc
```
### 從 Grafana 面板深度連結至 Azure 入口網站中的 Log Analytics 查詢編輯器
在面板中選擇時間序列，以查看內容功能表，其中包含在 **Azure 入口網站中檢視**的連結。選擇該連結會在 Azure 入口網站中開啟 Azure Log Analytics 查詢編輯器，並從該處 Grafana 面板執行查詢。
如果您目前尚未登入 Azure 入口網站，則連結會開啟登入頁面。提供的連結對任何帳戶都有效，但只有在您的帳戶可以存取查詢中指定的 Azure Log Analytics 工作區時，才會顯示查詢。
### Azure Log Analytics 提醒
Application Insights 支援 Grafana 提醒。這不是 Azure Alerts 支援。如需在 Grafana 工作區中提醒的詳細資訊，請參閱 [Grafana 提醒](alerts-overview.md)。
## 查詢 Application Insights Analytics 服務
如果您將服務類型變更為 **Insights Analytics**，則會提供與 Log Analytics 服務類似的編輯器。此服務也使用 Kusto 語言，因此查詢資料的指示與 相同[查詢 Azure Log Analytics 服務](#querying-the-azure-log-analytics-service)，除非您改為查詢 Application Insights Analytics 資料。
# 連接至 Graphite 資料來源
Grafana 具有進階的 Graphite 查詢編輯器，可讓您快速導覽指標空間、新增函數、變更函數參數等等。編輯器可以處理所有類型的石圖查詢。它甚至可以透過使用查詢參考來處理複雜的巢狀查詢。
## 石墨設定
若要存取 Graphite 設定，請在**組態** （齒輪） 圖示上暫停，然後選擇**資料來源**，然後選擇 Graphite 資料來源。
| 名稱 | 描述 |
| --- | --- |
| Name | 資料來源名稱。這是您在面板和查詢中看到資料來源的方式。 |
| Default | 預設資料來源表示新面板會預先選取。 |
| URL | 您的 graphite-web 或 graphite-api 安裝的 HTTP 通訊協定、IP 和連接埠。 |
| Access | 伺服器 （預設） = URL 必須可從 Grafana 後端/伺服器存取。 |
| Auth | |
| Basic Auth | 啟用資料來源的基本身分驗證。 |
| User | 基本身分驗證的使用者名稱。 |
| Password | 基本身分驗證的密碼。 |
| Custom HTTP Headers | 選擇新增標頭以新增自訂 HTTP 標頭。 |
| Header | 輸入自訂標頭名稱。 |
| Value | 輸入自訂標頭值。 |
| Graphite details | |
| Version | 選取您的 Graphite 版本。 |
| Type | 選取您的 Graphite 類型。 |
存取模式控制將如何處理對資料來源的請求。如果未說明其他項目，伺服器應該是偏好的方式。
### 伺服器存取模式 （預設）
所有請求都是從瀏覽器向 Amazon Managed Grafana 提出，其會將請求轉送至資料來源，以規避可能的跨來源資源共享 (CORS) 要求。如果您選擇此存取模式，則必須從 Amazon Managed Grafana 存取 URL。
### 瀏覽器存取模式
Amazon Managed Grafana 不支援 Graphite 資料來源的瀏覽器直接存取。
## 石磚查詢編輯器
Grafana 包含 Graphite 特定的查詢編輯器，可協助您建置查詢。
若要查看傳送至 Graphite 的查詢原始文字，請選擇**切換文字編輯模式 **（鉛筆） 圖示。
### 選擇要查詢的指標
選擇**選取指標**以導覽指標空間。開始之後，您可以繼續使用指標或鍵盤方向鍵。您可以選取萬用字元並繼續。
### 函數
若要新增函數，請選擇**函數**旁的加號圖示。您可以搜尋函數，或從選單中選取它。選取函數之後，將會新增該函數，而您的焦點將位於第一個參數的文字方塊中。若要編輯或變更參數，請選擇它，它會變成文字方塊。- 若要刪除函數，請選擇函數名稱，後面接著 x 圖示。
有些函數，例如 `aliasByNode`，支援選用的第二個引數。若要新增引數，請在第一個引數上暫停，然後選擇出現的`+`符號。若要移除第二個選用參數，請選擇它並保留空白。編輯器會將其移除。
### 排序標籤
如果您想要一致排序，請使用 `sortByName`。當您在多個圖形上有相同的標籤時，這可能會令人煩惱，而且它們的排序方式和使用不同的顏色。若要修正此問題，請使用 `sortByName()`。
### 巢狀查詢
您可以依查詢所在的列*字母*來參考查詢 （類似 Microsoft Excel)。如果您將第二個查詢新增至圖形，則可以在 \$1A 中輸入 來參考第一個查詢。這提供了建立複合查詢的便利方式。
### 使用萬用字元來避免許多查詢
有時，您可能會想要看到繪製在相同圖形上的多個時間序列。例如，您可能想要查看 CPU 在機器上的使用方式。最初，您可以透過為每個時間序列新增查詢來建立圖形，例如 `cpu.percent.user.g`、 `cpu.percent.system.g`等。這會導致對資料來源進行 *n* 個查詢，這是無效的。
為了更有效率，您可以在搜尋中使用萬用字元，請在一個查詢中傳回所有時間序列。例如 `cpu.percent.*.g`。
### 修改資料表或圖表中的指標名稱
使用 `alias`函數來變更 Grafana 資料表或圖形上的指標名稱；例如 `aliasByNode()`或 `aliasSub()`。
## 點合併
所有 Graphite 指標都會合併，因此 Graphite 不會傳回超過圖形中像素的資料點。根據預設，此合併會使用 `avg`函數完成。您可以新增 Graphite consolidateBy 函數來控制 Graphite 合併指標的方式。
**注意**
這表示圖例摘要值 （最大值、最小值、總計） 無法同時更正。它們是由 Grafana 計算的用戶端。根據您的合併函數，同時只能有一個或兩個是正確的。
## 結合時間序列
若要合併時間序列，請在**函數**清單中選擇**合併**。
## 資料探勘和標籤
在 Graphite 中，一切都是一個標籤。
探索資料時，先前選取的標籤會用來篩選剩餘的結果集。若要選取資料，您可以使用 `seriesByTag`函數，其會採用標籤表達式 (`=`、`!=`、`=~`、`!=~`) 來篩選時間序列。
當您選取標籤時，Grafana 查詢建置器會自動為您執行此操作。
**注意**
**秘訣：**規則表達式搜尋在高基數標籤上可能會很慢，因此請嘗試先使用其他標籤來縮小範圍。從特定名稱或命名空間開始，有助於減少結果。
## 範本變數
您可以在指標查詢中使用變數，而不是硬式編碼，例如伺服器、應用程式和感應器名稱。變數會顯示為儀表板頂端的下拉式清單選取方塊。您可以使用這些下拉式方塊來變更儀表板中顯示的資料。
如需範本和範本變數的詳細資訊，請參閱 [範本和變數](templates-and-variables.md)。
若要使用標籤值建立變數，請使用 Grafana 函數 `tags`和 `tag_values`。
| Query | Description |
| --- | --- |
| tags() | 傳回所有標籤。 |
| tags(server=\$1backend\$1\$1) | 僅傳回在符合篩選條件表達式的序列中發生的標籤。 |
| tag\$1values(server) | 傳回指定標籤的標籤值。 |
| tag\$1values(server, server=\$1backend\$1\$1) | 在符合這些表達式的序列中，傳回所指定標籤發生的篩選標籤值。 |
| tag\$1values(server, server=\$1backend\$1\$1, app=\$1\$1\$1apps:regex\$1) | 多個篩選條件表達式和表達式可以包含其他變數。 |
如需詳細資訊，請參閱[標籤自動完成 API 上的 Graphite 文件](https://graphite.readthedocs.io/en/latest/tags.html#auto-complete-support)。
### 查詢變數
您在查詢欄位中指定的查詢應該是查詢的指標尋找類型。例如， 之類的查詢`prod.servers.*`會將存在於萬用字元位置中的所有可能值填入變數。
您也可以建立在其定義中使用其他變數的巢狀變數。例如， `apps.$app.servers.*` 會在其查詢定義`$app`中使用 變數。
#### 使用 `__searchFilter` 篩選查詢變數結果
`__searchFilter` 在查詢欄位中使用 會根據您在下拉式清單選取方塊中輸入的內容來篩選查詢結果。當您未輸入任何內容時，當做為規則表達式的一部分使用時， 的預設值`__searchFilter`為 `*`和 ``。
下列範例顯示如何使用 `__searchFilter`做為查詢欄位的一部分，以在使用者在下拉式清單選取方塊中輸入文字`server`時啟用搜尋。
Query
```
apps.$app.servers.$__searchFilter
```
TagValues
```
tag_values(server, server=~${__searchFilter:regex})
```
### 變數用量
您可以在指標節點路徑中使用變數，或做為函數的參數。
有兩種語法：
+ `$` 範例：apps.frontend.\$1server.requests.count
+ `${varname}` 範例：apps.frontend.\$1\$1server\$1.requests.count
為什麼使用兩種方式？ 第一個語法更容易讀取和寫入，但不允許您在單字中間使用變數。在 等表達式中使用第二個語法`my.server${serverNumber}.count`。
### 標籤查詢中的變數用量
標籤查詢中的多值變數使用 Grafana 5.0 中針對變數推出的進階格式化語法：`{var:regex}`。非標籤查詢將使用多值變數的預設 glob 格式。
下列程式碼範例顯示具有 regex 格式和使用等於 Tilde 運算子 的標籤表達式`=~`。
```
server=~${servers:regex}
```
如需詳細資訊，請參閱[進階變數格式選項](templates-and-variables.md#advanced-variable-format-options)。
## 註釋
註釋可讓您在圖形上方疊加豐富的事件資訊。您可以透過儀表板功能表/註釋檢視新增註釋查詢。如需詳細資訊，請參閱[註釋](dashboard-annotations.md)。
Graphite 支援兩種查詢註釋的方式：
+ 一般指標查詢。為此，您可以使用 **Graphite 查詢**文字方塊。
+ Graphite 事件查詢。為此，您可以使用`Graphite event tags`文字方塊，並指定標籤或萬用字元 （保留空白也可以運作）。
# 連線至 Google Cloud Monitoring 資料來源
**注意**
在舊版 Grafana 中，此資料來源名為 Google Stackdriver。
新增 Google Cloud Monitoring 資料來源，以便能夠為您的 Google Cloud Monitoring 指標建置儀表板。
## 新增資料來源
1. 選擇頂端標頭中的 Grafana 圖示，開啟側邊選單。
1. 在側邊選單的**儀表板**連結下，您應該會找到**資料來源**連結。
1. 選擇頂端標頭中的 **\$1 新增資料來源**按鈕。
1. 從**類型**下拉式清單中選取 **Google Cloud Monitoring**。
1. 在服務帳戶金鑰檔案中上傳或貼上。如需建立服務帳戶金鑰檔案的步驟，請參閱本文件稍後的 。
**注意**
如果您在側邊選單中看不到**資料來源**連結，表示您目前的使用者沒有 `Admin`角色。
| 名稱 | 描述 |
| --- | --- |
| Name | 資料來源名稱。這是您在面板和查詢中參考資料來源的方式。 |
| Default | 預設資料來源表示新面板會預先選取。 |
| Service Account Key | GCP 專案的服務帳戶金鑰檔案。請參閱本文件稍後有關如何建立的說明。 |
## 身分驗證
有兩種方式可以驗證 Google Cloud Monitoring 外掛程式
+ 上傳 Google JWT 檔案
+ 從 Google 中繼資料伺服器自動擷取登入資料
後者選項僅在 GCE 虛擬機器上執行 Grafana 時可用。
### 使用 Google 服務帳戶金鑰檔案
若要使用 Google Cloud Monitoring API 進行驗證，您必須為要顯示資料的專案建立 Google Cloud Platform (GCP) 服務帳戶。Grafana 資料來源會與一個 GCP 專案整合。若要視覺化來自多個 GCP 專案的資料，您必須為每個 GCP 專案建立一個資料來源。
#### 啟用 APIs
必須先啟用下列 APIs：
+ [監控 API](https://console.cloud.google.com/apis/library/monitoring.googleapis.com)
+ [雲端資源管理員 API](https://console.cloud.google.com/apis/library/cloudresourcemanager.googleapis.com)
選擇列出的連結，然後選擇**啟用**按鈕。
#### 建立專案的 GCP 服務帳戶
1. 導覽至 [APIs和服務登入資料頁面](https://console.cloud.google.com/apis/credentials)。
1. 選擇**建立登入**資料下拉式清單/按鈕，然後選擇**服務帳戶金鑰**選項。
\$1\$1< docs-imagebox img="/img/docs/v71/cloudmonitoring\$1create\$1service\$1account\$1button.png" class="docs-image–no-shadow" caption="建立服務帳戶按鈕" >\$1\$1
1. 在**建立服務帳戶金鑰**頁面上，選擇金鑰類型 `JSON`。然後，在**服務帳戶**下拉式清單中，選擇**新增服務帳戶**選項。
\$1\$1< docs-imagebox img="/img/docs/v71/cloudmonitoring\$1create\$1service\$1account\$1key.png" class="docs-image–no-shadow" caption="建立服務帳戶金鑰" >\$1\$1
1. 會出現一些新欄位。在服務帳戶名稱欄位中輸入**服務帳戶的名稱**，然後從角色下拉式清單中選擇**監控檢視器****角色**。
\$1\$1< docs-imagebox img="/img/docs/v71/cloudmonitoring\$1service\$1account\$1choose\$1role.png" class="docs-image–no-shadow" caption="Choose role" >\$1\$1
1. 選擇**建立**按鈕。系統會建立 JSON 金鑰檔案並下載至您的電腦。將此檔案存放在安全的地方，因為它允許存取您的 Google Cloud Monitoring 資料。
1. 在資料來源**組態**頁面上將其上傳至 Grafana。您可以上傳檔案或貼上檔案的內容。
\$1\$1< docs-imagebox img="/img/docs/v71/cloudmonitoring\$1grafana\$1upload\$1key.png" class="docs-image–no-shadow" caption="將服務金鑰檔案上傳至 Grafana" >\$1\$1
1. 檔案內容會加密並儲存在 Grafana 資料庫中。上傳檔案後別忘了儲存！
\$1\$1< docs-imagebox img="/img/docs/v71/cloudmonitoring\$1grafana\$1key\$1uploaded.png" class="docs-image–no-shadow" caption="服務金鑰檔案上傳至 Grafana" >\$1\$1
## 使用查詢編輯器
Google Cloud Monitoring 查詢編輯器可讓您建置兩種類型的查詢：**指標****和服務水準目標 (SLO)**。這兩種類型都會傳回時間序列資料。
### 指標查詢
指標查詢編輯器可讓您選取指標、依標籤和時間分組/彙總，並使用篩選條件來指定您想要在結果中哪個時間序列。
若要建立指標查詢，請遵循下列步驟：
1. 在**查詢類型**下拉式清單中選擇選項**指標**。
1. 從專案下拉式清單中選擇**專案**。
1. 從服務下拉式清單中選擇 Google Cloud Platform **服務**。
1. 從指標下拉式清單中選擇**指標**。
1. 若要依子句新增或移除篩選條件或群組，請使用篩選條件中的加號和減號圖示，並依區段分組。此為選擇性步驟。
Google Cloud Monitoring 指標可以是不同類型的 (GAUGE、DELTA、CUMULATIVE)，而且這些類型支援不同的彙總選項 （減少程式和對齊程式）。Grafana 查詢編輯器會顯示所選指標的可用彙總方法清單，並在您選取指標時設定預設縮減器和對齊器。查詢編輯器也會自動選取 Y 軸的單位。
#### 篩選條件
若要新增篩選條件，請選擇加號圖示，選擇要篩選的欄位，然後輸入篩選條件值。例如，輸入 `instance_name = grafana-1`。您可以透過選擇篩選條件名稱並選取 來移除篩選條件`--remove filter--`。
##### 簡單萬用字元
當運算子設定為 或 時，`=``!=`可以將萬用字元新增至篩選條件值欄位。例如， 會`us-*`擷取以 "us-" 開頭的所有值，並`*central-a`擷取以 "central-a" 結尾的所有值。 會`*-central-*`擷取具有 子字串的所有值`central-`。簡單的萬用字元比一般表達式便宜。
##### 常規表達式
當運算子設定為 或 時，`=~``!=~`可以將規則表達式新增至篩選條件值欄位。例如， 會`us-central[1-3]-[af]`比對以「us-central」開頭的所有值，後面接著介於 1 到 3 之間的數字、破折號，然後是「a」或「f」。建立規則表達式時，不需要前斜線和後斜線。
#### 聚合
彙總欄位可讓您根據常見統計資料結合時間序列。如需彙總的詳細資訊，請參閱[彙總選項](https://cloud.google.com/monitoring/charts/metrics-selector#aggregation-options)。
`Aligner` 欄位可讓您依時間間隔，在相同群組之後對齊多個時間序列。如需對齊器的詳細資訊，請參閱[對齊指標選擇](https://cloud.google.com/monitoring/charts/metrics-selector#alignment)器。
##### 對齊期間和依時間分組
如果選擇彙總， 會依時間`Alignment Period`分組指標。預設為使用 GCP Google Cloud Monitoring 預設分組 （可讓您比較 Grafana 中的圖形與 Google Cloud Monitoring UI 中的圖形）。選項稱為 `cloud monitoring auto`，預設值為：
+ 時間範圍 < 23 小時為 1 公尺
+ 時間範圍 >= 23 小時且 < 6 天的 5 公尺
+ 時間範圍 >= 6 天的 1 小時
另一個自動選項是 `grafana auto`。這會根據所選的時間範圍和圖形面板的寬度，自動依時間設定群組。如需詳細資訊，請參閱[新增間隔變數](variables-types.md#add-an-interval-variable)。
您也可以選擇要分組的固定時間間隔，例如 `1h`或 `1d`。
#### 分組依據
依資源或指標標籤分組，以減少時間序列的數量，並依群組彙總結果。例如，依 instance\$1name 分組，以查看運算執行個體的彙總指標。
##### 中繼資料標籤
資源中繼資料標籤包含可唯一識別 Google Cloud 中資源的資訊。如果中繼資料標籤是時間序列請求中**依區段分組**的一部分，則只會在時間序列回應中傳回中繼資料標籤。沒有用於擷取中繼資料標籤的 API，因此無法使用所選服務和指標可用的中繼資料標籤，依下拉式清單填入群組。不過，**分組依據**欄位下拉式清單隨附預先定義的常用系統標籤清單。
使用者標籤無法預先定義，但可以在**分組依據**欄位中輸入標籤。如果中繼資料標籤、使用者標籤或系統標籤包含在**分組依據**區段中，您可以根據它建立篩選條件，並在**別名**欄位中展開其值。
#### 別名模式
別名依據欄位可讓您控制圖例金鑰的格式。預設為顯示指標名稱和標籤。這可能很長且難以讀取。在別名欄位中使用以下模式，您可以按照您想要的方式格式化圖例索引鍵。
#### 指標類型模式
| 別名模式 | Description | 範例結果 |
| --- | --- | --- |
| \$1\$1metric.type\$1\$1 | 傳回完整的指標類型。 | compute.googleapis.com/instance/cpu/utilization |
| \$1\$1metric.name\$1\$1 | 傳回指標名稱部分。 | instance/cpu/utilization |
| \$1\$1metric.service\$1\$1 | 傳回服務部分。 | compute |
#### 標籤模式
在分組依據下拉式清單中，您可以看到指標的指標和資源標籤清單。這些可使用別名模式包含在圖例金鑰中。
| 別名模式格式 | Description | 別名模式範例 | 範例結果 |
| --- | --- | --- | --- |
| \$1\$1metric.label.xxx\$1\$1 | 傳回指標標籤值。 | \$1\$1metric.label.instance\$1name\$1\$1 | grafana-1-prod |
| \$1\$1resource.label.xxx\$1\$1 | 傳回資源標籤值。 | \$1\$1resource.label.zone\$1\$1 | us-east1-b |
| \$1\$1metadata.system\$1labels.xxx\$1\$1 | 傳回中繼資料系統標籤值。 | \$1\$1metadata.system\$1labels.name\$1\$1 | grafana |
| \$1\$1metadata.user\$1labels.xxx\$1\$1 | 傳回中繼資料使用者標籤值。 | \$1\$1metadata.user\$1labels.tag\$1\$1 | production |
別名範例依據： `{{metric.type}} - {{metric.label.instance_name}}`
範例結果： `compute.googleapis.com/instance/cpu/usage_time - server1-prod`
您也可以解析受監控資源類型的名稱。
| 別名模式格式 | Description | 範例結果 |
| --- | --- | --- |
| \$1\$1resource.type\$1\$1 | 傳回受監控資源類型的名稱。 | gce\$1instance |
別名範例依據： `{{resource.type}} - {{metric.type}}`
範例結果： `gce_instance - compute.googleapis.com/instance/cpu/usage_time`
### SLO 查詢
**注意**
SLO 查詢僅適用於 Grafana v7.0\$1
Google Cloud Monitoring 資料來源中的 SLO 查詢建置器可讓您以時間序列格式顯示 SLO 資料。若要了解服務監控中的基本概念，請參閱 Google Cloud Monitoring [官方文件](https://cloud.google.com/monitoring/service-monitoring)。
#### 建立 SLO 查詢
若要建立 SLO 查詢，請遵循下列步驟：
1. 在**查詢類型**下拉式清單中選擇**服務水準目標 (SLO)** 選項。
1. 從專案下拉式清單中選擇**專案**。
1. 從服務下拉式清單中選擇 [SLO](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/services) **服務**。
1. 從 [SLO](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/services.serviceLevelObjectives) 下拉式清單中選擇 **SLO**。
1. 從選取**器**下拉式清單中選擇[時間序列](https://cloud.google.com/monitoring/service-monitoring/timeseries-selectors#ts-selector-list)選取器。
時間序列選取器的易記名稱會顯示在 Grafana 中。下表顯示從易記名稱映射到服務監控文件中所使用的系統名稱。
| 選擇器下拉式清單值 | 使用的對應時間序列選取器 |
| --- | --- |
| SLI 值 | select\$1slo\$1health |
| SLO 合規 | select\$1slo\$1compliance |
| SLO 錯誤預算剩餘 | select\$1slo\$1budget\$1fraction |
#### SLO 查詢的別名模式
您可以使用別名依據欄位來控制 SLO 查詢的圖例索引鍵格式。
| 別名模式 | Description | 範例結果 |
| --- | --- | --- |
| \$1\$1project\$1\$1 | 傳回 GCP 專案名稱。 | myProject |
| \$1\$1service\$1\$1 | 傳回服務名稱。 | myService |
| \$1\$1slo\$1\$1 | 傳回 SLO。 | latency-slo |
| \$1\$1selector\$1\$1 | 傳回選擇器。 | select\$1slo\$1health |
#### SLO 查詢的對齊期間和依時間分組
SLO 查詢使用與指標查詢相同的對齊期間功能。如需詳細資訊，請參閱[指標查詢](#google-metric-queries)。
## 範本化
您可以在指標查詢中使用變數，而不是硬式編碼，例如伺服器、應用程式和感應器名稱。變數會顯示為儀表板頂端的下拉式清單選取方塊。您可以使用這些下拉式方塊來變更儀表板中顯示的資料。
如需範本和範本變數的詳細資訊，請參閱 [範本和變數](templates-and-variables.md)。
### 查詢變數
*查詢*類型的變數可讓您查詢 Google Cloud Monitoring 的各種資料類型。Google Cloud Monitoring 資料來源外掛程式提供下列 `Query Types`。
| 名稱 | 描述 |
| --- | --- |
| Metric Types | 傳回指定服務可用的指標類型名稱清單。 |
| Labels Keys | 傳回指定指標resource label中 metric label和 的索引鍵清單。 |
| Labels Values | 傳回指定指標中標籤的值清單。 |
| Resource Types | 傳回指定指標的資源類型清單。 |
| Aggregations | 傳回指定指標的彙總清單 （跨序列縮減器）。 |
| Aligners | 傳回指定指標的對齊器清單 （每個系列對齊器）。 |
| Alignment periods | 傳回 Grafana 中 Google Cloud Monitoring 查詢編輯器中可用的所有對齊期間清單。 |
| Selectors | 傳回可用於 SLO （服務層級目標） 查詢的選取器清單。 |
| SLO Services | 傳回可在 SLO 查詢中使用的服務監控服務清單。 |
| Service Level Objectives (SLO) | 傳回指定 SLO 服務的 SLO 清單。 |
### 在查詢中使用變數
有兩種語法：
+ `$` 範例: `metric.label.$metric_label`
+ `[[varname]]` 範例: `metric.label.[[metric_label]]`
為什麼使用兩種方式？ 第一個語法更容易讀取和寫入，但不允許您在單字中間使用變數。啟用*多值*或*包含所有值*選項時，Grafana 會將標籤從純文字轉換為 regex 相容字串，這表示您必須使用 `=~`而非 `=`。
## 註釋
您可以使用註釋在圖形上方覆蓋豐富的事件資訊。您可以透過儀表板功能表/註釋檢視新增註釋查詢。註釋轉譯非常昂貴，因此請務必限制傳回的資料列數。尚不支援顯示 Google Cloud Monitoring 註釋和事件，但它適用於 Google Cloud Monitoring 中的[自訂指標](https://cloud.google.com/monitoring/custom-metrics/)。
如需註釋的詳細資訊，請參閱 [註釋](dashboard-annotations.md)。
使用註釋的查詢編輯器，您可以選取指標和篩選條件。**標題**和**文字**欄位支援範本化，並且可以使用查詢傳回的資料。例如，標題欄位可以有下列文字：
`{{metric.type}} has value: {{metric.value}}`
範例結果： `monitoring.googleapis.com/uptime_check/http_status has this value: 502`
### 註釋查詢編輯器的模式
| 別名模式格式 | Description | 別名模式範例 | 範例結果 |
| --- | --- | --- | --- |
| \$1\$1metric.value\$1\$1 | 指標/點的值。 | \$1\$1metric.value\$1\$1 | 555 |
| \$1\$1metric.type\$1\$1 | 傳回完整的指標類型。 | \$1\$1metric.type\$1\$1 | compute.googleapis.com/instance/cpu/utilization |
| \$1\$1metric.name\$1\$1 | 傳回指標名稱部分。 | \$1\$1metric.name\$1\$1 | instance/cpu/utilization |
| \$1\$1metric.service\$1\$1 | 傳回服務部分。 | \$1\$1metric.service\$1\$1 | compute |
| \$1\$1metric.label.xxx\$1\$1 | 傳回指標標籤值。 | \$1\$1metric.label.instance\$1name\$1\$1 | grafana-1-prod |
| \$1\$1resource.label.xxx\$1\$1 | 傳回資源標籤值。 | \$1\$1resource.label.zone\$1\$1 | us-east1-b |
## 從 Grafana 面板深度連結至 Google Cloud Console 中的 Metrics Explorer
**注意**
此功能僅適用於指標查詢。
在面板中選擇時間序列，以查看內容選單，其中包含在 Google Cloud Console 中檢視指標總管的連結。選擇該連結會在 Google Cloud Console 中開啟 Metrics Explorer，並從該處 Grafana 面板執行查詢。此連結會先將使用者導覽至 Google 帳戶選擇器。成功選取帳戶後，使用者會重新導向至 Metrics Explorer。提供的連結對任何帳戶都有效，但只有在您的帳戶可以存取查詢中指定的 GCP 專案時，才會顯示查詢。
# 連線至 InfluxDB 資料來源
Grafana 隨附功能豐富的 InfluxDB 資料來源外掛程式。外掛程式包含自訂查詢編輯器，並支援註釋和查詢範本。
## 新增資料來源
1. 選擇頂端標頭中的 Grafana 圖示，開啟側邊選單。
1. 在連結下方的側邊選單中，****儀表板應該會找到名為**資料來源**的連結。
1. 選擇頂端標頭中的 **\$1 新增資料來源**按鈕。
1. 從**類型**下拉式清單中選取 **InfluxDB**。
1. 從**查詢語言**清單中選取 **InfluxQL** 或 **Flux**。
**注意**
如果您在側邊選單中看不到**資料來源**連結，這表示您目前的使用者沒有 `Admin`角色。
# 連接至 Jaeger 資料來源
Jaeger 資料來源提供開放原始碼的end-to-end分散式追蹤。
## 新增資料來源
若要存取 Jaeger 設定，請選擇**組態** （齒輪） 圖示，然後選擇**資料來源**，然後選擇 **Jaeger**。
| 名稱 | 描述 |
| --- | --- |
| Name | 資料來源名稱。這是您在面板、查詢和探索中看到資料來源的方式。 |
| Default | 預設資料來源表示新面板會預先選取該資料來源。 |
| URL | Jaeger 執行個體的 URL，例如 http://localhost:16686。 |
| Access | 伺服器 （預設） = URL 必須可從 Grafana 後端/伺服器存取。 |
| Basic Auth | 啟用對 Jaeger 資料來源的基本身分驗證。 |
| User | 基本身分驗證的使用者名稱。 |
| Password | 基本身分驗證的密碼。 |
## 查詢追蹤
您可以透過探索從 Jaeger 查詢和顯示追蹤。如需詳細資訊，請參閱[探索](explore.md)。
Jaeger 查詢編輯器可讓您透過追蹤 ID 直接查詢，或從追蹤選取器中選取追蹤。若要依追蹤 ID 查詢，請將 ID 插入文字輸入。
使用追蹤選取器，從您在探索中選取的時間範圍中記錄的所有追蹤中選取特定追蹤。追蹤選取器有三個巢狀層級：1。您感興趣的服務。1. 特定操作是所選服務的一部分。1. 執行所選操作的特定追蹤，以根操作名稱和追蹤持續時間表示。
## 從日誌連結到追蹤 ID
您可以透過使用內部連結設定衍生欄位，從 Loki 中的日誌連結到 Jaeger 追蹤。如需詳細資訊，請參閱[衍生欄位](using-loki-in-AMG.md#loki-derived-fields)。
# 連線至 Loki 資料來源
Loki 資料來源可讓您存取 Grafana 的日誌彙總系統 Loki。
## 新增資料來源
1. 開啟 Grafana 工作區，並確保您已登入。
1. 在**組態**連結下方的側邊選單中，您應該會找到**資料來源**連結。
1. 選擇頂端的**新增資料來源**按鈕。
1. 從資料來源清單中選取 **Loki**。
**注意**
如果您在側邊選單中看不到**資料來源**連結，表示您目前的使用者沒有 `Admin`角色。
| 名稱 | 描述 |
| --- | --- |
| Name | 資料來源名稱。這是您在面板、查詢和探索中看到資料來源的方式。 |
| Default | 預設資料來源表示新面板會預先選取。 |
| URL | Loki 執行個體的 URL，例如 http://localhost:3100。這可以是 Amazon EC2 主機的 URL，或是 Amazon EKS 叢集前面的 Application Load Balancer，或是 Loki 執行個體的任何其他 URL。 |
| Maximum lines | Loki 傳回的日誌行數上限 （預設為 1000)。在探索中顯示日誌時，如果您的瀏覽器緩慢，請減少 。 |
### 衍生欄位
您可以使用*衍生欄位*組態來執行下列動作：
+ 新增從日誌訊息剖析的欄位。
+ 新增使用 欄位值的連結。
您可以使用此功能直接從您的日誌連結到您的追蹤後端，或者如果日誌列中存在 userId，則連結到使用者設定檔頁面。這些連結會出現在日誌詳細資訊中。如需詳細資訊，請參閱[標籤和偵測到的欄位](explore.md#labels-and-detected-fields)。
每個衍生欄位都包含下列項目：
+ **名稱** – 在日誌詳細資訊中顯示為標籤。
+ **Regex** – 在日誌訊息上執行的 Regex 模式，並將其部分擷取為新欄位的值。只能包含單一擷取群組。
+ **URL/查詢** – 如果連結是外部連結，請輸入完整的連結 URL。如果連結是內部連結，則此輸入會做為目標資料來源的查詢。在這兩種情況下，您可以將 欄位的值插入`${__value.raw }`巨集。
+ **內部連結** – 選取連結是內部或外部。如果是內部連結，資料來源選取器可讓您選取目標資料來源。僅支援追蹤資料來源。
您可以使用偵錯區段來查看欄位擷取的內容以及 URL 插入的方式。選擇**顯示範例日誌訊息**，以顯示您可以輸入日誌訊息的文字區域。
具有顯示在日誌詳細資訊中連結的新欄位。
## 查詢 日誌
透過探索和視覺化中的日誌面板，查詢和顯示 Loki 的日誌資料。選取 Loki 資料來源，然後輸入 LogQL 查詢以顯示您的日誌。如需 LogQL 的詳細資訊，請參閱 [LogQL](https://grafana.com/docs/loki/latest/logql/)。
### 日誌查詢
日誌查詢包含兩個部分：**日誌串流選擇器**和**搜尋表達**式。基於效能考量，您必須從選擇日誌串流的日誌標籤開始。
查詢欄位旁的 Logs Explorer (**日誌標籤**按鈕） 會顯示可用日誌串流的標籤清單。撰寫查詢的替代方法是使用查詢欄位的自動完成。首先輸入左大括號`{`，自動完成功能表會建議標籤清單。按 **Enter** 鍵執行查詢。
傳回結果後，日誌面板會顯示日誌資料列清單和長條圖，其中 x 軸顯示時間，y 軸顯示頻率/計數。
### 日誌串流選取器
對於查詢表達式的標籤部分，請以大括號包裝，`{}`然後使用索引鍵值語法來選取標籤。多個標籤表達式以逗號分隔：
`{app="mysql",name="mysql-backup"}`
目前支援下列標籤比對運算子：
+ `=` 完全相同。
+ `!=` 不相等。
+ `=~` regex-match。
+ `!~` 不要進行 regex-match。
範例：
+ `{name=~"mysql.+"}`
+ `{name!~"mysql.+"}`
新增標籤選擇器的另一種方式是在資料表區段中。選擇標籤旁的**篩選條件**，將標籤新增至查詢表達式。這甚至適用於多個查詢，並將標籤選擇器新增至每個查詢。
### 搜尋表達式
撰寫日誌串流選取器之後，您可以透過撰寫搜尋表達式進一步篩選結果。搜尋表達式可以是文字或 regex 表達式。
範例查詢：
+ `{job="mysql"} |= "error"`
+ `{name="kafka"} |~ "tsdb-ops.*io:2003"`
+ `{instance=~"kafka-[23]",name="kafka"} != "kafka.server:type=ReplicaManager"`
篩選條件運算子可以鏈結，並依序篩選表達式。產生的日誌行將滿足每個篩選條件。
範例
`{job="mysql"} |= "error" != "timeout"`
目前支援下列篩選條件類型：
+ `|=` 行包含字串。
+ `!=` 行不包含字串。
+ `|~` 行符合規則表達式。
+ `!~` 行不符合規則表達式。
**注意**
如需 Loki 查詢語言 LogQL 的詳細資訊，請參閱 [Loki LogQL](https://grafana.com/docs/loki/latest/logql/)。
## 日誌內容
使用上述的搜尋表達式時，您現在可以擷取篩選結果周圍的內容。透過選擇篩選資料列上的`Show Context`連結，您將能夠調查您感興趣的日誌訊息前後的日誌訊息。
## 範本化
您可以在指標查詢中使用變數，而不是硬式編碼，例如伺服器、應用程式和感應器名稱。變數會顯示為儀表板頂端的下拉式清單選取方塊。您可以使用這些下拉式方塊來變更儀表板中顯示的資料。
如需範本和範本變數的詳細資訊，請參閱 [範本和變數](templates-and-variables.md)。
## 註釋
您可以使用任何非指標 Loki 查詢做為註釋的來源。日誌內容將用作註釋文字，而日誌串流標籤將用作標籤，因此不需要額外的映射。
# 連線至 Microsoft SQL Server 資料來源
使用 Microsoft SQL Server (MSSQL) 資料來源查詢和視覺化任何 Microsoft SQL Server 2005 或更新版本的資料，包括 Microsoft Azure SQL Database。
**重要**
Grafana 8.0 版會變更 Microsoft SQL Server、Postgres 和 MySQL 的資料框架基礎資料結構。因此，時間序列查詢結果會以寬格式傳回。如需詳細資訊，請參閱 Grafana 資料影格文件中的[廣角格式](https://grafana.com/developers/plugin-tools/introduction/data-frames#wide-format)。
若要讓視覺化效果如之前一樣運作，您可能需要進行一些手動遷移。一個解決方案記錄在 Github 上的 [Postgres/MySQL/MSSQL：中斷 v8.0 中與時間序列查詢和資料欄排序相關的變更](https://github.com/grafana/grafana/issues/35534)。
## 新增資料來源
1. 選擇頂端標頭中的 Grafana 圖示，開啟側邊選單。
1. 在連結下方的側邊選單中，****您應該會找到**資料來源**連結。
1. 選擇頂端標頭中的 **\$1 新增資料來源**按鈕。
1. 從**類型**下拉式清單中選取 **Microsoft SQL Server**。
### 資料來源選項
| 名稱 | 描述 |
| --- | --- |
| Name | 資料來源名稱。這是您在面板和查詢中查看資料來源的方式。 |
| Default | 預設資料來源表示將針對新面板預先選取。 |
| Host | MSSQL 執行個體的 IP 地址/主機名稱和選用連接埠。如果省略連接埠，則會使用預設的 1433。 |
| Database | MSSQL 資料庫的名稱。 |
| User | 資料庫使用者的登入/使用者名稱。 |
| Password | 資料庫使用者的密碼。 |
| Encrypt | 此選項會決定安全 SSL TCP/IP 連線是否會與伺服器交涉，預設 false(Grafana v5.4\$1)。 |
| Max open | 預設資料庫的開啟連線數目上限 unlimited(Grafana v5.4\$1)。 |
| Max idle | 預設閒置連線集區中的連線數目上限 2(Grafana v5.4\$1)。 |
| Max lifetime | 可以重複使用連線的秒數上限，預設為 14400/4 小時。 |
### 最短時間間隔
`$_interval` `$_interval_ms` 變數的下限。建議設定為寫入頻率，例如`1m`，如果您的資料每分鐘寫入一次。也可以在資料來源選項下的儀表板面板中覆寫/設定此選項。此值的格式**必須是**數字，後面接著有效的時間識別符；例如 `1m`(1 分鐘） 或 `30s`(30 秒）。支援下列時間識別符。
| 識別符 | Description |
| --- | --- |
| y | 年 |
| M | 月 |
| w | 週 |
| d | 天 |
| h | 小時 |
| m | 分鐘 |
| s | 秒 |
| ms | 毫秒 |
### 資料庫使用者許可
**重要**
您在新增資料來源時指定的資料庫使用者，應只獲得您要查詢之指定資料庫和資料表的 SELECT 許可。Grafana 不會驗證查詢是否安全。查詢可能包含任何 SQL 陳述式。例如，`DROP TABLE user;`會執行 `DELETE FROM user;`和 等陳述式。為了防止這種情況，強烈建議您建立具有受限許可的特定 MSSQL 使用者。
下列範例程式碼顯示建立具有受限許可的特定 MSSQL 使用者。
```
CREATE USER grafanareader WITH PASSWORD 'password'
GRANT SELECT ON dbo.YourTable3 TO grafanareader
```
確定使用者未從公有角色取得任何不需要的許可。
### 已知問題
如果您使用的是舊版 Microsoft SQL Server，例如 2008 和 2008R2，您可能需要停用加密才能連線。如果可能，我們建議您使用最新的 Service Pack，以獲得最佳相容性。
## 查詢編輯器
您可以在圖形、Singlestat 或資料表面板的編輯模式中的指標索引標籤中找到 MSSQL 查詢編輯器。您可以選擇面板標題，然後選擇編輯，以進入編輯模式。編輯器可讓您定義 SQL 查詢，以選取要視覺化的資料。
1. 選取*格式化為* `Time series`（用於圖形或 Singlestat 面板等） 或 `Table`（用於資料表面板等）。
1. 這是您寫入 SQL 查詢的實際編輯器。
1. 在查詢編輯器下方顯示 MSSQL 的說明區段。
1. 顯示已執行的 SQL 查詢。成功執行查詢後，會先提供 。
1. 新增額外的查詢，其中會顯示額外的查詢編輯器。
## 巨集
為了簡化語法並允許動態部分，例如日期範圍篩選條件，查詢可以包含巨集。
| 巨集範例 | Description |
| --- | --- |
| \$1\$1\$1time(dateColumn) | 將由表達式取代，以不時重新命名資料欄。例如，dateColumn 做為時間 。 |
| \$1\$1\$1timeEpoch(dateColumn) | 將由表達式取代，將 DATETIME 資料欄類型轉換為 Unix 時間戳記，並將其重新命名為時間。例如，DATEDIFF（秒， "1970-01-01"， dateColumn) AS 時間。 |
| \$1\$1\$1timeFilter(dateColumn) | 將由使用指定資料欄名稱的時間範圍篩選條件取代。例如，dateColumn BETWEEN "2017-04-21T05：01：17Z" AND "2017-04-21T05：06：17Z"。 |
| \$1\$1\$1timeFrom() | 將由目前作用中時間選擇的開始取代。例如，「2017-04-21T05：01：17Z」。 |
| \$1\$1\$1timeTo() | 將取代為目前作用中時間選擇的結尾。例如，「2017-04-21T05：06：17Z」。 |
| \$1\$1\$1timeGroup(dateColumn,'5m'[, fillvalue]) | 將由 GROUP BY 子句中可用的表達式取代。提供 NULL 或浮點數的 fillValue 會自動以該值填入時間範圍中的空序列。例如，CAST(ROUND(DATEDIFF(second， "1970-01-01"， time\$1column)/300.0， 0) as bigint)\$1300。 |
| \$1\$1\$1timeGroup(dateColumn,'5m', 0) | 與上述相同，但具有填充參數，因此 grafana 會新增該系列中的遺失點，並使用 0 做為值。 |
| \$1\$1\$1timeGroup(dateColumn,'5m', NULL) | 與上述相同，但 NULL 將用作遺失點的值。 |
| \$1\$1\$1timeGroup(dateColumn,'5m', previous) | 與上述相同，但如果尚未看到 NULL，則會使用該序列中的上一個值作為填充值 （僅適用於 Grafana 5.3\$1)。 |
查詢編輯器具有**產生的 SQL** 連結，會在查詢執行後，在面板編輯模式中顯示。選擇它，它會展開並顯示已執行的原始插補 SQL 字串。
## 資料表查詢
如果查詢選項設定為 ，**Format as******Table，則基本上您可以執行任何類型的 SQL 查詢。資料表面板會自動顯示查詢傳回的任何資料欄和資料列的結果。
下列範例程式碼顯示資料庫資料表。
```
CREATE TABLE [event] (
time_sec bigint,
description nvarchar(100),
tags nvarchar(100),
)
```
```
CREATE TABLE [mssql_types] (
c_bit bit, c_tinyint tinyint, c_smallint smallint, c_int int, c_bigint bigint, c_money money, c_smallmoney smallmoney, c_numeric numeric(10,5),
c_real real, c_decimal decimal(10,2), c_float float,
c_char char(10), c_varchar varchar(10), c_text text,
c_nchar nchar(12), c_nvarchar nvarchar(12), c_ntext ntext,
c_datetime datetime, c_datetime2 datetime2, c_smalldatetime smalldatetime, c_date date, c_time time, c_datetimeoffset datetimeoffset
)
INSERT INTO [mssql_types]
SELECT
1, 5, 20020, 980300, 1420070400, '$20000.15', '£2.15', 12345.12,
1.11, 2.22, 3.33,
'char10', 'varchar10', 'text',
N'☺nchar12☺', N'☺nvarchar12☺', N'☺text☺',
GETDATE(), CAST(GETDATE() AS DATETIME2), CAST(GETDATE() AS SMALLDATETIME), CAST(GETDATE() AS DATE), CAST(GETDATE() AS TIME), SWITCHOFFSET(CAST(GETDATE() AS DATETIMEOFFSET), '-07:00')
```
下列範例程式碼顯示查詢。
```
SELECT * FROM [mssql_types]
```
您可以使用一般 `AS` SQL 資料欄選取語法來控制資料表面板資料欄的名稱，如下列範例程式碼所示。
```
SELECT
c_bit as [column1], c_tinyint as [column2]
FROM
[mssql_types]
```
產生的資料表面板：
## 時間序列查詢
如果您將**格式化設定為****時間序列**，例如在圖形面板中使用，查詢必須具有名為 的資料欄`time`，以秒為單位傳回 SQL 日期時間或任何代表 Unix epoch 的數值資料類型。您可以傳回名為 的資料欄`metric`，做為值資料欄的指標名稱。除了 `time`和 以外的任何資料欄`metric`都會視為值資料欄。如果您省略資料`metric`欄，值資料欄的名稱將是指標名稱。您可以選取多個值資料欄，每個資料欄的名稱都會做為指標。如果您傳回多個值資料欄和名為 的資料欄`metric`，則會使用此資料欄做為序列名稱的字首。
時間序列查詢的結果集必須依時間排序。
下列範例程式碼顯示資料庫資料表。
```
CREATE TABLE [event] (
time_sec bigint,
description nvarchar(100),
tags nvarchar(100),
)
```
```
CREATE TABLE metric_values (
time datetime,
measurement nvarchar(100),
valueOne int,
valueTwo int,
)
INSERT metric_values (time, measurement, valueOne, valueTwo) VALUES('2018-03-15 12:30:00', 'Metric A', 62, 6)
INSERT metric_values (time, measurement, valueOne, valueTwo) VALUES('2018-03-15 12:30:00', 'Metric B', 49, 11)
...
INSERT metric_values (time, measurement, valueOne, valueTwo) VALUES('2018-03-15 13:55:00', 'Metric A', 14, 25)
INSERT metric_values (time, measurement, valueOne, valueTwo) VALUES('2018-03-15 13:55:00', 'Metric B', 48, 10)
```
下列範例程式碼顯示一欄`value`和一`metric`欄。
```
SELECT
time,
valueOne,
measurement as metric
FROM
metric_values
WHERE
$__timeFilter(time)
ORDER BY 1
```
在圖形面板中使用上述查詢時，會產生兩個名為 `Metric A`和 的序列，`Metric B`其值為 `valueOne`，並`valueTwo`繪製在 上`time`。
下列範例程式碼顯示多個`value`資料欄。
```
SELECT
time,
valueOne,
valueTwo
FROM
metric_values
WHERE
$__timeFilter(time)
ORDER BY 1
```
在圖形面板中使用上述查詢時，會產生兩個名為 `Metric A`和 的序列，`Metric B`其值為 `valueOne`，並`valueTwo`繪製在 上`time`。
下列範例程式碼顯示使用 \$1\$1\$1timeGroup 巨集。
```
SELECT
$__timeGroup(time, '3m') as time,
measurement as metric,
avg(valueOne)
FROM
metric_values
WHERE
$__timeFilter(time)
GROUP BY
$__timeGroup(time, '3m'),
measurement
ORDER BY 1
```
在圖形面板中使用上一個查詢時，會產生兩個名為 `Metric A`和 的序列`Metric B`，其值為 `valueOne`，並`valueTwo`繪製在 上`time`。在三分鐘的時段內缺少值的任何兩個序列都會轉譯這兩行之間的線條。您會注意到右側的圖形永遠不會下降到零。
下列範例程式碼顯示使用 \$1\$1\$1timeGroup 巨集，且填充參數設為零。
```
SELECT
$__timeGroup(time, '3m', 0) as time,
measurement as metric,
sum(valueTwo)
FROM
metric_values
WHERE
$__timeFilter(time)
GROUP BY
$__timeGroup(time, '3m'),
measurement
ORDER BY 1
```
在圖形面板中使用此查詢時，結果是兩個名為 `Metric A`和 的序列`Metric B`，加總以 `valueTwo`繪製`time`。在 3 分鐘內缺少值的任何序列將具有零值，您會在右側的圖表中看到該值。
## 範本化
您可以在指標查詢中使用變數，而不是硬式編碼，例如伺服器、應用程式和感應器名稱。變數會顯示為儀表板頂端的下拉式清單選取方塊。您可以使用這些下拉式方塊來變更儀表板中顯示的資料。
如需範本和範本變數的詳細資訊，請參閱 [範本和變數](templates-and-variables.md)。
### 查詢變數
如果您新增類型 的範本變數`Query`，您可以撰寫 MSSQL 查詢，以傳回顯示為下拉式清單選取方塊的測量名稱、索引鍵名稱或索引鍵值等物件。
例如，如果您在範本變數查詢**設定中指定這類查詢，您可以有一個變數，其中包含資料表中資料`hostname`欄的所有值。
```
SELECT hostname FROM host
```
查詢可以傳回多個資料欄，Grafana 會自動從中建立清單。例如，下列查詢將傳回來自 `hostname`和 的值清單`hostname2`。
```
SELECT [host].[hostname], [other_host].[hostname2] FROM host JOIN other_host ON [host].[city] = [other_host].[city]
```
另一個選項是可建立索引鍵/值變數的查詢。查詢應傳回兩個名為 `__text`和 的資料欄`__value`。`__text` 資料欄值應該是唯一的 （如果不是唯一的，則會使用第一個值）。下拉式清單中的選項會有文字和值，可讓您將易記的名稱做為文字，並將 ID 做為值。使用 `hostname`做為文字和 `id`做為值的範例查詢：
```
SELECT hostname __text, id __value FROM host
```
您也可以建立巢狀變數。例如，如果您有另一個名為 的變數`region`。然後，您可以讓主機變數只顯示目前所選區域中具有此類查詢的主機 （如果 `region` 是多值變數，則使用`IN`比較運算子，而不是`=`比對多個值）。
```
SELECT hostname FROM host WHERE region IN ($region)
```
### 在查詢中使用變數
**注意**
只有在範本變數是 時，才會引用範本變數值`multi-value`。
如果變數是多值變數，請使用`IN`比較運算子`=`，而不是比對多個值。
有兩種語法：
`$` 範本變數名為 的範例`hostname`：
```
SELECT
atimestamp time,
aint value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in($hostname)
ORDER BY atimestamp
```
`[[varname]]` 範本變數名為 的範例`hostname`：
```
SELECT
atimestamp as time,
aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in([[hostname]])
ORDER BY atimestamp
```
#### 關閉多值變數的引號
Grafana 會自動為多值變數建立以逗號分隔的引號字串。例如，如果選取 `server02` `server01`和 ，則會格式化為：`'server01', 'server02'`。若要關閉引號，請使用變數的 csv 格式選項。
`${servers:csv}`
如需變數格式化選項的詳細資訊，請參閱 [範本和變數](templates-and-variables.md)。
## 註釋
您可以使用註釋在圖形上方覆蓋豐富的事件資訊。您可以透過儀表板功能表/註釋檢視新增註釋查詢。如需詳細資訊，請參閱[註釋](dashboard-annotations.md)。
**資料欄：**
| 名稱 | 描述 |
| --- | --- |
| time | 日期/時間欄位的名稱。可以是具有原生 SQL 日期/時間資料類型或 epoch 值的資料欄。 |
| timeend | 結束日期/時間欄位的選用名稱。可以是具有原生 SQL 日期/時間資料類型或 epoch 值的資料欄。 |
| text | 事件描述欄位。 |
| tags | 用於事件標籤的選用欄位名稱，做為逗號分隔字串。 |
下列範例程式碼顯示資料庫資料表。
```
CREATE TABLE [events] (
time_sec bigint,
description nvarchar(100),
tags nvarchar(100),
)
```
我們也使用 中定義的資料庫資料表[時間序列查詢](#mssql-time-series-queries)。
下列範例程式碼使用具有 epoch 值的時間欄來顯示查詢。
```
SELECT
time_sec as time,
description as [text],
tags
FROM
[events]
WHERE
$__unixEpochFilter(time_sec)
ORDER BY 1
```
下列範例程式碼顯示使用具有 epoch 值的時間和結束時間資料欄的區域查詢。
```
SELECT
time_sec as time,
time_end_sec as timeend,
description as [text],
tags
FROM
[events]
WHERE
$__unixEpochFilter(time_sec)
ORDER BY 1
```
下列範例程式碼顯示使用原生 SQL 日期/時間資料類型的時間欄的查詢。
```
SELECT
time,
measurement as text,
convert(varchar, valueOne) + ',' + convert(varchar, valueTwo) as tags
FROM
metric_values
WHERE
$__timeFilter(time_column)
ORDER BY 1
```
## 預存程序支援
已驗證存放程序是否正常運作。不過，在某些情況下，它可能無法如您預期般運作。應支援資料表、時間序列和註釋查詢中存放的程序，只要您使用相同的資料欄命名，並以與先前各章節所述的相同格式傳回資料。
巨集函數無法在預存程序中運作。
### 範例
針對下列範例，資料庫資料表是在時間序列查詢中定義。假設您想要在圖形面板中視覺化四個序列，例如資料欄 `valueOne`、 `valueTwo`和 的所有組合`measurement`。右側的圖形面板可視覺化我們想要達成的目標。若要解決此問題，您必須使用兩個查詢：
下列範例程式碼顯示第一個查詢。
```
SELECT
$__timeGroup(time, '5m') as time,
measurement + ' - value one' as metric,
avg(valueOne) as valueOne
FROM
metric_values
WHERE
$__timeFilter(time)
GROUP BY
$__timeGroup(time, '5m'),
measurement
ORDER BY 1
```
下列範例程式碼顯示第二個查詢。
```
SELECT
$__timeGroup(time, '5m') as time,
measurement + ' - value two' as metric,
avg(valueTwo) as valueTwo
FROM
metric_values
GROUP BY
$__timeGroup(time, '5m'),
measurement
ORDER BY 1
```
#### 使用 epoch 格式的時間存放程序
您可以定義預存程序，以傳回在如上述的圖形面板中轉譯四個序列所需的所有資料。在此情況下，預存程序接受兩種參數 `@from`和 `int`資料類型的 `@to`，其應為 epoch 格式的時間範圍 （從-到），用於篩選要從預存程序傳回的資料。
這會模擬選取`$__timeGroup(time, '5m')`中的 ，並依表達式分組，因此需要許多冗長的表達式。如果需要，這些可以解壓縮到 MSSQL 函數。
```
CREATE PROCEDURE sp_test_epoch(
@from int,
@to int
) AS
BEGIN
SELECT
cast(cast(DATEDIFF(second, {d '1970-01-01'}, DATEADD(second, DATEDIFF(second,GETDATE(),GETUTCDATE()), time))/600 as int)*600 as int) as time,
measurement + ' - value one' as metric,
avg(valueOne) as value
FROM
metric_values
WHERE
time >= DATEADD(s, @from, '1970-01-01') AND time <= DATEADD(s, @to, '1970-01-01')
GROUP BY
cast(cast(DATEDIFF(second, {d '1970-01-01'}, DATEADD(second, DATEDIFF(second,GETDATE(),GETUTCDATE()), time))/600 as int)*600 as int),
measurement
UNION ALL
SELECT
cast(cast(DATEDIFF(second, {d '1970-01-01'}, DATEADD(second, DATEDIFF(second,GETDATE(),GETUTCDATE()), time))/600 as int)*600 as int) as time,
measurement + ' - value two' as metric,
avg(valueTwo) as value
FROM
metric_values
WHERE
time >= DATEADD(s, @from, '1970-01-01') AND time <= DATEADD(s, @to, '1970-01-01')
GROUP BY
cast(cast(DATEDIFF(second, {d '1970-01-01'}, DATEADD(second, DATEDIFF(second,GETDATE(),GETUTCDATE()), time))/600 as int)*600 as int),
measurement
ORDER BY 1
END
```
然後，您可以針對圖形面板使用下列查詢。
```
DECLARE
@from int = $__unixEpochFrom(),
@to int = $__unixEpochTo()
EXEC dbo.sp_test_epoch @from, @to
```
#### 使用日期時間格式的時間存放程序
您可以定義預存程序，以傳回在如上述的圖形面板中轉譯四個序列所需的所有資料。在此情況下，預存程序接受兩種參數 `@from`和 `datetime`資料類型`@to`的 ，其應為時間範圍 （從-到），將用於篩選要從預存程序傳回的資料。
這會模擬選取`$__timeGroup(time, '5m')`中的 ，並依表達式分組，因此需要許多冗長的表達式。如果需要，這些可以解壓縮到 MSSQL 函數。
```
CREATE PROCEDURE sp_test_datetime(
@from datetime,
@to datetime
) AS
BEGIN
SELECT
cast(cast(DATEDIFF(second, {d '1970-01-01'}, time)/600 as int)*600 as int) as time,
measurement + ' - value one' as metric,
avg(valueOne) as value
FROM
metric_values
WHERE
time >= @from AND time <= @to
GROUP BY
cast(cast(DATEDIFF(second, {d '1970-01-01'}, time)/600 as int)*600 as int),
measurement
UNION ALL
SELECT
cast(cast(DATEDIFF(second, {d '1970-01-01'}, time)/600 as int)*600 as int) as time,
measurement + ' - value two' as metric,
avg(valueTwo) as value
FROM
metric_values
WHERE
time >= @from AND time <= @to
GROUP BY
cast(cast(DATEDIFF(second, {d '1970-01-01'}, time)/600 as int)*600 as int),
measurement
ORDER BY 1
END
```
然後，您可以針對圖形面板使用下列查詢。
```
DECLARE
@from datetime = $__timeFrom(),
@to datetime = $__timeTo()
EXEC dbo.sp_test_datetime @from, @to
```
## 提醒
時間序列查詢應在提醒條件下運作。警示規則條件中尚不支援資料表格式的查詢。
# 連線至 MySQL 資料來源
新增 MySQL 資料來源，以查詢和視覺化 MySQL 相容資料庫中的資料。
**重要**
Grafana 8.0 版會變更 MySQL、Postgres 和 Microsoft SQL Server 資料來源的資料影格基礎資料結構。因此，時間序列查詢結果會以寬格式傳回。如需詳細資訊，請參閱 Grafana 資料影格文件中的[廣角格式](https://grafana.com/developers/plugin-tools/introduction/data-frames#wide-format)。
若要讓視覺化效果如之前一樣運作，您可能需要進行一些手動遷移。一個解決方案記錄在 Github 上的 [Postgres/MySQL/MSSQL：中斷 v8.0 中與時間序列查詢和資料欄排序相關的變更](https://github.com/grafana/grafana/issues/35534)。
## 新增資料來源
1. 選擇頂端標頭中的 Grafana 圖示，開啟側邊選單。
1. 在**儀表板**連結下的側邊選單中，您應該會找到名為**資料來源**的連結。
1. 選擇頂端標頭中的 **\$1 新增資料來源**按鈕。
1. 從**類型**下拉式清單中選取 **MySQL**。
### 資料來源選項
| 名稱 | 描述 |
| --- | --- |
| Name | 資料來源名稱。這是您在面板和查詢中查看資料來源的方式。 |
| Default | 預設資料來源表示將針對新面板預先選取。 |
| Host | MySQL 執行個體的 IP 地址/主機名稱和選用連接埠。 |
| Database | MySQL 資料庫的名稱。 |
| User | 資料庫使用者的登入/使用者名稱。 |
| Password | 資料庫使用者的密碼。 |
| Max open | 預設資料庫的開啟連線數目上限 unlimited(Grafana v5.4\$1)。 |
| Max idle | 預設閒置連線集區中的連線數目上限 2(Grafana v5.4\$1)。 |
| Max lifetime | 可以重複使用連線的秒數上限，預設為 14400/4 小時。這應一律低於 MySQL 中設定的 [wait\$1timeout](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_wait_timeout) (Grafana v5.4\$1)。 |
### 最短時間間隔
`$_interval` `$_interval_ms` 變數的下限。建議設定為寫入頻率，例如`1m`，如果您的資料每分鐘寫入一次。也可以在資料來源選項下的儀表板面板中覆寫/設定此選項。此值的格式**必須是**數字，後面接著有效的時間識別符；例如 `1m`(1 分鐘） 或 `30s`(30 秒）。支援下列時間識別符。
| 識別符 | Description |
| --- | --- |
| y | 年 |
| M | 月 |
| w | 週 |
| d | 天 |
| h | 小時 |
| m | 分鐘 |
| s | 秒 |
| ms | 毫秒 |
### 資料庫使用者許可
**重要**
您在新增資料來源時指定的資料庫使用者，應僅獲得您要查詢之指定資料庫和資料表的 SELECT 許可。Grafana 不會驗證查詢是否安全。查詢可能包含任何 SQL 陳述式。例如，`DROP TABLE user;`會執行 `USE otherdb;`和 等陳述式。為了防止這種情況，強烈建議您建立具有受限許可的特定 MySQL 使用者。
下列程式碼範例顯示建立具有受限許可的特定 MySQL 使用者。
```
CREATE USER 'grafanaReader' IDENTIFIED BY 'password';
GRANT SELECT ON mydatabase.mytable TO 'grafanaReader';
```
若要授予對更多資料庫和資料表的存取權，您可以視需要使用萬用字元 (`*`) 取代資料庫或資料表。
## 查詢編輯器
您可以在面板編輯模式中的指標索引標籤中找到 MySQL 查詢編輯器。您可以選擇面板標題，然後選擇編輯，以進入**編輯**模式。
查詢編輯器具有**產生的 SQL** 連結，會在查詢執行後，在面板編輯模式中顯示。選擇它，它會展開並顯示已執行的原始插補 SQL 字串。
### 選取資料表、時間欄和指標欄 (FROM)
當您第一次進入編輯模式或新增查詢時，Grafana 會嘗試使用具有時間戳記欄和數值欄的第一個資料表預先填入查詢建置器。
在 FROM 欄位中，Grafana 會建議已設定資料庫中的資料表。若要選取資料庫使用者可存取的另一個資料庫中的資料表或檢視，您可以手動輸入完整名稱 (database.table)，例如 `otherDb.metrics`。
時間欄欄位是指保留時間值的資料欄名稱。選取指標資料欄欄位的值是選用的。如果選取值，則會使用指標欄欄位做為序列名稱。
指標欄建議只會包含具有文字資料類型 （文字、小文字、中文字、長文字、varchar、char) 的資料欄。如果您想要使用具有不同資料類型的資料欄做為指標資料欄，您可以輸入具有轉換的資料欄名稱：`CAST(numericColumn as CHAR)`。您也可以在評估為文字資料類型的指標資料欄欄位中輸入任意 SQL 表達式，例如 `CONCAT(column1, " ", CAST(numericColumn as CHAR))`。
### 資料欄和彙總函數 (SELECT)
在 `SELECT`列中，您可以指定要使用的資料欄和函數。在資料欄欄位中，您可以撰寫任意表達式，而不是資料欄名稱，例如 `column1 * column2 / column3`。
如果您使用彙總函數，則必須將結果集分組。`GROUP BY time`如果您新增彙總函數，編輯器會自動新增 。
您可以選擇加號按鈕並從`Column`選單中選取，以新增更多值欄。圖形面板中的多個值資料欄將繪製為個別序列。
### 篩選資料 (WHERE)
若要新增篩選條件，請選擇`WHERE`條件右側的加號圖示。您可以透過選擇篩選條件並選取 來移除篩選條件`Remove`。目前所選時間範圍的篩選條件會自動新增至新查詢。
### 分組依據
若要依時間或任何其他資料欄分組，請選擇 GROUP BY 資料列結尾的加號圖示。建議下拉式清單只會顯示目前所選資料表的文字資料欄，但您可以手動輸入任何資料欄。您可以透過選擇項目，然後選擇 來移除群組`Remove`。
如果您新增任何分組，則所有選取的資料欄都必須套用彙總函數。當您新增分組時，查詢建置器會自動將彙總函數新增至所有資料欄，而不需要彙總函數。
#### 間隙填充
當您依時間分組時，Grafana 可以填入缺少的值。時間函數接受兩個引數。第一個引數是您要分組的時間範圍，第二個引數是您希望 Grafana 填入缺少項目的值。
### 文字編輯器模式 （原始）
您可以選擇漢堡圖示並選取**切換編輯器模式，或選擇查詢下方的編輯 SQL，即可切換到原始查詢編輯器模式**。 ****
**注意**
如果您使用原始查詢編輯器，請確定您的查詢至少具有 ，`ORDER BY time`並在傳回的時間範圍上有一個篩選條件。
## 巨集
為了簡化語法並允許動態部分，例如日期範圍篩選條件，查詢可以包含巨集。
| 巨集範例 | Description |
| --- | --- |
| \$1\$1\$1time(dateColumn) | 將由表達式取代，以轉換為 UNIX 時間戳記，並將資料欄重新命名為 time\$1sec；例如 UNIX\$1TIMESTAMP(dateColumn) 作為 time\$1sec。 |
| \$1\$1\$1timeEpoch(dateColumn) | 將由表達式取代，以轉換為 UNIX 時間戳記，並將資料欄重新命名為 time\$1sec；例如 UNIX\$1TIMESTAMP(dateColumn) 作為 time\$1sec。 |
| \$1\$1\$1timeFilter(dateColumn) | 將由使用指定資料欄名稱的時間範圍篩選條件取代。例如，dateColumn BETWEEN FROM\$1UNIXTIME(1494410783) 和 FROM\$1UNIXTIME(1494410983)。 |
| \$1\$1\$1timeFrom() | 將由目前作用中時間選擇的開始取代。例如 FROM\$1UNIXTIME(1494410783)。 |
| \$1\$1\$1timeTo() | 將取代為目前作用中時間選擇的結尾。例如 FROM\$1UNIXTIME(1494410983)。 |
| \$1\$1\$1timeGroup(dateColumn,'5m') | 將由 GROUP BY 子句中可用的表達式取代。例如，Cast(cast(UNIX\$1TIMESTAMP(dateColumn)/(300) 為已簽署），300 為已簽署），\$1 |
| \$1\$1\$1timeGroup(dateColumn,'5m', 0) | 與上一列相同，但具有填充參數，因此 grafana 會新增該系列中的遺失點，並使用 0 做為值。 |
| \$1\$1\$1timeGroup(dateColumn,'5m', NULL) | 與上述相同，但 NULL 將用作遺失點的值。 |
| \$1\$1\$1timeGroup(dateColumn,'5m', previous) | 與上述相同，但如果尚未看到 NULL，則會使用該序列中的上一個值作為填充值 （僅適用於 Grafana 5.3\$1)。 |
| \$1\$1\$1timeGroupAlias(dateColumn,'5m') | 將與 相同，\$1\$1\$1timeGroup但以新增的資料欄別名取代 （僅適用於 Grafana 5.3\$1)。 |
| \$1\$1\$1unixEpochFilter(dateColumn) | 將使用指定資料欄名稱取代為時間範圍篩選條件，時間表示為 Unix 時間戳記。例如 dateColumn > 1494410783 AND dateColumn < 1494497183。 |
| \$1\$1\$1unixEpochFrom() | 將由目前作用中時間選擇的開頭取代為 Unix 時間戳記。例如 1494410783。 |
| \$1\$1\$1unixEpochTo() | 將被目前作用中時間選擇的結尾取代為 Unix 時間戳記。例如 1494497183。 |
| \$1\$1\$1unixEpochNanoFilter(dateColumn) | 將使用指定的資料欄名稱取代為時間範圍篩選條件，時間表示為奈秒時間戳記。例如 dateColumn > 1494410783152415214 AND dateColumn < 1494497183142514872。 |
| \$1\$1\$1unixEpochNanoFrom() | 將由目前作用中時間選擇的開頭取代為奈秒時間戳記。例如 1494410783152415214。 |
| \$1\$1\$1unixEpochNanoTo() | 將被目前作用中時間選擇的結尾取代為奈秒時間戳記。例如 1494497183142514872。 |
| \$1\$1\$1unixEpochGroup(dateColumn,"5m", [fillmode]) | 與 相同，\$1\$1\$1timeGroup但適用於儲存為 Unix 時間戳記的時間 （僅適用於 Grafana 5.3\$1)。 |
| \$1\$1\$1unixEpochGroupAlias(dateColumn,"5m", [fillmode])` | 與上述相同，但也會新增資料欄別名 （僅適用於 Grafana 5.3\$1)。 |
查詢編輯器具有**產生的 SQL** 連結，會在查詢執行後，在面板編輯模式中顯示。選擇它，它會展開並顯示已執行的原始插補 SQL 字串。
## 資料表查詢
如果**格式化為**查詢選項設定為**資料表**，基本上您可以執行任何類型的 SQL 查詢。資料表面板會自動顯示查詢傳回的任何資料欄和資料列的結果。
下列程式碼顯示範例查詢。
```
SELECT
title as 'Title',
user.login as 'Created By' ,
dashboard.created as 'Created On'
FROM dashboard
INNER JOIN user on user.id = dashboard.created_by
WHERE $__timeFilter(dashboard.created)
```
您可以使用一般 `as` SQL 資料欄選取語法來控制資料表面板資料欄的名稱。
## 時間序列查詢
如果您**將 格式**設定為**時間序列**，例如用於圖形面板，查詢必須傳回名為 的資料欄`time`，該資料欄會傳回 SQL 日期時間或任何代表 Unix epoch 的數值資料類型。除了 `time`和 以外的任何資料欄`metric`都會視為值資料欄。您可以傳回名為 的資料欄`metric`，做為值資料欄的指標名稱。如果您傳回多個值資料欄和名為 的資料欄`metric`，則此資料欄會用作序列名稱的字首 （僅適用於 Grafana 5.3\$1)。
時間序列查詢的結果集必須依時間排序。
下列程式碼範例顯示 `metric`欄。
```
SELECT
$__timeGroup(time_date_time,'5m'),
min(value_double),
'min' as metric
FROM test_data
WHERE $__timeFilter(time_date_time)
GROUP BY time
ORDER BY time
```
下列程式碼範例顯示使用 \$1\$1\$1timeGroup 巨集中的填充參數，將 null 值改為零。
```
SELECT
$__timeGroup(createdAt,'5m',0),
sum(value_double) as value,
measurement
FROM test_data
WHERE
$__timeFilter(createdAt)
GROUP BY time, measurement
ORDER BY time
```
下列程式碼範例顯示多個資料欄。
```
SELECT
$__timeGroup(time_date_time,'5m'),
min(value_double) as min_value,
max(value_double) as max_value
FROM test_data
WHERE $__timeFilter(time_date_time)
GROUP BY time
ORDER BY time
```
根據時間範圍和面板寬度，不支援依時間的動態群組。
## 範本化
您可以在指標查詢中使用變數，而不是硬式編碼，例如伺服器、應用程式和感應器名稱。變數會顯示為儀表板頂端的下拉式清單選取方塊。您可以使用這些下拉式方塊來變更儀表板中顯示的資料。
如需範本和範本變數的詳細資訊，請參閱 [範本](templates-and-variables.md#templates)。
### 查詢變數
如果您新增類型 的範本變數`Query`，您可以撰寫 MySQL 查詢，以傳回顯示為下拉式清單選取方塊的測量名稱、索引鍵名稱或索引鍵值等物件。
例如，如果您在範本變數查詢**設定中指定這類查詢，您可以有一個變數，其中包含資料表中資料`hostname`欄的所有值。
```
SELECT hostname FROM my_host
```
查詢可以傳回多個資料欄，Grafana 會自動從中建立清單。例如，下列查詢將傳回來自 `hostname`和 的值清單`hostname2`。
```
SELECT my_host.hostname, my_other_host.hostname2 FROM my_host JOIN my_other_host ON my_host.city = my_other_host.city
```
若要在查詢`$__timeFilter(column)`中使用時間範圍相依巨集，例如 ，範本變數的重新整理模式必須設定為*時間範圍變更*。
```
SELECT event_name FROM event_log WHERE $__timeFilter(time_column)
```
另一個選項是可建立索引鍵/值變數的查詢。查詢應傳回兩個名為 `__text`和 的資料欄`__value`。`__text` 資料欄值應該是唯一的 （如果不是唯一的，則會使用第一個值）。下拉式清單中的選項會有文字和值，因此您可以將易記的名稱做為文字，並將 ID 做為值。
下列程式碼範例顯示使用 `hostname`做為文字和 `id` 做為值的查詢。
```
SELECT hostname AS __text, id AS __value FROM my_host
```
您也可以建立巢狀變數。例如，如果您有另一個名為 的變數`region`。然後，您可以讓主機變數只顯示目前所選區域中具有此類查詢的主機 （如果 `region` 是多值變數，則使用`IN`比較運算子，而不是`=`比對多個值）。
```
SELECT hostname FROM my_host WHERE region IN($region)
```
#### 使用 `__searchFilter` 在查詢變數中篩選結果
`__searchFilter` 在查詢欄位中使用 會根據下拉式清單選取方塊中的使用者類型來篩選查詢結果。當使用者未輸入任何內容時， 的預設值`__searchFilter`為 `%`。
**注意**
請務必使用引號括住`__searchFilter`表達式，因為 Grafana 不會為您執行此操作。
下列範例示範如何使用 `__searchFilter`做為查詢欄位的一部分，以在下拉式清單選取方塊中的使用者類型`hostname`時啟用搜尋。
```
SELECT hostname FROM my_host WHERE hostname LIKE '$__searchFilter'
```
### 在查詢中使用變數
從 Grafana 4.3.0 到 4.6.0，範本變數一律會自動引號，因此如果是字串值，則不會在 子句所在的引號中包裝它們。
從 Grafana 4.7.0 開始，只有在範本變數為 時，才會引用範本變數值。 `multi-value`
如果變數是多值變數，請使用`IN`比較運算子`=`，而不是比對多個值。
有兩種語法：
`$` 範本變數名為 的範例`hostname`：
```
SELECT
UNIX_TIMESTAMP(atimestamp) as time,
aint as value,
avarchar as metric
FROM my_table
WHERE $__timeFilter(atimestamp) and hostname in($hostname)
ORDER BY atimestamp ASC
```
`[[varname]]` 範本變數名為 的範例`hostname`：
```
SELECT
UNIX_TIMESTAMP(atimestamp) as time,
aint as value,
avarchar as metric
FROM my_table
WHERE $__timeFilter(atimestamp) and hostname in([[hostname]])
ORDER BY atimestamp ASC
```
#### 關閉多值變數的引號
Grafana 會自動為多值變數建立以逗號分隔的引號字串。例如：如果選取 `server02` `server01`和 ，則會格式化為：`'server01', 'server02'`。若要關閉引號，請使用變數的 csv 格式選項。
`${servers:csv}`
如需變數格式化選項的詳細資訊，請參閱 [進階變數格式選項](templates-and-variables.md#advanced-variable-format-options)。
## 註釋
您可以使用註釋在圖形上方覆蓋豐富的事件資訊。您可以透過儀表板功能表/註釋檢視新增註釋查詢。如需詳細資訊，請參閱。
下列範例程式碼顯示使用具有 epoch 值的時間欄的查詢。
```
SELECT
epoch_time as time,
metric1 as text,
CONCAT(tag1, ',', tag2) as tags
FROM
public.test_data
WHERE
$__unixEpochFilter(epoch_time)
```
下列範例程式碼顯示使用具有 epoch 值的時間和結束時間資料欄進行區域查詢。
**注意**
僅適用於 Grafana v6.6\$1。
```
SELECT
epoch_time as time,
epoch_timeend as timeend,
metric1 as text,
CONCAT(tag1, ',', tag2) as tags
FROM
public.test_data
WHERE
$__unixEpochFilter(epoch_time)
```
下列範例程式碼使用原生 SQL 日期/時間資料類型的時間資料欄顯示查詢。
```
SELECT
native_date_time as time,
metric1 as text,
CONCAT(tag1, ',', tag2) as tags
FROM
public.test_data
WHERE
$__timeFilter(native_date_time)
```
| 名稱 | 描述 |
| --- | --- |
| time | 日期/時間欄位的名稱。可以是具有原生 SQL 日期/時間資料類型或 epoch 值的資料欄。 |
| timeend | 結束日期/時間欄位的選用名稱。可以是具有原生 SQL 日期/時間資料類型或 epoch 值的資料欄。 |
| text | 事件描述欄位。 |
| tags | 用於事件標籤的選用欄位名稱，做為逗號分隔字串。 |
## 提醒
時間序列查詢應在提醒條件下運作。警示規則條件中尚不支援資料表格式的查詢。
# 連線至 OpenSearch 資料來源
**注意**
在支援第 9 版或更新版本的工作區中，此資料來源可能需要您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
使用 Amazon Managed Grafana，您可以將開放原始碼 [OpenSearch](https://opensearch.org/docs/) （或舊版 Elasticsearch) 新增為資料來源。您可以執行許多類型的簡單或複雜的 OpenSearch 查詢，以視覺化儲存在 OpenSearch 中的日誌或指標。您也可以使用儲存在 OpenSearch 中的日誌事件來註釋圖表。
## 新增 OpenSearch 做為資料來源
**注意**
若要能夠新增 OpenSearch 資料來源，您需要將 Grafana IAM 帳戶新增至 ALL\$1ACCESS 和 SECURITY\$1MANAGER 角色。
1. 選擇頂端標頭中的 Grafana 圖示，開啟側邊選單。
1. 在**儀表板**連結下的側邊選單中，您應該會找到具名**資料來源**連結。
1. 選擇頂端標頭中的 **\$1 新增資料來源**按鈕。
1. 從**類型**下拉式清單中選取 **OpenSearch**。
**注意**
如果您在側邊選單中看不到**資料來源**連結，這表示您目前的使用者沒有 `Admin`角色。
| 名稱 | 描述 |
| --- | --- |
| Name | 資料來源名稱。這是您在面板和查詢中查看資料來源的方式。 |
| Default | 預設資料來源表示將針對新面板預先選取。 |
| Url | OpenSearch 伺服器的 HTTP 通訊協定、IP 和連接埠。 |
| Access | 伺服器 （預設） = URL 必須可從 Grafana 後端/伺服器存取。瀏覽器 = URL 必須可從瀏覽器存取。 |
存取模式控制將如何處理對資料來源的請求。如果未說明其他項目，伺服器應該是偏好的方式。
### 伺服器存取模式 （預設）
所有請求都是從瀏覽器向 Grafana 後端或伺服器提出，其會將請求轉送至資料來源，以規避可能的跨來源資源共享 (CORS) 要求。如果您選擇此存取模式，則必須從 Grafana 後端或伺服器存取 URL。
### 瀏覽器 （直接） 存取
Amazon Managed Grafana 不支援 OpenSearch 資料來源的瀏覽器直接存取。
### 索引設定
您可以在這裡為 指定預設值，`time field`並指定 OpenSearch 索引的名稱。您可以使用索引名稱或萬用字元的時間模式。
### OpenSearch/Elasticsearch 版本
在版本下拉式選單中指定您的 OpenSearch 或舊版 Elasticsearch 版本。版本很重要，因為每個版本的查詢撰寫方式有所不同。目前，Grafana 支援 OpenSearch 1.0.x。支援的 Elasticsearch 版本為 `2.0+`、`5.0+`、`6.0+`、 `5.6+`和 `7.0+`。此值`5.6+`表示 5.6 版或更新版本，但低於 6.0。此值`6.0+`表示 6.0 版或更新版本，但低於 7.0。最後， `7.0+`表示 7.0 版或更新版本，但低於 8.0 版。
### 最短時間間隔
依時間間隔分類的自動群組下限。建議設定為寫入頻率；例如，`1m`如果您的資料每分鐘寫入一次。也可以在資料來源選項下的儀表板面板中覆寫/設定此選項。此值的格式**必須是**數字，後面接著有效的時間識別符；例如 `1m`(1 分鐘） 或 `30s`(30 秒）。支援下列時間識別符。
| 識別符 | Description |
| --- | --- |
| y | 年 |
| M | 月 |
| w | 週 |
| d | 天 |
| h | 小時 |
| m | 分鐘 |
| s | 秒 |
| ms | 毫秒 |
### 日誌
在 中視覺化日誌時`Level field name`，可以從資料來源設定頁面選擇性地設定兩個參數 `Message field name`和 ，以決定哪些欄位將用於日誌訊息和日誌層級[探索](explore.md)。
例如，如果您使用 Filebeat 的預設設定將日誌運送到 OpenSearch，則下列組態應該可以運作。
+ **訊息欄位名稱：**訊息
+ **層級欄位名稱：**Fields.level
### 資料連結
資料連結會從可在探索日誌檢視中存取的指定欄位建立連結。
每個資料連結組態都包含下列項目：
+ **欄位** – 資料連結所使用的欄位名稱。
+ **URL/查詢 ** – 如果連結是外部連結，請輸入完整的連結 URL。如果連結是內部連結，則此輸入會做為目標資料來源的查詢。在這兩種情況下，您可以將 欄位的值插入`${__value.raw }`巨集。
+ **內部連結** – 如果連結是內部或外部，請選取此選項。如果連結是內部連結，則資料來源選取器可讓您選取目標資料來源。僅支援追蹤資料來源。
## 使用 OpenSearch 資料來源
### 指標查詢編輯器
OpenSearch 查詢編輯器可讓您依多個詞彙或篩選條件選取多個指標和群組。使用右側的加號和減號圖示，依子句新增/移除指標或群組。有些指標和依子句分組都有選項。選擇選項文字來展開資料列，以檢視和編輯指標或依選項分組。
### 系列命名和別名模式
您可以透過`Alias`輸入欄位控制時間序列的名稱。
| 模式 | Description |
| --- | --- |
| \$1\$1term fieldname\$1\$1 | 以 Group By 一詞的值取代。 |
| \$1\$1metric\$1\$1 | 以指標名稱 （例如 平均值、最小值、最大值）。 |
| \$1\$1field\$1\$1 | 以指標欄位名稱取代。 |
### 管道指標
有些指標彙總稱為管道彙總，例如*移動平均*和*衍生*。OpenSearch 管道指標需要根據另一個指標。使用指標旁的眼睛圖示，隱藏指標不出現在圖形中。這對於您在查詢中只有用於管道指標的指標很有用。
### 範本化
您可以在指標查詢中使用變數，而不是硬式編碼，例如伺服器、應用程式和感應器名稱。變數會顯示為儀表板頂端的下拉式清單選取方塊。您可以使用這些下拉式方塊來變更儀表板中顯示的資料。
如需範本和範本變數的詳細資訊，請參閱 [範本和變數](templates-and-variables.md)。
#### 查詢變數
OpenSearch 資料來源支援兩種類型的查詢，您可以在*查詢*變數的*查詢*欄位中使用。查詢是使用自訂 JSON 字串撰寫。
| Query | Description |
| --- | --- |
| \$1"find": "fields", "type": "keyword"\$1 | 傳回索引類型為 的欄位名稱清單keyword。 |
| \$1"find": "terms", "field": "@hostname", "size": 1000\$1 | 使用詞彙彙總傳回欄位的值清單。查詢將使用目前的儀表板時間範圍做為查詢的時間範圍。 |
| \$1"find": "terms", "field": "@hostname", "query": ''\$1 | 使用詞彙彙總和指定的 Lucene 查詢篩選條件，傳回欄位的值清單。查詢將使用目前的儀表板時間範圍做為查詢的時間範圍。 |
詞彙查詢的預設大小限制為 500。若要設定自訂限制，請在查詢中設定大小屬性。您可以在查詢內使用其他變數。下列程式碼範例顯示名為 之變數的查詢定義`$host`。
```
{"find": "terms", "field": "@hostname", "query": "@source:$source"}
```
在上一個範例中，我們使用在查詢定義`$source`內名為 的另一個變數。每當您透過下拉式清單變更`$source`變數的目前值時，就會啟動`$host`變數的更新。更新之後， `$host`變數只會包含由 篩選的主機名稱，在此情況下為`@source`文件屬性。
預設情況下，這些查詢會依詞彙順序傳回結果 （然後，任何變數都可以按字母或數字排序）。若要產生依文件計數排序的詞彙清單 （前 N 個值清單），請新增 的 `orderBy` 屬性`doc_count`。這會自動選取遞減排序。使用 `asc`搭配 doc\$1count (N 底部清單） 可以透過設定 來完成`order: "asc"`，但不建議這麼做，因為它會增加文件計數的錯誤。若要將術語保留在文件計數順序中，請將變數的**排序**下拉式清單設定為**已停用**。或者，您可能仍然想要使用**按字母順序**重新排序它們。
```
{"find": "terms", "field": "@hostname", "orderBy": "doc_count"}
```
#### 在查詢中使用變數
有兩種語法：
+ `$` 範例：@hostname：\$1hostname
+ `[[varname]]` 範例：@hostname：【【hostname】】
為什麼使用兩種方式？ 第一個語法更容易讀取和寫入，但不允許您在單字中間使用變數。啟用*多值*或*包含所有值*選項時，Grafana 會將標籤從純文字轉換為 Lucene 相容條件。
在先前的範例中，我們有使用名為 的變數，根據 `@hostname` 屬性篩選文件的 lucene 查詢`$hostname`。它也在 Terms **群組中依欄位輸入方塊中使用變數。這可讓您使用變數來快速變更資料的分組方式。
### 註釋
註釋可讓您在圖形上方疊加豐富的事件資訊。您可以透過儀表板功能表或註釋檢視新增註釋查詢。Grafana 可以查詢註釋事件的任何 OpenSearch 索引。如需詳細資訊，請參閱[註釋](dashboard-annotations.md)。
| 名稱 | 描述 |
| --- | --- |
| Query | 您可以保持搜尋查詢空白，或指定 Lucene 查詢。 |
| Time | 時間欄位的名稱；必須是日期欄位。 |
| Time End | 時間結束欄位的選用名稱必須是日期欄位。如果設定，註釋將標記為時間與時間結束之間的區域。 |
| Text | 事件描述欄位。 |
| Tags | 用於事件標籤的選用欄位名稱 （可以是陣列或 CSV 字串）。 |
### 查詢 日誌
探索中提供從 OpenSearch 查詢和顯示日誌資料。若要顯示日誌，請選取 OpenSearch 資料來源，然後選擇性地輸入 Lucene 查詢。如需詳細資訊，請參閱[探索](explore.md)。
#### 日誌查詢
傳回結果後，日誌面板會顯示日誌資料列清單和長條圖，其中 x 軸顯示時間，y 軸顯示頻率或計數。
#### 篩選日誌訊息
或者，在查詢欄位中輸入 Lucene 查詢來篩選日誌訊息。例如，使用預設的 Filebeat 設定，您應該能夠使用 `fields.level:error` 僅顯示錯誤日誌訊息。
# 連線至 OpenTSDB 資料來源
Amazon Managed Grafana 隨附 OpenTSDB 的進階支援。
## 新增資料來源
1. 選擇頂端標頭中的 Grafana 圖示，開啟側邊選單。
1. 在**儀表板**連結下的側邊選單中，您應該會找到**資料來源**連結。
1. 選擇頂端標頭中的 **\$1 新增資料來源**按鈕。
1. 從**類型**下拉式清單中選取 **OpenTSDB**。
**注意**
如果您在側邊選單中看不到**資料來源**連結，這表示您目前的使用者沒有 `Admin`角色。
| 名稱 | 描述 |
| --- | --- |
| Name | 資料來源名稱。這是您在面板和查詢中查看資料來源的方式。 |
| Default | 預設資料來源表示新面板會預先選取該資料來源。 |
| Url | Opentsdb 伺服器的 HTTP 通訊協定、ip 和連接埠 （預設連接埠通常為 4242)。 |
| Access | 伺服器 （預設） = URL 必須可從 Grafana 後端/伺服器存取。 |
| Version | 版本 = opentsdb 版本，<=2.1 或 2.2。 |
| Resolution | Opentsdb 的指標可以具有秒或毫秒解析度的資料點。 |
## 查詢編輯器
選擇標題，以編輯模式開啟圖形。如果資料來源的版本 <=2.1 或 = 2.2，則查詢編輯器會有所不同。在舊版中，只有標籤可用於查詢 OpenTSDB。但在後者版本中，篩選條件以及標籤可用於查詢 opentsdb。填補政策也在 OpenTSDB 2.2 中推出。
**注意**
使用 OpenTSDB 2.2 資料來源時，請務必使用篩選條件或標籤，因為它們是互斥的。如果一起使用， 可能會為您提供奇怪的結果。
### 使用自動完成建議
一旦您開始輸入指標名稱、標籤名稱和標籤值 ，您應該會看到反白的自動完成建議。只有在 OpenTSDB 建議 API 已啟用時，自動完成才會運作。
## 範本查詢
您可以在指標查詢中使用變數，而不是硬式編碼，例如伺服器、應用程式和感應器名稱。變數會顯示為儀表板頂端的下拉式清單選取方塊。您可以使用這些下拉式方塊來變更儀表板中顯示的資料。
如需範本和範本變數的詳細資訊，請參閱 [範本和變數](templates-and-variables.md)。
### 查詢變數
OpenTSDB 資料來源支援範本變數查詢。這表示您可以建立範本變數，從 OpenTSDB 擷取值。例如，指標名稱、標籤名稱或標籤值。
使用 OpenTSDB 搭配 `query`類型的範本變數時，您可以使用下列語法進行查詢。
| Query | Description |
| --- | --- |
| metrics(prefix) | 傳回具有特定字首的指標名稱 （可以是空的）。 |
| tag\$1names(cpu) | 傳回特定 cpu 指標的標籤名稱 （即 索引鍵）。 |
| tag\$1values(cpu, hostname) | 傳回指標 cpu 和標籤索引鍵主機名稱的標籤值。 |
| suggest\$1tagk(prefix) | 傳回具有特定字首 （可以是空的） 之所有指標的標籤名稱 （即 索引鍵）。 |
| suggest\$1tagv(prefix) | 傳回具有特定字首的所有指標的標籤值 （可以是空的）。 |
如果您沒有看到範本變數在`Preview of values`區段中填入，您必須在 OpenTSDB 伺服器設定`tsd.core.meta.enable_realtime_ts`中啟用 。此外，若要在 OpenTSDB 中填入現有時間序列資料的中繼資料，您必須在 `tsdb uid metasync` OpenTSDB 伺服器上執行 。
### 巢狀範本
一個範本變數可用來篩選另一個範本變數的標籤值。第一個參數是指標名稱，第二個參數是您需要尋找標籤值的標籤索引鍵，之後所有其他相依範本變數。以下是一些範例，可讓巢狀範本查詢成功運作。
| Query | Description |
| --- | --- |
| tag\$1values(cpu, hostname, env=\$1env) | 傳回 cpu 指標的標籤值、選取的 env 標籤值和標籤索引鍵主機名稱。 |
| tag\$1values(cpu, hostname, env=\$1env, region=\$1region) | 傳回 cpu 指標的標籤值、選取的 env 標籤值、選取的區域標籤值和標籤索引鍵主機名稱。 |
如需 OpenTSDB 指標查詢的詳細資訊，請參閱 [OpenTSDB 文件](https://opentsdb.net/docs/build/html/index.html)
# 連線至 PostgreSQL 資料來源
您可以使用 PostgreSQL 資料來源來查詢和視覺化來自 Amazon Aurora PostgreSQL 資料庫的資料。
**重要**
*Grafana 第 8 版*會變更 Postgres、MySQL 和 Microsoft SQL Server 資料來源的資料影格基礎資料結構。因此，時間序列查詢結果會以寬格式傳回。如需詳細資訊，請參閱 Grafana 資料影格文件中的[寬格式](https://grafana.com/developers/plugin-tools/introduction/data-frames#wide-format)。若要讓視覺化效果如第 8 版之前一樣運作，您可能需要進行一些手動遷移。一個解決方案記錄在 Github 上的 [Postgres/MySQL/MSSQL：中斷 v8.0 中與時間序列查詢和資料欄排序相關的變更。](https://github.com/grafana/grafana/issues/35534)
在 *Grafana 第 9 版*中，PostgreSQL 資料來源會設定根憑證，以與先前版本不同的方式連線至資料庫。如果您將工作區從第 8 版更新至第 9 版，您可能需要變更連線方式。如需詳細資訊，請參閱[對更新工作區的問題進行故障診斷](AMG-workspace-version-update-troubleshoot.md)。
## 新增資料來源
1. 選擇頂端標頭中的 Grafana 圖示，開啟側邊選單。
1. 在側邊選單的**組態**圖示下，您應該會找到**資料來源**連結。
1. 選擇頂端標頭中的 **\$1 新增資料來源**按鈕。
1. 從**類型**下拉式清單中選取 **PostgreSQL**。
### 資料來源選項
| 名稱 | 描述 |
| --- | --- |
| Name | 資料來源名稱。這是您在面板和查詢中看到資料來源的方式。 |
| Default | 預設資料來源表示新面板會預先選取。 |
| Host | PostgreSQL 執行個體的 IP 地址/主機名稱和選用連接埠。請勿包含資料庫名稱。連線至 Postgres 的連線字串將不正確，且會導致錯誤。 |
| Database | PostgreSQL 資料庫的名稱。 |
| User | 資料庫使用者的登入/使用者名稱。 |
| Password | 資料庫使用者的密碼 |
| SSL Mode | 此選項會決定安全 SSL TCP/IP 連線是否或優先與伺服器交涉。 |
| Max open | 預設資料庫的開啟連線數目上限 unlimited(Grafana v5.4\$1)。 |
| Max idle | 預設閒置連線集區中的連線數目上限 2(Grafana v5.4\$1)。 |
| Max lifetime | 可以重複使用連線的秒數上限，預設 14400/4 小時 (Grafana v5.4\$1)。 |
| Version | 此選項會決定查詢建置器中可用的函數 （僅適用於 Grafana 5.3\$1)。 |
| TimescaleDB | TimescaleDB 是建置為 PostgreSQL 延伸模組的時間序列資料庫。如果啟用，Grafana 將在\$1\$1\$1timeGroup巨集time\$1bucket中使用 ，並在查詢建置器中顯示 TimescaleDB 特定彙總函數 （僅適用於 Grafana 5.3\$1)。 |
### 最短時間間隔
`$_interval` `$_interval_ms` 變數的下限。建議設定為寫入頻率，例如`1m`，如果資料每分鐘寫入一次。也可以在資料來源選項下的儀表板面板中覆寫/設定此選項。此值的格式**必須是**數字，後面接著有效的時間識別符；例如 `1m`(1 分鐘） 或 `30s`(30 秒）。支援下列時間識別符。
| 識別符 | Description |
| --- | --- |
| y | 年 |
| M | 月 |
| w | 週 |
| d | 天 |
| h | 小時 |
| m | 分鐘 |
| s | 秒 |
| ms | 毫秒 |
### 資料庫使用者許可
**重要**
您在新增資料來源時指定的資料庫使用者，應只獲得您要查詢之指定資料庫和資料表的 SELECT 許可。Grafana 不會驗證查詢是否安全。查詢可能包含任何 SQL 陳述式。例如，`DROP TABLE user;`會執行 `DELETE FROM user;`和 等陳述式。為了防止這種情況，強烈建議您建立具有受限許可的特定 PostgreSQL 使用者。
下列範例程式碼顯示建立具有受限許可的 specifice PostgreSQL 使用者。
```
CREATE USER grafanareader WITH PASSWORD 'password';
GRANT USAGE ON SCHEMA schema TO grafanareader;
GRANT SELECT ON schema.table TO grafanareader;
```
確定使用者未從公有角色取得任何不需要的許可。
## 查詢編輯器
您可以在圖形或 Singlestat 面板編輯模式中的指標索引標籤中找到 PostgreSQL 查詢編輯器。您可以選擇面板標題，然後編輯，以進入編輯模式。
查詢編輯器具有**產生的 SQL** 連結，會在查詢執行後，在面板編輯模式中顯示。選擇它，它會展開並顯示已執行的原始插補 SQL 字串。
### 選取資料表、時間欄和指標欄 (FROM)
當您第一次進入編輯模式或新增查詢時，Grafana 會嘗試使用具有時間戳記欄和數值欄的第一個資料表預先填入查詢建置器。
在 FROM 欄位中，Grafana 會建議資料庫使用者 `search_path` 中的資料表。若要選取不在 中的資料表或檢視，`search_path`您可以手動輸入完整名稱 (schema.table)，例如 `public.metrics`。
時間欄欄位是指保留時間值的資料欄名稱。選取指標資料欄欄位的值是選用的。如果選取值，則會使用指標欄欄位做為序列名稱。
指標欄建議只會包含具有文字資料類型 (char、varchar、text) 的資料欄。若要使用具有不同資料類型的資料欄做為指標資料欄，您可以輸入具有轉換的資料欄名稱：`ip::text`。您也可以在評估為文字資料類型的指標資料欄欄位中輸入任意 SQL 表達式，例如 `hostname || ' ' || container_name`。
### 資料欄、視窗和彙總函數 (SELECT)
在 `SELECT`列中，您可以指定要使用的資料欄和函數。在資料欄欄位中，您可以撰寫任意表達式，而不是資料欄名稱，例如 `column1 * column2 / column3`。
查詢編輯器中可用的函數取決於您在設定資料來源時選取的 PostgreSQL 版本。如果您使用彙總函數，則必須將結果集分組。如果您新增彙總函數，編輯器會自動新增 `GROUP BY time`。
編輯器會嘗試簡化和統一查詢的這個部分。
您可以選擇加號按鈕，然後從功能表中選取資料欄，以新增其他值資料**欄**。圖形面板中的多個值資料欄將繪製為個別序列。
### 篩選資料 (WHERE)
若要新增篩選條件，請選擇`WHERE`條件右側的加號圖示。您可以選擇篩選條件並選取移除，以**移除**篩選條件。目前所選時間範圍的篩選條件會自動新增至新查詢。
### 分組依據
若要依時間或任何其他資料欄分組，請選擇 GROUP BY 資料列結尾的加號圖示。建議下拉式清單只會顯示目前所選資料表的文字資料欄，但您可以手動輸入任何資料欄。您可以選擇項目，然後選取移除，以**移除**群組。
如果您新增任何分組，則所有選取的資料欄都必須套用彙總函數。當您新增分組時，查詢建置器會自動將彙總函數新增至所有資料欄，而不需要彙總函數。
#### 間隙填充
當您依時間分組時，Amazon Managed Grafana 可以填入缺少的值。時間函數接受兩個引數。第一個引數是您要分組的時間範圍，第二個引數是您希望 Grafana 填入缺少項目的值。
### 文字編輯器模式 (RAW)
您可以選擇漢堡圖示並選取**切換編輯器模式，或選擇查詢下方的編輯 SQL，即可切換到原始查詢編輯器模式**。 ****
**注意**
如果您使用原始查詢編輯器，請確定您的查詢至少具有 ，`ORDER BY time`並在傳回的時間範圍上有一個篩選條件。
## 巨集
巨集可在查詢中使用，以簡化語法並允許動態組件。
| 巨集範例 | Description |
| --- | --- |
| \$1\$1\$1time(dateColumn) | 將由表達式取代，以轉換為 UNIX 時間戳記，並將資料欄重新命名為 time\$1sec。例如，UNIX\$1TIMESTAMP(dateColumn) 作為 time\$1sec。 |
| \$1\$1\$1timeEpoch(dateColumn) | 將由表達式取代，以轉換為 UNIX 時間戳記，並將資料欄重新命名為 time\$1sec。例如，UNIX\$1TIMESTAMP(dateColumn) 作為 time\$1sec。 |
| \$1\$1\$1timeFilter(dateColumn) | 將由使用指定資料欄名稱的時間範圍篩選條件取代。例如，dateColumn BETWEEN FROM\$1UNIXTIME(1494410783) 和 FROM\$1UNIXTIME(1494410983)。 |
| \$1\$1\$1timeFrom() | 將由目前作用中時間選擇的開始取代。例如 FROM\$1UNIXTIME(1494410783)。 |
| \$1\$1\$1timeTo() | 將取代為目前作用中時間選擇的結尾。例如 FROM\$1UNIXTIME(1494410983)。 |
| \$1\$1\$1timeGroup(dateColumn,'5m') | 將由 GROUP BY 子句中可用的表達式取代。例如，Cast(cast(UNIX\$1TIMESTAMP(dateColumn)/(300) 已簽章），300 已簽章），\$1 |
| \$1\$1\$1timeGroup(dateColumn,'5m', 0) | 與慣用的資料列相同，但使用填充參數，因此 grafana 會新增該系列中的遺失點，並使用 0 做為值。 |
| \$1\$1\$1timeGroup(dateColumn,'5m', NULL) | 與上述相同，但 NULL 將用作遺失點的值。 |
| \$1\$1\$1timeGroup(dateColumn,'5m', previous) | 與上述相同，但如果尚未看到 NULL，則會使用該序列中的上一個值作為填充值 （僅適用於 Grafana 5.3\$1)。 |
| \$1\$1\$1timeGroupAlias(dateColumn,'5m') | 將取代為與 \$1\$1\$1timeGroup 相同，但使用新增的資料欄別名 |
| \$1\$1\$1unixEpochFilter(dateColumn) | 將使用指定的資料欄名稱取代為時間範圍篩選條件，時間表示為 Unix 時間戳記。例如，\$1dateColumn > 1494410783 AND dateColumn < 1494497183\$1 |
| \$1\$1\$1unixEpochFrom()` | \$1 將由目前作用中時間選擇的開頭取代為 Unix 時間戳記。例如，\$11494410783\$1 |
| \$1\$1\$1unixEpochTo() | 將被目前作用中時間選擇的結尾取代為 Unix 時間戳記。例如，\$11494497183\$1 |
| \$1\$1\$1unixEpochNanoFilter(dateColumn) | 將使用指定的資料欄名稱取代為時間範圍篩選條件，時間表示為奈秒時間戳記。例如，\$1dateColumn > 1494410783152415214 AND dateColumn < 1494497183142514872\$1 |
| \$1\$1\$1unixEpochNanoFrom() | 將由目前作用中時間選擇的開頭取代為奈秒時間戳記。例如，\$11494410783152415214\$1 |
| \$1\$1\$1unixEpochNanoTo() | 將被目前作用中時間選擇的結尾取代為奈秒時間戳記。例如，\$11494497183142514872\$1 |
| \$1\$1\$1unixEpochGroup(dateColumn,"5m", [fillmode]) | 與 \$1\$1\$1timeGroup 相同，但時間儲存為 Unix 時間戳記。 |
## 資料表查詢
如果查詢選項設定為**格式化為資料表**，基本上您可以執行任何類型的 SQL 查詢。資料表面板會自動顯示查詢傳回的任何資料欄和資料列的結果。
您可以使用一般 `as` SQL 資料欄選取語法來控制資料表面板資料欄的名稱。
## 時間序列查詢
如果您將**格式設定為** `Time series`，例如用於圖形面板，查詢必須傳回名為 的資料欄`time`，該資料欄會傳回 SQL 日期時間或任何代表 Unix epoch 的數值資料類型。除了 `time`和 以外的任何資料欄`metric`都會視為值資料欄。您可以傳回名為 的資料欄`metric`，做為值資料欄的指標名稱。如果您傳回多個值資料欄和名為 的資料欄`metric`，則會使用此資料欄做為序列名稱的字首。
時間序列查詢的結果集必須依時間排序。
下列範例程式碼顯示 `metric`欄。
```
SELECT
$__timeGroup("time_date_time",'5m'),
min("value_double"),
'min' as metric
FROM test_data
WHERE $__timeFilter("time_date_time")
GROUP BY time
ORDER BY time
```
以下程式碼範例顯示使用 \$1\$1\$1timeGroup 巨集中的填充參數，將 null 值改為零。
```
SELECT
$__timeGroup("createdAt",'5m',0),
sum(value) as value,
measurement
FROM test_data
WHERE
$__timeFilter("createdAt")
GROUP BY time, measurement
ORDER BY time
```
下列範例程式碼顯示多個資料欄。
```
SELECT
$__timeGroup("time_date_time",'5m'),
min("value_double") as "min_value",
max("value_double") as "max_value"
FROM test_data
WHERE $__timeFilter("time_date_time")
GROUP BY time
ORDER BY time
```
## 範本化
您可以在指標查詢中使用變數，而不是硬式編碼，例如伺服器、應用程式和感應器名稱。變數會顯示為儀表板頂端的下拉式清單選取方塊。您可以使用這些下拉式方塊來變更儀表板中顯示的資料。
如需範本和範本變數的詳細資訊，請參閱 [範本](templates-and-variables.md#templates)。
### 查詢變數
如果您新增類型 的範本變數`Query`，您可以撰寫 PostgreSQL 查詢，以傳回顯示為下拉式清單選取方塊的測量名稱、索引鍵名稱或索引鍵值等物件。
例如，如果您在範本變數查詢**設定中指定這類查詢，您可以有一個變數，其中包含資料表中資料`hostname`欄的所有值。
```
SELECT hostname FROM host
```
查詢可以傳回多個資料欄，Grafana 會自動從中建立清單。例如，下列查詢將傳回來自 `hostname`和 的值清單`hostname2`。
```
SELECT host.hostname, other_host.hostname2 FROM host JOIN other_host ON host.city = other_host.city
```
若要在查詢`$__timeFilter(column)`中使用時間範圍相依巨集，例如 ，範本變數的重新整理模式必須設定為*時間範圍變更*。
```
SELECT event_name FROM event_log WHERE $__timeFilter(time_column)
```
另一個選項是可建立索引鍵/值變數的查詢。查詢應傳回兩個名為 `__text`和 的資料欄`__value`。`__text` 資料欄值應該是唯一的 （如果不是唯一的，則會使用第一個值）。下拉式清單中的選項會有文字和值，可讓您將易記的名稱做為文字，並將 ID 做為值。使用 `hostname`做為文字和 `id`做為值的範例查詢：
```
SELECT hostname AS __text, id AS __value FROM host
```
您也可以建立巢狀變數。使用名為 的變數`region`，您可以讓主機變數僅顯示目前所選區域的主機。下列程式碼範例顯示這樣的查詢 （如果 `region` 是多值變數，請使用`IN`比較運算子`=`，而不是比對多個值）。
```
SELECT hostname FROM host WHERE region IN($region)
```
#### 使用 `__searchFilter` 在查詢變數中篩選結果
`__searchFilter` 在查詢欄位中使用 會根據下拉式清單選取方塊中的使用者類型來篩選查詢結果。當使用者未輸入任何內容時， 的預設值`__searchFilter`為 `%`。
**注意**
請務必使用引號括住`__searchFilter`表達式，因為 Grafana 不會為您執行此操作。
下列範例示範如何使用 `__searchFilter`做為查詢欄位的一部分，以在下拉式清單選取方塊中的使用者類型`hostname`時啟用搜尋。
```
SELECT hostname FROM my_host WHERE hostname LIKE '$__searchFilter'
```
### 在查詢中使用變數
只有在範本變數是 時，才會引用範本變數值`multi-value`。
如果變數是多值變數，請使用`IN`比較運算子`=`，而不是比對多個值。
有兩種語法：
`$` 範本變數名為 的範例`hostname`：
```
SELECT
atimestamp as time,
aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in($hostname)
ORDER BY atimestamp ASC
```
`[[varname]]` 範本變數名為 的範例`hostname`：
```
SELECT
atimestamp as time,
aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in([[hostname]])
ORDER BY atimestamp ASC
```
#### 關閉多值變數的引號
Amazon Managed Grafana 會自動為多值變數建立以逗號分隔的引號字串。例如：如果選取 `server02` `server01`和 ，則會格式化為：`'server01', 'server02'`。若要關閉引號，請使用變數的 csv 格式選項。
`${servers:csv}`
如需變數格式化選項的詳細資訊，請參閱 [範本和變數](templates-and-variables.md)。
## 註釋
使用註釋在圖形上方覆蓋豐富的事件資訊。您可以透過儀表板功能表/註釋檢視新增註釋查詢。如需詳細資訊，請參閱[註釋](dashboard-annotations.md)。
下列範例程式碼使用具有 epoch 值的時間欄來顯示查詢。
```
SELECT
epoch_time as time,
metric1 as text,
concat_ws(', ', metric1::text, metric2::text) as tags
FROM
public.test_data
WHERE
$__unixEpochFilter(epoch_time)
```
下列範例程式碼顯示使用具有 epoch 值的時間和結束時間資料欄的區域查詢。
**注意**
這僅適用於 Grafana v6.6\$1。
```
SELECT
epoch_time as time,
epoch_time_end as timeend,
metric1 as text,
concat_ws(', ', metric1::text, metric2::text) as tags
FROM
public.test_data
WHERE
$__unixEpochFilter(epoch_time)
```
下列範例程式碼顯示使用原生 SQL 日期/時間資料類型的時間欄的查詢。
```
SELECT
native_date_time as time,
metric1 as text,
concat_ws(', ', metric1::text, metric2::text) as tags
FROM
public.test_data
WHERE
$__timeFilter(native_date_time)
```
| 名稱 | 描述 |
| --- | --- |
| time | 日期/時間欄位的名稱。可以是具有原生 SQL 日期/時間資料類型或 epoch 值的資料欄。 |
| timeend | 結束日期/時間欄位的選用名稱。可以是具有原生 SQL 日期/時間資料類型或 epoch 值 (Grafana v6.6\$1) 的資料欄。 |
| text | 事件描述欄位。 |
| tags | 用於事件標籤的選用欄位名稱，做為逗號分隔字串。 |
## 提醒
時間序列查詢應在提醒條件下運作。警示規則條件中尚不支援資料表格式的查詢。
# 連線至 Tempo 資料來源
Tempo 是來自 Grafana Labs 的大量最小相依性追蹤儲存 OSS 追蹤解決方案。
## 新增資料來源
若要存取 Tempo 設定，請選擇**組態** （齒輪） 圖示，然後選擇**資料來源**，然後選擇 **Tempo**。
| 名稱 | 描述 |
| --- | --- |
| Name | 您將用來在面板、查詢和探索中參考資料來源的名稱。 |
| Default | 預設資料來源表示新面板會預先選取該資料來源。 |
| URL | Tempo 執行個體的 URL；例如 http://tempo。 |
| Basic Auth | 啟用對 Tempo 資料來源的基本身分驗證。 |
| User | 基本身分驗證的使用者名稱。 |
| Password | 基本身分驗證的密碼。 |
## 追蹤至日誌
這是追蹤至日誌功能的組態。目標資料來源目前必須是 Loki。如需詳細資訊，請參閱[追蹤整合](explore.md#tracing-integration)。
+ **資料來源** – 目標資料來源。
+ **標籤** – 將用於 Loki 查詢的標籤。預設為 `'cluster', 'hostname', 'namespace', pod'`。
+ **跨度開始時間轉移** – 根據跨度開始時間來轉移 Loki 查詢的開始時間。若要延伸到過去，您需要使用負值。您可以在這裡使用時間單位，例如 5s、1m、3h。預設值為 0。
+ **跨度結束時間轉移** – 根據跨度結束時間，在 Loki 查詢的結束時間轉移。您可以在這裡使用時間單位，例如 5s、1m、3h。預設值為 0。
## 查詢追蹤
您可以透過探索從 Tempo 查詢和顯示追蹤。如果您在資料來源組態頁面中將追蹤設定為日誌設定，您可以搜尋追蹤。若要尋找要視覺化的追蹤，請使用 Loki 查詢編輯器。若要取得搜尋結果，您必須設定衍生欄位，以指向此資料來源。
若要查詢特定追蹤，請選取 TraceID 查詢類型，然後將 ID 放入追蹤 ID 欄位。
## 從日誌連結到追蹤 ID
您可以透過設定內部連結，從 Loki 或 Elastic 中的日誌連結到 Tempo 追蹤。如需詳細資訊，請參閱[衍生欄位](using-loki-in-AMG.md#loki-derived-fields)。
# 設定 TestData 資料來源進行測試
Grafana 隨附 TestData 資料來源，可為任何面板建立模擬的時間序列資料。您可以使用它來建置自己的仿造和隨機時間序列資料，並將其轉譯在任何面板中，這可協助您驗證儀表板功能，並安全輕鬆地共用資料。
**設定資料來源**
**存取 TestData 的資料來源組態**
1. 選擇**組態** （齒輪） 圖示。
1. 選擇**資料來源**。
1. 選擇 **TestData**。
除了所有資料來源常用的最基本選項之外，資料來源不提供任何設定：
| 名稱 | 描述 |
| --- | --- |
| `Name` | 面板、查詢和探索中資料來源的名稱。 |
| `Default` | 是否針對新面板預先選取此資料來源。 |
**建立模擬資料**
新增 TestData 資料來源，您的 Grafana 執行個體使用者可以在任何指標面板中將其用作資料來源，並根據您選擇的 TestData 案例提供您可以使用的模擬資料。
**選擇案例**
TestData 資料來源不會提供查詢編輯器，而是協助您選取為面板產生模擬資料的**案例**。
您可以為每個案例指派**別名**，而且許多 都有自己的選項會在選取時顯示。
**可用的案例：**
+ **註釋**
+ **條件式錯誤**
+ **CSV 內容**
+ **CSV 檔案**
+ **CSV 指標值**
+ **超出範圍的資料點**
+ **指數熱度圖儲存貯體資料**
+ **Grafana API**
+ **Grafana Live**
+ **線性熱度圖儲存貯體資料**
+ **載入 Apache Arrow 資料**
+ **日誌**
+ **無資料點**
+ **節點圖形**
+ **可預測的 CSV Wave**
+ **可預測脈衝**
+ **隨機行走**
+ **Random Walk （發生錯誤）**
+ **隨機行走資料表**
+ **原始影格**
+ **模擬**
+ **慢查詢**
+ **串流用戶端**
+ **資料表靜態**
+ **美國產生的資料**
**匯入預先設定的儀表板**
TestData 也提供範例儀表板。
**匯入範例儀表板**
1. 導覽至資料來源的組態頁面。
1. 選取**儀表板**索引標籤。
1. 針對**簡易串流範例**儀表板選取**匯入**。
**若要自訂匯入的儀表板：**
若要自訂匯入的儀表板，建議您將其儲存為不同的名稱。如果沒有，升級 Grafana 可以使用新版本覆寫自訂儀表板。
**使用測試資料來報告問題**
如果您向 GitHub 上的 GrafanaLabs 報告涉及使用或轉譯時間序列資料的問題，強烈建議您使用此資料來源來複寫問題。這可讓開發人員更輕鬆地複寫和解決您的問題。
# 連線至 Zipkin 資料來源
Zipkin 是一種開放原始碼的分散式追蹤系統。新增 Zipkin 資料來源，以便在 Amazon Managed Grafana 中的探索中查詢追蹤
## 新增資料來源
若要存取 Zipkin 設定，請選擇**組態** （齒輪） 圖示，然後選擇**資料來源**，然後選擇 **Zipkin**。
| 名稱 | 描述 |
| --- | --- |
| Name | 資料來源名稱。這是您在面板、查詢和探索中看到資料來源的方式。 |
| Default | 預設資料來源表示將針對新面板預先選取。 |
| URL | Zipkin 執行個體的 URL，例如 http://localhost:9411。 |
| Access | 伺服器 （預設） = 需要從 Grafana 後端/伺服器存取 URL。 |
| Basic Auth | 啟用 Zipkin 資料來源的基本身分驗證。 |
| User | 基本身分驗證的使用者名稱。 |
| Password | 基本身分驗證的密碼。 |
## 查詢追蹤
您可以透過探索來查詢和顯示來自 Zipkin 的追蹤。
Zipkin 查詢編輯器可讓您透過追蹤 ID 直接查詢，或從追蹤選取器中選取追蹤。若要依追蹤 ID 查詢，請將 ID 插入文字輸入。
使用追蹤選取器從您在探索中選取的時間範圍中記錄的所有追蹤中選取特定追蹤。追蹤選取器有三種巢狀層級：1。您感興趣的服務。1. 特定操作是所選服務 1 的一部分。所選取操作發生的特定追蹤，以根操作名稱和追蹤持續時間表示。
## 追蹤 UI 中的資料映射
Zipkin 註釋在追蹤檢視中顯示為日誌，註釋值顯示在註釋索引鍵下。
## 從日誌連結到追蹤 ID
您可以透過使用內部連結設定衍生欄位，從 Loki 中的日誌連結到 Zipkin 追蹤。如需詳細資訊，請參閱[衍生欄位](using-loki-in-AMG.md#loki-derived-fields)。
# 連線至企業資料來源
已升級至 Amazon Managed Grafana Enterprise 外掛程式的工作區支援下列資料來源。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。
企業外掛程式會定期更新。這包括現有外掛程式的更新，有時還包括新的資料來源。下列文件可能不會包含所有可用的資料來源。如需 Amazon Managed Grafana Enterprise 外掛程式支援的目前 Enterprise 外掛程式清單，請參閱 [Grafana 文件中的 Grafana Enterprise 外掛程式](https://grafana.com/docs/plugins/)。 **
對於支援第 9 版及更新版本的工作區，預設不會再安裝企業資料來源。您必須安裝正確的資料來源外掛程式。您可以為所有企業資料來源安裝外掛程式，包括此處未列出的任何 。您也可以選擇更新已安裝的外掛程式版本。如需管理外掛程式的詳細資訊，請參閱 [使用外掛程式擴展您的工作區](grafana-plugins.md)。
**Topics**
+ [AppDynamics](appdynamics-AMG-datasource.md)
+ [Databricks](AMG-databricks-datasource.md)
+ [Datadog](AMG-datadog-datasource-plugin.md)
+ [Dynatrace](dynatrace-AMG-datasource.md)
+ [GitLab](gitlab-AMG-datasource.md)
+ [Honeycomb](honeycomb-AMG-datasource.md)
+ [Jira](jira-AMG-datasource.md)
+ [MongoDB](AMG-mongodb-datasource.md)
+ [New Relic](new-relic-data-source.md)
+ [Oracle Database](oracle-datasource-AMG.md)
+ [Salesforce](salesforce-AMG-datasource.md)
+ [SAP HANA](saphana-AMG-datasource.md)
+ [ServiceNow](grafana-enterprise-servicenow-datasource.md)
+ [Snowflake](snowflake-datasource-for-AMG.md)
+ [Splunk](splunk-datasource.md)
+ [Splunk 基礎設施監控](AMG-datasource-splunkinfra.md)
+ [Wavefront](wavefront-datasource-for-AMG.md)
# 連線至 AppDynamics 資料來源
Amazon Managed Grafana 的 AppDynamics 資料來源可讓您使用其指標 API 從 AppDynamics 查詢指標，並在 Grafana 儀表板中將其視覺化。
**注意**
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
## 資料來源組態的注意事項
使用伺服器 （代理） 存取 （避免 CORS 和使用者查詢您的密碼） 和基本身分驗證。請記住，使用者名稱應該是「user@account」（即 your.name@customer1 或 my\$1user@saas\$1account\$1name)。
使用下列步驟設定密碼：
1. 導覽至 https：//[https://accounts.appdynamics.com/subscriptions](https://accounts.appdynamics.com/subscriptions)
1. 選擇訂閱資料列名稱****欄中的連結。
1. 選擇頁面頂端的索引標籤，導覽至**授權詳細資訊**。
1. 存取金鑰欄位具有**顯示**按鈕。選擇**顯示**按鈕以顯示存取金鑰。
1. 將存取金鑰複製到 Grafana 組態上的基本驗證詳細資訊頁面中的密碼欄位。
使用下列步驟設定 Amazon Managed Grafana 的使用者和角色。
1. 在 AppDynamics 中，導覽至設定、管理。
1. 選取**角色**索引標籤，然後選擇「＋」按鈕來建立新的角色；例如， `grafana_readonly.`
1. 在建立角色區段**的帳戶**索引標籤中，新增許可 `View Business Flow`。
1. 在**應用程式**索引標籤中，勾選**檢視**方塊以允許 Grafana 檢視應用程式資料。
1. 在**資料庫**索引標籤中，勾選**檢視**方塊以允許 Grafana 檢視資料庫資料。
1. 在**分析**索引標籤中，勾選**可檢視所有應用程式的資料**方塊，以允許 Grafana 檢視應用程式分析資料。
1. 在管理頁面**的使用者**索引標籤中，建立新的使用者，例如 `grafana`。將新使用者 （或使用者所屬的群組） 指派給您剛建立的角色；例如 `grafana_readonly`。
## 範本化
目前支援的範本查詢如下：
1. `Applications` （所有應用程式）
1. `AppName.BusinessTransactions` （應用程式名稱的所有 BTs)
1. `AppName.Tiers` （應用程式名稱的所有層）
1. `AppName.Nodes` （應用程式名稱的所有節點）
1. `AppName.TierName.BusinessTransactions` （特定方案的所有 BTs)
1. `AppName.TierName.Nodes` （特定 層的所有節點）
1. `AppName.Path.` （可指定任何指標路徑）
## 圖例索引鍵
圖例金鑰的預設值可以很長，但可以自訂此格式。
選擇 `App on legend`選項，即可在圖例金鑰前加上應用程式名稱。例如：`MyApp - Overall Application Performance|Average Response Time (ms)`。
如果查詢是針對您無法看到圖例索引鍵的單一狀態或其他面板，請選擇顯示中繼資料選項，以查看查詢的圖例索引鍵 （也稱為別名） 是什麼。
圖例下拉式清單有三個選項：`Full Path`、 `Segments`和 `Custom`。
### 圖例選項 – 完整路徑
圖例索引鍵是完整的指標路徑，例如 `Overall Application Performance|Average Response Time (ms)`。
### 圖例選項 – 區段
指標名稱由區段組成。您可以選擇要顯示的區段。
例如，具有指標名稱：
`Errors|mywebsite|Error|Errors per Minute`
`2,4` 在區段欄位中輸入下列項目會傳回 `mywebsite|Errors per minute`。
索引開頭為 1，因此 `1`會傳回 `Errors`。
### 圖例選項 – 自訂
將文字與下列別名模式結合，以建立自訂圖例，以便在指標中繼資料中混合。
+ `{{app}}` 傳回應用程式名稱
+ `{{1}}` 從指標路徑傳回區段。
例如， 指標： `Overall Application Performance|Average Response Time (ms)` 有兩個區段。 `{{1}}`傳回第一個區段， `{{2}}`傳回第二個區段。
產生的圖例金鑰模式和圖例金鑰範例：
+ `custom legend key` => `custom legend key`
+ `App: {{app}} MetricPart2: {{2}}` => `App: myApp MetricPart2: Average Response Time (ms)`
# 連線至 Databricks 資料來源
Databricks 資料來源可讓您查詢和視覺化 Amazon Managed Grafana 中的 Databricks 資料。它包含 SQL 編輯器來格式化查詢的格式和顏色代碼。
**注意**
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
## 新增 Databricks 資料來源
請依照下列步驟，在 Grafana 主控台中新增 Databricks 資料來源。
**新增 Databricks 資料來源**
1. 選擇頂端標頭中的 Grafana 圖示，開啟側邊選單。
1. 在側邊選單的**儀表板**連結下，選取**資料來源**。
**注意**
如果您沒有看到**資料來源**連結，表示您沒有 Grafana `Admin`的角色。
1. 選擇頂端標頭中的 **\$1 新增資料來源**按鈕。
1. 從**類型**下拉式清單中選取 **Databricks**。
**注意**
如果您沒有看到 Databricks 選項且需要，則必須升級至 Grafana Enterprise。
1. 選擇要連接至 的選項，並編輯您的資料。
## 使用 Databricks 資料來源時的注意事項
**時間序列**
當您將`datetime`欄位新增至查詢時，即可選取時間序列視覺化。此欄位將用作序列的時間戳記。如果 欄位不包含特定時區，Grafana 會假設時間是 UTC。
**多行時間序列**
若要建立多行時間序列視覺化，查詢必須依下列順序包含至少三個欄位。
1. 別名為 `datetime`的欄位`time`。
1. 的值為 `GROUP BY`。
1. 要視覺化的一或多個指標值。
以下是將傳回多行時間序列選項的查詢範例。
```
SELECT log_time AS time, machine_group, avg(disk_free) AS avg_disk_free
FROM mgbench.logs1
GROUP BY machine_group, log_time
ORDER BY log_time
```
# 連線至 Datadog 資料來源
Datadog 資料來源可讓您從 Amazon Managed Grafana 中的 Datadog 監控服務視覺化指標。
**注意**
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
## Usage
### 快取
對於大型儀表板，這使得許多查詢可能受到 Datadog API 限制 （達到 Datadog API 允許的每小時 API 呼叫數量上限）。快取功能會快取唯一的查詢 60 秒。在組態頁面上，此間隔可以變更為更長或更短。
### 查詢編輯器
很簡單 - 選取彙總和指標。如果您想要篩選結果，請選取一或多個標籤。
Datadog 資料來源支援 Datadog 查詢編輯器支援的所有進階函數。從下拉式清單中選取它，然後選擇函數名稱來安排。
**依欄位用量的別名可能性**：
+ 在「別名依據」欄位中輸入別名。
+ 使用範圍變數：
+ `$__metric` = 以指標名稱取代
+ `$__display_name` = 以指標名稱取代
+ `$__expression` = 以完整指標表達式取代
+ `$__aggr` = 以指標彙總函數取代 （例如， avg、max、min、 sum)
+ `$__scope` = 以指標範圍取代 （例如， 區域、網站、env、主機）
+ 使用規則表達式：
+ 以 `/you regexp here/flags` 格式將規則表達式輸入 "Alias RegExp" 欄位。
+ 如果 "Alias by" 欄位為空白，則會使用 加入 RegExp 結果。指標表達式 = `avg:system.load.5{*}` 的範例：「Alias by」欄位輸入：「""Alias RegExp」欄位輸入：`avg:(.+)\.(\d)`結果： `system.load, 5`
+ 在「Alias by」欄位中使用`$`變數。指標表達式 = `avg:system.load.5{*}` 的範例：「Alias by」欄位輸入：`$1: $2 seconds`「Alias RegExp」欄位輸入：`avg:(.+)\.(\d)`結果： `system.load: 5 seconds`
+ 使用 `$0`取得整個表達式。指標表達式 = `datadog.dogstatsd.packet.count{*}` 的範例：「Alias by」欄位輸入：`Expression: $0`「Alias RegExp」欄位輸入：`DOGstatsd\.(.*)\.(.*){\*}/i`結果： `Expression: datadog.dogstatsd.packet.count{*}`
注意：您將會收到使用不存在群組號碼的錯誤。
#### 指標算術
若要使用指標算術，請將*查詢類型*設為*算術*。使用`#`符號連結到您想要的指標。例如， `#A * 2`會將查詢 的結果加倍`A`。兩個指標之間的算術運作方式相同 - 新增要用於計算結果的查詢，然後在第三個查詢中連結至這些指標，例如 `#A / #B`。
### 註釋
註釋是覆蓋在圖形上的事件 - 事件的範例是部署或中斷。使用此資料來源，您可以從 Datadog 擷取事件，並將其覆蓋在 Amazon Managed Grafana 中的圖形上。註釋事件可以依來源、標籤或優先順序篩選。
### 範本化
取得範本變數 - 指標和標籤的值有幾個選項。擷取`*`*查詢*欄位中指定的可用指標清單。
若要傳回所有標籤，請使用 值： `tag`或 `scope`。
若要傳回指定標籤群組的標籤，請使用下列其中一個預設類別值：
+ `host`
+ `device`
+ `env`
+ `region`
+ `site`
+ `status`
+ `version`
對於自訂標籤群組，只需輸入標籤群組名稱。例如， 如果您的自訂標籤群組名稱為 `subscription_name`，請在*查詢*欄位中輸入該名稱。
使用 *Regex* 欄位篩選結果。使用標籤時支援多值變數 - 多個選取的標籤值將轉換為以逗號分隔的標籤清單。
#### 臨機操作篩選條件
Grafana 中有一種新的特殊類型範本變數，稱為*臨機操作篩選條件*。此變數將套用至儀表板中的所有 ** Datadog 查詢。這允許將其用作快速篩選條件。Datadog 的臨機操作變數會從標籤擷取所有鍵值對，例如 `region:east, region:west`，並使用它們做為查詢標籤。若要建立此變數，請選取*臨機操作篩選條件*類型，然後選擇 Datadog 資料來源。您可以設定此變數的任何名稱。
# 連線至 Dynatrace 資料來源
[https://www.dynatrace.com/](https://www.dynatrace.com) 的資料來源。若要使用此資料來源，您必須擁有 Dynatrace 帳戶。
**注意**
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
**已知限制**
範本變數不能為多選。只支援單一選擇。
僅支援 v2 指標 APIs。
## 功能
### 核心功能
+ 範本變數
+ 指標名稱
+ 僅限單一選取 (**無多選取**)
+ 臨時篩選條件
+ 註釋
+ 目前不支援
+ 別名
+ 指標名稱
+ 聚合
+ 顯示名稱
+ 主機
+ Description
+ 提醒
+ 完整提醒支援
### Dynatrace 特定功能
支援使用 Dynatrace 指標 v2 API 的內建和自訂指標。如需詳細資訊，請參閱 Dynatrace 文件：[指標 API v2](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/) [和指標擷取](https://www.dynatrace.com/support/help/how-to-use-dynatrace/metrics/metric-ingestion/)。
根據指標，API 可能支援其他轉換選項。
## Dynatrace 許可
在 Dynatrace - 使用 API V2 讀取指標 (metrics.read) 許可 - 使用 API V2 讀取實體 (entities.read) 許可中，您將需要下列許可
## 從 Dynatrace 取得 API 金鑰
若要設定 API 字符，請參閱 [Dynatrace API - 字符和身分驗證](https://www.dynatrace.com/support/help/dynatrace-api/basics/dynatrace-api-authentication/?api-token%3C-%3Epersonal-access-token=api-token)
設定 API 字符的 `metrics.read`和 `entities.read`許可。
### Configuration
1. 在邏輯 Grafana 伺服器 UI 中選擇**設定/資料來源**，然後選擇**新增資料來源**。
1. 在**新增資料來源**頁面上，篩選 **Dynatrace**，然後選取 Dynatrace 外掛程式。
1. 設定 Dynatrace 資料來源需要下列參數：
+ `Name` - 您要套用至 Dynatrace 資料來源的名稱 （預設值：Dynatrace)。
+ `Dynatrace API Type` - 您要連線的 Dynatrace 執行個體類型。這是 `SaaS`或 `Managed Cluster`。
+ `Dynatrace API Token` - 這是您在上一個步驟中產生的 API 字符。
接下來的兩個設定取決於您是 Dynatrace SaaS 還是 受管
+ 在 的 SaaS 範例中`yfc55578.live.dynatrace.com`，您的**環境 ID** 會是 `yfc55578`。
+ 在 的受管範例中`yd8888.managed-sprint.dynalabs.io/e/abc99984-3af2-55tt-72kl-0672983gc45`，您的**環境 ID** 會是 `abc99984-3af2-55tt-72kl-0672983gc45`，而您的**網域**會是 `yd8888.managed-sprint.dynalabs.io`
1. 設定所有組態值之後，請選擇**儲存與測試**以驗證組態並儲存變更。
### 查詢資料來源
使用查詢編輯器來查詢 Dynatrace 指標和問題。查詢類型可以是 `metric`或 `problem`。
**指標查詢類型**
+ `Metric`— 選取您要查看的指標。若要再次從 Dynatrace 取得指標清單，請選擇**重新整理**按鈕。
+ `Aggregations`— 選取您要用於特定指標的彙總。選擇彙總值以變更彙總類型，或選擇 **\$1** 以新增另一個彙總。
+ `Transformations`— 您可以在查詢編輯器中選取轉換。之後，在選取的轉換中輸入多個參數。目前，僅支援合併轉換。如需合併轉換的詳細資訊，請參閱[合併轉換](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/metric-selector/#merge-transformation)。
+ `Filters`— Dynatrace 資料來源會動態查詢每個指標的適當篩選條件。若要新增篩選條件，請選擇 Dynatrace 查詢編輯器上**篩選條件**標籤旁的 **\$1** 符號，選取要篩選的欄位，選取要使用的運算子，然後選取要篩選的值。Dynatrace 資料來源可讓您建立篩選條件群組，您可以將這些群組聯結在一起，以建立複雜的邏輯比較。對於大多數使用案例，不需要篩選條件群組。使用標籤建立篩選條件時，無論選取的結合為何，Dynatrace 一律會使用 AND。Dynatrace 不支援具有標籤的 OR 篩選條件。
+ `Alias`— 使用 Dynatrace 資料來源時會遇到兩種不同類型的別名。第一個是靜態別名。您建置的每個查詢都提供此類型的別名，別名名稱開頭為小寫字母。第二個是動態別名，會根據您在查詢中使用的指標而變更，別名名稱開頭為大寫字母。Dynatrace 外掛程式支援數種不同的別名：`Metric Names`、`Aggregation``Display Name`、、 `Host`和 `Description`。
| 名稱 | 值 |
| --- | --- |
| \$1name | builtin：apps.other.keyUserActions.reportedErrorCount.os |
| \$1aggregation | 自動、值 |
| \$1displayName | 報告的錯誤計數 （依金鑰使用者動作、作業系統） 【行動、自訂】 |
**問題查詢類型**
+ `Problem Query Type`— 選取問題查詢類型。目前，僅支援饋送問題查詢類型。如需饋送問題查詢類型的資訊，請參閱[合併轉換](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/metric-selector/#merge-transformation)
+ `Status Filter`— 依狀態篩選結果問題。
+ `Impact Filter`— 依影響層級篩選結果問題。
+ `Severity Filter`— 依嚴重性等級篩選結果問題。
+ `Expand Details`— 如果設定，請將相關事件包含在回應中。
#### 使用範本變數
若要新增新的 Dynatrace 查詢變數，請參閱[新增新的範本變數](variables-types.md#add-a-query-variable)。使用 Dynatrace 資料來源做為下列可用查詢的資料來源：
+ `Query type`— 選取查詢類型。查詢類型會將某些資料與某些索引鍵或描述項建立關聯。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/dynatrace-AMG-datasource.html)
+ `Regex`— （選用） 使用規則表達式篩選掉查詢中傳回的任何值。
**注意**
`Multi-value` Dynatrace 資料來源`Include All option`目前不支援 和 。
建立變數之後，您可以在**指標**下拉式功能表中找到該變數。
##### 匯入 Dynatrace 的儀表板
若要匯入儀表板，請參閱 [匯入儀表板](dashboard-export-and-import.md#importing-a-dashboard)。您可以在**組態** > **資料來源** > 選取您的 Dynatrace 資料來源 > 選取**儀表板**索引標籤以查看可用的預先製作儀表板中找到匯入的儀表板。
# 連線至 GitLab 資料來源
GitLab 資料來源可讓您追蹤詳細的 GitLab 統計資料，例如最高參與者、每天遞交或每天部署。您也可以使用範本變數，例如專案，為您的儀表板設定篩選條件。您可以將來自 GitLab API 的資料與其他來源的資料合併。
**注意**
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
## 已知限制
此外掛程式尚未支援警示，因為警示查詢不支援轉換，而轉換是從 GitLab API 原始資料取得有意義的彙總指標的唯一方法。
## 新增資料來源
1. 在 Amazon Managed Grafana 工作區中開啟 Grafana 主控台，並確保您已登入。
1. 在**組態** （齒輪圖示） 下的側邊選單中，選擇**資料來源**。
1. 選擇**新增資料來源**。
**注意**
如果您在側邊選單中看不到**資料來源**連結，這表示您目前的使用者沒有 `Admin`角色。
1. 從資料來源清單中選取 **GitLab**。
1. 輸入下列資訊：
+ 針對**名稱**，輸入此 GitLab 資料來源的名稱。
+ 針對 **URL**，輸入 GitLab 執行個體的根 URL，例如 **https://gitlab.com/api/v4**。
+ 針對**存取字符**，輸入您的 GitLab 個人存取字符。
## 查詢 GitLab 資料來源
從 GitLab 查詢編輯器中，您可以選取不同的資源類型，例如遞交、問題或版本。
**篩選和檢視專案**
1. 從下拉式選單中，選擇**專案**。
1. （選用） 依您擁有的專案進行篩選。
1. 使用下拉式清單，然後選取**是**或**否**來篩選結果。
**注意**
擷取所有**專案 擁有 = 否** 可能需要很長的時間。
**篩選和檢視遞交**
1. 從下拉式選單中，選擇**遞交**。
1. 使用輸入欄位來新增專案 ID。
1. （選用） 若要依分支/標籤篩選，請使用輸入欄位來新增分支/標籤參考。
**篩選和檢視問題**
1. 從下拉式選單中，選擇**問題**。
1. 使用輸入欄位來新增專案 ID。
1. （選用） 若要依標題/描述篩選，請使用輸入欄位根據其**標題**和**描述**來搜尋問題。
**檢視版本**
1. 從下拉式選單中，選擇**部署**。
1. 使用輸入欄位來新增專案 ID。
1. （選用） 若要依環境/狀態篩選，請使用輸入欄位。**狀態**屬性可以是下列其中一個值：`created`、`running`、`failed`、 `success`或 `canceled`。
**檢視標籤**
1. 從下拉式選單中，選擇**標籤**。
1. 使用輸入欄位來新增專案 ID。
## 範本和變數
若要新增新的 GitLab 查詢變數，請參閱 [新增查詢變數](variables-types.md#add-a-query-variable)。使用您的 GitLab 資料來源做為資料來源。選擇資源類型：**版本**、**專案**或**標籤**。
若要取得專案、標籤等的動態清單以供選擇，請建立查詢類型變數。查詢類型變數使用 GitLab 查詢編輯器來查詢和傳回專案、標籤等。下列範例會建立專案變數來參數化您的查詢
**建立專案變數以參數化您的查詢**
1. 新增名為 的**查詢**類型的變數**project**。
1. 選取您的 GitLab 資料來源，並在**儀表板載入時**重新整理。
1. 選取**專案**資源類型，**是**表示**擁有**，**顯示欄位****的名稱**和**值欄位 ****的 ID**。
1. 選擇**更新**，將變數新增至儀表板。
1. 將新面板新增至儀表板，並使用 **\$1project**做為專案 ID。
現在，從下拉式清單中選擇時，您會取得屬於該專案的結果。
## 使用 Grafana 的轉換來回答常見問題
現在，您可以執行基本的 GitLab 查詢來尋找遞交、問題等，您可以使用轉換來視覺化、彙總、分組和聯結資料集，以及許多其他類型的轉換，將簡單的結果轉換為複雜問題的答案。以下是幾個常見問題，以及如何使用轉換來回答這些問題。
**我的專案中每天commits/issues/deployments？**
1. 新增查詢。針對資源類型選取**遞交**，然後新增專案 ID。
1. **依**轉換新增群組：針對**群組依據**，選取 **create\$1at\$1date**，然後計算 **(Count)=id**
1. 選擇**圖形**視覺化。
**在我的專案中關閉問題的平均時間為何？**
1. 新增查詢。選取資源類型的**問題**，然後新增專案 ID。
1. **從計算**轉換新增欄位：對於**模式**，選取**二進位操作**，對於**操作**，選取 **closed\$1at = created\$1at**，對於**別名**，選擇 **resolution\$1time**。
1. **從計算**轉換新增欄位：對於**模式**，選取**二進位操作**，對於**操作**，選取 **resolution\$1time / 86400000**，對於**別名**，選取 **resolution\$1time**。
針對**取代所有欄位**，選擇 **True**。
1. 選擇 **Stat** 視覺化。
+ 顯示 = 計算
+ 計算 = 平均值
+ 欄位 = **resolution\$1time**
# 連接至 Honeycomb 資料來源
Honeycomb 資料來源可讓您查詢和視覺化 Honeycomb 指標，並從 Amazon Managed Grafana 內連結至 Honeycomb 追蹤。
**注意**
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
## 已知限制
+ 此資料來源不支援臨機操作查詢。
+ 由於 API 限制，變數編輯器只能傳回所選資料欄的前 1000 個唯一值。
+ 由於 API 限制，資料來源只能查詢過去 7 天的資料。
## 新增資料來源
1. 在 Amazon Managed Grafana 工作區中開啟 Grafana 主控台，並確保您已登入。
1. 在**組態** （齒輪圖示） 下的側邊選單中，選擇**資料來源**。
1. 選擇**新增資料來源**。
1. 從資料來源清單中選取 **Honeycomb**。
**注意**
如果您在側邊選單中看不到**資料來源**連結，表示您目前的使用者沒有 `Admin`角色。
**Honeycomb 設定**
| 名稱 | 描述 |
| --- | --- |
| Name | 資料來源名稱。這是您在面板、查詢和探索中看到資料來源的方式。 |
| Honeycomb API key | 您從 Honeycomb 取得的 API 金鑰。 |
| URL | Honeycomb API 的 URL。例如 https://api.honeycomb.io。 |
| Team | 與 API 金鑰相關聯的 Honeycomb 團隊。 |
## 查詢 Honeycomb 資料來源
若要查詢指標，請在編輯器欄位中輸入值：
+ 選取資料集。
+ 預設查詢是所選資料集`COUNT`上的 。
+ 若要精簡查詢，請選取任何剩餘欄位的值，例如**視覺化**、**視覺化**、**哪裡**、**限制**條件、**分組依據**、**排序依據**或**限制**。
## 範本和變數
若要新增 Honeycomb 查詢變數，請參閱 [新增查詢變數](variables-types.md#add-a-query-variable)。
YOu 可以建立包含資料集、資料欄或資料欄值的變數。
+ 如果未選取資料集，則變數將包含資料集。
+ 如果只選取資料集，則變數將包含資料欄名稱。
+ 如果同時選取資料集和資料欄，則變數將包含資料欄值。您可以使用編輯器中的 **Where** 欄位進一步限制資料欄值。
## 在 Honeycomb UI 中檢視查詢
若要從儀表板面板查看您在 Honeycomb UI 中建立的查詢，請選擇圖形中的任何點，然後選擇在 **Honeycomb 中開啟**。
若要從查詢編輯器查看您在 Honeycomb UI 中建立的查詢，請選擇在 **Honeycomb 中開啟**。
## 匯入 Honeycomb 的儀表板
若要匯入儀表板，請參閱 [匯入儀表板](dashboard-export-and-import.md#importing-a-dashboard)。
若要尋找匯入的儀表板，請選擇**組態**、**資料來源**。
若要查看可用的預先製作儀表板，請選擇 Honeycomb 資料來源，然後選擇**儀表板**索引標籤。
# 連線至 Jira 資料來源
結合來自 Jira 的問題資料和其他來源的應用程式效能資料，取得開發程序的完整樣貌。
**注意**
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
+ 根據問題建立或解決來建立註釋，以查看問題與指標之間的關係。
+ 追蹤詳細的 Jira 統計資料，例如平均解決時間和問題輸送量。
若要使用 Jira 資料來源，您需要可存取 Jira 專案的 Atlassian 帳戶。
## 已知限制
可能不支援來自 Jira 附加元件的自訂欄位類型。
## 新增資料來源
1. 在 Amazon Managed Grafana 工作區中開啟 Grafana 主控台，並確保您已登入。
1. 在**組態** （齒輪圖示） 下的側邊選單中，選擇**資料來源**。
1. 選擇**新增資料來源**。
**注意**
如果您在側邊選單中看不到**資料來源**連結，這表示您目前的使用者沒有 `Admin`角色。
1. 從資料來源清單中選取 **Jira**。
1. 輸入下列資訊：
+ 針對**名稱**，輸入此 Jira 資料來源的名稱。
+ 針對 **URL**，輸入 Atlassian 執行個體的根 URL，例如 **https://bletchleypark.atlassian.net**。
+ 針對**使用者**，輸入使用者/服務帳戶的電子郵件地址。
+ 針對 **API 字符**，輸入為使用者產生的 API 字符。
## 查詢 Jira 資料來源
從 Jira 查詢編輯器中，您可以選取欄位和查詢問題。
Jira 資料來源會查詢 Jira 是否有問題，這可能代表 Jira 中的錯誤、使用者案例、支援票證或其他任務
**篩選和檢視問題**
1. 選擇**欄位** 選擇下拉式清單，並使用預先類型從 Jira 執行個體中的任何欄位進行選取，包括自訂欄位。要嘗試的一些欄位：
+ **摘要** — 問題的名稱
+ **Epic Name** - 問題所屬的 epis
+ **案例點估算** - 團隊針對問題估計的案例點數量
1. 篩選或排序問題。若要這樣做，請輸入任何有效的 JQL 表達式，根據其任何欄位篩選或排序問題，例如 **Project**、**Designee** 或 **Sprint** with Atlassian 查詢語言 JQL。
從這裡，您可以在資料表中顯示資料，或使用 Grafana 轉換來操作該問題資料、執行計算，或將資料轉換為時間序列圖表。如需詳細資訊，請參閱[套用轉換](panel-transformations.md#apply-a-transformation)。
## 時間序列查詢
若要顯示時間序列資料，請選擇**日期**欄位和數值欄位，然後切換到圖形視覺化。例如：**Sprint Start Date**、**Story 點預估**。
上述範例本身並不實用。數值欄位可以是 （且最有可能是） 從轉換計算而得。使用**依轉換分組**將允許依 **Sprint 開始日期**分組，並摘要 **Story 點估計值**，以允許每個 Sprint 隨時間顯示故事點。如需轉型的詳細資訊，請參閱[套用轉換](panel-transformations.md#apply-a-transformation)。
## 範本和變數
若要新增 Jira 查詢變數，請參閱 [新增查詢變數](variables-types.md#add-a-query-variable)。使用您的 Jira 資料來源做為資料來源。
您可以在儀表板上定義變數，並在 JQL 表達式中參考它們。例如，您可以建立專案狀態儀表板，並在專案或史詩狀態儀表板之間進行選擇，然後選擇不同的語意，或任務狀態儀表板，然後選擇不同的受指派者。
若要取得專案、epics、受指派者等的動態清單，請建立查詢類型變數。查詢類型變數使用 JQL 來查詢問題，並傳回專案、Epic、承授者或與問題相關的任何內容。以下是範例：
**建立被指派者變數，以取得被指派者的問題狀態**
1. 新增名為 的**查詢**類型的變數**assignee**。
1. 選取**欄位：被指派者**。
1. )選用） 新增 JQL 篩選**專案 = '您的專案'**。
1. 選擇**執行**以查看被指派者清單。
1. 選擇**更新**，將變數新增至儀表板。
1. 將新面板新增至儀表板，並編輯 JQL 以使用您的新變數**指派者 = \$1assignee** 進行篩選。
現在，從下拉式清單中選擇時，您只會看到指派給該使用者的問題。
多值變數允許選取多個選項，並可做為 IN 子句的一部分。例如，**受指派者 IN (\$1assignee)**。
## 使用 Grafana 的轉換來回答常見問題
巨集是參考儀表板時段的變數，因此您只能在儀表板時段的範圍內篩選問題。有 2 個巨集：
+ **\$1\$1\$1timeFrom**
+ **\$1\$1\$1timeTo。**
下列範例 JQL 查詢會篩選在儀表板時段內建立的問題： `createdDate >= $__timeFrom AND createdDate <= $__timeTo`
## 充分利用資料來源
使用 Grafana 的轉換和其他內建功能可協助您從意義上檢視 Jira 資料。
### 使用轉換來增強 JQL
雖然 Grafana 中有許多轉換可供選擇，但以下提供強大的增強功能，為 JQL 提供 SQL 的一些功能/能力。
**依**此轉換分組 提供的金鑰功能不屬於標準 Jira JQL 語法：分組。使用**分組依據**轉換，您可以依衝刺或其他問題欄位分組，並依群組彙總以取得指標，例如速度和故事點估計值與衝刺中實際完成的指標。
**外部聯結** 類似於 SQL 聯結，您可以透過常用欄位將 2 個或更多查詢聯結在一起。這樣可以結合查詢中的資料集，並使用其他轉換來計算來自多個查詢/資料集的值。
**從計算新增欄位** 類似於 SQL 表達式，此轉換允許根據其他欄位的計算，將新欄位新增至資料集。計算中使用的欄位可以來自單一查詢或您聯結在一起的查詢。您也可以將計算鏈結在一起，並從計算欄位執行計算。
### 使用 Grafana 的轉換來回答常見問題
您可以使用轉換視覺化、彙總、分組和聯結資料集，以及許多其他類型的轉換，將簡單的結果轉換為複雜問題的答案。
**如何顯示每個衝刺的速度？**
1. 選取欄位：**Sprint Name**、**Story 點預估**。
1. 新增 JQL 篩選條件： `project = "Your Project" AND type != epic AND status = done order by created ASC`
1. 新增**依轉換的群組**：
+ 衝刺名稱 \$1 分組依據
+ 案例點估算 \$1 計算 \$1 總計
1. 選擇**長條測量器**視覺效果。
**如何顯示 Sprint 中已完成與預估的內容？**
1. 新增查詢。首先，選取欄位：**Sprint Name**、**Sprint Start Date、****Story point 預估**。
然後新增 JQL 篩選條件： `project = 'Your Project' AND type != epic`
1. 新增第二個查詢。首先，選取欄位：**Sprint Name**、**Sprint Start Date、****Story Point 預估**。
然後新增 JQL 篩選條件： `project = 'Your Project' AND type != epic AND status = done`
1. 新增依轉換的**群組**：
+ 衝刺名稱 \$1 分組依據
+ 衝刺開始日期 \$1 分組依據
+ 案例點估算 \$1 計算 \$1 總計
1. 選擇**圖形**視覺化。
**完成我的專案問題的平均時間是幾點？**
1. 新增查詢。首先，選取欄位：**已建立**、**狀態類別已變更**。
然後新增 JQL 篩選條件： `project = 'Your Project' AND type != epic AND status = done`
1. 新增轉換：**從計算新增欄位**
+ 模式 = 減少資料列
+ 計算 = 差異
1. 新增轉換：**從計算新增欄位**
+ 模式 = 二進位操作
+ 操作 = 差異 / 86000000
+ 別名 = 天
1. 新增轉換：**組織欄位**
+ 隱藏不同的欄位
1. 新增轉換：**依值篩選資料**
+ 篩選條件類型 = 包含
+ 條件 = 符合任何
+ 欄位 = 天 \$1 相符 = 較大 \$1 值 = 1
1. 新增轉換：**減少**
+ 模式 = 系列到資料列
+ 計算 = 平均值
1. 選擇 **Stat** 視覺化。
# 連線至 MongoDB 資料來源
MongoDB 資料來源可讓您將來自 Amazon Managed Grafana 中 MongoDB 的資料視覺化。
**注意**
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
## Usage
### 查詢編輯器
查詢編輯器支援與 MongoDB Shell 相同的語法，但有一些限制：\$1 您只能執行一個命令/查詢。\$1 僅支援讀取命令：**尋找**和**彙總** \$1 不支援*大多數*物件建構函數 （受支援的 **ISODate** 除外）
編輯器會以下列方式展開 MongoDB Shell 語法：
+ **資料庫選擇** – 您可以提供資料庫的名稱來取代正常的 "db"：
**注意**
您仍然可以使用 "db"。它會參考連線字串中的預設資料庫。
```
sample_mflix.movies.find()
```
+ **彙總排序** – 一般排序發生在彙總管道中的步驟，但 MongoDB Atlas 免費方案不允許排序。我們已擴展語法，以允許使用免費方案的使用者使用。
**注意**
MongoDB 不會使用此語法執行排序。排序會在從集合查詢結果之後發生。
```
sample_mflix.movies.aggregate({}).sort({"time": 1})
```
+ 使用空白編輯器時，**Ctrl \$1 Space** 會顯示所有可用資料庫的選擇。
+ 在資料庫之後輸入點將顯示該資料庫所有可用集合的選擇。
+ 在集合之後輸入點將顯示可用的查詢方法。
+ 在查詢方法之後輸入點會顯示其他函數： sort/limit。
#### 執行查詢
按 **Cmd \$1 S** 執行查詢
### 時間序列
視覺化時間序列資料時，外掛程式需要知道要使用哪個欄位做為時間。只需投影名稱別名為 "time" 的欄位。欄位資料類型必須是日期。
您可以強制到目前為止的非日期資料類型。這樣做將允許使用非日期欄位作為時間序列時間。下列範例顯示如何使用 MongoDB \$1dateFromParts 管道運算子，將 int 欄位 "year" 轉換為投影為 "time" 的日期。
```
sample_mflix.movies.aggregate([
{"$match": { "year": {"$gt" : 2000} }},
{"$group": { "_id": "$year", "count": { "$sum": 1 }}},
{"$project": { "_id": 0, "count": 1, "time": { "$dateFromParts": {"year": "$_id", "month": 2}}}}
]
).sort({"time": 1})
```
### 診斷
[診斷命令](https://docs.mongodb.com/manual/reference/command/nav-diagnostic/)
目前支援下列診斷命令："stats"、"serverStatus"、"replSetGetStatus"、"getLog"、"connPoolStats"、"connectionStatus"、"buildInfo"、"dbStats"、"hostInfo"、"lockInfo"
範例：
```
admin.connectionStatus() // run the connectionStatus command
admin.connectionStatus({"authInfo.authenticatedUserRoles": 1}) // run and only return the "authInfo.authenticatedUserRoles" field
admin.connPoolStats({arg: "pool"}) // run the connPoolStats command and pass 1 argument
admin.serverStatus({args: {repl: 0, metrics:0}}) // run the serverStatus command and pass multiple args
```
### 巨集
您可以在查詢中參考儀表板時間範圍。
+ ` $__timeFrom `— 參考儀表板開始時間的巨集
+ ` $__timeTo `— 參考儀表板結束時間的巨集
```
$__timeTo - ``` sample_mflix.movies.find({released: {$gt:
"$__timeFrom"}}).sort({year: 1})
```
#### 範本變數
MongoDB 支援「複合變數」的概念，可讓您使用一個變數做為多個變數來執行複雜的多金鑰篩選條件。
若要建立複合變數，請使用使用底線將變數分解的命名慣例 （必須以底線開頭）：查詢`_var1_var2`時，回應的格式必須為： `val1-val2`
**範例：我想要篩選電影名稱和年份的結果。**
1. 建立查詢類型的變數： `_movie_year`
1. 將變數查詢設定為將傳回具有一個電影年屬性之項目陣列的查詢，如下列範例所示。
```
// Example sample_mflix.movies.aggregate([
{"$match": {year: {"$gt": 2011}}},
{"$project": {_id: 0, movie_year: {"$concat":
["$title", " - ", {"$toString":"$year"}]}}}
])
```
```
// [{"movie-year": "Ted - 2016"},
{"movie-year": "The Terminator -
1985"}]
```
1. 現在在您的查詢中，您可以使用語法 "\$1\$1variable" 將 "Movie" 和 "Year" 參考為個別的範本變數。
##### 使用臨機操作篩選條件
除了任何名稱的標準「臨機操作篩選條件」類型變數之外，還必須建立第二個協助程式變數。它應該是名稱為 `mongodb\$1adhoc\$1query` 的「常數」類型，以及與查詢編輯器相容的值。查詢結果將用於填入可選取的篩選條件。您可以選擇隱藏此變數，因為沒有進一步用途。
```
sample_mflix.movies.aggregate([
{"$group": { "_id": "$year"}},
{"$project": { "year": "$_id","_id":
0 }} ] )
```
# 連接至新的 Relic 資料來源
本節涵蓋 Grafana 的新版本 [APM](https://newrelic.com/products/application-monitoring) 和[洞見](https://newrelic.com/products/insights)。
**注意**
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
## 功能
+ 範本變數
+ 指標名稱
+ 指標值
+ 註釋
+ 別名
+ 指標名稱
+ 指標值
+ 臨機操作篩選條件
+ 目前不支援
+ 提醒
## Configuration
新增資料來源，填寫[管理員 API 金鑰](https://docs.newrelic.com/docs/apis/get-started/intro-apis/types-new-relic-api-keys#admin)、[個人 API 金鑰](https://docs.newrelic.com/docs/apis/get-started/intro-apis/types-new-relic-api-keys#personal-api-key)和[帳戶 ID](https://docs.newrelic.com/docs/accounts/install-new-relic/account-setup/account-id) 的欄位。
## Usage
### 服務類型
+ **指標**；用於透過 New Relic 的 [REST API](https://docs.newrelic.com/docs/apis/rest-api-v2) 查詢 New Relic APM。
+ **Insights**； 用於透過 [NRQL](https://docs.newrelic.com/docs/insights/nrql-new-relic-query-language/nrql-resources/nrql-syntax-components-functions) 查詢新的 Relic Insights。
### 別名
您可以結合純文字與下列變數來產生自訂輸出。
| 變數 | Description | 範例值 |
| --- | --- | --- |
| \$1\$1\$1nr\$1metric | 指標名稱 | CPU/使用者時間 |
| \$1\$1\$1nr\$1metric\$1value | 指標值 | average\$1value |
例如：
```
Server: $__nr_server Metric: $__nr_metric
```
### 範本和變數
1. 為您的儀表板建立範本變數。如需詳細資訊，請參閱[範本和變數](templates-and-variables.md)。
1. 選取「查詢」類型。
1. 選取「新複本」資料來源。
1. 使用相對 [REST API](https://docs.newrelic.com/docs/apis/rest-api-v2) 端點 （不包括副檔名） 來制定查詢。
可用應用程式的清單：
```
applications
```
應用程式的可用指標清單：
```
applications/{application_id}/metrics
```
### NRQL 巨集
為了改善建立新複本查詢語言 (NRQL) 查詢時的寫入體驗，編輯器支援預先定義的巨集：
+ `$__timeFilter` （或 `[[timeFilter]]`) `SINCE <from> UNTIL <to>` 會根據儀表板的時間範圍插入 。
範例：
```
SELECT average(value) FROM $event_template_variable
$__timeFilter TIMESERIES
```
如需如何使用巨集和範本變數的進一步提示，請參閱編輯器的說明一節。
### 警示事件
選取您的新複本資料來源，並設定其他篩選條件。如果未設定任何篩選條件，則會傳回所有事件。
如果您想要依*實體 ID* 篩選事件，請使用範本變數，因為您可以選取實體名稱而非 ID。例如，若要篩選特定應用程式的事件，請建立可`_$app_`擷取應用程式清單並將其用作*實體 ID* 篩選條件的變數。
### 部署事件
*應用程式 ID* 是必要欄位。
# 連線至 Oracle 資料庫資料來源
**注意**
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
## 新增資料來源
選取 Grafana 左側面板上的**資料來源**。
選取新增資料來源：
輸入 **oracle** 以尋找資料來源。
輸入 Oracle 伺服器詳細資訊。
輸入主機名稱 （或 IP 地址） 以及連接埠號碼，以及要連線的使用者名稱和密碼。
使用 tnsnames 選項切換，可在 tnsnames.ora 組態檔案中找到的任何有效項目，以及基本身分驗證。
與先前的範例類似，但使用 Kerberos 進行身分驗證。如需如何設定作業系統或 Docker 容器以使用 kerberos 的詳細資訊，請參閱 kerberos 特定設定指南。
選擇性地變更用於連線至 Oracle 伺服器和供時區感知巨集使用的時區。預設設定為 UTC。
儲存並測試資料來源，您應該會看到綠色訊息，其中包含「資料庫連線正常」
## Usage
### 巨集
為了簡化語法並允許動態部分，例如日期範圍篩選條件，查詢可以包含巨集。資料欄名稱必須包含在雙引號 () 中`"`。
| 巨集範例 | Description |
| --- | --- |
| \$1\$1\$1\$1time(dateColumn)\$1 \$1 將由表達式取代，將資料欄重新命名為 `time`。例如，`dateColumn as time` \$1\$1\$1\$1timeEpoch(dateColumn)\$1 | 將由表達式取代，將資料欄重新命名為 ，time並將值轉換為 unix 時間戳記 （以毫秒為單位）。 |
| \$1\$1\$1\$1timeFilter(dateColumn)\$1 \$1 將由使用指定資料欄名稱的時間範圍篩選條件取代。例如，`dateColumn BETWEEN TO\$1DATE('19700101'，'yyyymmdd') \$1 (1/24/60/60/1000) \$1 1500376552001 AND TO\$1DATE('19700101'，'yyyymmdd') \$1 (1/24/60/60/1000) \$1 1500376552002` \$1\$1\$1\$1timeFrom()\$1 | 將取代為目前作用中時間選擇的開頭，轉換為DATE資料類型。例如 TO\$1DATE('19700101','yyyymmdd') \$1 (1/24/60/60/1000) \$1 1500376552001。 |
| \$1\$1\$1\$1timeTo()\$1 \$1 將由轉換為 `DATE` 資料類型的目前作用中時間選取結束時取代。\$1\$1\$1\$1timeGroup(dateColumn，"5m")\$1 | 將由 GROUP BY 子句中可用的表達式取代。 |
| \$1\$1\$1\$1timeGroup(dateColumn，"5m"【， fillvalue】)\$1 | 將由 GROUP BY 子句中可用的表達式取代。提供 NULL 或浮點數的 fillValue 會自動以該值填入時間範圍中的空序列。例如，timeGroupcreatedAt、 ′1m′、 0.\$1\$1\$1timeGroup(dateColumn、"5m"、0)\$1。 |
| \$1timeGroup(dateColumn、 '5m'、 NULL) \$1 \$1SameasabovebutNULwilbeusedasvalueformisinpoints.\$1\$1\$1timeGroup(dateColumn，"5m"， previous)\$1 | 與上述相同，但如果尚未看到 NULL 值，則會使用該序列中的上一個值作為填充值。 |
| \$1\$1\$1\$1unixEpochFilter(dateColumn)\$1 \$1 將由使用指定資料欄名稱的時間範圍篩選條件取代，時間表示為 unix 時間戳記 （以毫秒為單位）。例如，`dateColumn >= 1500376552001 AND dateColumn <= 1500376552002` \$1\$1\$1\$1unixEpochFrom()\$1 | 將由目前作用中時間選擇的開頭取代為 unix 時間戳記。例如 1500376552001。 |
| \$1\$1\$1\$1unixEpochTo()\$1 | 將被目前作用中時間選擇的結尾取代為 unix 時間戳記。例如 1500376552002。 |
外掛程式也支援使用括號 進行標記`{}`。當參數內需要查詢時，請使用此表示法。
**注意**
每個查詢使用一種表示法類型。如果查詢需要括號，查詢中的所有巨集都必須使用括號。
```
$__timeGroup{"dateColumn",'5m'}
$__timeGroup{SYS_DATE_UTC("SDATE"),'5m'}
$__timeGroup{FROM_TZ(CAST("SDATE" as timestamp), 'UTC'), '1h'}
```
查詢編輯器具有**產生的 SQL** 連結，會在查詢執行後，在面板編輯模式中顯示。當您選擇連結時，它會展開並顯示已執行的原始插補 SQL 字串。
### 資料表查詢
如果**格式化為**查詢選項設定為**資料表**，則基本上您可以執行任何類型的 SQL 查詢。資料表面板會自動顯示查詢傳回的任何資料欄和資料列的結果。您可以使用一般 `as` SQL 資料欄選取語法來控制資料表面板資料欄的名稱。
### 時間序列查詢
如果您將**格式化設定為****時間序列**，例如在圖形面板中使用，查詢必須傳回名為 的資料欄`time`，以秒為單位傳回 SQL 日期時間或任何代表 unix epoch 的數值資料類型。Grafana 會將沒有明確時區的 DATE 和 TIMESTAMP 資料欄解譯為 UTC。除了 `time`和 以外的任何資料欄`metric`都會視為值資料欄。您可以傳回名為 的資料欄`metric`，做為值資料欄的指標名稱。
下列程式碼範例顯示 `metric`欄。
```
SELECT
$__timeGroup("time_date_time", '5m') AS time,
MIN("value_double"),
'MIN' as metric
FROM test_data
WHERE $__timeFilter("time_date_time")
GROUP BY $__timeGroup("time_date_time", '5m')
ORDER BY time
```
### 更多查詢 – 使用 oracle-fake-data-gen
```
SELECT
$__timeGroup("createdAt", '5m') AS time,
MIN("value"),
'MIN' as metric
FROM "grafana_metric"
WHERE $__timeFilter("createdAt")
GROUP BY $__timeGroup("createdAt", '5m')
ORDER BY time
```
下列程式碼範例顯示仿造資料時間序列。
```
SELECT
"createdAt",
"value"
FROM "grafana_metric"
WHERE $__timeFilter("createdAt")
ORDER BY "createdAt" ASC
```
```
SELECT
"createdAt" as time,
"value" as value
FROM "grafana_metric"
WHERE $__timeFilter("createdAt")
ORDER BY time ASC
```
下列範例顯示有用的資料表結果。
```
select tc.table_name Table_name
,tc.column_id Column_id
,lower(tc.column_name) Column_name
,lower(tc.data_type) Data_type
,nvl(tc.data_precision,tc.data_length) Length
,lower(tc.data_scale) Data_scale
,tc.nullable nullable
FROM all_tab_columns tc
,all_tables t
WHERE tc.table_name = t.table_name
```
### 範本化
您可以在指標查詢中使用變數，而不是硬式編碼，例如伺服器、應用程式和感應器名稱。變數會顯示為儀表板頂端的下拉式清單選取方塊。這些下拉式方塊可讓您輕鬆變更儀表板中顯示的資料。
#### 查詢變數
如果您新增類型 的範本變數`Query`，您可以撰寫 Oracle 查詢，以傳回如測量名稱、索引鍵名稱或顯示為下拉式清單選取方塊的索引鍵值等物件。
例如，如果您在範本變數查詢**設定中指定類似這樣的查詢，則可以有一個變數，其中包含資料表中資料`hostname`欄的所有值。
```
SELECT "hostname" FROM host
```
查詢可以傳回多個資料欄，Grafana 會自動從中建立清單。例如，下列查詢將傳回來自 `hostname`和 的值清單`hostname2`。
```
SELECT "host.hostname", "other_host.hostname2" FROM host JOIN other_host ON host.city = other_host.city
```
若要在查詢`$__timeFilter("time_column")`中使用時間範圍相依巨集，例如 ，範本變數的重新整理模式需要設定為*時間範圍變更*。
```
SELECT "event_name" FROM event_log WHERE $__timeFilter("time_column")
```
另一個選項是可建立索引鍵/值變數的查詢。查詢應傳回兩個名為 `__text`和 的資料欄`__value`。`__text` 資料欄值應該是唯一的 （如果不是唯一的，則會使用第一個值）。下拉式清單中的選項會有文字和值，可讓您將易記的名稱做為文字，並將 ID 做為值。下列範例程式碼顯示具有 `hostname`做為文字和 `id` 做為值的查詢。
```
SELECT "hostname" AS __text, "id" AS __value FROM host
```
您也可以建立巢狀變數。例如，如果您有另一個名為 的變數`region`。然後，您可以讓主機變數只顯示目前所選區域中具有類似查詢的主機 （如果 `region` 是多值變數，則使用`IN`比較運算子，而不是`=`比對多個值）。
```
SELECT "hostname" FROM host WHERE region IN('$region')
```
#### 在查詢中使用變數
只有在範本變數是 時，才會引用範本變數值`multi-value`。
如果變數是多值變數，請使用`IN`比較運算子`=`，而不是比對多個值。
有兩種語法：
`$` 範本變數名為 的範例`hostname`：
```
SELECT
"atimestamp" as time,
"aint" as value
FROM table
WHERE $__timeFilter("atimestamp") AND "hostname" IN('$hostname')
ORDER BY "atimestamp" ASC
```
`[[varname]]` 範本變數名為 的範例`hostname`：
```
SELECT
"atimestamp" as time,
"aint" as value
FROM table
WHERE $__timeFilter("atimestamp") AND "hostname" IN('[[hostname]]')
ORDER BY atimestamp ASC
```
# 連線至 Salesforce 資料來源
**注意**
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
Salesforce 資料來源可讓您將 Amazon Managed Grafana 內來自 Salesforce 的資料視覺化。
若要使用此資料來源，您必須擁有 [Salesforce](https://www.salesforce.com/) 帳戶和 [Salesforce Connected 應用程式](https://help.salesforce.com/articleView?id=sf.connected_app_overview.htm&type=5)。
## 已知限制
+ 尚未支援臨機操作篩選條件。
+ 目前僅支援 SOQL 查詢，以及可透過 SOQL 存取的資料。尚不支援 SOSL 和 SAQL 查詢格式。
## 必要設定
需要下列設定。
**注意**
外掛程式目前使用 OAuth 2.0 Username-Password Flow。未使用連線應用程式中所需的回呼 URL。因此，您可以將其設定為任何有效的 URL。
| 名稱 | 描述 |
| --- | --- |
| Enable OAuth settings | 您必須勾選此項才能啟用 OAuth。 |
| Callback URL | 未用於此外掛程式，因此您可以指定任何有效的 URL。 |
| Selected OAuth Scopes (minimum requirements) | 存取和管理您的資料 (api)。 |
| Require Secret for Refresh Token Flow | 您可以啟用或停用此功能。 |
## 新增資料來源
1. 在 Amazon Managed Grafana 工作區中開啟 Grafana 主控台，並確保您已登入。
1. 在**組態** （齒輪圖示） 下的側邊選單中，選擇**資料來源**。
1. 選擇**新增資料來源**。
**注意**
如果您在側邊選單中看不到**資料來源**連結，表示您目前的使用者沒有 `Admin`角色。
1. 從資料來源清單中選取 **Salesforce**。
1. 輸入下列資訊：
+ 在**使用者名稱**中，輸入您要用來連接和查詢 Salesforce 的 Salesforce 帳戶的使用者名稱。
+ 針對**密碼**，輸入該使用者的密碼。
+ 針對**安全字符**，輸入該使用者的安全字符。
+ 針對**取用者金鑰**，輸入取用者金鑰以連線至 Salesforce。您可以從 Salesforce Connected 應用程式取得此資訊。
+ 在**消費者秘密**中，輸入要連線至 Salesforce 的消費者秘密。您可以從 Salesforce Connected 應用程式取得此資訊。
+ 針對**使用沙盒**，如果您想要使用 Salesforce 沙盒，請選取此選項。
## 查詢 Salesforce 資料來源
查詢編輯器支援查詢建置器和 SOQL 編輯器模式。SOQL 代表 [ Salesforce 物件查詢語言](https://developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/sforce_api_calls_soql.htm)。
### 查詢建置器 (SOQL Builder)
Query Builder 是用於建置 SOQL 查詢的易用界面。如果您不熟悉撰寫 SOQL 查詢，您可以使用此模式來建置 SOQL 來查詢 Salesforce 物件。查詢建置器中的 **FROM** 欄位是指 Salesforce 中的實體。您需要在查詢建置器中的任何其他操作之前選取 **FROM** 欄位。選擇 **FROM** 欄位後，您需要選擇建置器模式。SOQL Builder 目前支援下列模式。
+ `List`— 從選取的資料表/salesforce 列出項目及其欄位。使用此模式來取得結果，例如「顯示本會計季度建立的機會清單及其名稱、值和階段」。
+ `Aggregate`— 彙總實體中的項目。使用此模式來取得結果，例如「計算上個月建立的機會」。或「依階段名稱分組的機會總值是多少？」
+ `Trend`— 顯示一段時間內的彙總結果。使用此模式取得結果，例如「Count the opportunities by CreatedDate." 或「按機會的結束日期分組的值總和是多少。」
在查詢編輯器中選擇 `Entity/FROM`和 **模式**之後，請使用下列選項建置查詢。
| **欄位** | **適用於** | **描述** |
| --- | --- | --- |
| SELECT | ALL | 選取您要查看的欄位清單。針對彙總或趨勢檢視，也請選取您要彙總值的方式。 |
| WHERE | ALL | （選用） 指定篩選條件。系統會根據您選取的條件篩選結果。 |
| ORDER BY | LIST，彙總 | （選用） 選取您要用於結果的欄位名稱和排序順序。 |
| LIMIT | LIST，彙總 | （選用） 限制傳回的結果數量。預設為 100。 |
| GROUP BY | AGGREGATE | （選用） 如果您想要依任何特定欄位分割彙總值，請選取欄位。 |
| 時間欄位 | 趨勢 | 指定您要將結果分組的日期欄位。結果會根據 Grafana 的時間挑選器範圍進行篩選。 |
您在查詢編輯器中設定上述欄位，您也會在查詢編輯器下方看到產生的 SOQL 預覽。如果您因為查詢建置器中的任何限制而遭到封鎖，您可以安全地切換到 SOQL 編輯器，您可以在其中自訂產生的 SOQL 查詢。
### SOQL 編輯器
原始 SOQL 編輯器提供透過原始 SOQL 查詢來查詢 Salesforce 物件的選項。SOQL 編輯器提供自動完成建議，例如每個資料表的可用實體和對應的欄位。在 SELECT 或 WHERE 之後使用 Ctrl\$1Space 來查看每個資料表的可用實體。如果您在實體名稱後面輸入點，您可以看到可用的欄位。
**捷徑**
使用 CTRL \$1 SPACE 顯示程式碼完成，顯示可用的內容選項。
CMD \$1 S 會執行查詢。
**以時間序列的形式查詢**
將日期欄位與指標別名化，然後依指標和日期分組，以建立時間序列查詢。以下是範例：
```
SELECT sum(Amount) amount, CloseDate time, Type metric from Opportunity
group by Type, CloseDate
```
**巨集**
若要依儀表板時間範圍進行篩選，您可以在 SOQL 查詢中使用巨集：
+ `$__timeFrom`— 將由轉換為`time`資料類型之目前作用中時間選擇的開始取代。
+ `$__timeTo`— 將取代為目前作用中時間選擇的結尾，轉換為 `time`資料類型。
+ `$__quarterStart`— 會計季度的開始 （衍生自 SalesForce 會計年度設定）。
+ `$__quarterEnd`— 會計季度結束 （衍生自 SalesForce 會計年度設定）。
```
SELECT UserId, LoginTime from LoginHistory where LoginTime > $__timeFrom
```
## 範本和變數
若要新增 Salesforce 查詢變數，請參閱 [新增查詢變數](variables-types.md#add-a-query-variable)。使用您的 Salesforce 資料來源做為資料來源。您可以在此使用任何 SOQL 查詢。
如果您想要使用名稱/值對，例如使用者 ID 和使用者名稱，請從 SOQL 查詢傳回兩個欄位。第一個欄位將用作 ID。當您想要在查詢編輯器 SOQL 中依索引鍵 (ID 等） 篩選時，請執行此操作。
使用變數語法，在 SOQL 查詢中使用 變數。如需詳細資訊，請參閱[變數語法](templates-and-variables.md#variable-syntax)。
# 連線至 SAP HANA 資料來源
[SAP HANA](https://www.sap.com/products/technology-platform/hana.html) 是高效能的記憶體內資料庫，可加速資料驅動的即時決策和 \$1 動作。它由 SAP 開發和行銷。SAP HANA 資料來源外掛程式可協助您將 SAP HANA 執行個體連線至 Grafana。
使用 SAP HANA Grafana Enterprise 外掛程式，您可以視覺化 SAP HANA 資料與 Grafana 中的所有其他資料來源，以及內容中的日誌和指標資料。此外掛程式包含內建的查詢編輯器、支援註釋，並可讓您設定提醒閾值、控制存取、設定許可等。
**注意**
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
## 功能
+ **查詢編輯器** – 外掛程式隨附內建的 SQL 查詢編輯器與語法反白，可讓您視覺化時間序列或資料表資料，並自動完成基本的 Grafana 巨集。
+ **資料來源許可** - 控制誰可以在 Grafana 中檢視或查詢 SAP HANA 資料。
+ **註釋 **- 在任何 Grafana 圖形上疊加 SAP HANA 事件或資料，以將事件與其他圖形資料建立關聯。
+ **警示** — 在 SAP HANA 中設定警示型指標存放區。
+ **查詢的變數** — 在以 SAP HANA 資料為基礎的 Grafana 中建立範本變數，並在 SAP HANA 查詢中包含變數，讓儀表板成為互動式。
## 新增資料來源
1. 在 Amazon Managed Grafana 工作區中開啟 Grafana 主控台，並確保您已登入。
1. 在**組態** （齒輪圖示） 下的側邊選單中，選擇**資料來源**。
1. 選擇**新增資料來源**。
**注意**
如果您在側邊選單中看不到**資料來源**連結，這表示您目前的使用者沒有 `Admin`角色。
1. 從資料來源清單中選取 **SAP HANA**。
1. 在 Config 編輯器中，輸入下列資訊：
+ 針對**伺服器地址**，提供 SAP HANA 執行個體的地址。範例：`xxxxxxx-xxxx-xxxx-xxxx-xxxxxxx.hana.trial-us10.hanacloud.ondemand.com`。
+ 對於**伺服器連接埠**，請提供 SAP HANA 執行個體的連接埠。
+ 針對**使用者名稱**，輸入用於連線至 SAP HANA 執行個體的使用者名稱。
+ 針對**密碼**，輸入此使用者的密碼。
+ （選用） 啟用**略過 TLS 以確認**您是否要略過 TLS 驗證。
+ （選用） 如果您需要提供用戶端憑證和金鑰，請啟用 **TLS 用戶端驗證**。
+ （選用） 如果您想要啟用驗證自我簽署 TLS 憑證，請使用 **CA 憑證**啟用 。
+ （選用） 針對**預設結構描述**，輸入要使用的預設結構描述。如果您省略此項目，則需要在每次查詢中指定結構描述。
**存取和許可**
若要將 Grafana 連線至 SAP HANA，請使用專用登入資料。僅提供必要的許可給使用者。首先，使用使用者名稱和密碼建立受限使用者。下列查詢是建立受限使用者的範例。此查詢也會停用強制密碼變更。
```
CREATE RESTRICTED USER PASSWORD NO FORCE_FIRST_PASSWORD_CHANGE;
```
接著，允許使用者透過 Grafana 等用戶端來連接系統，並包含下列項目：
```
ALTER USER ENABLE CLIENT CONNECT;
```
最後，提供使用者必要檢視、資料表和結構描述的存取權。
```
ALTER USER GRANT ROLE PUBLIC;
GRANT SELECT ON SCHEMA TO ;
```
**使用者層級許可**
按一下資料來源組態頁面中的許可索引標籤以啟用資料來源許可，以限制對 SAP HANA 的存取。在許可頁面上，管理員可以啟用許可，並將查詢許可限制為特定使用者和團隊。
## 查詢編輯器
SAP HANA Grafana 外掛程式隨附 SQL 查詢編輯器，您可以在其中輸入任何 HANA 查詢。如果您的查詢傳回時間序列資料，您可以將其格式化為時間序列，以在圖形面板中將其視覺化。查詢編輯器為支援的 Grafana 巨集和 SQL 查詢的語法反白提供自動完成。
## 註釋
您可以使用 SAP HANA 查詢做為 Grafana 註釋的來源。您的註釋查詢應至少傳回一個時間欄和一個文字欄。如需註釋的詳細資訊，請參閱 [註釋](dashboard-annotations.md)。
**從 SAP HANA 建立註釋**
1. 選擇**儀表板設定**齒輪圖示。
1. 從左側選單中，選擇**註釋**、**新增**。
1. 從**資料來源**下拉式功能表中，選取您的 SAP HANA 資料來源執行個體。
1. 在**查詢**欄位中，輸入至少傳回一個時間欄位和一個文字欄位的 SAP HANA 查詢。
1. 在**格式化為**下拉式功能表中，選取**時間序列**。
1. 針對每個註釋，設定**寄件**者欄位。
## 範本和變數
若要新增 SAP HANA 查詢變數，請參閱 [新增查詢變數](variables-types.md#add-a-query-variable)。使用您的 SAP HANA 資料來源做為資料來源。
下列範例查詢會傳回`username`與`users`資料表不同的 清單。
```
select distinct("username") from "users"
```
**注意**
請務必在變數查詢中只選取一個資料欄。如果您的查詢傳回兩個資料欄，第一欄將用作顯示值，第二欄將用作變數的實際值。如果您的查詢傳回兩個以上的資料欄，則會遭到拒絕。
### 範本和變數
您可以在查詢中使用任何 Grafana 變數。下列範例示範如何在查詢中使用單一 / 多變數。
```
-- For example, following query
select * from "users" where "city" = ${city}
-- will be translated into
select * from "users" where "city" = 'london'
--- where you can see ${city} variable translated into actual value in the variable
```
與文字類似，變數也適用於數值欄位。在下列範例中， `${age}` 是一個文字方塊變數，它接受數字，然後與資料表中的數值欄位進行比較。
```
select * from "users" where "age" > ${age}
--- wil be translated into
select * from "users" where "age" > '36'
```
如果您的變數傳回多個值，您可以在 SAP HANA 查詢`in`的條件中使用它，如下所示。請注意變數周圍的括號，讓`where in`條件在 SAP HANA 中有效。
```
select * from "users" where "city" in (${cities})
--- will be translated into
select * from "users" where "city" in ('london','perth','delhi')
--- where you can see ${cities} turned into a list of grafana variables selected.
--- You can also write the same query using shorthand notation as shown below
select * from "users" where "city" in ($cities)
```
### 巨集
+ `$__timeFilter()`— 在原始查詢中使用時，將 Grafana 的時間範圍套用至指定的資料欄。適用於 date/timestamp/long time 欄。
+ `$__timeFilter(, )`— 與上述相同。但是， 可讓您指定儲存在資料庫中的 time\$1column 格式。
+ `$__timeFilter(, "epoch", )`— 與上述相同，但可在您的時間欄為 epoch 時使用。 格式可以是 's'、'ms' 和 'ns' 之一。
+ `$__fromTimeFilter()`— 與上述相同，但可在您的時間欄為 epoch 時使用。 格式可以是 's'、'ms' 和 'ns' 之一。
+ `$__fromTimeFilter(, )`— 與上述相同，但能夠指定 comparison\$1predicate。
+ `$__fromTimeFilter(, )`— 與上述相同，但能夠指定時間欄的格式。
+ `$__fromTimeFilter(, , )`— 與上述相同，但能夠指定 comparison\$1predicate。
+ `$__toTimeFilter()`— 根據 grafana 在某個時間欄位中的時間到時間傳回時間條件。
+ `$__toTimeFilter(, )`— 與上述相同，但能夠指定 comparison\$1predicate。
+ `$__toTimeFilter(, )`— 與上述相同，但能夠指定時間欄的格式。
+ `$__toTimeFilter(, )`— 與上述相同，但能夠指定 comparison\$1predicate。
+ `$__timeGroup(, )`— 將時間欄展開為間隔群組。適用於 date/timestamp/long time 欄。
**\$1\$1\$1timeFilter() 巨集**
下列範例說明 `$__timeFilter()`巨集：
```
- In the following example, the query
select ts, temperature from weather where $__timeFilter(ts)
--- will be translated into
select ts, temperature from weather where ts > '2021-02-24T12:52:48Z' AND ts < '2021-03-24T12:52:48Z'
--- where you can see the grafana dashboard's time range is applied to the column ts in the query.
```
**\$1\$1\$1timeFilter(、) 巨集**
在某些情況下，資料庫中的時間欄會以自訂格式儲存。下列範例說明 `$__timeFilter(, )`巨集，這有助於根據 grafana 的時間挑選器篩選自訂時間戳記：
```
SELECT TO_TIMESTAMP("TS",'YYYYMMDDHH24MISS') AS METRIC_TIME , "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TS","YYYYMMDDHH24MISS") -- TS is in 20210421162012 format
SELECT TO_TIMESTAMP("TS",'YYYY-MON-DD') AS METRIC_TIME , "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TS","YYYY-MON-DD") -- TS is in 2021-JAN-15 format
```
在巨集中，格式可以是符合時間戳記資料欄的有效 HANA 格式之一。例如，當您的資料以 格式儲存時， `YYYYMMDDHH24MISS` 是有效的`20210421162012`格式。
**\$1\$1\$1timeFilter(， "epoch" ) 巨集**
在某些情況下，時間戳記會儲存為資料庫中的 epoch 時間戳記。下列範例說明`$__timeFilter(, "epoch" )`巨集，其有助於根據 grafana 的時間挑選器篩選 epoch 時間戳記。在巨集中，格式可以是 ms、s 或 ns 之一。如果未指定，則會將 視為預設格式。
```
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP") AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch") -- Example : TIMESTAMP field stored in epoch_second format 1257894000
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP") AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch","s") -- Example : TIMESTAMP field stored in epoch_second format 1257894000
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP"/1000) AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch","ms") -- Example : TIMESTAMP field stored in epoch_ms format 1257894000000
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP"/1000000000) AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch","ns") -- Example : TIMESTAMP field stored in epoch_nanoseconds format 1257894000000000000
```
您可以使用其中一個 epoch\$1s、epoch\$1ms 或 epoch\$1ns 作為第二個引數，而不是將第三個引數用於 \$1\$1\$1timeFilter。
```
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP"/1000) AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch","ms")
-- is same as
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP"/1000) AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch_ms")
```
**\$1\$1\$1fromTimeFilter() 和 \$1\$1\$1toTimeFilter() 巨集**
`$__fromTimeFilter()` 巨集會根據 Grafana 時間挑選器從時間開始，在時間欄位中擴展至條件。
這接受三個參數。第一個參數是時間欄位名稱。您可以傳遞時間欄的 comparison\$1predicate 或格式做為第二個引數。如果您想要同時傳遞這兩個參數，則格式為第二個參數，並使用 comparison\$1predicate 做為第三個參數。
**** 如果未指定格式，外掛程式會假設時間欄為時間戳記/日期類型。如果您的時間欄以時間戳記/日期以外的任何其他格式儲存，則傳遞格式做為第二個引數。 可以是 epoch\$1s、epoch\$1ms、epoch\$1ns 或任何其他自訂格式之一，例如 YYYY-MM-DD。
**** 選用參數。如果未傳遞，外掛程式將使用 > 做為比較述詞。 可以是 =、！=、<>、＜、<=、＞、>=
`$__toTimeFilter()` 運作方式與 \$1\$1\$1fromTimeFilter() 相同。它會不時使用 ，而不是使用 Grafana 的 。此外，預設比較述詞將為 <。
**\$1\$1\$1timeGroup(、)**
例如，巨集 \$1\$1\$1timeGroup(timecol，1h) 在查詢中擴展到 SERIES\$1ROUND("timecol"， 'INTERVAL 1 HOUR')。
下列範例說明 `$__timeGroup(, ) macro.`
```
SELECT $__timeGroup(timestamp,1h), "user", sum("value") as "value"
FROM "salesdata"
WHERE $__timeFilter("timestamp")
GROUP BY $__timeGroup(timestamp,1h), "user"
ORDER BY $__timeGroup(timestamp,1h) ASC
```
這會轉譯為下列查詢，其中 `$__timeGroup(timestamp,1h)` 會擴展為 `SERIES_ROUND("timestamp", 'INTERVAL 1 HOUR')`。
```
SELECT SERIES_ROUND("timestamp", 'INTERVAL 1 HOUR') as "timestamp", "user", sum("value") as "value"
FROM "salesdata"
WHERE "timestamp" > '2020-01-01T00:00:00Z' AND "timestamp" < '2020-01-01T23:00:00Z'
GROUP BY SERIES_ROUND("timestamp", 'INTERVAL 1 HOUR'), "user"
ORDER BY "timestamp" ASC
```
**注意**
將 的群組與 \$1\$1\$1timeGroup 巨集搭配使用時，請確定您的選取依欄位排序與 群組依欄位排序的名稱相同。否則，HANA 可能無法辨識查詢。
如果您不想在 \$1\$1\$1timeGroup() 函數中硬式編碼間隔，則可以指定 \$1\$1\$1interval 做為間隔，將其保留給 Grafana。Grafana 會從儀表板時間範圍計算該間隔。查詢範例：
```
SELECT $__timeGroup(timestamp, $__interval), sum("value") as "value"
FROM "salesdata"
WHERE $__timeFilter("timestamp")
GROUP BY $__timeGroup(timestamp, $__interval)
ORDER BY $__timeGroup(timestamp, $__interval) ASC
```
該查詢會根據儀表板時間範圍轉換為後續查詢。
```
SELECT SERIES_ROUND("timestamp", 'INTERVAL 1 MINUTE'), sum("value") as "value"
FROM "salesdata"
WHERE "timestamp" > '2019-12-31T23:09:14Z' AND "timestamp" < '2020-01-01T23:17:54Z'
GROUP BY SERIES_ROUND("timestamp", 'INTERVAL 1 MINUTE')
ORDER BY SERIES_ROUND("timestamp", 'INTERVAL 1 MINUTE') ASC
```
### 提醒
**在 Grafana 中設定 SAP HANA 提醒**
1. 在儀表板中建立圖形面板。
1. 以時間序列格式建立 SAP HANA 查詢。
1. 選擇**提醒**索引標籤，並指定提醒條件。
1. 選擇**測試規則**以測試提醒查詢。
1. 指定提醒收件人、訊息和錯誤處理。
1. 儲存儀表板。
#### 對非時間序列資料發出警示
若要提醒非時間序列資料，請使用`TO_TIMESTAMP('${__to:date}')`巨集將非時間序列指標設為時間序列。這會將指標轉換為單一點時間序列查詢。查詢的格式如下所示
```
SELECT TO_TIMESTAMP('${__to:date}'), FROM
```
在下列範例中，資料表有四個欄位，稱為使用者名稱、年齡、城市和角色。此資料表沒有任何時間欄位。當具有開發角色的使用者數量少於三個時，我們想要通知 。
```
SELECT TO_TIMESTAMP('${__to:date}'), count(*) as "count" FROM (
SELECT 'John' AS "username", 32 AS "age", 'Chennai' as "city", 'dev' as "role" FROM dummy
UNION ALL SELECT 'Jacob' AS "username", 32 AS "age", 'London' as "city", 'accountant' as "role" FROM dummy
UNION ALL SELECT 'Ali' AS "username", 42 AS "age", 'Delhi' as "city", 'admin' as "role" FROM dummy
UNION ALL SELECT 'Raja' AS "username", 12 AS "age", 'New York' as "city", 'ceo' as "role" FROM dummy
UNION ALL SELECT 'Sara' AS "username", 35 AS "age", 'Cape Town' as "city", 'dev' as "role" FROM dummy
UNION ALL SELECT 'Ricky' AS "username", 25 AS "age", 'London' as "city", 'accountant' as "role" FROM dummy
UNION ALL SELECT 'Angelina' AS "username", 31 AS "age", 'London' as "city", 'cxo' as "role" FROM dummy
) WHERE "role" = 'dev'
```
# 連線至 ServiceNow 資料來源
這是用來連線至 ServiceNow 執行個體的 ServiceNow 資料來源。
**注意**
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
## 功能
+ 查詢
+ Stat API 查詢
+ 資料表 API 查詢
+ 事件、變更和任何其他資料表
+ Alerts (提醒)
+ 註釋 (Beta 功能）
+ 範本變數
## Configuration
選取 Grafana 左側面板上的資料來源。
選取新增資料來源：
輸入 **servicenow** 以尋找資料來源外掛程式：
輸入 ServiceNow URL：
選擇**儲存並測試**。您應該會看到綠色訊息，其中包含「ServiceNow Connection OK」。
### 範例儀表板
預先製作的儀表板包含在外掛程式中，並且可以透過儀表板索引標籤下的資料來源組態頁面匯入。
## Usage
有兩種方式可在查詢編輯器中傳回資料。
+ TableAPI
+ AggregateAPI
使用者目前可以選擇查詢預先定義的資料表，如下所示：
+ 變更
+ 事故
或者，自 起`v1.4.0`，使用**其他 （自訂資料表） **選項的 API 驅動資料表和欄位清單。此選項可讓您查詢使用者可用於設定 ServiceNow 資料來源之任何資料表中的資料。
**自訂資料表**選項應支援與預先定義資料表清單相同的所有功能。
### TableAPI 查詢
TableAPI 會傳回適合在資料表面板中顯示的資料。它允許按順序選擇欄位，以顯示加上篩選選項。查詢編輯器也提供 欄位，以限制查詢傳回的資料列數。
顯示上一個查詢結果的範例資料表面板。
#### Show
*顯示*列為要顯示的欄位提供選擇器。您也可以指定多個欄位。欄位將以指定的確切順序傳回。
#### 顯示值
*顯示值*旗標將導致查詢傳回人性化的值，或顯示小精靈，而不是數值。
例如，`1`沒有此旗標的 嚴重性只會顯示 `1`。如果啟用 旗標，顯示的值將為 `1 - High`。
根據 [ServiceNow API 文件](https://developer.servicenow.com/dev.do#!/reference/api/orlando/rest/c_TableAPI)，這可能會對效能產生負面影響。
**注意**
【...】 指定顯示值可能會導致效能問題，因為它不會直接從資料庫讀取，並且可能包括參考其他欄位和記錄。
#### 篩選條件 （一般）
*篩選條件*列可讓您根據多個欄位和值條件縮小顯示的資料列範圍。
所有篩選條件都會與 *AND* 或 *OR* 操作結合。
未使用自訂資料表時，可使用下列欄位 （此清單將在未來展開）。
```
Active
Asset
Group
Assigned To
Escalation
Issue Number
Description
Priority
State
Type
Change Risk
Change State
Start Date
End Date
On Hold
```
選取自訂資料表時，會自動從 Service Now API 填入欄位。
##### 日期篩選條件
| 時間欄位 | 運算子 | Value |
| --- | --- | --- |
| 開啟時間 | 今天或之前 今天 之前 今天或之後 之前 | 時間戳記 javascript：gs.daysAgo(30) |
| 活動到期 | | |
| 關閉時間 | | |
| 到期日 | | |
| 預期開始 | | |
| 重新開啟的時間 | | |
| 在 解決 | | |
| 工作結束 | | |
| 工作開始 | | |
| 忽略時間 | | |
如需其他日期值，請參閱：https：//https://developer.servicenow.com/app.do\$1\$1/api\$1doc?v=newyork&id=r\$1SGSYS-dateGenerate\$1S\$1S
##### 運算子 （一般、字串型）
+ 開頭為
+ Ends With
+ 類似
+ 不喜歡
+ Equals
+ 不等於
+ Is Empty
##### 運算子 （以時間為基礎）
+ 今天
+ 不是今天
+ Before
+ 在 或之前
+ After
+ 在 或之後
##### 值
值選擇取決於選取的篩選條件類型。
+ 布林值篩選條件具有 True/False 選項
+ 文字篩選條件將允許輸入任何值
+ 呈報，優先順序具有一組固定的數值
#### 排序依據
*排序依據*資料列可根據多個欄位和值條件縮小顯示的資料列範圍。
所有篩選條件都會與 *AND* 操作結合。將新增對其他運算子的支援。
#### 限制
您可以指定資料列限制，以防止傳回過多的資料。預設值為 25。
#### 時間欄位
`Time Field` 會將您查詢的資料轉換為時間序列。以時間序列處理的資料表示不會顯示所選「時間欄位」中不在儀表板/面板時間範圍內的值。
使用的預設時間欄位是「開啟時間」，但可以變更為保留時間值的任何可用欄位。
提供特殊值「忽略時間」，以允許結果「截至現在」，也允許篩選條件控制顯示哪些資料。
### AggregateAPI 查詢 （統計資料）
AggregateAPI 一律會傳回具有下列彙總的指標：avg、min、max、 sum。篩選也可用於縮小查詢範圍。
#### Show
*顯示*列為要顯示的指標提供選擇器。您也可以指定多個指標。
#### 篩選條件 （一般）
彙總*篩選條件*可根據欄位和值條件縮小顯示的指標範圍，類似於資料表選項。
所有篩選條件都會與 *AND* 操作結合。將新增對其他運算子的支援。
Stat 篩選條件選項與 TableAPI 相同。
#### 聚合
指標彙總有四種類型，加上「計數」：
+ 平均數
+ 下限
+ 上限
+ 總和
+ 計數 - 這會傳回查詢傳回的指標的 "number"
##### 分組依據
此選擇器可讓您將指標分割為較少的彙總。依「優先順序」分組會傳回優先順序為「標籤」的指標，並將唯一值分開。
### 範本化
您可以在其位置使用變數，而不是硬式編碼查詢中的名稱。變數會顯示為儀表板頂端的下拉式清單選取方塊。您可以使用這些下拉式方塊來變更儀表板上顯示的資料。
請參閱**查詢變數**區段中的範例，了解如何新增查詢變數並參考具有範本值的 。
#### 查詢變數
如果您新增 類型的範本變數`Query`，您可以撰寫查詢，以傳回顯示為下拉式清單選取方塊的項目，例如類別名稱、索引鍵名稱或索引鍵值。
例如，您可以在範本變數查詢**設定中`categories`指定這類查詢，以擁有包含 所有值的變數。
選擇**查詢**設定時，會顯示**篩選條件**區段，讓您選擇**類型**和**欄位**。目前，**類型**僅限於事件和變更。選取類型時，您會收到適用於該類型的欄位清單。選取**類型**和**欄位**後，底部會顯示值的預覽，顯示該類型/欄位可用的選項。這些值會顯示在儀表板的下拉式清單中，您可以搭配範本來篩選儀表板上的資料。
例如，如果您新增名為 的變數*類別*，然後選取類型 = 事件和欄位 = 類別，您會看到類別的選項清單。如果您接著將篩選條件新增至面板，然後選取類別等於 \$1\$1category\$1，則面板資料只會顯示從儀表板下拉式清單中選取該類別的資料。
匯入**依類別分類的事件**儀表板以查看範例。
#### 在查詢中使用變數
有兩種語法：
`$` 範本變數名為 的範例`hostname`：
`[[varname]]` 範本變數名為 的範例`hostname`：
## 提醒
支援標準 Grafana 警示。圖形面板中定義的任何查詢都可以用來產生提醒。
以下是查詢和提醒的範例。此查詢將傳回所有開啟關鍵高優先順序事件的圖表：
當有超過五個開啟的重大高優先順序事件時，將會啟動此提醒：
測試提醒規則會顯示提醒規則的輸出，而選取狀態歷史記錄會顯示提醒從 ok 轉換為待定，再轉換為提醒。
圖形檢視會顯示垂直線，當警示處於待定狀態時，頂端的心形圖示會變成橘色。
一旦符合提醒條件，規則就會轉換為紅色。
在圖形檢視中，紅色垂直線將出現，頂端的心圖示將變為紅色。
### 撰寫警示的事件
**Beta 功能**
+ 為您的 ServiceNow 資料來源設定通知管道。
這會設定 [Grafana 通知管道](https://grafana.com/docs/grafana/latest/alerting/notifications/)，此管道會使用您設定的 使用者，在此資料來源的 ServiceNow 執行個體上建立事件。
此動作需要 ServiceNow 資料來源使用者具有寫入事件的許可。
## 註釋
Grafana 註釋是截至此資料來源`v1.4.0`的 **Beta 版功能**。註釋可讓您在圖形上覆蓋事件。
註釋查詢支援與標準查詢編輯器相同的選項，但有一些細微差異：
+ 只能選取一個「顯示」欄。這可能會在未來的改善中修正。
+ 時間欄位為必要欄位。
## 常見問答集
### 如果我們沒有 ITSM 角色外掛程式該怎麼辦？
**需要管理員存取權才能執行下列動作**
選項 1：授予 Grafana 使用者管理員許可，以允許存取所有資料表。
選項 2：建立角色並將 ACLs 套用至 Grafana 必須存取的所有資料表。
需要管理員存取權才能執行下列動作。
1. 登入的管理員需要提升對 security\$1admin 的存取。
1. 在右上角導覽窗格中，選擇設定檔圖示。設定檔圖示具有下拉式插入符號。
1. 從下拉式清單中，選擇**升級角色**。
1. 從顯示的模態中，選取 **security\$1admin** 核取方塊。
1. 選擇確定。
1. 使用您想要的任何命名慣例建立新的角色。
1. 導覽至左側導覽系統安全性 => 使用者和群組 => 角色中的角色區段
1. 在頂端選擇**新增**。
1. 輸入角色的名稱和相關描述。
1. 選擇**提交**。
1. 建立新的使用者或修改具有所需角色的現有使用者。
1. 您在步驟 2 中建立的角色
1. personalize\$1dictionary
1. personalize\$1choices
1. cmdb\$1read （這會授予所有 cmdb 資料表的讀取存取權）
1. 為必要的資料表和欄位建立資料表 ACLs。
1. 為 sys\$1db\$1object 資料表建立 ACL。
1. 在第二個搜尋標頭資料欄**名稱**中，輸入 **sys\$1db\$1object**，然後按 **Enter**。
1. 篩選的結果應該會顯示**資料表**。選擇**資料表**以導覽至記錄。
1. 在索引標籤區段中，選擇**控制項**。
1. 在頁面的下半部，確定**存取控制**是選取的索引標籤。
1. 選擇**新增**以建立新的 ACL。
1. 變更要讀取**的操作**選擇。
1. 在畫面下方的**需要角色**區段中，選擇 （按兩下） **插入新資料列**，然後搜尋您建立的角色。
1. 選取您建立的角色後，請選擇綠色核取記號。
1. 選擇畫面下方的**提交**以建立 ACL，然後在模態出現時選擇**繼續**。
1. 針對特定 sys\$1db\$1object 欄位建立 ACLs。必須針對下列每個欄位重複下列步驟：名稱、標籤、顯示名稱和延伸資料表。
1. 當仍在 sys\$1db\$1object 的資料表記錄檢視中時，請選取最接近畫面頂端的標籤群組中的資料**欄**標籤。
1. 找到欄位名稱並選取它。
1. 在下方索引標籤區段中，選擇**存取控制**索引標籤上的**新增**。
1. 將 操作變更為讀取
1. 選擇 （按兩下） 在底部「需要角色」資料表中插入資料列文字。
1. 搜尋您建立的角色，然後選擇綠色核取記號。
1. 選擇**提交**。
1. 請確定您已針對所有必要欄位重複這些步驟：名稱、標籤、顯示名稱和延伸資料表。
1. 針對您要從 Grafana 查詢的變更、事件和任何其他非 CMDB 資料表，重複 4.1 中的步驟。請勿重複 4.2 中的步驟；該步驟僅適用於 sys\$1db\$1object。
# 連線至 Snowflake 資料來源
使用 Snowflake Enterprise 資料來源，您可以將 Snowflake 資料與 Grafana 中的所有其他資料來源以及內容中的日誌和指標資料視覺化。此資料來源包含功能強大的預先類型查詢編輯器、支援複雜的註釋、設定提醒閾值、控制存取和許可等。
**注意**
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
## 概觀
### 什麼是 Snowflake？
Snowflake 提供雲端資料儲存和分析服務，通常稱為「資料warehouse-as-a-service」，提供資料倉儲、資料湖、資料工程、資料科學、資料應用程式開發和資料共用的解決方案。在過去幾年中，由於 Snowflake 能夠以經濟實惠的方式使用雲端型硬體和軟體存放和分析資料，因此廣受好評；最近成為史上最大的軟體 IPO。如今，許多公司使用 Snowflake 作為其主要資料庫來存放應用程式和商業資料，例如交易計數、作用中的使用者工作階段，甚至是時間序列和指標資料。
### 充分利用 Snowflake 和 Amazon Managed Grafana
**視覺化 Snowflake 資料而不移動：**Grafana 的唯一架構會直接查詢資料，而不是移動資料並支付備援儲存和擷取的費用。
**從各種來源編寫面板：**使用預先建置的自訂儀表板，將來自許多不同資料來源的資料整合到單一玻璃窗格中。
**在使用者層級轉換和運算**：使用者可以轉換資料，並根據他們看到的資料執行各種運算，從而減少資料準備。
**在面板中結合、運算和視覺化**：建立混合資料來源面板，顯示來自 Snowflake 和其他來源的相關資料。
### 功能
**查詢編輯器：**查詢編輯器是一種智慧型 SQL 自動完成編輯器，可讓您視覺化時間序列或資料表資料、處理 SQL 語法錯誤，以及自動完成基本 SQL 關鍵字。
**資料來源許可**：控制誰可以在 Grafana 中檢視或查詢 Snowflake 資料
**註釋：**在任何 Grafana 圖形上疊加 Snowflake 事件，以關聯事件與其他圖形資料
**警示：**在 Snowflake 中設定警示型指標存放區
**查詢的變數：**根據 Snowflake 資料在 Grafana 中建立範本變數，並在 Snowflake 查詢中包含變數以建立互動式儀表板。
**多指標查詢：**撰寫單一查詢，傳回多個指標，每個指標都在自己的資料欄中
## 開始使用 Snowflake 外掛程式
以下是在 Grafana 中開始使用 Snowflake 外掛程式的五個快速步驟：
### 步驟 1：設定 Snowflake 資料來源
若要設定資料來源，請選擇**組態**、**資料來源**、**新增資料來源**、Snowflake。
新增身分驗證詳細資訊，且資料來源已準備好進行查詢！
下列組態欄位可供使用。
| 名稱 | 描述 |
| --- | --- |
| 帳戶 | Snowflake 的帳戶。 |
| 使用者名稱 | 服務帳戶的使用者名稱。 |
| 密碼 | 服務帳戶的密碼。 |
| 結構描述 （選用） | 設定查詢的預設結構描述。 |
| 倉儲 （選用） | 設定查詢的預設倉儲。 |
| 資料庫 （選用） | 設定查詢的預設資料庫。 |
| 角色 （選用） | 擔任查詢的角色。 |
### 步驟 2：寫入 Snowflake 資料的查詢
在儀表板中建立面板，然後選取 Snowflake 資料來源以開始使用查詢編輯器。
+ 只要包含日期/時間，它就會出現在查詢中的任何位置。
+ 必須包含數值欄。這可以是彙總或 int/float 資料欄。
+ 或者，如果您的時間序列資料已針對不同的指標進行格式化，您可以包含字串資料欄來建立個別的資料序列。
#### Snowflake 查詢的配置
```
select
,
,
,
<...>
from
where
$__timeFilter() // predefined where clause for time range
and $ = 1 // custom variables start with dollar sign
```
#### 依間隔分類的時間序列群組 SQL 查詢格式
```
select
$__timeGroup(created_ts, '1h'), // group time by interval of 1h
,
,
from
where
$__timeFilter() // predefined where clause for time range
and $ = 1 // custom variables start with dollar sign
group by
```
#### 資料表的 SQL 查詢格式
```
select
, // optional if result format option is table
from
where
$__timeFilter(time_column) // macro for time range, optional if format as option is table
and $ = 1 // custom variables start with dollar sign
```
### 步驟 3：建立和使用範本變數
#### 使用範本變數
您可以在查詢中包含範本變數，如下列範例所示。
```
select
from
WHERE column >= '$variable'
```
下列範例顯示在查詢中使用多值變數。
```
select
from
WHERE regexp '${variable:regex}'
```
#### 使用 Snowflake 資料來源建立變數
在儀表板設定中，選擇**變數**，然後選擇**新增**。
使用「查詢」變數類型，選取 Snowflake 資料來源做為「資料來源」。
**重要**
請務必在變數查詢中只選取一個資料欄。
範例：
```
SELECT DISTINCT query_type from account_usage.query_history;
```
會為您提供這些變數：
```
All DESCRIBE USE UNKNOWN GRANT SELECT CREATE DROP SHOW
```
### 步驟 4：設定提醒
您可以針對特定 Snowflake 指標或您建立的查詢設定提醒。
在查詢編輯器中選擇提醒索引標籤按鈕，然後選擇**建立提醒**。
### 步驟 5. 建立註釋
註釋可讓您在圖形上疊加事件。
若要建立註釋，請在儀表板設定中選擇**註釋**和**新增**，然後選取 Snowflake 作為資料來源。
由於註釋是事件，因此它們至少需要一個時間欄和一個資料欄來描述事件。
下列範例程式碼顯示查詢，以註釋所有 Snowflake 失敗的登入。
```
SELECT
EVENT_TIMESTAMP as time,
EVENT_TYPE,
CLIENT_IP
FROM ACCOUNT_USAGE.LOGIN_HISTORY
WHERE $__timeFilter(time) AND IS_SUCCESS!='YES'
ORDER BY time ASC;
```
及
+ 時間： `TIME`
+ 標題： `EVENT_TYPE`
+ 文字： `CLIENT_IP`
這將在儀表板面板上疊加所有登入 Snowflake 失敗的註釋。
## 其他功能
### 使用顯示名稱欄位
此外掛程式使用選項面板欄位索引標籤中的顯示名稱欄位，根據其名稱、標籤或值來縮短或修改圖例金鑰。其他資料來源使用自訂`alias`功能來修改圖例索引鍵，但顯示名稱函數是更一致的方法。
### 資料來源許可
選擇資料來源組態頁面中的**許可**索引標籤來啟用資料來源許可，以限制對 Snowflake 的存取。在許可頁面上，管理員可以啟用許可，並將查詢許可限制為特定使用者和團隊。
### 了解您的 Snowflake 帳單和用量資料
在 Snowflake 資料來源中，您可以匯入帳單和用量儀表板，顯示有用的帳單和用量資訊。
在 Snowflake 資料來源組態頁面中新增儀表板：
此儀表板使用 ACCOUNT\$1USAGE 資料庫，並要求佇列具有 ACCOUNTADMIN 角色。若要安全地執行此操作，請建立新的 Grafana 資料來源，其中包含具有 ACCOUNTADMIN 角色的使用者。然後在變數中選取該資料來源。
# 連線至 Splunk 資料來源
**注意**
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
## Configuration
### 資料來源組態
設定資料來源時，請確定 URL 欄位使用 `https`並指向您設定的 Splunk 連接埠。預設 Splunk API 點是 8089，而不是 8000 （這是預設 Web UI 連接埠）。啟用*基本驗證*，並指定 Splunk 使用者名稱和密碼。
#### 瀏覽器 （直接） 存取模式和 CORS
Amazon Managed Grafana 不支援 Splunk 資料來源的瀏覽器直接存取。
### 進階選項
#### 串流模式
如果您想要在搜尋結果可用時取得搜尋結果，請啟用串流模式。這是實驗性功能，除非您確實需要，否則請勿啟用它。
#### 輪詢結果
執行搜尋，然後定期檢查結果。在幕後，此選項會執行 `search/jobs` API 呼叫，並將 `exec_mode`設定為 `normal`。在此情況下，API 請求會傳回任務 SID，然後 Grafana 會不時檢查任務狀態，以取得任務結果。此選項有助於慢查詢。預設會停用此選項，且 Grafana 會將 `exec_mode` 設為 `oneshot`，允許在相同的 API 呼叫中傳回搜尋結果。進一步了解 [Splunk 文件](https://docs.splunk.com/Documentation/Splunk/latest/RESTREF/RESTsearch#search.2Fjobs)中的 `search/jobs` API 端點。
#### 搜尋輪詢間隔
此選項允許 調整 Amazon Managed Grafana 輪詢 splunk 以取得搜尋結果的頻率。從 【最小值，最大值） 間隔隨機選擇下一個輪詢的時間。如果您執行大量搜尋，則增加這些值是合理的。提示：如果搜尋任務執行需要很長時間，則增加*最小值*；如果您執行許多平行搜尋 (Grafana 儀表板上的大量碎片指標），則增加*最大值*。預設為 【500， 3000) 毫秒間隔。
#### 自動取消
如果指定，任務會在這幾秒鐘沒有活動後自動取消 (0 表示永遠不會自動取消）。預設為 30。
#### 狀態儲存貯體
要產生的最多狀態儲存貯體。0 表示不產生時間軸資訊。預設為 300。
#### 欄位搜尋模式
當您使用視覺化查詢編輯器時，資料來源會嘗試取得所選來源類型的可用欄位清單。
+ 快速 - 使用預覽版中第一個可用的結果
+ full - 等待任務完成並取得完整結果。
#### 預設最早時間
有些搜尋無法使用儀表板時間範圍 （例如範本變數查詢）。此選項有助於防止搜尋所有時間，這可能會拖慢 Splunk。語法是整數和時間單位 `[+|-]`。例如 `-1w`。[時間單位](https://docs.splunk.com/Documentation/Splunk/latest/Search/Specifytimemodifiersinyoursearch)可以是 `s, m, h, d, w, mon, q, y`。
#### 變數搜尋模式
範本變數查詢的搜尋模式。可能的值如下：
+ fast - 事件搜尋的欄位探索關閉。統計資料搜尋沒有事件或欄位資料。
+ 上的 smart - 事件搜尋的欄位探索。統計資料搜尋沒有事件或欄位資料。
+ 詳細資訊 - 所有事件和欄位資料。
## Usage
### 查詢編輯器
#### 編輯器模式
查詢編輯器支援兩種模式：原始和視覺化。若要在這些模式之間切換，請選擇編輯器右側的漢堡圖示，然後選取*切換編輯器模式*。
#### 原始模式
針對時間序列資料使用 `timechart`命令，如下列程式碼範例所示。
```
index=os sourcetype=cpu | timechart span=1m avg(pctSystem) as system, avg(pctUser) as user, avg(pctIowait) as iowait
index=os sourcetype=ps | timechart span=1m limit=5 useother=false avg(cpu_load_percent) by process_name
```
查詢支援範本變數，如下列範例所示。
```
sourcetype=cpu | timechart span=1m avg($cpu)
```
請記住，Grafana 是時間序列導向的應用程式，您的搜尋應該傳回時間序列資料 （時間戳記和值） 或單一值。您可以閱讀 [timechart](https://docs.splunk.com/Documentation/Splunk/latest/SearchReference/Timechart) 命令，並在官方 [Splunk 搜尋參考中找到更多搜尋](https://docs.splunk.com/Documentation/Splunk/latest/SearchReference/WhatsInThisManual)範例
#### Splunk 指標和 `mstats`
Splunk 7.x 提供用於分析指標的`mstats`命令。若要讓圖表與 正常運作`mstats`，它應該與 `timeseries` 命令結合，且必須設定 `prestats=t` 選項。
```
Deprecated syntax:
| mstats prestats=t avg(_value) AS Value WHERE index="collectd" metric_name="disk.disk_ops.read" OR metric_name="disk.disk_ops.write" by metric_name span=1m
| timechart avg(_value) span=1m by metric_name
Actual:
| mstats prestats=t avg(disk.disk_ops.read) avg(disk.disk_ops.write) WHERE index="collectd" by metric_name span=1m
| timechart avg(disk.disk_ops.read) avg(disk.disk_ops.write) span=1m
```
閱讀 [Splunk 搜尋參考](https://docs.splunk.com/Documentation/Splunk/latest/SearchReference/Mstats)中有關 `mstats` 命令的詳細資訊。
#### 格式化為
支援兩種結果格式模式：*時間序列* （預設） 和*資料表*。當您想要顯示彙總資料時，適用於搭配資料表面板使用的資料表模式。這適用於原始事件 （傳回所有選取的欄位） 和`stats`搜尋函數，這會傳回類似資料表的資料。範例：
```
index="os" sourcetype="vmstat" | fields host, memUsedMB
index="os" sourcetype="ps" | stats avg(PercentProcessorTime) as "CPU time", latest(process_name) as "Process", avg(UsedBytes) as "Memory" by PID
```
結果與 Splunk UI 中的*統計資料*索引標籤類似。
閱讀 [Splunk 搜尋參考](https://docs.splunk.com/Documentation/Splunk/latest/SearchReference/Stats)中有關`stats`函數用量的詳細資訊。
#### 視覺化模式
此模式提供step-by-step建立搜尋。請注意，此模式會建立`timechart`碎片搜尋。只要選取索引、來源類型和指標，然後視需要依欄位設定分割。
##### 指標
您可以新增多個指標來搜尋，方法是選擇指標列右側的*加*號按鈕。指標編輯器包含常用彙總的清單，但您可以在此處指定任何其他函數。只需選擇觸發區段 (`avg`預設） 並輸入您需要的內容。從下拉式清單中選取感興趣的欄位 （或輸入），並視需要設定別名。
##### 依 和位置分割
如果您設定依欄位分割並使用*時間序列*模式，則編輯器將可用。選擇*加*號，然後選取運算子、彙總和值，例如*前 10 個平均的位置*。請注意，此 *Where* 子句是 *Split by* 的一部分。如需詳細資訊[，請參閱時間圖表文件](https://docs.splunk.com/Documentation/Splunk/latest/SearchReference/timechart#where_clause)。
#### 選項
若要變更預設的時間表選項，請選擇最後一列**的選項**。
如需這些選項的詳細資訊，請參閱[時間表文件](https://docs.splunk.com/Documentation/Splunk/latest/SearchReference/timechart)。
#### 轉譯的 splunk 搜尋
選擇左側的目標字母以收合編輯器，並顯示轉譯的碎片搜尋。
### 註釋
如果您想要在圖形上顯示 Splunk 提醒或事件，請使用註釋。註釋可以是預先定義的 Splunk 提醒或一般 splunk 搜尋。
#### Splunk 提醒
指定提醒名稱，或將欄位保留空白，以取得所有觸發的提醒。支援範本變數。
#### Splunk 搜尋
使用 splunk 搜尋來取得所需的事件，如下列範例所示。
```
index=os sourcetype=iostat | where total_ops > 400
index=os sourcetype=iostat | where total_ops > $io_threshold
```
支援範本變數。
如果您想要使用欄位值做為註釋文字，則**事件欄位做為**文字選項是合適的。下列範例顯示日誌中的錯誤訊息文字。
```
Event field as text: _raw
Regex: WirelessRadioManagerd\[\d*\]: (.*)
```
Regex 允許 擷取部分訊息。
### 範本變數
範本變數功能支援 Splunk 查詢，其會傳回值清單，例如使用 `stats`命令。
```
index=os sourcetype="iostat" | stats values(Device)
```
此查詢會從`iostat`來源傳回`Device`欄位值的清單。然後，您可以將這些裝置名稱用於時間序列查詢或註釋。
有兩種可能的變數查詢類型可用於 Grafana。第一個是簡單的查詢 （如先前所示），會傳回值清單。第二個類型是可建立索引鍵/值變數的查詢。查詢應傳回兩個名為 `_text`和 的資料欄`_value`。`_text` 資料欄值應該是唯一的 （如果不是唯一的，則會使用第一個值）。下拉式清單中的選項會有文字和值，因此您可以將易記的名稱做為文字，並將 ID 做為值。
例如，此搜尋會傳回包含資料欄 `Name`(Docker 容器名稱） 和 `Id`（容器 ID) 的資料表。
```
source=docker_inspect | stats count latest(Name) as Name by Id | table Name, Id
```
若要使用容器名稱做為變數的可見值，並使用 ID 做為實際值，應修改查詢，如下列範例所示。
```
source=docker_inspect | stats count latest(Name) as Name by Id | table Name, Id | rename Name as "_text", Id as "_value"
```
#### 多值變數
您可以在查詢中使用多值變數。插入的搜尋將取決於變數用量內容。外掛程式支援許多內容。假設有一個`$container`變數具有選取的值 `foo`和 `bar`：
+ `search` 命令的基本篩選條件
```
source=docker_stats $container
=>
source=docker_stats (foo OR bar)
```
+ 欄位值篩選條件
```
source=docker_stats container_name=$container
=>
source=docker_stats (container_name=foo OR container_name=bar)
```
+ 具有`IN`運算子和`in()`函數的欄位值篩選條件
```
source=docker_stats container_name IN ($container)
=>
source=docker_stats container_name IN (foo, bar)
source=docker_stats | where container_name in($container)
=>
source=docker_stats | where container_name in(foo, bar)
```
#### 多值變數和引號
如果變數以引號括住 （雙或單），也會引用其值，如下列範例所示。
```
source=docker_stats container_name="$container"
=>
source=docker_stats (container_name="foo" OR container_name="bar")
source=docker_stats container_name='$container'
=>
source=docker_stats (container_name='foo' OR container_name='bar')
```
# 連線至 Splunk Infrastructure Monitoring 資料來源
支援 Splunk Infrastructure Monitoring （先前稱為 SignalFx)。
**注意**
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
## 新增資料來源
1. 在 Amazon Managed Grafana 工作區中開啟 Grafana 主控台，並確保您已登入。
1. 在**組態** （齒輪圖示） 下的側邊選單中，選擇**資料來源**。
1. 選擇**新增資料來源**。
**注意**
如果您在側邊選單中看不到**資料來源**連結，表示您目前的使用者沒有 `Admin`角色。
1. 從資料來源清單中選取 **Splunk Infrastructure Monitoring**。
1. 輸入下列資訊：
+ 針對**存取字符**，輸入 SignalFx 帳戶產生的字符。如需詳細資訊，請參閱[身分驗證字符](https://docs.signalfx.com/en/latest/admin-guide/tokens.html)。
+ **領域** 託管您組織的獨立部署。登入 SignalFx 使用者介面時，您可以在設定檔頁面上找到您的領域名稱。
## 使用查詢編輯器
查詢編輯器接受 [ SignalFlow](https://dev.splunk.com/observability/docs/signalflow/) 程式/查詢。
對於標籤，訊號流程標籤`publish(label = 'foo')`會套用為結果的中繼資料：**"label"："foo"**
對於查詢類型範本變數，沒有**查詢**欄位。而是選取下列其中一個查詢類型：
+ 維度
+ 指標
+ Tags (標籤)
支援臨機操作篩選條件，允許使用維度進行全域篩選條件。
支援 Grafana 註釋。當您建立註釋時，請使用 SignalFlow 警示或事件查詢。
取得偵測器警示的範例：
```
alerts(detector_name='Deployment').publish();
```
依類型取得自訂事件的範例：
```
events(eventType='simulated').publish();
```
# 連線至 Wavefront 資料來源 (Wavefront 的 VMware Tanzu 可觀測性）
Wavefront (VMware Tanzu Observability by Wavefront) 資料來源可讓 Amazon Managed Grafana 使用者直接從 Wavefront 查詢和視覺化他們收集的資料，並輕鬆地將其與任何其他指標、日誌、追蹤或其他資料來源一起視覺化。這種靈活的單一窗格檢視可讓您更輕鬆地追蹤系統運作狀態和偵錯問題。
**注意**
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。
## 什麼是 Wavefront？
[Wavefront](https://www.wavefront.com) 是由 VMware 開發的雲端監控和分析工具。Wavefront 是一種雲端託管服務，可讓您從 CollectD、StatsD、JMX、Ruby 的 記錄器 AWS或其他工具傳送時間序列 （指標） 資料。使用 Wavefront，使用者可以在這些序列上執行數學操作、轉譯圖表以查看異常、追蹤 KPIs和建立提醒。
## 使用 Wavefront 和 Grafana 最大化您的技術堆疊
在表面上，Grafana 和 Wavefront 聽起來相似，許多組織使用 Wavefront 和 Grafana 作為其可觀測性工作流程的關鍵部分。
**視覺化而不移動資料來源：**Grafana 的唯一架構會直接查詢資料，而不是移動資料並支付備援儲存和擷取的費用。
**從不同來源編寫面板** 使用預先建置的自訂儀表板，將來自許多不同資料來源的資料整合到單一玻璃窗格中。
**使用者層級的轉換和運算：**使用者可以轉換資料，並對其看到的資料執行各種運算，從而減少資料準備。
**在面板中結合、運算和視覺化：**建立混合資料來源面板，顯示來自 Waveferont 和其他來源的相關資料，例如 Prometheus 和 InfluxDB。
## 文件
### 功能
+ Timeseries 視覺化
+ 資料表視覺化
+ 熱度圖視覺化
+ 單一統計資料視覺化
+ 引導式查詢編輯器
+ 原始 WQL 查詢編輯器
+ 事件資料的註釋
+ 範本變數
+ 臨時篩選條件
+ 提醒
### Configuration
設定 Wavefront 資料來源相對簡單。完成組態只需要兩個欄位： `API URL`和 `Token`。
+ `API URL` 將是您用來存取 wavefront 環境的 URL。範例：`https://myenvironment.wavefront.com`。
+ `Token` 必須從使用者帳戶或服務帳戶產生。
1. 若要建立以使用者帳戶為基礎的權杖，請登入 Wavefront 環境，選擇頁面右上角的齒輪，選擇您的使用者名稱 （例如，`me@grafana.com`)，選取使用者頁面頂端的 **API 存取**索引標籤，然後複製現有的金鑰或選擇**產生**。
1. 若要建立以服務帳戶為基礎的權杖，請登入 Wavefront 環境，選擇頁面右上角的齒輪，選擇帳戶管理。在左側導覽上，選取**帳戶、群組和角色**，選擇頂端**的服務帳戶**索引標籤，然後選擇**建立新帳戶**。輸入服務帳戶的名稱。這可以是您想要的任何項目。複製字符區段下提供的**字符**。
1. 最後一個步驟是確保在**許可**下選取的**帳戶、群組和角色**核取方塊。
擁有權杖之後，請將權杖新增至`Token`組態欄位，即可設定！
完成的組態頁面看起來應該類似：
### Usage
#### 使用查詢編輯器
Wavefront 查詢編輯器有兩種模式：**查詢建置器**和**原始查詢**。若要在它們之間切換，請使用查詢表單右上角的選取器：
在**查詢建置器**模式中，您會看到四個選項：
1. 您想要查詢什麼指標？
1. 您想要在該指標上執行什麼彙總？
1. 您要如何篩選該指標查詢的結果？
1. 是否要將任何其他函數套用至結果？
指標選擇器是分類階層。選取類別，然後再次選擇 以深入探索子類別。重複此程序，直到您達到所需的指標為止。
選取指標後，系統會自動為您填入可用的篩選條件和篩選條件值。
在**原始查詢**模式中，您會看到一個標示為**查詢**的欄位。這可讓您執行任何您想要的 [WQL](#wavefront-references) 查詢。
#### 使用篩選條件
Wavefront 外掛程式會動態查詢每個指標的適當篩選條件。
若要新增篩選條件，請選擇 Wavefront 查詢編輯器上**篩選條件**標籤旁的 **\$1**，選取要篩選的欄位，然後選取要篩選的值。
#### 使用 函數
函數提供一種額外的方法來彙總、操作和對指標回應資料執行計算。若要檢視可用的函數，請依**查詢建置器**上的函數標籤選擇下拉式清單。根據您選取的函數，您將能夠執行進一步的動作，例如依欄位設定群組或套用閾值。使用者可以將多個函數鏈結在一起，以執行進階計算或資料處理。
#### 新增查詢範本變數
1. 若要為儀表板建立新的 Wavefront 範本變數，請選擇儀表板右上角的設定齒輪。
1. 在左側面板中，選擇**變數**。
1. 在變數頁面的右上角，選擇**新增**。
1. 輸入您要建立之範本變數**的名稱**和**標籤**。**名稱**是您將在查詢內用來參考範本變數的值。**Label** 是人類易記的名稱，可在儀表板選取面板上顯示範本變數。
1. 選取類型 **查詢**類型欄位 （預設為應選取）。
1. 在**查詢選項**標題下，選取**資料來源**下拉式清單中的 **Wavefront**。
1. 如需在[查詢欄位中輸入內容的詳細資訊，請參閱範本變數查詢結構](#template-variable-query-structure)。 ****
1. 如果您想要篩選掉查詢傳回的任何值，請在 **Regex** 輸入欄位中輸入規則表達式。
1. 在排序下拉式清單中選擇排序類型，以套用您可能有的任何**排序**偏好設定。
1. 驗證組態後，選擇**新增**以新增範本變數，然後選擇左側導覽面板上的**儲存儀表板**以儲存變更。
#### 範本變數查詢結構
指標清單：指標：ts(...)
來源清單：來源：ts(...)
來源標籤清單：sourceTags： ts(...)
比對來源標籤清單：matchingSourceTags：ts(...)
標籤名稱清單：tagNames： ts(...)
標籤值清單：tagValues()：ts(...)
**備註**
+ 每個查詢類型結尾的 是選用的
+ 支援所有小寫。您可以使用 tagname 或 tagNames，但不能使用 TAGNAMES。
+ 在 周圍使用空格：選用
**WARNING**
`Multi-value` Wavefront 外掛程式`Include All option`目前不支援 和 。
#### 使用範本變數
完成[新增範本變數](#wavefront-adding-a-query-template-variable-1)的步驟後，您現在可以在儀表板面板中使用範本變數來建立動態視覺化。
1. 使用儀表板右上角的 panel\$1 圖示新增儀表板面板。
1. 選取您要用於查詢的彙總。
1. 選擇**篩選條件**標籤旁的 \$1 圖示，然後選取符合您範本變數的金鑰類型。例如，`host=`主機篩選條件。
1. 輸入您在篩選條件的值****輸入欄位中建立的範本變數名稱。
1. 儲存儀表板。
您現在應該可以循環查看範本變數的不同值，並讓您的面板動態更新！
#### 使用 Ad-Hoc 篩選條件
若要使用臨機操作篩選條件，我們必須建立兩個範本變數。第一個是輔助變數，將用於選取指標，以便為該指標名稱填入附加型篩選條件。另一個是實際的臨機操作篩選條件變數。
**重要**
所需的協助程式變數必須命名為 `metriclink`。這可以是自訂變數，其中包含您要使用的指標清單，或使用[範本變數查詢結構的查詢型變數](#template-variable-query-structure)。如果您想要僅將單一指標的值填入臨機操作篩選條件欄位，您可以隱藏`metriclink`範本變數。
建立`metriclink`變數之後，您現在可以依照新增[查詢範本變數中詳述的相同步驟來新增](#wavefront-adding-a-query-template-variable-1)臨機操作篩選條件。差別在於您將選取**臨時篩選條件**做為**類型**，而且查詢不需要輸入。
#### 新增註釋
1. 若要為儀表板建立新的 Wavefront 註釋，請選擇儀表板右上角的設定齒輪。
1. 在左側面板中，選擇**註釋**。
1. 在註釋頁面的右上角，選擇**新增**。
1. 輸入註釋的名稱 （這將用作儀表板上的切換名稱）。
1. 選取 Wavefront 的**資料來源**。
1. 根據預設，註釋的傳回提醒事件限制為 100 個。若要變更，請將**限制**欄位設定為您想要的值。
1. 選擇**新增**。
#### 使用註釋
開啟註釋時，您現在應該會看到與指定時段相關的提醒事件和問題。
如果您在視覺化的註釋區段底部暫停，則會顯示顯示提醒名稱的快顯視窗，並提供 Wavefront 中提醒的直接連結。
#### 使用顯示名稱欄位
此資料來源使用選項面板欄位索引標籤中的顯示名稱欄位，根據其名稱、標籤或值來縮短或修改圖例金鑰。其他資料來源使用自訂`alias`功能來修改圖例索引鍵，但顯示名稱函數是更一致的方法。
### 參考
+ [WQL (Wavefront 查詢語言）](https://docs.wavefront.com/query_language_reference.html)
# 使用 Grafana 第 10 版
****
本文件主題專為支援 Grafana **10.x 版的 Grafana** 工作區而設計。
如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。
建立 Grafana 工作區時，您可以選擇要使用哪個版本的 Grafana。下列主題說明使用 Grafana 第 10 版的 Grafana 工作區。
**Topics**
+ [Grafana 第 10 版中的儀表板](v10-dashboards.md)
+ [Grafana 第 10 版中的面板和視覺化](v10-panels.md)
+ [在 Grafana 第 10 版中探索](v10-explore.md)
+ [Grafana 第 10 版中的相關性](v10-correlations.md)
+ [Grafana 第 10 版中的提醒](v10-alerts.md)
# Grafana 第 10 版中的儀表板
****
本文件主題專為支援 Grafana **10.x 版的 Grafana** 工作區而設計。
如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。
儀表板是一組一或多個[面板](v10-panels.md)，組織並排列成一或多個資料列。Grafana 隨附各種面板，可讓您輕鬆建構正確的查詢，並自訂視覺化效果，以便建立符合您需求的理想儀表板。每個面板都可以與任何已設定 的資料互動[連線至資料來源](AMG-data-sources.md)。
儀表板快照是靜態的。無法從快照重新執行查詢和表達式。因此，如果您更新查詢或表達式中的任何變數，它將不會變更儀表板資料。
**Topics**
+ [使用儀表板](v10-dash-using-dashboards.md)
+ [建置儀表板](v10-dash-building-dashboards.md)
+ [管理儀表板](v10-dash-managing-dashboards.md)
+ [管理播放清單](v10-dash-managing-playlists.md)
+ [共用儀表板和面板](v10-dash-sharing.md)
+ [Variables](v10-dash-variables.md)
+ [評估儀表板用量](v10-dash-assess-dashboard-usage.md)
+ [故障診斷儀表板](v10-dash-troubleshoot.md)
+ [在 Grafana 第 10 版中搜尋儀表板](v10-search.md)
# 使用儀表板
****
本文件主題專為支援 Grafana **10.x 版的 Grafana** 工作區而設計。
如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。
本主題提供儀表板功能和捷徑的概觀，並說明如何使用儀表板搜尋。
## 功能
您可以使用儀表板來自訂資料的呈現。下圖顯示 Amazon Managed Grafana 工作區中的儀表板界面。
![\[顯示 Amazon Managed Grafana 工作區中儀表板界面的影像，其中包含不同功能的按鈕重點。\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/images/AMG-dashboard-overview-v10.png)
| 功能 | Description |
| --- | --- |
| **1。首頁** | 選取要重新導向至 Grafana 執行個體中設定的首頁的 Grafana 主圖示。 |
| **2. 標題** | 選取儀表板標題時，您可以搜尋目前資料夾中包含的儀表板。 |
| **3. 共用儀表板** | 使用此選項，透過連結或快照共用目前的儀表板。您也可以從共用模式匯出儀表板定義。 |
| **4. 新增面板** | 使用此選項可將面板、儀表板列或程式庫面板新增至目前的儀表板。 |
| **5. 儲存儀表板** | 選擇儲存圖示以儲存儀表板的變更。 |
| **6. 儀表板洞察** | 選擇檢視儀表板的分析，包括使用者、活動和查詢計數的相關資訊。如需詳細資訊，請參閱[評估儀表板用量](v10-dash-assess-dashboard-usage.md)。 |
| **7. 儀表板設定** | 使用此選項可變更儀表板名稱、資料夾或標籤，以及管理變數和註釋查詢。如需儀表板設定的詳細資訊，請參閱 [修改儀表板設定](v10-dash-modify-settings.md)。 |
| **8. 時間選擇器下拉式清單** | 使用 選取相對時間範圍選項並設定自訂絕對時間範圍。 您可以按一下變更時間設定按鈕，從時間範圍控制項變更**時區**和**會計年度****設定**。 時間設定是以每個儀表板為基礎儲存。 |
| **9. 縮小時間範圍** | 使用 縮小時間範圍。如需如何使用時間範圍控制項的詳細資訊，請參閱 [設定儀表板時間範圍](#v10-dash-setting-dashboard-time-range)。 |
| **10. 重新整理儀表板** | 選取 可立即觸發查詢並重新整理儀表板資料。 |
| **11. 重新整理儀表板時間間隔** | 選取儀表板自動重新整理時間間隔。 |
| **12. 檢視模式** | 選取以在電視或資訊站等大型螢幕上顯示儀表板。檢視模式隱藏不相關的資訊，例如導覽功能表。 |
| **13. 儀表板面板** | 儀表板的主要建置區塊是面板。若要新增面板、儀表板列或程式庫面板，請選取**新增面板**。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/v10-dash-using-dashboards.html) |
| **14. 圖形圖例** | 直接從圖例變更系列顏色、y 軸和系列可見性。 |
| **15. 儀表板列** | 儀表板列是儀表板內的邏輯分隔器，可將面板分組在一起。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/v10-dash-using-dashboards.html) |
## 鍵盤快速鍵
Grafana 有許多可用的鍵盤快速鍵。若要顯示所有可用的鍵盤快速鍵，請按鍵盤上的 **？** 或 **h**。
+ `Ctrl+S` 會儲存目前的儀表板。
+ `f` 會開啟儀表板搜尋工具/搜尋。
+ `d+k` 切換資訊站模式 （隱藏選單）。
+ `d+e` 會展開所有資料列。
+ `d+s` 會開啟儀表板設定。
+ `Ctrl+K` 會開啟命令調色盤。
+ `Esc` 在全螢幕檢視或編輯模式下結束面板。也會從儀表板設定傳回儀表板。
**聚焦面板**
若要使用以特定面板為目標的捷徑，請將滑鼠游標暫留在面板上。
+ `e` 切換面板編輯檢視
+ `v` 切換面板全螢幕檢視
+ `ps` 開啟面板共用功能
+ `pd` 重複面板
+ `pr` 移除面板
+ `pl` 切換面板圖例
## 設定儀表板時間範圍
Grafana 提供多種方法來管理要視覺化的資料時間範圍，包括儀表板、面板和提醒。
本節說明支援的時間單位和相對範圍、常用時間控制、儀表板範圍的時間設定，以及面板特定的時間設定。
**時間單位和相對範圍**
Grafana 支援下列時間單位：`s (seconds)`、`m (minutes)`、`h (hours)`、`d (days)``w (weeks)`、`M (months)`、`Q (quarters)`、 和 `y (years)`。
減號運算子可讓您回到相對於目前日期和時間的時間，或 `now`。如果您想要顯示單位的完整期間 （天、週或月），請附加`/