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

# 連線至 Dynatrace 資料來源
<a name="dynatrace-AMG-datasource"></a>

[https://www.dynatrace.com/](https://www.dynatrace.com) 的資料來源。若要使用此資料來源，您必須擁有 Dynatrace 帳戶。

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

**已知限制**

範本變數不能為多選。只支援單一選擇。

僅支援 v2 指標 APIs。

## 功能
<a name="features"></a>

### 核心功能
<a name="core-features"></a>
+  範本變數 
  +  指標名稱 
  +  僅限單一選取 (**無多選取**) 
  +  臨時篩選條件 
+  註釋 
  +  目前不支援 
+  別名 
  +  指標名稱 
  +  聚合 
  +  顯示名稱 
  +  主機 
  +  Description 
+  提醒 
  +  完整提醒支援 

### Dynatrace 特定功能
<a name="dynatrace-specific-features"></a>

 支援使用 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 許可
<a name="dynatrace-permissions"></a>

 在 Dynatrace - 使用 API V2 讀取指標 (metrics.read) 許可 - 使用 API V2 讀取實體 (entities.read) 許可中，您將需要下列許可 

## 從 Dynatrace 取得 API 金鑰
<a name="dynatrace-apikey"></a>

若要設定 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
<a name="configuration"></a>

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.  設定所有組態值之後，請選擇**儲存與測試**以驗證組態並儲存變更。

### 查詢資料來源
<a name="dynatrace-usage"></a>

使用查詢編輯器來查詢 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`— 如果設定，請將相關事件包含在回應中。

#### 使用範本變數
<a name="using-template-variables"></a>

 若要新增新的 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 的儀表板
<a name="dynatrace-import"></a>

若要匯入儀表板，請參閱 [匯入儀表板](dashboard-export-and-import.md#importing-a-dashboard)。您可以在**組態** > **資料來源** > 選取您的 Dynatrace 資料來源 > 選取**儀表板**索引標籤以查看可用的預先製作儀表板中找到匯入的儀表板。