Lindorm:Grafana を使用して LindormTSDB にアクセスする

前提条件

• Grafana ワークスペースが作成されていること。 詳細については、「ワークスペースの管理」をご参照ください。

• インターネットを使用して LindormTSDB にアクセスする場合は、次の操作を実行します。

  • LindormTSDB のインターネットエンドポイントを有効にします。 詳細については、「LindormTSDB のエンドポイントの表示」をご参照ください。

  • Grafana のパブリック IP アドレスを Lindorm インスタンスのホワイトリストに追加します。 詳細については、「ホワイトリストの設定」をご参照ください。

手順

このトピックでは、Grafana 10.0.x を例として使用して、LindormTSDB にアクセスする方法を示します。

1. Managed Service for Grafana コンソールにログインします。 左側のナビゲーションペインで、[ワークスペース管理] をクリックします。 次に、LindormTSDB への接続に使用するワークスペースをクリックします。

2. [基本情報] セクションで、ユーザー名とパスワードを入力します。 ユーザー名は admin です。 パスワードは、ワークスペースの作成時に設定されます。

3. Lindorm をデータソースとして Grafana に追加します。

   1. 左上隅の アイコンをクリックし、[管理] を選択します。 次に、データソースをクリックします。

   2. [管理] ページで、データソースをクリックします。

   3. データソース設定ページで、[データソースの追加] をクリックします。

   4. [データソースの追加] ページの検索ボックスに「Alibaba Cloud Lindorm」と入力します。 データソースを見つけてクリックします。

   5. [設定] タブで、次の表に示すパラメーターを設定します。 その他のパラメーターについては、デフォルト値をそのまま使用できます。

      構成項目	パラメーター	必須	説明
      名前		はい	データソースの名前。 カスタム名を指定できます。
      HTTP	URL	はい	LindormTSDB のエンドポイント。 詳細については、「LindormTSDB のエンドポイントの表示」をご参照ください。 重要 LindormTSDB のインターネットエンドポイントを使用し、Grafana サービスのインターネットエンドポイントが Lindorm インスタンスのホワイトリストに追加されていることを確認してください。
      認証	ベーシック認証	いいえ	LindormTSDB でユーザー認証と権限検証機能が有効になっている場合は、[ベーシック認証] をオンにし、[ベーシック認証の詳細] セクションに LindormTSDB へのログインに使用するユーザー名とパスワードを入力します。 詳細については、「ユーザーと権限の管理」をご参照ください。
      ベーシック認証の詳細	ユーザー	いいえ	Lindorm インスタンスへのログインに使用するユーザー名。 [ベーシック認証] をオンにした場合は、このパラメーターを指定する必要があります。
      	パスワード	いいえ	Lindorm インスタンスへのログインに使用するパスワード。 [ベーシック認証] をオンにした場合は、このパラメーターを指定する必要があります。
      Lindorm TSDB の詳細	データベース	いいえ	アクセスする LindormTSDB データベース。

   6. [保存 & テスト] をクリックします。

      「テスト成功」メッセージが返された場合、接続テストは成功です。

4. [ダッシュボードの作成] をクリックします。

5. [新規ダッシュボード] ページで、[新しいパネルの追加] をクリックします。

6. 手順 3 で追加した Lindorm データソースを選択します。

7. [クエリ] タブでデータをクエリします。

   1. [データソース] ドロップダウンリストから、使用するデータソースを選択します。

   2. Grafana でデータをクエリするには、SQL ステートメントエディターまたはテンプレートベースのクエリ エディターを使用できます。

      SQL ステートメントエディター

      アイコンを [A] セクションの右上隅でクリックし、エディターを生のクエリモードに切り替えます。その後、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 に設定できます。 この場合、時系列のタグはホスト名です。

      • OFFSET を使用して時間オフセットを設定できます。 これにより、異なる期間内に生成されたデータを比較できます。

      テンプレートベースのクエリ エディター

      テンプレートでクエリ条件とクエリするテーブルとフィールドを指定して、単純なクエリを実行できます。 次の表に、エディターで指定できるキーワードを示します。

      キーワード	説明
      SELECT	クエリするフィールドの名前を指定します。
      FROM	クエリするテーブルの名前を指定します。
      WHERE	クエリ条件を追加します。
      GROUP BY	集計条件を追加します。
      SAMPLE BY	ダウンサンプリングの間隔を指定します。 詳細については、「ダウンサンプリング クエリ」をご参照ください。 [クエリ オプション] をクリックし、[最小間隔] パラメーターと [最大データ ポイント] パラメーターを指定して、[間隔] の値を調整できます。
      ORDER BY TIME	並べ替え順序を指定します。
      LIMIT	結果セットで返すことができる最大行数を指定します。
      ALIAS BY	時系列のタグの名前を変更します。 時系列のエイリアスは、$tag_<tag_name> 形式です。 たとえば、時系列のタグを $tag_host に設定できます。 この場合、時系列のタグはホスト名です。
      OFFSET	時間オフセットを指定します。 これにより、異なる期間内に生成されたデータを比較できます。

