Tablestore を Grafana に接続する方法 - Tablestore - Alibaba Cloud ドキュメントセンター

Tablestore を Grafana に接続すると、Grafana を使用して Tablestore のデータを可視化できます。

前提条件

Resource Access Management (RAM) ユーザーを作成し、RAM ユーザーに AliyunOTSFullAccess 権限を付与して Tablestore を管理できるようにしておきます。

警告
Alibaba Cloud アカウントのアクセスキーペアが漏洩すると、クラウドリソースが危険にさらされます。このリスクを軽減するために、代わりに RAM ユーザーのアクセスキーペアを使用してください。
Tablestore サービスを有効化し、インスタンスを作成しておきます。その後、データテーブルとそのマッピングを作成するか、時系列テーブルとその多元値モデルマッピングを作成できます。
オープンソースの Grafana バージョン 8.0.0 以降をインストールしておきます。このガイドでは、[Grafana v12.3.1] を例に説明します。Grafana のインストールに関する詳細については、「Grafana 公式ドキュメント」をご参照ください。

背景情報

Grafana は、Prometheus、Graphite、OpenTSDB、InfluxDB、Elasticsearch、MySQL、PostgreSQL などの複数のデータソースからのデータのクエリと可視化に対応した、オープンソースの可視化および分析プラットフォームです。詳細については、「Grafana 公式ドキュメント」をご参照ください。

Tablestore を Grafana に接続した後、Tablestore のテーブルデータに基づいてダッシュボードパネルを生成し、データをリアルタイムで表示できます。

使用上の注意

Grafana の可視化機能を利用できるリージョンは、使用するデータモデルによって異なります。

ワイドテーブルモデル：すべてのリージョンをサポートします。
時系列モデル：中国 (杭州)、中国 (上海)、中国 (北京)、中国 (張家口)、中国 (ウランチャブ)、中国 (深圳)、中国 (成都)、中国 (香港)、日本 (東京)、シンガポール、マレーシア (クアラルンプール)、インドネシア (ジャカルタ)、ドイツ (フランクフルト)、英国 (ロンドン)、米国 (シリコンバレー)、米国 (バージニア)、および SAU (リヤド - パートナーリージョン) をサポートしています。

ステップ 1：Tablestore プラグインのインストール

Windows

Tablestore Grafana プラグインパッケージをダウンロードします。
Tablestore Grafana プラグインパッケージを解凍し、その内容を Grafana のインストール先の data/plugins ディレクトリに移動します。
Grafana の設定ファイルを変更します。
1. テキストエディターで、Grafana の conf ディレクトリにある defaults.ini 設定ファイルを開きます。
2. 設定ファイルの [plugins] セクションで、allow_loading_unsigned_plugins パラメーターを設定します。
```
allow_loading_unsigned_plugins = 'aliyun-tablestore-grafana-datasource-adapt-react'
```
タスクマネージャーで grafana-server.exe プロセスを再起動します。

Mac/Linux

次のコマンドを実行して、Tablestore Grafana プラグインパッケージをダウンロードします。

wget https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260203/qbqmxg/aliyun-tablestore-grafana-datasource-adapt-react.zip

Tablestore Grafana プラグインパッケージを Grafana プラグインディレクトリに解凍します。
Grafana のインストール方法に対応するコマンドを実行します。
- Yellowdog Updater, Modified (YUM) リポジトリまたは RPM Package Manager (RPM) パッケージから Grafana をインストールした場合 (Linux のみ) ： unzip aliyun-tablestore-grafana-datasource-adapt-react.zip -d /var/lib/grafana/plugins
- .zip ファイルから Grafana をインストールした場合： unzip aliyun-tablestore-grafana-datasource-adapt-react.zip -d {PATH_TO}/grafana-{VERSION}/data/plugins
  
  説明
  コマンドの {PATH_TO}/grafana-{VERSION} は Grafana のインストールパス、{VERSION} は Grafana のバージョン番号です。
Grafana の設定ファイルを変更します。
1. ディレクトリに移動し、設定ファイルを開きます。
  - YUM リポジトリまたは RPM パッケージから Grafana をインストールした場合 (Linux のみ) ： /etc/grafana/grafana.ini
  - .zip ファイルから Grafana をインストールした場合： {PATH_TO}/grafana-{VERSION}/conf/defaults.ini
    
    説明
    パスの {PATH_TO}/grafana-{VERSION} は Grafana のインストールパス、{VERSION} は Grafana のバージョン番号です。
2. 設定ファイルの [plugins] セクションで、allow_loading_unsigned_plugins パラメーターを設定します。
```
allow_loading_unsigned_plugins = 'aliyun-tablestore-grafana-datasource-adapt-react'
```
Grafana を再起動します。
1. kill コマンドを実行して Grafana プロセスを停止します。
2. インストール方法に対応するコマンドを実行して Grafana を起動します。
  - YUM リポジトリまたは RPM パッケージから Grafana をインストールした場合 (Linux のみ) ： systemctl restart grafana-server
  - .zip ファイルから Grafana をインストールした場合： ./bin/grafana-server web

