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

# 連線至 OpenTSDB 資料來源
<a name="using-opentsdb-in-AMG"></a>

 Amazon Managed Grafana 隨附 OpenTSDB 的進階支援。

## 新增資料來源
<a name="opentsdb-adding-the-data-source"></a>

1.  選擇頂端標頭中的 Grafana 圖示，開啟側邊選單。

1.  在**儀表板**連結下的側邊選單中，您應該會找到**資料來源**連結。

1.  選擇頂端標頭中的 **\$1 新增資料來源**按鈕。

1.  從**類型**下拉式清單中選取 **OpenTSDB**。

**注意**  
 如果您在側邊選單中看不到**資料來源**連結，這表示您目前的使用者沒有 `Admin`角色。


|  名稱  |  描述  | 
| --- | --- | 
|  Name  |  資料來源名稱。這是您在面板和查詢中查看資料來源的方式。 | 
|  Default  |  預設資料來源表示新面板會預先選取該資料來源。 | 
|  Url  |  Opentsdb 伺服器的 HTTP 通訊協定、ip 和連接埠 （預設連接埠通常為 4242)。 | 
|  Access  |  伺服器 （預設） = URL 必須可從 Grafana 後端/伺服器存取。 | 
|  Version  |  版本 = opentsdb 版本，<=2.1 或 2.2。 | 
|  Resolution  |  Opentsdb 的指標可以具有秒或毫秒解析度的資料點。 | 

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

 選擇標題，以編輯模式開啟圖形。如果資料來源的版本 <=2.1 或 = 2.2，則查詢編輯器會有所不同。在舊版中，只有標籤可用於查詢 OpenTSDB。但在後者版本中，篩選條件以及標籤可用於查詢 opentsdb。填補政策也在 OpenTSDB 2.2 中推出。

**注意**  
 使用 OpenTSDB 2.2 資料來源時，請務必使用篩選條件或標籤，因為它們是互斥的。如果一起使用， 可能會為您提供奇怪的結果。

### 使用自動完成建議
<a name="auto-complete-suggestions"></a>

 一旦您開始輸入指標名稱、標籤名稱和標籤值 ，您應該會看到反白的自動完成建議。只有在 OpenTSDB 建議 API 已啟用時，自動完成才會運作。

## 範本查詢
<a name="opentsdb-templating-queries"></a>

 您可以在指標查詢中使用變數，而不是硬式編碼，例如伺服器、應用程式和感應器名稱。變數會顯示為儀表板頂端的下拉式清單選取方塊。您可以使用這些下拉式方塊來變更儀表板中顯示的資料。

 如需範本和範本變數的詳細資訊，請參閱 [範本和變數](templates-and-variables.md)。

### 查詢變數
<a name="opentsdb-query-variable"></a>

 OpenTSDB 資料來源支援範本變數查詢。這表示您可以建立範本變數，從 OpenTSDB 擷取值。例如，指標名稱、標籤名稱或標籤值。

 使用 OpenTSDB 搭配 `query`類型的範本變數時，您可以使用下列語法進行查詢。


|  Query  |  Description  | 
| --- | --- | 
|  metrics(prefix)  |  傳回具有特定字首的指標名稱 （可以是空的）。 | 
|  tag\$1names(cpu)  |  傳回特定 cpu 指標的標籤名稱 （即 索引鍵）。 | 
|  tag\$1values(cpu, hostname)  |  傳回指標 cpu 和標籤索引鍵主機名稱的標籤值。 | 
|  suggest\$1tagk(prefix)  |  傳回具有特定字首 （可以是空的） 之所有指標的標籤名稱 （即 索引鍵）。 | 
|  suggest\$1tagv(prefix)  |  傳回具有特定字首的所有指標的標籤值 （可以是空的）。 | 

 如果您沒有看到範本變數在`Preview of values`區段中填入，您必須在 OpenTSDB 伺服器設定`tsd.core.meta.enable_realtime_ts`中啟用 。此外，若要在 OpenTSDB 中填入現有時間序列資料的中繼資料，您必須在 `tsdb uid metasync` OpenTSDB 伺服器上執行 。

### 巢狀範本
<a name="nested-templating"></a>

 一個範本變數可用來篩選另一個範本變數的標籤值。第一個參數是指標名稱，第二個參數是您需要尋找標籤值的標籤索引鍵，之後所有其他相依範本變數。以下是一些範例，可讓巢狀範本查詢成功運作。


|  Query  |  Description  | 
| --- | --- | 
|  tag\$1values(cpu, hostname, env=\$1env)  |  傳回 cpu 指標的標籤值、選取的 env 標籤值和標籤索引鍵主機名稱。 | 
|  tag\$1values(cpu, hostname, env=\$1env, region=\$1region)  |  傳回 cpu 指標的標籤值、選取的 env 標籤值、選取的區域標籤值和標籤索引鍵主機名稱。 | 

 如需 OpenTSDB 指標查詢的詳細資訊，請參閱 [OpenTSDB 文件](https://opentsdb.net/docs/build/html/index.html)