openGemini には独自の Grafana プラグインが含まれています。

Grafana-openGemini の概要

Grafana は、収集されたデータをクエリし、柔軟な構成を通じて視覚的に表示できる、人気のあるオープンソースのデータ視覚化および監視分析プラットフォームです。クライアントチャートを迅速かつ柔軟に作成でき、公式ライブラリにはヒートマップ、折れ線グラフ、チャート、その他の表示方法などのダッシュボードプラグインが豊富に用意されています。InfluxDB、OpenTSDB、Prometheus、ElasticSerach、MySQL などのデータソースをサポートします。カスタムアラームルールを作成して、他のメッセージ処理サービスやコンポーネントに通知することもできます。

openGemini は InfluxDB インターフェイスと互換性があるため、openGemini がオープンソースであったときから、InfluxDB データソースを使用して openGemini に接続することが推奨されてきましたが、今日に至るまで、コミュニティは最終的にギャップを埋めるために独自のデータソースプラグインを開発しました。この記事では主にプラグインの機能と使い方を紹介します（プラグインはGrafanaのバージョン：v9.5.3以降に依存しますのでご注意ください）。

プラグインはコミュニティでオープンソース化されており、ニーズに合わない機能があれば二次開発も可能です。

https://github.com/openGemini/grafana-opengemini-datasource

プラグインの機能

ソースデータの 3 種類のデータ (時系列、テーブル、ログ) へのフォーマットをサポートします。
ログデータの表示をサポートします。openGeminiデータベース自体のログ検索関連構文と、openGeminiデータソースプラグインのキーワードハイライト機能を組み合わせて、ログの検索、表示、検索などの操作を実現します。
エイリアスのサポート。エイリアスモードは、複雑なデータを区別するために、テーブル名、列名、またはタグ名の名前置換をサポートします。
このプラグインは、クエリステートメントに表示される $timeFilter、$__interval、およびその他の変数をサポートしており、変数はクエリプロセス中に対応する値に置き換えられます。

プラグインのインストール

Grafana-openGemini プラグインは、次のいずれかの方法で使用することを選択できます。

(1) ソースコードのコンパイル

環境情報をコンパイルする

Node.js：バージョンv16+
糸。次のコマンドでインストールできます。
```
> npm install yarn
```

ソースコードをダウンロードする

> git clone https://github.com/openGemini/grafana-opengemini-datasource.git

ホームディレクトリに入る

> cd grafana-opengemini-datasource

コンパイル

> yarn install
> yarn run build

コンパイルされたプラグインは dist フォルダーに保存されます

(2) リリース版をダウンロードする

最新バージョンのリリースをダウンロードします。ダウンロードリンク:

https://github.com/openGemini/grafana-opengemini-datasource/releases/

グラファナの構成

Grafana 構成ファイルを変更しますcustom.ini。

[paths]
...
//配置下载的源码路径
plugins = /path/to/[plugin-path]
...
[plugins]
...
//配置插件名称为opengemini-opengemini-datasource (不可修改)
allow_loading_unsigned_plugins = opengemini-opengemini-datasource

Custom.ini ファイルがない場合は、sample.ini ファイルをコピーして、名前をcustom.ini に変更できます。

構成が正常に変更されたら、grafana-server を再起動します。

プラグインの使用法

左側のメニュー「接続」をクリックします
openGemini を選択します
「新しいデータソースを追加」をクリックします

データソース構成

HTTP URL、ユーザー名とパスワード、データベース、その他の関連情報など、openGemini にリンクするためのさまざまなパラメーターを構成します。
設定項目の説明
- Name、データソースの名前を設定します
- デフォルト、デフォルトで開き、データソースは新しいパネルでデフォルトで選択できます。
- URL、openGemini サービスのアドレス、openGemini サービスのデフォルトのポート番号は 8086 です
- 許可された Cookie。デフォルトでは、grafana プロキシは転送された Cookie を削除します。この項目は、データソースに転送する必要がある Cookie を名前で指定します。
- Timeout、リクエストのタイムアウト期間を設定します
- Database、openGemini のデフォルトのデータベースを設定します
- HTTPメソッド、openGeminiのリクエストメソッドを設定
- 最小時間間隔、自動グループ化の最小時間間隔を設定します。

お問い合わせ

クエリ構文:詳細については、openGemini のドキュメントを参照してください。

https://docs.opengemini.org/zh/

形式: データを時系列、テーブル、ログなどに形式設定することを選択します。

Alias by : テーブル名、列名、またはタグ名の名前置換をサポートします

$measurement は測定名を置き換えます
$col は列名を置き換えます
$tag_exampletag は exampletag タグの値を置き換えます

たとえば、各ノードの CPU 使用率をクエリするには、次のクエリステートメントを使用します。

SELECT mean("CpuUsage") FROM $database.."system" WHERE $timeFilter GROUP BY time($__interval), "host" fill(null)

Alias by に $tag_host を入力します。これは、ホスト値を使用してデフォルトのテーブル名の表示を置き換えることを意味します。

時系列と表形式を使用した表示効果を次の図に示します。

時系列

テーブル

別の例として、ログをクエリするには、クエリステートメントは次のようになります。

select * from mst181998 limit 100

結果は以下のようになります。

要約する

openGemini は、独自のデータソースプラグイン、openGemini-Grafana を備えた別の「強力な将軍」を追加しました。この記事では、openGemini で Gra fana に簡単にアクセスする方法を、インストール、使用、データソースの設定の 3 つのステップで詳しく説明しますので、どなたでもダウンロードしてインストールして体験してください。

openGemini公式ウェブサイト：http://www.openGemini.org

openGemini オープンソースアドレス: https://github.com/openGemini

openGemini パブリックアカウント:

注目へようこそ~openGeminiコミュニティに参加して、一緒に未来を構築、管理、共有することを心から歓迎します!