ステップ 2：データソースの設定

Grafana にログインします。
1. ブラウザで http://:3000/ を入力して Grafana のログインページを開きます。
  
  説明
  <x.x.x.x> は Grafana がインストールされているサーバーの IP アドレスです。たとえば、Grafana が Windows にインストールされている場合、ログインアドレスは http://localhost:3000 です。
2. [Email or username] と [Password] を入力し、[Log in] をクリックします。
  
  説明
  デフォルトのユーザー名とパスワードはどちらも admin です。初めてログインすると、パスワードの変更を求められます。
Grafana の左側メニューで、[Connections] > [Data sources] を選択します。
[Data sources] ページで、[+ Add new data source] をクリックします。
[Add data source] ページの [Others] セクションで、[aliyun-tablestore-grafana-datasource] をクリックします。

[Settings] タブで、次の表の説明に従ってパラメーターを設定します。

パラメーター	例	説明
Name	aliyun-tablestore-grafana-datasource	データソースの名前。必要に応じてカスタム名を入力します。デフォルト値は `aliyun-tablestore-grafana-datasource` です。
Default		Tablestore データソースをデフォルトのデータソースとして設定するかどうかを指定します。
Endpoint	https://myinstance.cn-hangzhou.ots.aliyuncs.com	アクセスする Tablestore インスタンスのエンドポイントを入力します。
Instance	myinstance	Tablestore インスタンスの名前。
AccessId	************************	Tablestore へのアクセス権限を持つ Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey ID。
AccessKey	********************************	Tablestore へのアクセス権限を持つ Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey シークレット。

[Save & test] をクリックします。

接続に成功すると、画面に [Data source is working] というメッセージが表示されます。

ステップ 3：ダッシュボードパネルの作成

Grafana の左側メニューで、[Dashboards] をクリックします。
[Dashboards] ページで [New] をクリックし、[New dashboard] を選択します。
[New dashboard] ページで、[+ Add visualization] をクリックします。
[Select data source] ダイアログボックスで、設定した Tablestore データソースを選択します。

[Edit panel] ページの [Queries] タブで、クエリ条件を設定します。

パラメーターは次の表のとおりです。

パラメーター	例	説明
Query	`SELECT * FROM your_table WHERE $__unixMicroTimeRangeFilter(_time)AND _m_name = "your_measurement" AND tag_value_at(_tags, "your_tag")="your_tag_value" LIMIT 1000`	SQL クエリステートメント。詳細については、「データのクエリ」をご参照ください。重要 WHERE 句では、例の `$__unixMicroTimeRangeFilter` のように、事前定義マクロを使用して時間範囲でデータをフィルタリングする必要があります。その他の時間マクロを表示するには、設定ページで [Show Help] をクリックします。データを時系列チャートで表示する場合は、クエリで数値タイムスタンプで表される時間列を返す必要があります。また、時間列の名前も設定する必要があります。
Format As	Timeseries	結果のフォーマット。有効な値： Timeseries (デフォルト) ：標準の時系列チャート。 FlowGraph：多次元チャート。 Table：標準テーブル。説明 SQL を使用してワイドテーブルモデルからクエリを実行する際にテーブルデータに時間列がない場合は、[Switch to table] をクリックしてクエリ結果をテーブル形式で表示するか、[Open visualization suggestions] をクリックして追加の推奨される可視化オプションを表示して選択できます。
Time Column	_time	返されたデータの時間列の名前。時間列は、時系列チャートの X 軸として使用されます。このパラメーターは、Format As を [Timeseries] または [FlowGraph] に設定した場合に設定できます。
Aggregation Column	_field_name#:#_double_value	同じ時点の複数行の単一列データを、単一行の複数列データに変換します。このパラメーターは、単一値モデルのデータを多元値モデルのデータに変換するために使用されます。単一値モデルのデータは、SQL を使用して Tablestore の時系列テーブルをクエリするときに取得される結果です。このパラメーターは、Format As を [FlowGraph] に設定した場合に設定できます。フォーマットは `<Data point name column>#:#<Value column>` です。

[Run SQL] をクリックして SQL ステートメントを実行し、結果を表示またはデバッグします。
ダッシュボードパネルを設定して保存します。
1. 右側のペインで、監視チャートの名前、タイプ、表示スタイルを指定します。
2. 右上隅にある [Save dashboard] をクリックします。[Save dashboard] ダイアログボックスで、ダッシュボードの Title、Description、Folder を指定します。次に、[Save] をクリックします。
3. 右上隅で [ダッシュボードを保存] をクリックします。 [ダッシュボードを保存] ダイアログボックスで、[保存] をクリックします。

ステップ 4：監視データの表示

Grafana の左側メニューで、[Dashboards] を選択します。目的のフォルダー内のダッシュボードをクリックして、すべての監視チャートを表示します。