デプロイ要件

• ECS インスタンスのオペレーティングシステムは 64 ビット CentOS 7.3 以降のバージョンであること。

• ECS インスタンスには、1 CPU コア以上、2 GB のメモリ、および 10 GB の利用可能なストレージ容量が必要であること。

前提条件

• ポート 3000 でのトラフィックを許可するルールが ECS インスタンスのセキュリティグループに追加されていること。 詳細については、「セキュリティグループ ルールの追加」をご参照ください。

• ECS インスタンスの IP アドレスが Lindorm インスタンスのホワイトリストに追加されていること。

  ECS インスタンスと Lindorm インスタンスが同じ VPC にある場合：ECS インスタンスのプライベート IP アドレスを Lindorm インスタンスのホワイトリストに追加します。 詳細については、「ホワイトリストの設定」をご参照ください。

  ECS インスタンスと Lindorm インスタンスが異なる VPC にある場合：

  • ECS インスタンスにパブリック IP アドレスを割り当てます。 ECS インスタンスにパブリック IP アドレスが割り当てられていない場合は、EIP を ECS インスタンスに関連付けるか、インスタンスの帯域幅設定を変更します。 詳細については、「EIP を ECS インスタンスに関連付ける」および「帯域幅設定の変更」をご参照ください。

  • ECS インスタンスのパブリック IP アドレスを Lindorm インスタンスのホワイトリストに追加します。 詳細については、「ホワイトリストの設定」をご参照ください。

• インターネット経由で Grafana の Web UI にアクセスする場合は、ECS インスタンスにパブリック IP アドレスが割り当てられていることを確認してください。 ECS インスタンスにパブリック IP アドレスが割り当てられていない場合は、EIP を ECS インスタンスに関連付けるか、インスタンスの帯域幅設定を変更します。 詳細については、「EIP を ECS インスタンスに関連付ける」および「帯域幅設定の変更」をご参照ください。 VPC 経由で Grafana の Web UI にアクセスする場合は、ECS インスタンスにパブリック IP アドレスを割り当てる必要はありません。

手順

1. Grafana をインストールします。 Grafana がインストールされている場合は、この手順をスキップします。

   1. ECS インスタンスにログインします。 詳細については、「インスタンスへの接続」をご参照ください。

   2. 次のコマンドを実行して、Grafana をダウンロードします。

      wget https://dl.grafana.com/enterprise/release/grafana-enterprise-8.2.2-1.x86_64.rpm

      説明

      この例では、Grafana 8.2.2-1 を使用しています。 要件に基づいてインストールする Grafana のバージョンを選択できます。 その他のバージョンの Grafana のダウンロード方法については、Grafana 公式 Web サイトをご覧ください。

   3. 次のコマンドを実行して、Grafana をインストールします。

      sudo yum install grafana-enterprise-8.2.2-1.x86_64.rpm

   4. 次のコマンドを実行して、Grafana を起動します。

      sudo service grafana-server start

2. Alibaba Cloud Lindorm プラグインをインストールします。

   1. 次のコマンドを実行して、Alibaba Cloud Lindorm データソースプラグインをダウンロードします。

      wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/grafana-alibabacloud-lindorm-datasource-latest.zip

   2. 次のコマンドを実行して、パッケージをデフォルトディレクトリに抽出します。 Linux のデフォルトディレクトリは /var/lib/grafana/plugins/ です。

      unzip grafana-alibabacloud-lindorm-datasource-latest.zip -d /var/lib/grafana/plugins/

   3. 次のコマンドを実行して、grafana.ini ファイルを変更します。 デフォルトでは、Linux のファイルのパスは /etc/grafana/grafana.ini です。

      sudo nano -w  /etc/grafana/grafana.ini

   4. [plugins] セクションで、;allow_loading_unsigned_plugins= を allow_loading_unsigned_plugins = alibabacloud-lindorm-datasource に変更します。 パラメーターを変更した後、CTRL + O を押して変更を保存し、Enter キーを押して編集モードを終了します。

      重要

      grafana.ini ファイルを変更するときは、;allow_loading_unsigned_plugins のセミコロン (;) を削除する必要があります。

   5. 次のコマンドを実行して、Grafana を再起動します。

      sudo service grafana-server restart

