本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Connect 至資 ServiceNow料來源

這是用來連線至 ServiceNow執行個體的 ServiceNow 資料來源。

功能

組態

在左側面板上選擇數據源 Grafana。

選取「新增資料來源」：

輸入servicenow以尋找資料來源外掛程式：

輸入 ServiceNow 網址：

選擇儲存並測試。您應該會看到一條綠色消息，其中包含「ServiceNow 連接正常」。

儀表板範例

外掛程式隨附預先製作的儀表板，可透過資料來源組態頁面的 [儀表板] 索引標籤下方匯入。

用量

有兩種方法可以在查詢編輯器中返回數據。

使用者目前可以選擇查詢預先定義的資料表，例如：

或者，截至目前為止v1.4.0，使用「其他 (自訂表格)」選項的表格和欄位的 API 驅動清單。此選項可讓您查詢用來設定資料來源之使用者可用之任何表格中的 ServiceNow 資料。

「自訂表格」選項應支援與預先定義的表格清單相同的所有功能。

表格 API 查詢

表格 API 會傳回適合在表格面板中顯示的資料。它允許有序的字段選擇顯示加上過濾選項。查詢編輯器還提供了一個字段來限制查詢返回的行數。

範例表格面板會顯示先前查詢的結果。

Show

「顯示」列提供了要顯示之欄位的選取器。您也可以指定多個欄位。這些字段將按照指定的確切順序返回。

顯示值

「顯示值」旗標將導致查詢傳回人性化的值，或顯示 Vault，而不是數值。

例如，1沒有此旗標的嚴重性只會顯示1。如果標誌已啟用，則顯示的值將為1 - High。

根據 ServiceNow API 文檔，這可能會對性能產生負面影響。

過濾器（一般）

「過濾器」行可根據多個字段和值條件來縮小顯示的行的范圍。

所有篩選器都會與 AND 或 OR 作業結合使用。

未使用自訂表格時，可使用下列欄位 (此清單將在 future 展開)。

Active
Asset
Group
Assigned To
Escalation
Issue Number
Description
Priority
State
Type
Change Risk
Change State
Start Date
End Date
On Hold

選取自訂表格時，系統會自動從「立即服務 API」填入欄位。

日期篩選條件

如需其他日期值，請參閱：https://developer.servicenow.com/app.do #！ /阿皮文件？ V = 紐約與 ID = R_SGS-日期產生器 _ 秒

運算子 (一般、以字串為基礎)

運算子 (以時間為基礎)

值

值選取取決於所選篩選的類型。

排序方式

「排序依據」列提供了根據多個欄位和值條件縮小顯示列的範圍。

所有篩選器都會與 AND 作業結合使用。將增加對其他運算子的 Support 援。

限制

您可以指定資料列限制，以防止傳回過多的資料。預設值為 25。

時間欄位

Time Field這就是將您查詢的數據轉換為時間序列的原因。您的數據作為時間序列處理意味著不在儀表板/面板時間範圍內的所選「時間字段」中的值將不會顯示。

使用的預設時間欄位為「開啟時間」，但可以變更為任何保留時間值的可用欄位。

提供了一個特殊值「忽略時間」，以允許結果「到目前為止」，並允許過濾器控制顯示的數據。

彙總 API 查詢 (統計資料)

聚合 API 將始終返回指標，其中包含以下聚合：平均，最小值，最大值，總和。篩選也可用於縮小查詢範圍。

Show

「顯示」資料列提供要顯示之測量結果的選取器。您也可以指定多個量度。

過濾器（一般）

彙總篩選器可根據欄位和值條件 (類似於表格選項) 來縮小顯示量度的範圍。

所有篩選器都會與 AND 作業結合使用。將增加對其他運算子的 Support 援。

統計信息過濾器選項與表格 API 相同。

聚合

有四種類型的量度彙總，加上一個「計數」：

分組依據

此選取器提供將量度分割為較少彙總的功能。依「優先順序」分組會傳回具有優先順序「標籤」且分隔唯一值的量度。

模板

您可以在查詢中使用變量，而不是在查詢中對名稱進行硬編碼。變數會顯示為儀表板頂端的下拉式選取方塊。您可以使用這些下拉式方塊來變更顯示在儀表板上的資料。

請參閱「查詢變數」一節中的範例，瞭解如何新增查詢變數，並使用「範本」值參考該變數。

查詢變數

如果您新增類型的範本變數Query，您可以撰寫查詢，以傳回顯示為下拉式選取方塊的項目，例如類別名稱、索引鍵名稱或索引鍵值。

例如，您可以在範本變數「查詢」設定中指定查詢 (如此)，categories來擁有一個包含所有值的變數。

選擇「查詢」設定時，會顯示「篩選」區段，讓您選擇「類型」和「欄位」。目前，「類型」僅限於「事件」和「變更」。選取類型時，系統會提供適用於該「類型」的欄位清單。選取「類型」和「欄位」 後，會在底部顯示值預覽，顯示該類型/欄位的可用選項。這些值將顯示在「管控面板」上的下拉式清單中，您可以將其與「範本」一起使用，以篩選管控面板上的資料。

例如，如果您新增名為類別的變數，然後選取「類型 = 事件」且「欄位 = 類別」，您會看到「類別」的選項清單。如果您接著將篩選器新增至面板，並選取「類別等於 $ {類別}」，面板資料將僅顯示從「儀表板」下拉式清單中選取的該類別的資料。

匯入「依類別的事件」儀表板以查看範例。

在查詢中使用變數

有兩種語法：

$<varname>範例的範本變數名稱為hostname：

[[varname]]範例的範本變數名稱為hostname：

提醒

支援標準 Grafana 警示。在圖形面板中定義的任何查詢都可以用來產生警示。

以下是查詢範例和警示。此查詢會傳回所有開啟的嚴重高優先順序事件的圖表：

當發生五個以上的嚴重高優先順序事件時，就會啟動此警示：

測試警示規則會顯示警示規則的輸出，而選取狀態歷史記錄會顯示警示從確定轉換為待處理到警示。

圖形視圖將顯示一條垂直線，頂部的心形圖標將在警報等待中變為橙色。

一旦符合警示的準則，規則就會轉換為紅色。

在圖形視圖中，將出現紅色垂直線，頂部的心形圖標將變為紅色。

撰寫警示的事件

測試版功能

這會設定 Grafana 通知通道，該通道會使用您設定的使用者在此資料來源的 ServiceNow 執行個體上建立事件。

此動作要求資 ServiceNow 料來源使用者具有寫入事件的權限。

使用 HTTP 代理

使用 HTTP 代理伺服器時，Amazon 受管的 Grafana 需要將下列環境變數設定為代理伺服器的位置：

註釋

圖形註釋是一個測試功能作為此數據源v1.4.0的。註釋使您能夠在圖形上覆蓋事件。

註釋查詢支援與標準查詢編輯器相同的選項，但有一些細微差異：

常見問答集

如果我們沒有 ITSM 角色外掛程式怎麼辦？

需要管理員存取權才能執行下列動作

選項 1：授予 Grafana 使用者管理員權限，以允許存取所有資料表。

選項 2：建立角色並將 ACL 套用至必須由 Grafana 存取的所有表格。

需要管理員存取權才能執行下列動作。