OpenTSDB データソースに接続する - Amazon Managed Grafana
データソースの追加クエリエディタクエリのテンプレート化

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

OpenTSDB データソースに接続する

Amazon Managed Grafana には、OpenTSDB の高度なサポートが付属しています。

データソースの追加

  1. 上部のヘッダーにある Grafana アイコンを選択して、サイドメニューを開きます。

  2. Dashboards リンクのサイドメニューには、データソースリンクがあります。

  3. 上部のヘッダーで + データソースの追加ボタンを選択します。

  4. タイプドロップダウンリストから OpenTSDB を選択します。

注記

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

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

クエリエディタ

タイトルを選択して、編集モードでグラフを開きます。データソースのバージョンが <=2.1 または = 2.2 の場合、クエリエディタは異なります。以前のバージョンでは、OpenTSDB のクエリに使用できるのはタグのみです。ただし、後者のバージョンでは、フィルターとタグを使用して opentsdb をクエリできます。フィルポリシーは OpenTSDB 2.2 でも導入されています。

注記

OpenTSDB 2.2 データソースを使用するときは、フィルターまたはタグのいずれかを使用してください。これらは相互に排他的です。一緒に使用すると、異常な結果が得られる可能性があります。

オートコンプリート提案の使用

メトリクス名、タグ名、タグ値 の入力を開始するとすぐに、自動完了候補が強調表示されます。オートコンプリートは、OpenTSDB サジェスト API が有効になっている場合にのみ機能します。

クエリのテンプレート化

メトリクスクエリでサーバー、アプリケーション、センサー名などのモノをハードコーディングする代わりに、代わりに変数を使用できます。変数は、ダッシュボードの上部にドロップダウン選択ボックスとして表示されます。これらのドロップダウンボックスを使用して、ダッシュボードに表示されるデータを変更できます。

テンプレート変数とテンプレート変数の詳細については、「」を参照してくださいテンプレートと変数。

クエリ変数

OpenTSDB データソースは、テンプレート変数クエリをサポートしています。つまり、OpenTSDB から値を取得するテンプレート変数を作成できます。例えば、メトリクス名、タグ名、タグ値などです。

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

Query 説明
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で を実行する必要があります。

ネストされたテンプレート

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

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

OpenTSDB メトリクスクエリの詳細については、「OpenTSDB ドキュメント」を参照してください。