翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Wavefront データソースに接続する (VMware Tanzu Observability by Wavefront)
<a name="wavefront-datasource-for-AMG"></a>

 Wavefront (VMware Tanzu Observability by Wavefront) データソースを使用すると、Amazon Managed Grafana ユーザーは、Wavefront から直接収集したデータをクエリおよび視覚化し、他のメトリクス、ログ、トレース、またはその他のデータソースとともに簡単に視覚化できます。この柔軟な単一ペインビューにより、システムのヘルス状態の追跡と問題のデバッグが容易になります。

**注記**  
このデータソースは、Grafana Enterprise 専用です。詳細については、「[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 を使用すると、ユーザーはこれらの系列で数学的操作の実行、異常を表示するためのグラフのレンダリング、KPI の追跡、アラートの作成が可能です。

## Wavefront と Grafana でテクノロジースタックを最大化する
<a name="maximizing-your-tech-stack-with-wavefront-and-AMG"></a>

 表面的には、Grafana と Wavefront は似ていますが、多くの組織は、オブザーバビリティワークフローの重要な部分として Wavefront と Grafana の両方を使用しています。

 **データソースを移動せずに視覚化する: ** Grafana の独自のアーキテクチャは、データを移動して冗長ストレージと取り込みに消費するのではなく、データが置かれている場所に直接クエリを実行します。

 **さまざまなソースからパネルを作成する** 事前に構築されたカスタムダッシュボードを使用すると、さまざまなデータソースのデータを 1 つのウィンドウにまとめることができます。

 **ユーザーレベルでの変換とコンピューティング**: ユーザーはデータを変換し、表示されるデータに対してさまざまな計算を実行できるため、データの準備が少なくて済みます。

 **パネル内で結合、コンピューティング、視覚化: **Prometheus や InfluxDB などの Waveferont やその他のソースからの関連データを表示する混合データソースパネルを作成します。

## ドキュメント
<a name="wavefront-documentation"></a>

### 機能
<a name="wavefront-features-3"></a>
+  時系列の視覚化 
+  テーブルの視覚化 
+  ヒートマップの視覚化 
+  単一統計の視覚化 
+  ガイド付きクエリエディタ 
+  生の WQL クエリエディタ 
+  イベントデータの注釈 
+  テンプレート変数 
+  アドホックフィルター 
+  [アラート] 

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

 Wavefront データソースの設定は比較的簡単です。設定を完了するために必要なフィールドは `API URL` と `Token` の 2 つだけです。
+  `API URL` は、wavefront 環境へのアクセスに使用する URL です。例えば、`https://myenvironment.wavefront.com` などです。
+  `Token` は、ユーザーアカウントまたはサービスアカウントから生成する必要があります。

  1.  ユーザーアカウントベースのトークンを作成するには、Wavefront 環境にログインし、ページの右上隅にある歯車を選択し、ユーザー名 (例: `me@grafana.com`) を選択し、ユーザーページの上部にある **[API アクセス]** タブを選択し、既存のキーをコピーするか、**[生成]** を選択します。

  1. サービスアカウントベースのトークンを作成するには、Wavefront 環境にログインし、ページの右上隅にある歯車を選択し、アカウント管理を選択します。左側のナビゲーションで、**[アカウント、グループ、ロール]** を選択し、上部の **[サービスアカウント]** タブを選択し、**[新しいアカウントの作成]** を選択します。サービスアカウントの名前を入力します。これは、任意のものになります。**トークン**セクションで提供されているトークンをコピーします。

  1. 最後のステップとして、**[アクセス許可]** で **[アカウント、グループ、ロール]**チェックボックスが選択されていることを確認してください。

 トークンを取得したら、`Token` 設定フィールドに追加します。これで準備完了です。

 確定された設定ページは次のようになります。

### 使用方法
<a name="wavefront-usage-6"></a>

#### クエリエディタの使用
<a name="wavefront-using-the-query-editor"></a>

 Wavefront クエリエディタには、**Query Builder** と **Raw Query** の 2 つのモードがあります。モードを切り替えるには、クエリフォームの右上にあるセレクタを使用します。

 **Query Builder** モードでは、次の 4 つの選択肢が表示されます。

1.  どのメトリクスに対してクエリを実行しますか?

1.  そのメトリクスに対してどのような集計を実行しますか?

1.  そのメトリクスクエリから結果をフィルタリングするにはどうすればよいですか?

1.  結果に追加の関数を適用しますか?

 メトリクスセレクタは分類された階層です。カテゴリを選択してから、もう一度選択してサブカテゴリにドリルダウンします。必要なメトリクスに達するまで、このプロセスを繰り返します。

 メトリクスを選択すると、使用可能なフィルターとフィルター値が自動的に入力されます。

 **Raw Query** モードでは、**[Query]** とラベル付けされた 1 つのフィールドが表示されます。これにより、任意の [WQL](#wavefront-references) クエリを実行できます。

#### フィルターの使用
<a name="wavefront-using-filters-1"></a>

 Wavefront プラグインは、各メトリクスに適したフィルターに対して動的にクエリを実行します。

 フィルターを追加するには、Wavefront クエリエディタの **[Filters]** ラベルの横にある **[\$1]** を選択し、フィルタリングするフィールドを選択し、フィルタリングする値を選択します。

#### 関数の使用
<a name="wavefront-using-functions"></a>

 関数は、メトリクスレスポンスデータを集計、操作、および計算実行するための追加の方法を提供します。使用可能な関数を表示するには、**Query Builder** の関数ラベルでドロップダウンリストを選択します。選択した関数に基づいて、フィールドによるグループの設定やしきい値の適用など、さらなるアクションを実行できます。ユーザーは複数の関数を連鎖させて、高度な計算やデータ操作を実行できます。

#### クエリテンプレート変数の追加
<a name="wavefront-adding-a-query-template-variable-1"></a>

1.  ダッシュボードの新しい Wavefront テンプレート変数を作成するには、ダッシュボードの右上にある設定 (歯車) を選択します。

1.  左側のパネルで、**[変数]** を選択します。

1.  変数ページの右上で、**[新規]** を選択します。

1.  作成するテンプレート変数の **[名前]** と **[Label]** を入力します。**[名前]** は、クエリ内でテンプレート変数を参照するために使用する値です。**ラベル** は、ダッシュボード選択パネルのテンプレート変数に表示するわかりやすい名前です。

1.  タイプフィールドの**クエリ**タイプを選択します (デフォルトで選択する必要があります)。

1.  **[Query Options]** の見出しにある**データソース**ドロップダウンリストで **[Wavefront]** を選択します。

1.  **クエリ** フィールドに入力する内容の詳細については、「[テンプレート変数クエリ構造](#template-variable-query-structure)」を参照してください。

1.  クエリから返された値をフィルタリングする場合は、**[Regex]** 入力フィールドに正規表現を入力します。

1.  **[ソート]** ドロップダウンリストでソートタイプを選択して、ソート設定を適用します。

1.  設定を確認したら、**[追加]** を選択してテンプレート変数を追加し、左側のナビゲーションパネルで **[ダッシュボードの保存]** を選択して変更を保存します。

#### テンプレート変数クエリ構造
<a name="template-variable-query-structure"></a>

 metric lists: metrics: ts(…) 

 source lists: sources: ts(…) 

 source tag lists: sourceTags: ts(…) 

 matching source tag lists: matchingSourceTags: ts(…) 

 tag name lists: tagNames: ts(…) 

 tag value lists: tagValues(<tag>): ts(…) 

 **Notes** (メモ) 
+  各クエリタイプの末尾にある「s」は任意です 
+  すべての小文字をサポートしています。tagnames または tagNames を使用できますが、TAGNAMES は使用できません。
+  : を囲むスペースの使用は任意です 

   **警告** 

   `Multi-value` および `Include All option` は現在、Wavefront プラグインではサポートされていません。

#### テンプレート変数の使用
<a name="wavefront-using-template-variables-2"></a>

 [新しいテンプレート変数を追加する](#wavefront-adding-a-query-template-variable-1)ステップの完了で、ダッシュボードパネル内のテンプレート変数を使用して動的視覚化を作成する準備が整いました。

1.  ダッシュボードの右上隅にある [panel\$1] アイコンを使用して、新しいダッシュボードパネルを追加します。

1.  クエリに使用する集計を選択します。

1.  **[Filters] **ラベルの横にある [\$1] アイコンを選択し、テンプレート変数に一致するキータイプを選択します。例えば、`host=` はホストフィルターに対応しています。

1.  フィルターの**値**入力フィールドに作成したテンプレート変数の名前を入力します。

1.  ダッシュボードを保存します。

 これで、テンプレート変数のさまざまな値を循環させ、パネルを動的に更新できるようになりました。

#### アドホックフィルターの使用
<a name="wavefront-using-ad-hoc-filters"></a>

 アドホックフィルターを使用するには、2 つのテンプレート変数を作成する必要があります。1 つ目は、メトリクスの選択に使用されるヘルパー変数です。そのメトリクス名にアドホックフィルターを入力できるようになります。もう 1 つは実際のアドホックフィルター変数です。

**重要**  
 必要なヘルパー変数には `metriclink` という名前を付ける必要があります。これは、使用するメトリクスのリストを含むカスタム変数でも、[テンプレート変数クエリ構造](#template-variable-query-structure)を使用したクエリベースの変数でもかまいません。アドホックフィルターフィールドに 1 つのメトリクスの値のみを入力する場合は、`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>

 このデータソースは、オプションパネルのフィールドタブにある [Display Name] (表示名) フィールドを使用して、名前、ラベル、または値に基づいて凡例キーを短縮または変更します。他のデータソースでは、カスタム`alias`機能を使用して凡例キーを変更しますが、Display Name 関数の方がより一貫性のある方法です。

### リファレンス
<a name="wavefront-references"></a>
+  [WQL (Wavefront クエリ言語)](https://docs.wavefront.com/query_language_reference.html)