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

# 連線至 Datadog 資料來源
<a name="AMG-datadog-datasource-plugin"></a>

 Datadog 資料來源可讓您從 Amazon Managed Grafana 中的 Datadog 監控服務視覺化指標。

**注意**  
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。  
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。

## Usage
<a name="datadog-usage"></a>

### 快取
<a name="datadog-caching"></a>

 對於大型儀表板，這使得許多查詢可能受到 Datadog API 限制 （達到 Datadog API 允許的每小時 API 呼叫數量上限）。快取功能會快取唯一的查詢 60 秒。在組態頁面上，此間隔可以變更為更長或更短。

### 查詢編輯器
<a name="datadog-query-editor"></a>

 很簡單 - 選取彙總和指標。如果您想要篩選結果，請選取一或多個標籤。

 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」欄位中使用`$<group_number>`變數。指標表達式 = `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 name="datadog-metric-arithmetic"></a>

 若要使用指標算術，請將*查詢類型*設為*算術*。使用`#`符號連結到您想要的指標。例如， `#A * 2`會將查詢 的結果加倍`A`。兩個指標之間的算術運作方式相同 - 新增要用於計算結果的查詢，然後在第三個查詢中連結至這些指標，例如 `#A / #B`。

### 註釋
<a name="datadog-annotations"></a>

 註釋是覆蓋在圖形上的事件 - 事件的範例是部署或中斷。使用此資料來源，您可以從 Datadog 擷取事件，並將其覆蓋在 Amazon Managed Grafana 中的圖形上。註釋事件可以依來源、標籤或優先順序篩選。

### 範本化
<a name="datadog-templating"></a>

 取得範本變數 - 指標和標籤的值有幾個選項。擷取`*`*查詢*欄位中指定的可用指標清單。

 若要傳回所有標籤，請使用 值： `tag`或 `scope`。

 若要傳回指定標籤群組的標籤，請使用下列其中一個預設類別值：
+  `host` 
+  `device` 
+  `env` 
+  `region` 
+  `site` 
+  `status` 
+  `version` 

 對於自訂標籤群組，只需輸入標籤群組名稱。例如， 如果您的自訂標籤群組名稱為 `subscription_name`，請在*查詢*欄位中輸入該名稱。

 使用 *Regex* 欄位篩選結果。使用標籤時支援多值變數 - 多個選取的標籤值將轉換為以逗號分隔的標籤清單。

#### 臨機操作篩選條件
<a name="datadog-ad-hoc-filters"></a>

 Grafana 中有一種新的特殊類型範本變數，稱為*臨機操作篩選條件*。此變數將套用至儀表板中的所有 ** Datadog 查詢。這允許將其用作快速篩選條件。Datadog 的臨機操作變數會從標籤擷取所有鍵值對，例如 `region:east, region:west`，並使用它們做為查詢標籤。若要建立此變數，請選取*臨機操作篩選條件*類型，然後選擇 Datadog 資料來源。您可以設定此變數的任何名稱。