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

連線至 ServiceNow 資料來源

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

功能

組態

選取 Grafana 左側面板上的資料來源。

選取新增資料來源：

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

輸入 ServiceNow URL：

選擇儲存並測試。您應該會看到綠色訊息，其中包含「ServiceNow Connection OK」。

範例儀表板

預先製作的儀表板包含在外掛程式中，可以透過儀表板索引標籤下的資料來源組態頁面匯入。

用量

有兩種方式可在查詢編輯器中傳回資料。

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

或者，從 開始v1.4.0，使用其他 （自訂資料表） 選項的 API 驅動資料表和欄位清單。此選項可讓您查詢使用者可用於設定 ServiceNow 資料來源之任何資料表中的資料。

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

TableAPI 查詢

TableAPI 會傳回適合在資料表面板中顯示的資料。它允許按順序選擇欄位，以顯示加上篩選選項。查詢編輯器也提供 欄位，以限制查詢傳回的資料列數。

顯示上一個查詢結果的範例資料表面板。

Show

顯示列為要顯示的欄位提供選擇器。您也可以指定多個欄位。欄位將以指定的確切順序傳回。

顯示值

顯示值旗標將導致查詢傳回人性化的值，或顯示小精靈，而不是數值。

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

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

篩選條件 （一般）

篩選條件列可讓您根據多個欄位和值條件縮小顯示的資料列範圍。

所有篩選條件都會與 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 填入欄位。

日期篩選條件

如需其他日期值，請參閱：https：//https://developer.servicenow.com/app.do#!/api_doc?v=newyork&id=r_SGSYS-dateGenerate_S_S

運算子 （一般、字串型）

運算子 （以時間為基礎）

值

值選擇取決於選取的篩選條件類型。

排序依據

排序依據資料列可根據多個欄位和值條件縮小顯示的資料列範圍。

所有篩選條件都會與 AND 操作結合。將新增對其他運算子的支援。

限制

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

時間欄位

Time Field 會將您查詢的資料轉換為時間序列。以時間序列處理的資料表示不會顯示所選「時間欄位」中不在儀表板/面板時間範圍內的值。

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

提供特殊值「忽略時間」，以允許結果「直到現在為止」，也允許篩選條件控制顯示的資料。

AggregateAPI 查詢 （統計資料）

AggregateAPI 一律會傳回具有下列彙總的指標：avg、min、max、 sum。篩選也可用於縮小查詢範圍。

Show

顯示列為要顯示的指標提供選擇器。您也可以指定多個指標。

篩選條件 （一般）

彙總篩選條件可根據欄位和值條件縮小顯示的指標範圍，類似於資料表選項。

所有篩選條件都會與 AND 操作結合。將新增對其他運算子的支援。

Stat 篩選條件選項與 TableAPI 相同。

聚合

指標彙總有四種類型，加上「計數」：

分組依據

此選擇器可讓您將指標分割為較少的彙總。依「優先順序」分組會傳回優先順序為「標籤」的指標，並將唯一值分開。

範本化

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

請參閱查詢變數區段中有關如何新增查詢變數並參考具有範本值的範例。

查詢變數

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

例如，您可以在範本變數查詢設定中categories指定這類查詢，以擁有包含 所有值的變數。

選擇查詢設定時，會顯示篩選條件區段，讓您選擇類型和欄位。目前，類型僅限於事件和變更。選取類型時，您會收到適用於該類型的欄位清單。選取類型和欄位後，底部會顯示值的預覽，顯示該類型/欄位可用的選項。這些值會顯示在儀表板的下拉式清單中，您可以搭配範本來篩選儀表板上的資料。

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

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

在查詢中使用變數

有兩種語法：

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

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

提醒

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

以下是查詢和提醒的範例。此查詢將傳回所有開放關鍵高優先順序事件的圖表：

當有超過五個開啟的重大高優先順序事件時，將會啟動此提醒：

測試提醒規則會顯示提醒規則的輸出，而選取狀態歷史記錄會顯示提醒從 ok 轉換為待定，再轉換為提醒。

圖形檢視會顯示垂直線，當警示處於待定狀態時，頂端的心形圖示會變成橘色。

一旦符合提醒條件，規則就會轉換為紅色。

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

撰寫警示的事件

Beta 功能

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

此動作需要 ServiceNow 資料來源使用者具有寫入事件的許可。

註釋

Grafana 註釋是截至此資料來源v1.4.0的 Beta 版功能。註釋可讓您在圖形上疊加事件。

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

常見問答集

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

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

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

選項 2：建立角色並將 ACLs 套用至 Grafana 必須存取的所有資料表。

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