本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 連線至企業資料來源 已升級至 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)