すべてのプロダクト
Search
ドキュメントセンター

Lindorm:Grafana を使用した LindormTSDB へのアクセス

最終更新日:Jun 23, 2026

Grafana は、大規模なメトリックデータを可視化するためのオープンソースツールです。インターネットアプリケーションの分析に広く使用されており、産業モニタリング、気象モニタリング、ホームオートメーション、プロセスマネジメントなどの分野で人気があります。Lindorm は、Grafana のデータソースとして Lindorm を追加できる Alibaba Cloud Lindorm データソースプラグインを提供しています。このトピックでは、LindormTSDB に接続してデータを視覚的に分析する方法について説明します。

Managed Service for Grafana の利用

前提条件

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

  • インターネット経由で LindormTSDB に接続する場合は、次の手順を完了してください。

    • ご利用の LindormTSDB インスタンスのパブリックアドレスを有効にします。詳細については、「LindormTSDB の接続情報の表示」をご参照ください。

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

操作手順

このセクションでは、Grafana 10.0.x を例として説明します。

  1. Managed Service for Grafana コンソールにログインします。左側のナビゲーションウィンドウで、ワークスペースの管理 をクリックします。

  2. [基本情報] セクションで、パブリックアドレスまたはプライベートアドレスをクリックして Grafana UI を開きます。ユーザー名とパスワードを入力してログインします。ユーザー名は admin で、パスワードはワークスペース作成時に設定したものです。

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

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

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

    3. これにより、新しいデータソースを追加するページが開きます。

    4. [データソースの追加] ページで、Alibaba Cloud Lindorm を検索し、クリックします。

    5. [設定] タブで、次のパラメーターを設定します。他のパラメーターはデフォルト値のままにします。

      設定

      パラメーター

      必須

      説明

      Name

      はい

      データソースのカスタム名。

      HTTP

      URL

      はい

      LindormTSDB の HTTP エンドポイント。詳細については、「LindormTSDB の接続情報の表示」をご参照ください。

      重要

      LindormTSDB のパブリックアドレスを使用し、Grafana のパブリック IP アドレスを Lindorm のホワイトリストに追加します。

      認証

      [基本認証]

      いいえ

      LindormTSDB でユーザー認証が有効になっている場合は、[基本認証] を有効にし、[基本認証の詳細] セクションで LindormTSDB のユーザー名とパスワードを入力します。ユーザー認証の詳細については、「ユーザーと権限の管理」をご参照ください。

      [基本認証の詳細]

      [ユーザー]

      いいえ

      LindormTSDB のユーザー名。[基本認証] が有効な場合にのみ必須です。

      [パスワード]

      いいえ

      LindormTSDB のパスワード。[基本認証] が有効な場合にのみ必須です。

      [Lindorm TSDB の詳細]

      [データベース]

      いいえ

      アクセスする LindormTSDB データベース。

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

      「test success」というメッセージが表示されたら、接続は成功です。

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

  5. [新規ダッシュボード] ページで、[可視化の追加] をクリックします。

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

  7. [クエリ] タブで、クエリを設定します。

    1. [データソース] リストから、ご利用のデータソースを選択します。

    2. 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 内にない場合:

  • インターネット経由で Grafana Web UI にアクセスする場合は、ECS インスタンスにパブリック IP アドレスがあることを確認してください。ない場合は、クラウドリソースとの EIP の関連付けまたは帯域幅設定の変更を行います。VPC 経由で Grafana Web UI にアクセスする場合は、パブリック IP アドレスは必要ありません。

操作手順

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

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

    2. 次のコマンドを実行して、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 の公式サイトをご参照ください。

    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. 次のコマンドを実行して、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
    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. Grafana に Lindorm データソースを追加します。

    1. Web ブラウザーで http://IP:3000/ にアクセスします。ここで IP は、ご利用の ECS インスタンスのパブリック IP またはプライマリプライベート IP アドレスです。ユーザー名とパスワードを入力します。初回ログイン時のデフォルトのユーザー名とパスワードはどちらも admin です。ログイン後すぐにパスワードを変更することを推奨します。詳細については、「Grafana へのサインイン」をご参照ください。

    2. 左側のナビゲーションウィンドウで 设置 アイコンをクリックし、[データソース] を選択します。

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

    4. [データソースの追加] ページで、Alibaba Cloud Lindorm を検索し、[選択] をクリックします。

    5. [設定] タブで、次のパラメーターを設定します。他のパラメーターはデフォルト値のままにします。

      設定

      パラメーター

      必須

      説明

      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 データベースです。

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

      「test success」というメッセージが表示されたら、接続は成功です。

  4. Grafana でダッシュボードを作成して使用します。詳細については、「ダッシュボードの作成」をご参照ください。

  5. [クエリ] タブで、クエリを設定します。

    1. [データソース] リストから、ご利用のデータソースを選択します。

    2. 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

      時間オフセットを設定すると、異なる期間のデータを比較するのに役立ちます。