Grafana は、大規模なメトリックデータを可視化するためのオープンソースツールです。インターネットアプリケーションの分析に広く使用されており、産業モニタリング、気象モニタリング、ホームオートメーション、プロセスマネジメントなどの分野で人気があります。Lindorm は、Grafana のデータソースとして Lindorm を追加できる Alibaba Cloud Lindorm データソースプラグインを提供しています。このトピックでは、LindormTSDB に接続してデータを視覚的に分析する方法について説明します。
Managed Service for Grafana の利用
前提条件
-
Grafana ワークスペースが作成されていること。詳細については、「Grafana ワークスペースの作成」をご参照ください。
-
インターネット経由で LindormTSDB に接続する場合は、次の手順を完了してください。
-
ご利用の LindormTSDB インスタンスのパブリックアドレスを有効にします。詳細については、「LindormTSDB の接続情報の表示」をご参照ください。
-
Grafana のパブリック IP アドレスを Lindorm のホワイトリストに追加します。詳細については、「ホワイトリストの設定」をご参照ください。
-
操作手順
このセクションでは、Grafana 10.0.x を例として説明します。
-
Managed Service for Grafana コンソールにログインします。左側のナビゲーションウィンドウで、ワークスペースの管理 をクリックします。
-
[基本情報] セクションで、パブリックアドレスまたはプライベートアドレスをクリックして Grafana UI を開きます。ユーザー名とパスワードを入力してログインします。ユーザー名は admin で、パスワードはワークスペース作成時に設定したものです。
-
Grafana に Lindorm データソースを追加します。
-
左上の
アイコンをクリックし、Manage を選択します。次に、[データソース] をクリックします。 -
[データソース] ページで、[データソースの追加] をクリックします。
-
これにより、新しいデータソースを追加するページが開きます。
-
[データソースの追加] ページで、
Alibaba Cloud Lindormを検索し、クリックします。 -
[設定] タブで、次のパラメーターを設定します。他のパラメーターはデフォルト値のままにします。
設定
パラメーター
必須
説明
Name
はい
データソースのカスタム名。
HTTP
URL
はい
LindormTSDB の HTTP エンドポイント。詳細については、「LindormTSDB の接続情報の表示」をご参照ください。
重要LindormTSDB のパブリックアドレスを使用し、Grafana のパブリック IP アドレスを Lindorm のホワイトリストに追加します。
認証
[基本認証]
いいえ
LindormTSDB でユーザー認証が有効になっている場合は、[基本認証] を有効にし、[基本認証の詳細] セクションで LindormTSDB のユーザー名とパスワードを入力します。ユーザー認証の詳細については、「ユーザーと権限の管理」をご参照ください。
[基本認証の詳細]
[ユーザー]
いいえ
LindormTSDB のユーザー名。[基本認証] が有効な場合にのみ必須です。
[パスワード]
いいえ
LindormTSDB のパスワード。[基本認証] が有効な場合にのみ必須です。
[Lindorm TSDB の詳細]
[データベース]
いいえ
アクセスする LindormTSDB データベース。
-
[保存してテスト] をクリックします。
「test success」というメッセージが表示されたら、接続は成功です。
-
-
[ダッシュボードの構築] をクリックします。
-
[新規ダッシュボード] ページで、[可視化の追加] をクリックします。
-
ステップ 3 で追加した Lindorm データソースを選択します。
-
[クエリ] タブで、クエリを設定します。
-
[データソース] リストから、ご利用のデータソースを選択します。
-
Grafana は、テンプレートベースのクエリエディターと SQL ステートメントエディターの 2 つのクエリエディターモードを提供します。
SQL ステートメントエディター
セクション [A] の右上隅にある
アイコンをクリックして、raw クエリエディターに切り替えます。Lindorm SQL ステートメントを入力して、複雑なクエリを実行できます。例:SELECT region,time,avg(temperature) FROM sensor WHERE time >= $from AND time <= $to SAMPLE BY $interval説明Lindorm SQL 構文の詳細については、「SELECT 構文」をご参照ください。
-
時間条件
time >= $from AND time <= $toは必須です。指定しない場合、クエリは失敗します。パラメーター値は、ダッシュボードで選択された時間範囲に自動的に置き換えられます。 -
[クエリオプション] で、[最小間隔] と [最大データポイント数] の設定を使用して [間隔] を調整します。
-
[ALIAS BY] を使用して、時系列ラベルの名前を変更します。フォーマットは
$tag_<tag_name>です。たとえば、$tag_hostを使用すると、時系列ラベルにはhostタグの値が表示されます。 -
OFFSET を使用して時間のオフセットを設定することで、異なる期間のデータを比較できます。
テンプレートベースのクエリエディター
テンプレートを使用してテーブル、フィールド、クエリ条件を選択することで、簡単なクエリを実行できます。次の表にキーワードを示します。
キーワード
説明
SELECTクエリするフィールド名を選択します。
FROMクエリするテーブル名を選択します。
WHEREクエリ条件を追加します。
GROUP BY集約条件を追加します。
SAMPLE BYダウンサンプリングの時間間隔を選択します。詳細については、「ダウンサンプリングクエリ」をご参照ください。
[クエリオプション] をクリックして、[最小間隔] と [最大データポイント数] の設定を使用して [間隔] パラメーターを調整します。
ORDER BY TIMEクエリ結果を時間で並べ替えます。
LIMIT結果セットで返す行数を指定します。
ALIAS BY時系列ラベルの名前を変更します。フォーマットは
$tag_<tag_name>です。たとえば、$tag_hostを使用すると、時系列ラベルにはhostタグの値が表示されます。OFFSET時間オフセットを設定すると、異なる期間のデータを比較するのに役立ちます。
-
-
ECS 上のセルフマネージド Grafana の利用
デプロイメント要件
-
Elastic Compute Service (ECS) インスタンスは CentOS 7.3 64 ビット以降を使用する必要があります。
-
ECS インスタンスには、少なくとも 1 vCPU、2 GB のメモリ、10 GB の利用可能なディスク領域が必要です。
前提条件
開始する前に、次の項目が完了していることを確認してください。
-
ECS インスタンスのセキュリティグループにインバウンドルールを追加して、ポート 3000 でのトラフィックを許可します。詳細については、「セキュリティグループルールの追加」をご参照ください。
-
ECS インスタンスの IP アドレスを Lindorm のホワイトリストに追加します。
ECS インスタンスと Lindorm インスタンスが同じ VPC 内にある場合:ECS インスタンスのプライマリプライベート IP を Lindorm インスタンスのホワイトリストに追加します。詳細については、「ホワイトリストの設定」をご参照ください。
ECS インスタンスと Lindorm インスタンスが同じ VPC 内にない場合:
-
ECS インスタンスにパブリック IP アドレスを割り当てます。ECS インスタンスにパブリック IP アドレスがない場合は、クラウドリソースとの EIP の関連付けまたは帯域幅設定の変更を行います。
-
ECS インスタンスのパブリック IP アドレスを Lindorm インスタンスのホワイトリストに追加します。詳細については、「ホワイトリストの設定」をご参照ください。
-
-
インターネット経由で Grafana Web UI にアクセスする場合は、ECS インスタンスにパブリック IP アドレスがあることを確認してください。ない場合は、クラウドリソースとの EIP の関連付けまたは帯域幅設定の変更を行います。VPC 経由で Grafana Web UI にアクセスする場合は、パブリック IP アドレスは必要ありません。
操作手順
-
Grafana をインストールします。Grafana がすでにインストールされている場合は、このステップをスキップしてください。
-
ECS インスタンスにログインします。詳細については、「ECS インスタンスへの接続」をご参照ください。
-
次のコマンドを実行して、Grafana をダウンロードします。
wget https://dl.grafana.com/enterprise/release/grafana-enterprise-8.2.2-1.x86_64.rpm説明この例では Grafana Enterprise Edition 8.2.2-1 を使用します。他のバージョンもインストールできます。その他のダウンロードアドレスについては、Grafana の公式サイトをご参照ください。
-
次のコマンドを実行して、Grafana をインストールします。
sudo yum install grafana-enterprise-8.2.2-1.x86_64.rpm -
次のコマンドを実行して、Grafana サービスを開始します。
sudo service grafana-server start
-
-
Alibaba Cloud Lindorm データソースプラグインをインストールします。
-
次のコマンドを実行して、Lindorm データソースプラグインパッケージをダウンロードします。Grafana のバージョンに対応する正しいダウンロードリンクを選択してください。
-
Grafana 11.0 以降の場合:
wget https://hbaseuepublic.oss-cn-beijing.aliyuncs.com/grafana-alibabacloud-lindorm-datasource-11.0.1.zip-
Grafana 10.x 以前の場合:
wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/grafana-alibabacloud-lindorm-datasource-latest.zip -
-
次のコマンドを実行して、プラグインをデフォルトのディレクトリに展開します。Linux では、デフォルトのディレクトリは /var/lib/grafana/plugins/ です。
unzip grafana-alibabacloud-lindorm-datasource-latest.zip -d /var/lib/grafana/plugins/ -
次のコマンドを実行して、grafana.ini ファイルを編集します。 Linux では、デフォルトのファイルパスは /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.ini ファイルを編集する際は、
;allow_loading_unsigned_pluginsの先頭にあるセミコロン (;) を削除する必要があります。 -
次のコマンドを実行して、Grafana サービスを再起動します。
sudo service grafana-server restart
-
-
Grafana に Lindorm データソースを追加します。
-
Web ブラウザーで
http://IP:3000/にアクセスします。ここでIPは、ご利用の ECS インスタンスのパブリック IP またはプライマリプライベート IP アドレスです。ユーザー名とパスワードを入力します。初回ログイン時のデフォルトのユーザー名とパスワードはどちらも admin です。ログイン後すぐにパスワードを変更することを推奨します。詳細については、「Grafana へのサインイン」をご参照ください。 -
左側のナビゲーションウィンドウで
アイコンをクリックし、[データソース] を選択します。 -
[設定] ページで、[データソースの追加] をクリックします。
-
[データソースの追加] ページで、Alibaba Cloud Lindorm を検索し、[選択] をクリックします。
-
[設定] タブで、次のパラメーターを設定します。他のパラメーターはデフォルト値のままにします。
設定
パラメーター
必須
説明
Name
はい
データソースのカスタム名です。
HTTP
URL
はい
LindormTSDB の HTTP エンドポイントです。詳細については、「LindormTSDB の接続情報を表示」をご参照ください。
重要-
ご利用の ECS インスタンスが Lindorm インスタンスと同じ VPC 内にある場合は、LindormTSDB の VPC エンドポイントを使用します。そうでない場合は、パブリックアドレスを使用します。
-
VPC エンドポイントを使用する場合は、ECS インスタンスのプライマリプライベート IP アドレスを Lindorm のホワイトリストに追加します。パブリックアドレスを使用する場合は、ECS インスタンスのパブリック IP アドレスを Lindorm のホワイトリストに追加します。
認証
Basic 認証
いいえ
LindormTSDB でユーザー認証が有効になっている場合は、[ベーシック認証] を有効にして、[ベーシック認証の詳細] セクションに LindormTSDB のユーザー名とパスワードを入力します。ユーザー認証の詳細については、「ユーザーと権限の管理」をご参照ください。
Basic 認証の詳細
ユーザー
いいえ
LindormTSDB のユーザー名です。Basic 認証が有効な場合にのみ必須です。
パスワード
いいえ
LindormTSDB のパスワードです。Basic 認証が有効な場合にのみ必須です。
Lindorm TSDB の詳細
データベース
いいえ
アクセスする LindormTSDB データベースです。
-
-
[保存してテスト] をクリックします。
「test success」というメッセージが表示されたら、接続は成功です。
-
-
Grafana でダッシュボードを作成して使用します。詳細については、「ダッシュボードの作成」をご参照ください。
-
[クエリ] タブで、クエリを設定します。
-
[データソース] リストから、ご利用のデータソースを選択します。
-
Grafana は、テンプレートベースのクエリエディターと SQL ステートメントエディターの 2 つのクエリエディターモードを提供します。
SQL ステートメントエディター
セクション [A] の右上隅にある
アイコンをクリックすると、RAW クエリエディターに切り替わります。Lindorm SQL ステートメントを入力して、複雑なクエリを実行できます。例:SELECT region,time,avg(temperature) FROM sensor WHERE time >= $from AND time <= $to SAMPLE BY $interval説明Lindorm SQL 構文の詳細については、「SELECT 構文」をご参照ください。
-
時間条件
time >= $from AND time <= $toは必須です。指定しない場合、クエリは失敗します。パラメーター値は、ダッシュボードで選択された時間範囲に自動的に置き換えられます。 -
[クエリオプション] で、[最小間隔] と [最大データポイント数] の設定を使用して [間隔] を調整します。
-
[ALIAS BY] を使用して、時系列ラベルの名前を変更します。フォーマットは
$tag_<tag_name>です。たとえば、$tag_hostを使用すると、時系列ラベルにはhostタグの値が表示されます。 -
[OFFSET] を使用して時間オフセットを設定すると、異なる期間のデータを比較するのに役立ちます。
テンプレートベースのクエリエディター
テンプレートを使用してテーブル、フィールド、クエリ条件を選択することで、簡単なクエリを実行できます。次の表にキーワードを示します。
キーワード
説明
SELECTクエリするフィールド名を選択します。
FROMクエリするテーブル名を選択します。
WHEREクエリ条件を追加します。
GROUP BY集約条件を追加します。
SAMPLE BYダウンサンプリングの時間間隔を選択します。詳細については、「ダウンサンプリングクエリ」をご参照ください。
[クエリオプション] をクリックして、[最小間隔] と [最大データポイント数] の設定を使用して [間隔] パラメーターを調整します。
ORDER BY TIMEクエリ結果を時間で並べ替えます。
LIMIT結果セットで返す行数を指定します。
ALIAS BY時系列ラベルの名前を変更します。フォーマットは
$tag_<tag_name>です。たとえば、$tag_hostを使用すると、時系列ラベルにはhostタグの値が表示されます。OFFSET時間オフセットを設定すると、異なる期間のデータを比較するのに役立ちます。
-
-