Alibaba Cloud Lindorm データソースプラグインを使用すると、Grafana を LindormTSDB に接続し、ダッシュボード上で時系列データを可視化できます。本トピックでは、以下の 2 つのセットアップ方法について説明します。
ご自身のデプロイメントに合った方法を選択してください。
クイックリファレンス
| 構成項目 | Managed Service for Grafana | ECS 上のセルフマネージド Grafana |
|---|
| 例で使用する Grafana のバージョン | 10.0.x | 8.2.2-1 |
| プラグイン名（Grafana 内での検索用） | Alibaba Cloud Lindorm | Alibaba Cloud Lindorm |
| URL（同一 VPC 内） | 該当なし — インターネットエンドポイントを使用 | LindormTSDB の VPC エンドポイント |
| URL（異なる VPC / インターネット） | LindormTSDB のインターネットエンドポイント | LindormTSDB のインターネットエンドポイント |
| 基本認証（Basic auth） | 任意 — LindormTSDB の認証が有効な場合に有効化 | 任意 — LindormTSDB の認証が有効な場合に有効化 |
| データベース | 任意 | 任意 |
| 成功メッセージ | test success | test success |
Managed Service for Grafana を使用した接続
前提条件
開始する前に、以下の条件を満たしていることを確認してください。
LindormTSDB をデータソースとして追加
以下の手順では、Grafana 10.0.x を例として説明します。
Managed Service for Grafana コンソールにログインします。左側のナビゲーションウィンドウで ワークスペース管理 をクリックし、使用するワークスペースを選択します。
基本情報 セクションで、ユーザー名とパスワードを入力します。ユーザー名は admin です。パスワードは、ワークスペース作成時に設定したパスワードです。
左上隅のアイコンをクリックし、管理 を選択してから、データソース をクリックします。
データソースの追加 をクリックします。Alibaba Cloud Lindorm を検索し、検索結果をクリックします。
設定項目 タブで、以下のパラメーターを構成します。その他のパラメーターはデフォルト値のままにしてください。
| 構成項目 | パラメーター | 必須 | 説明 |
|---|
| 名前 | — | はい | このデータソースの名前を指定します。 |
| HTTP | URL | はい | LindormTSDB のインターネットエンドポイントを指定します。詳細については、「LindormTSDB のエンドポイントの表示」をご参照ください。Grafana サービスのパブリック IP アドレスが Lindorm インスタンスのホワイトリストに追加されていることを確認してください。 |
| 認証 | 基本認証（Basic auth） | いいえ | LindormTSDB のユーザー認証が有効な場合に有効化します。基本認証の詳細 セクションに認証情報を入力します。詳細については、「ユーザーおよび権限管理」をご参照ください。 |
| 基本認証の詳細 | ユーザー | いいえ | Lindorm インスタンスのユーザー名を指定します。基本認証（Basic auth） が有効な場合に必須です。 |
| 基本認証の詳細 | パスワード | いいえ | Lindorm インスタンスのパスワードを指定します。基本認証（Basic auth） が有効な場合に必須です。 |
| Lindorm TSDB の詳細 | データベース | いいえ | アクセス対象の LindormTSDB データベースを指定します。 |
保存してテスト をクリックします。test success のメッセージが表示されれば、接続が正常に確立されたことを確認できます。
ダッシュボードの作成とデータのクエリ実行
ダッシュボードの作成 をクリックします。
新規ダッシュボード ページで、新しいパネルの追加 をクリックします。
データソース のドロップダウンリストから、追加した Lindorm データソースを選択します。
クエリ タブで、SQL ステートメントエディターまたは「クエリエディター」で説明するテンプレートベースのクエリエディターを使用してデータをクエリします。
ECS 上のセルフマネージド Grafana を使用した接続
前提条件
開始する前に、以下の条件を満たしていることを確認してください。
ポート 3000 へのインバウンドトラフィックを許可するセキュリティグループルールが設定されていること。詳細については、「セキュリティグループルールの追加」をご参照ください。
ECS インスタンスの IP アドレスが Lindorm インスタンスのホワイトリストに追加されていること：
ECS と Lindorm が同一 VPC 内にある場合（推奨）： ECS インスタンスのプライベート IP アドレスをホワイトリストに追加します。詳細については、「ホワイトリストの設定」をご参照ください。
ECS と Lindorm が異なる VPC 内にある場合： ECS インスタンスにパブリック IP アドレスを割り当てます（または EIP を関連付ける、または 帯域幅の構成を変更する）、その後、パブリック IP アドレスをホワイトリストに追加します。
Grafana の Web UI をインターネット経由でアクセスする場合は、ECS インスタンスにパブリック IP アドレスが割り当てられていること。
ステップ 1：Grafana のインストール
Grafana が既にインストール済みの場合は、このステップをスキップしてください。
ECS インスタンスに接続するECS インスタンスに接続する。
Grafana のダウンロード：
この例では Grafana 8.2.2-1 を使用します。別のバージョンをインストールする場合は、Grafana のダウンロードページをご参照ください。
wget https://dl.grafana.com/enterprise/release/grafana-enterprise-8.2.2-1.x86_64.rpm
Grafana のインストール：
sudo yum install grafana-enterprise-8.2.2-1.x86_64.rpm
Grafana の起動：
sudo service grafana-server start
ステップ 2：Alibaba Cloud Lindorm プラグインのインストール
プラグインのダウンロード：
wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/grafana-alibabacloud-lindorm-datasource-latest.zip
プラグインをプラグインディレクトリ（デフォルト：/var/lib/grafana/plugins/）に展開：
unzip grafana-alibabacloud-lindorm-datasource-latest.zip -d /var/lib/grafana/plugins/
Grafana の設定ファイル（デフォルト：/etc/grafana/grafana.ini）を開きます：
sudo nano -w /etc/grafana/grafana.ini
[plugins] セクション内で、;allow_loading_unsigned_plugins= の行を見つけ、以下のように置き換えます：
重要 先頭のセミコロン（;）を削除してください。セミコロンは設定をコメントアウトしており、変更を有効にするには削除が必要です。
allow_loading_unsigned_plugins = alibabacloud-lindorm-datasource
Ctrl+O を押して保存し、Enter を押して確認して終了します。
変更を反映するために Grafana を再起動：
sudo service grafana-server restart
ステップ 3：LindormTSDB をデータソースとして追加
ブラウザを開き、http://<ECS-IP>:3000/ にアクセスします。<ECS-IP> は、ECS インスタンスのパブリック IP アドレスまたはプライマリプライベート IP アドレスに置き換えてください。
ログインします。初回ログイン時は、ユーザー名とパスワードの両方が admin です。ログイン後にパスワードを変更してください。詳細については、「Grafana へのサインイン」をご参照ください。
左側の設定アイコンをクリックし、データソース を選択します。
構成 ページで、データソースの追加 をクリックします。Alibaba Cloud Lindorm を検索し、選択 をクリックします。
設定項目 タブで、以下のパラメーターを構成します。その他のパラメーターはデフォルト値のままにしてください。
| 構成項目 | パラメーター | 必須 | 説明 |
|---|
| 名前 | — | はい | このデータソースの名前を指定します。 |
| HTTP | URL | はい | LindormTSDB のエンドポイントを指定します。詳細については、「LindormTSDB のエンドポイントの表示」をご参照ください。ECS と Lindorm インスタンスが同一 VPC 内にある場合は VPC エンドポイントを、それ以外の場合はインターネットエンドポイントを使用してください。対応する IP アドレス（プライベートまたはパブリック）がホワイトリストに追加されていることを確認してください。 |
| 認証 | 基本認証（Basic auth） | いいえ | LindormTSDB のユーザー認証が有効な場合に有効化します。基本認証の詳細 セクションに認証情報を入力します。詳細については、「ユーザーおよび権限管理」をご参照ください。 |
| 基本認証の詳細 | ユーザー | いいえ | Lindorm インスタンスのユーザー名を指定します。基本認証（Basic auth） が有効な場合に必須です。 |
| 基本認証の詳細 | パスワード | いいえ | Lindorm インスタンスのパスワードを指定します。基本認証（Basic auth） が有効な場合に必須です。 |
| Lindorm TSDB の詳細 | データベース | いいえ | アクセス対象の LindormTSDB データベースを指定します。 |
保存してテスト をクリックします。test success のメッセージが表示されれば、接続が正常に確立されたことを確認できます。
ステップ 4：ダッシュボードの作成とデータのクエリ実行
接続が完了したら、データの可視化のためにダッシュボードおよびパネルを作成します。一般的な Grafana の操作については、「ダッシュボードの作成」をご参照ください。
任意のパネルの クエリ タブで、データソース のドロップダウンリストから Lindorm データソースを選択し、以下のいずれかのエディターを使用してデータをクエリします。
クエリエディター
どちらのセットアップ方法でも、クエリ タブで同じクエリエディターを使用します。
SQL ステートメントエディター
A セクションの右上隅にあるトグルアイコンをクリックして、生クエリモード（Raw Query Mode） に切り替えます。このモードでは、複雑なクエリに対して Lindorm SQL を直接記述できます。
例：
SELECT region, time, avg(temperature) FROM sensor
WHERE time >= $from AND time <= $to
SAMPLE BY $interval
時間変数
Grafana は、これらの変数をダッシュボードの時間範囲セレクターから取得した値に置き換えます。
| 変数 | 解決される値 | 必須 |
|---|
$from | 選択された時間範囲の開始時刻 | はい |
$to | 選択された時間範囲の終了時刻 | はい |
$interval | 時間範囲およびパネルサイズに基づいて計算されたサンプリング間隔 | いいえ |
重要 time >= $from AND time <= $to はすべてのクエリで必須です。この条件がないと、クエリは結果を返しません。
「$interval」を調整するには、[クエリオプション] をクリックし、[最小間隔] および [最大データポイント数] を設定します。
テンプレートベースのクエリエディター
SQL を記述せずにシンプルなクエリを実行する場合は、テンプレートエディターを使用します。ドロップダウンメニューからフィールド、テーブル、フィルター、集約をそれぞれ選択します。
| キーワード | 機能 |
|---|
SELECT | 返すフィールドを選択します。 |
FROM | クエリ対象のテーブルを選択します。 |
WHERE | フィルター条件を追加します。 |
GROUP BY | 集約条件を追加します。 |
SAMPLE BY | ダウンサンプリング間隔を設定します。詳細については、「ダウンサンプリングクエリ」をご参照ください。クエリオプション の下にある 最小間隔（Min interval） および 最大データポイント数（Max data points） を使用して調整できます。 |
ORDER BY TIME | 結果を時間順（昇順または降順）に並べ替えます。 |
LIMIT | 返される行数の上限を設定します。 |
ALIAS BY | 凡例内の時系列タグの名前を変更します。形式は $tag_<tag_name> です（例：$tag_host）。 |
OFFSET | クエリのタイムウィンドウをシフトし、異なる期間のデータを比較します。 |