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

# 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.  **[タイプ]** ドロップダウンリストから **[OpenTSDB]** を選択します。

**注記**  
 サイドメニューに **[データソース]** リンクが表示されていない場合は、現在のユーザーに `Admin` ロールが付与されていないことを意味します。


|  名前  |  説明  | 
| --- | --- | 
|  Name  |  データソース名。これは、パネルとクエリ内へのデータソースの表示のされ方です。 | 
|  Default  |  デフォルトのデータソースは、新しいパネル用に事前に選択されたデータソースです。 | 
|  Url  |  opentsdb サーバーの HTTP プロトコル、ip、ポート (デフォルトポートは通常 4242)。 | 
|  Access  |  サーバー (デフォルト) = URL は Grafana バックエンド/サーバーからアクセス可能である必要があります。 | 
|  Version  |  バージョン = opentsdb バージョン、2.1 以前 または 2.2。 | 
|  Resolution  |  opentsdb からのメトリクスには、2 秒またはミリ秒の解像度のデータポイントを含めることができます。 | 

## クエリエディタ
<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 から値を取得するテンプレート変数を作成できます。例えば、メトリクス名、タグ名、タグ値などを取得できます。

 `query` タイプのテンプレート変数で OpenTSDB を使用する場合、次の構文を使用して検索できます。


|  クエリ  |  説明  | 
| --- | --- | 
|  metrics(prefix)  |  特定のプレフィックスを持つメトリクス名を返します (空になる場合もあります）。 | 
|  tag\_names(cpu)  |  特定の cpu メトリクスのタグ名 (キー) を返します。 | 
|  tag\_values(cpu, hostname)  |  メトリクス cpu とタグキーホスト名のタグ値を返します。 | 
|  suggest\_tagk(prefix)  |  特定のプレフィックスを持つすべてのメトリクスのタグ名 (キー) を返します (空になる場合もあります）。 | 
|  suggest\_tagv(prefix)  |  特定のプレフィックスを持つすべてのメトリクスのタグ値を返します (空になる場合もあります）。 | 

 `Preview of values` セクションにテンプレート変数が入力されていない場合は、OpenTSDB サーバー設定で `tsd.core.meta.enable_realtime_ts` を有効にする必要があります。また、OpenTSDB の既存の時系列データのメタデータを入力するには、OpenTSDB サーバーで `tsdb uid metasync` を実行する必要があります。

### テンプレートのネスト
<a name="nested-templating"></a>

 1 つのテンプレート変数を使用して、別のテンプレート変数のタグ値をフィルタリングできます。1 番目のパラメータはメトリクス名、2 番目のパラメータはタグ値を見つける必要があるタグキー、その後は他のすべての依存テンプレート変数です。ネストされたテンプレートクエリが正常に機能することを示すため、いくつかの例を以下に挙げます。


|  クエリ  |  説明  | 
| --- | --- | 
|  tag\_values(cpu, hostname, env=$env)  |  cpu メトリクスのタグ値、選択した env タグ値、およびタグキーホスト名を返します。 | 
|  tag\_values(cpu, hostname, env=$env, region=$region)  |  cpu メトリクス、選択した env タグ値、選択したリージョンタグ値、およびタグキーホスト名のタグ値を返します。 | 

 OpenTSDB メトリクスクエリの詳細については、「[OpenTSDB ドキュメント](https://opentsdb.net/docs/build/html/index.html)」を参照してください。