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

# 連線至 Wavefront 資料來源 (Wavefront 的 VMware Tanzu 可觀測性）
<a name="wavefront-datasource-for-AMG"></a>

 Wavefront (Wavefront 的 VMware Tanzu 可觀測性） 資料來源可讓 Amazon Managed Grafana 使用者直接從 Wavefront 查詢和視覺化他們收集的資料，並輕鬆地將其與任何其他指標、日誌、追蹤或其他資料來源一起視覺化。這種靈活的單一窗格檢視可讓您更輕鬆地追蹤系統運作狀態和偵錯問題。

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

## 什麼是 Wavefront？
<a name="what-is-wavefront"></a>

 [Wavefront](https://www.wavefront.com) 是由 VMware 開發的雲端監控和分析工具。Wavefront 是一種雲端託管服務，可讓您從 CollectD、StatsD、JMX、Ruby 的 記錄器 AWS或其他工具傳送時間序列 （指標） 資料。使用 Wavefront，使用者可以在這些序列上執行數學操作、轉譯圖表以查看異常、追蹤 KPIs和建立提醒。

## 使用 Wavefront 和 Grafana 最大化您的技術堆疊
<a name="maximizing-your-tech-stack-with-wavefront-and-AMG"></a>

 在表面上，Grafana 和 Wavefront 聽起來相似，許多組織使用 Wavefront 和 Grafana 作為其可觀測性工作流程的關鍵部分。

 **視覺化而不移動資料來源：**Grafana 的唯一架構會直接查詢資料，而不是移動資料並支付備援儲存和擷取的費用。

 **從不同來源編寫面板** 使用預先建置的自訂儀表板，將來自許多不同資料來源的資料整合到單一玻璃窗格中。

 **在使用者層級轉換和運算：**使用者可以轉換資料，並對其看到的資料執行各種運算，從而減少資料準備。

 **在面板中結合、運算和視覺化：**建立混合資料來源面板，以顯示來自 Waveferont 和其他來源的相關資料，例如 Prometheus 和 InfluxDB。

## 文件
<a name="wavefront-documentation"></a>

### 功能
<a name="wavefront-features-3"></a>
+  Timeseries 視覺化 
+  資料表視覺化 
+  熱度圖視覺化 
+  單一統計資料視覺化 
+  引導式查詢編輯器 
+  原始 WQL 查詢編輯器 
+  事件資料的註釋 
+  範本變數 
+  臨時篩選條件 
+  提醒 

### Configuration
<a name="wavefront-configuration-4"></a>

 設定 Wavefront 資料來源相對簡單。完成組態只需要兩個欄位： `API URL`和 `Token`。
+  `API URL` 將是您用來存取 wavefront 環境的 URL。範例：`https://myenvironment.wavefront.com`。
+  `Token` 必須從使用者帳戶或服務帳戶產生。

  1.  若要建立以使用者帳戶為基礎的權杖，請登入 Wavefront 環境，選擇頁面右上角的齒輪，選擇您的使用者名稱 （例如，`me@grafana.com`)，選取使用者頁面頂端的 **API 存取**索引標籤，然後複製現有的金鑰或選擇**產生**。

  1. 若要建立服務帳戶型權杖，請登入 Wavefront 環境，選擇頁面右上角的齒輪，選擇帳戶管理。在左側導覽上，選取**帳戶、群組和角色**，選擇頂端**的服務帳戶**索引標籤，然後選擇**建立新帳戶**。輸入服務帳戶的名稱。這可以是您想要的任何項目。複製字符區段下提供的**字符**。

  1. 最後一個步驟是確保在**許可**下選取的**帳戶、群組和角色**核取方塊。

 擁有權杖之後，請將權杖新增至`Token`組態欄位，即可設定！

 完成的組態頁面看起來應該類似：

### Usage
<a name="wavefront-usage-6"></a>

#### 使用查詢編輯器
<a name="wavefront-using-the-query-editor"></a>

 Wavefront 查詢編輯器有兩種模式：**查詢建置器**和**原始查詢**。若要在它們之間切換，請使用查詢表單右上角的選取器：

 在**查詢建置器**模式中，您會看到四個選項：

1.  您想要查詢什麼指標？ 

1.  您想要在該指標上執行什麼彙總？ 

1.  您要如何篩選該指標查詢的結果？ 

1.  是否要將任何其他函數套用至結果？ 

 指標選擇器是分類階層。選取類別，然後再次選擇以深入了解子類別。重複此程序，直到您達到所需的指標為止。

 選取指標後，系統會自動為您填入可用的篩選條件和篩選條件值。

 在**原始查詢**模式中，您會看到一個標示為**查詢**的欄位。這可讓您執行任何您想要的 [WQL](#wavefront-references) 查詢。

#### 使用篩選條件
<a name="wavefront-using-filters-1"></a>

 Wavefront 外掛程式會動態查詢每個指標的適當篩選條件。

 若要新增篩選條件，請選擇 Wavefront 查詢編輯器上**篩選條件**標籤旁的 **\$1**，選取要篩選的欄位，然後選取要篩選的值。

#### 使用 函數
<a name="wavefront-using-functions"></a>

 函數提供一種額外的方法來彙總、操作和對指標回應資料執行計算。若要檢視可用的函數，請在**查詢建置器**上依函數標籤選擇下拉式清單。根據您選取的函數，您將能夠執行進一步的動作，例如依欄位設定群組或套用閾值。使用者可以將多個函數鏈結在一起，以執行進階計算或資料處理。

#### 新增查詢範本變數
<a name="wavefront-adding-a-query-template-variable-1"></a>

1.  若要為儀表板建立新的 Wavefront 範本變數，請選擇儀表板右上角的設定齒輪。

1.  在左側面板中，選擇**變數**。

1.  在變數頁面的右上角，選擇**新增**。

1.  輸入您要建立之範本變數**的名稱**和**標籤**。**名稱**是您將在查詢內用來參考範本變數的值。**Label** 是人類易記的名稱，可在儀表板選取面板上顯示範本變數。

1.  選取類型 **查詢**類型欄位 （預設應選取）。

1.  在**查詢選項**標題下，選取**資料來源**下拉式清單中的 **Wavefront**。

1.  如需在[查詢欄位中輸入內容的詳細資訊，請參閱範本變數查詢結構](#template-variable-query-structure)。 ****

1.  如果您想要篩選掉查詢傳回的任何值，請在 **Regex** 輸入欄位中輸入規則表達式。

1.  在排序下拉式清單中選擇排序類型，以套用您可能有的任何**排序**偏好設定。

1.  驗證組態後，選擇**新增**以新增範本變數，然後選擇左側導覽面板上的**儲存儀表板**以儲存變更。

#### 範本變數查詢結構
<a name="template-variable-query-structure"></a>

 指標清單：指標：ts(...) 

 來源清單：來源：ts(...) 

 來源標籤清單：sourceTags： ts(...) 

 比對來源標籤清單：matchingSourceTags：ts(...) 

 標籤名稱清單：tagNames： ts(...) 

 標籤值清單：tagValues(<tag>)：ts(...) 

 **備註** 
+  每個查詢類型結尾的 是選用的 
+  支援所有小寫。您可以使用 tagname 或 tagNames，但不能使用 TAGNAMES。
+  在 周圍使用空格：是選用的 

   **WARNING** 

   `Multi-value` Wavefront 外掛程式`Include All option`目前不支援 和 。

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

 完成[新增範本變數](#wavefront-adding-a-query-template-variable-1)的步驟後，您現在可以在儀表板面板中使用範本變數來建立動態視覺化。

1.  使用儀表板右上角的 panel\$1 圖示新增儀表板面板。

1.  選取您要用於查詢的彙總。

1.  選擇**篩選條件**標籤旁的 \$1 圖示，然後選取符合您範本變數的金鑰類型。例如，`host=`主機篩選條件的 。

1.  輸入您在篩選條件的值****輸入欄位中建立的範本變數名稱。

1.  儲存儀表板。

 您現在應該可以循環查看範本變數的不同值，並讓您的面板動態更新！

#### 使用 Ad-Hoc 篩選條件
<a name="wavefront-using-ad-hoc-filters"></a>

 若要使用臨機操作篩選條件，我們必須建立兩個範本變數。第一個是輔助變數，將用於選取指標，以便為該指標名稱填入附加型篩選條件。另一個是實際的臨機操作篩選條件變數。

**重要**  
 所需的協助程式變數必須命名為 `metriclink`。這可以是自訂變數，其中包含您要使用的指標清單，或使用[範本變數查詢結構的查詢型變數](#template-variable-query-structure)。如果您想要僅將單一指標中的值填入臨機操作篩選條件欄位，您可以隱藏`metriclink`範本變數。

 建立`metriclink`變數之後，您現在可以依照新增[查詢範本變數中詳述的相同步驟來新增](#wavefront-adding-a-query-template-variable-1)臨機操作篩選條件。差別在於您將選取**臨時篩選條件**做為**類型**，且查詢不需要輸入。

#### 新增註釋
<a name="wavefront-adding-annotations"></a>

1.  若要為儀表板建立新的 Wavefront 註釋，請選擇儀表板右上角的設定齒輪。

1.  在左側面板中，選擇**註釋**。

1.  在註釋頁面的右上角，選擇**新增**。

1.  輸入註釋的名稱 （這將用作儀表板上的切換名稱）。

1.  選取 Wavefront 的**資料來源**。

1.  根據預設，註釋最多有 100 個將傳回的提醒事件。若要變更，請將**限制**欄位設定為您想要的值。

1.  選擇**新增**。

#### 使用註釋
<a name="using-annotations"></a>

 開啟註釋時，您現在應該會看到與指定時段相關的提醒事件和問題。

 如果您在視覺化的註釋區段底部暫停，則會顯示快顯視窗，顯示提醒名稱並提供 Wavefront 中提醒的直接連結。

#### 使用顯示名稱欄位
<a name="wavefront-using-display-name-1"></a>

 此資料來源使用選項面板欄位索引標籤中的顯示名稱欄位，根據其名稱、標籤或值來縮短或修改圖例金鑰。其他資料來源使用自訂`alias`功能來修改圖例金鑰，但顯示名稱函數是更一致的方法。

### 參考
<a name="wavefront-references"></a>
+  [WQL (Wavefront 查詢語言）](https://docs.wavefront.com/query_language_reference.html)