3. Lindorm をデータソースとして Grafana に追加します。

   1. ブラウザーのアドレスバーに次の URL を入力します。 http://IP:3000/。 URL の「IP」フィールドを ECS インスタンスのパブリック IP アドレスまたはプライマリ プライベート IP アドレスに置き換えます。 ユーザー名とパスワードを入力します。 セルフマネージド Grafana サービスに初めてログインする場合、ユーザー名とパスワードはどちらも admin です。 Grafana サービスにログインした後、パスワードを変更します。 詳細については、「Grafana へのサインイン」をご参照ください。

   2. 左側の アイコンをクリックし、ドロップダウンリストから [データソース] を選択します。

   3. [設定] ページで、[データソースの追加] をクリックします。

   4. [データソースの追加] ページで、検索ボックスに Alibaba Cloud Lindorm と入力し、追加するデータソースを見つけて、[選択] をクリックします。

   5. [設定] タブで、次の表に示すパラメーターを設定します。 その他のパラメーターについては、デフォルト値をそのまま使用できます。

      構成項目	パラメーター	必須	説明
      名前		はい	データソースの名前。 カスタム名を指定できます。
      HTTP	URL	はい	LindormTSDB のエンドポイント。 詳細については、「LindormTSDB のエンドポイントの表示」をご参照ください。 重要 ECS インスタンスが Lindorm インスタンスと同じ VPC に属している場合は、LindormTSDB の VPC エンドポイントを使用します。 それ以外の場合は、LindormTSDB のインターネットエンドポイントを使用します。 LindormTSDB の VPC エンドポイントを指定する場合は、ECS インスタンスのプライマリ プライベート IP アドレスが Lindorm インスタンスのホワイトリストに追加されていることを確認してください。 LindormTSDB のインターネットエンドポイントを指定する場合は、ECS インスタンスのパブリック IP アドレスが Lindorm インスタンスのホワイトリストに追加されていることを確認してください。
      認証	ベーシック認証	いいえ	LindormTSDB でユーザー認証と権限検証機能が有効になっている場合は、[ベーシック認証] をオンにし、[ベーシック認証の詳細] セクションに LindormTSDB へのログインに使用するユーザー名とパスワードを入力します。 詳細については、「ユーザーと権限の管理」をご参照ください。
      ベーシック認証の詳細	ユーザー	いいえ	Lindorm インスタンスへのログインに使用するユーザー名。 [ベーシック認証] をオンにした場合は、このパラメーターを指定する必要があります。
      	パスワード	いいえ	Lindorm インスタンスへのログインに使用するパスワード。 [ベーシック認証] をオンにした場合は、このパラメーターを指定する必要があります。
      Lindorm TSDB の詳細	データベース	いいえ	アクセスする LindormTSDB データベース。

   6. [保存 & テスト] をクリックします。

      「テスト成功」メッセージが返された場合、接続テストは成功です。

4. セルフマネージド Grafana サービスを Lindorm インスタンスに接続した後、Grafana サービスでダッシュボードを作成して使用できます。 詳細については、「ダッシュボードの作成」をご参照ください。

5. [クエリ] タブでデータをクエリします。

   1. [データソース] ドロップダウンリストから、使用するデータソースを選択します。

   2. Grafana でデータをクエリするには、SQL ステートメントエディターまたはテンプレートベースのクエリ エディターを使用できます。

      SQL ステートメントエディター

      アイコンを [A] セクションの右上隅でクリックし、エディターを生のクエリモードに切り替えます。その後、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 に設定できます。 この場合、時系列のタグはホスト名です。

      • OFFSET を使用して時間オフセットを設定できます。 これにより、異なる期間内に生成されたデータを比較できます。

      テンプレートベースのクエリ エディター

      テンプレートでクエリ条件とクエリするテーブルとフィールドを指定して、単純なクエリを実行できます。 次の表に、エディターで指定できるキーワードを示します。

      キーワード	説明
      SELECT	クエリするフィールドの名前を指定します。
      FROM	クエリするテーブルの名前を指定します。
      WHERE	クエリ条件を追加します。
      GROUP BY	集計条件を追加します。
      SAMPLE BY	ダウンサンプリングの間隔を指定します。 詳細については、「ダウンサンプリング クエリ」をご参照ください。 [クエリ オプション] をクリックし、[最小間隔] パラメーターと [最大データ ポイント] パラメーターを指定して、[間隔] の値を調整できます。
      ORDER BY TIME	並べ替え順序を指定します。
      LIMIT	結果セットで返すことができる最大行数を指定します。
      ALIAS BY	時系列のタグの名前を変更します。 時系列のエイリアスは、$tag_<tag_name> 形式です。 たとえば、時系列のタグを $tag_host に設定できます。 この場合、時系列のタグはホスト名です。
      OFFSET	時間オフセットを指定します。 これにより、異なる期間内に生成されたデータを比較できます。