Simple Log Service ダッシュボードのインポートとエクスポート Grafana 統合 - Simple Log Service

同一 Alibaba Cloud アカウント内でのダッシュボードのインポート

ダッシュボード エリアの右側で、[+] > ダッシュボードをインポート を選択します。

ダッシュボードをインポート ダイアログボックスで、次のパラメーターを設定して インポート をクリックします。ダッシュボードがインポートされると、ダッシュボードページにリダイレクトされます。

パラメーター	説明
[配信元プロジェクト]	ソースダッシュボードを含むプロジェクトを選択します。説明ソースは現在のプロジェクトでも、別のプロジェクトでもかまいません。
[ソースダッシュボード]	ソースダッシュボードを選択します。
[ダッシュボード名]	新しいダッシュボードの名前を入力します。
[Logstore の置き換え]	ダッシュボードがソース Logstore に依存している場合は、現在のプロジェクトの Logstore で置き換えます。複数の置換がサポートされています。

Alibaba Cloud アカウント間でのダッシュボードのインポート

1. ダッシュボード JSON ファイルの取得

対象のダッシュボードページで、右上隅にある編集をクリックして編集モードに入ります。
編集モードで、アイコンをクリックします。 [ダッシュボード設定] ページの [ダッシュボード JSON] タブで、JSON コンテンツをコピーします。

2. JSON ダッシュボードの追加

ダッシュボード エリアの右側で、[+] > JSON ダッシュボードの追加 を選択します。
ダッシュボードに追加 ダイアログボックスで、JSON を貼り付け、確認をクリックします。新しいダッシュボードにリダイレクトされます。

[操作タイプ] を [ダッシュボードの作成] に設定し、 [レイアウトモード] ([グリッドレイアウト] または [フリーレイアウト]) を選択して、 [ダッシュボード名] を入力します。displayName、attribute.type、および charts 内のクエリパラメーターを含むダッシュボード JSON を表示または編集できます。

SLS ダッシュボードの Grafana へのエクスポート

前提条件

Grafana 8.0.0 以降がインストールされていること (Grafana ドキュメント)。
説明
- このトピックでは Grafana 9.2.4 を使用します。
- Grafana がローカルにインストールされている場合は、ブラウザーでポート 3000 を有効にしてください。
Grafana 用の SLS プラグイン (バージョン 2) がインストールされていること。Grafana への接続。
[Grafana ダッシュボードに変換] タブが表示されない場合は、アカウントで有効化するため、チケットを起票してください。
円グラフを使用するには、円グラフプラグインをインストールしてください： grafana-cli plugins install grafana-piechart-panel。
変換エラーが表示された場合は、続行する前に解決してください。未解決のエラーがあると、グラフ要素が正しく表示されないことがあります。

制限事項

Grafana は SLS のフリーレイアウトをサポートしていません。フリーレイアウトのダッシュボードを変換すると、レイアウトが乱れます。
軸設定が欠落していると、表示に問題が発生することがあります。このような場合は、クエリと分析の設定 を確認してください。
SLS の単一値グラフは、区間値比較、周期値比較、およびカスタマイズをサポートしています。Grafana は数値のみを変換します。
Grafana がサポートするテーブル設定は SLS よりも少ないです。ミニラインチャート、ミニカラムチャート、カスタムインタラクション、フィルターはサポートされていません。
線の種類やカスタム設定などのグラフスタイルの詳細は変換されません。インポートされたダッシュボードは、Grafana のデフォルトスタイルを使用します。
データ変換、インタラクションイベント、フィールド設定などの SLS の機能は、Grafana では完全には複製できません。

1. Grafana 互換 JSON のエクスポート

ダッシュボードリストで目的のダッシュボードをクリックし、編集 > をクリックします。
[Grafana ダッシュボードへの変換] タブで、お使いの Grafana バージョンを選択します。Grafana の JSON 形式のコピー または Grafana の JSON 形式のダウンロード をクリックして、JSON コンテンツを取得します。

SLS クエリ構文には、対応する Grafana プラグインが必要です。Grafana 8.0.0 以降が必要です。バージョン 8.3.x は推奨されません。

2. Simple Log Service ダッシュボードの Grafana へのインポート

Grafana にログインします。
左側のメニューで、[ > ダッシュボード] をクリックします。ダッシュボードページで、[新規 > インポート] をクリックします。
[ダッシュボード JSON ファイルのアップロード] をクリックして JSON ファイルをインポートするか、JSON コンテンツを [パネル JSON でインポート] テキストボックスに貼り付けて [ロード] をクリックします。

または、 [grafana.com 経由でインポート] フィールドに Grafana.com のダッシュボード URL または ID を入力して、 [ロード] をクリックすることもできます。
[オプション] セクションで、以下の設定を行います。
1. ダッシュボードに名前を付けます。
2. ダッシュボードのフォルダーを選択します。
3. データソースを選択します。
4. [インポート] をクリックします。
インポートされたダッシュボードをダッシュボードページで表示します。

変換範囲

SLS と Grafana の実装の違いにより、変換がサポートされているのは、次のグラフタイプ、データソース、変数、ステートメント、およびグラフスタイルのみです。

カテゴリ	変換対象のコンテンツ
グラフタイプ	テーブル (Pro) 折れ線グラフ (Pro) 縦棒グラフ (Pro) フローチャート (Pro) 単一値グラフ (Pro) バーゲージ (Pro) 円グラフ (Pro) メトリック Prometheus テーブルテキスト折りたたみ行
データソースタイプ	Logstore (SQL) Metricstore (PromQL) Metricstore (SQL) Builtin
変数	変数の置換のみがサポートされています。Grafana はフィルターをサポートしていません。 1 つの変数に動的リスト項目と静的リスト項目を混在させることはできません。Grafana は、クエリ値と定数値の共存をサポートしていません。変数の置換は複数の変数をサポートしていません。Grafana はダッシュボードのカスタムキーをサポートしていません。
ステートメント	SQL PromQL SQL および PromQL
グラフスタイル	グラフの位置、サイズ、タイトル、凡例のマッチング

Grafana ダッシュボードの SLS へのインポート

前提条件

Grafana 8.0.0 以降がインストールされていること (Grafana ドキュメント)。

このトピックでは Grafana 9.2.4 を使用します。

重要
Grafana がローカルにインストールされている場合は、ブラウザーでポート 3000 を有効にしてください。
Grafana 用の SLS プラグイン (バージョン 2) がインストールされていること。Simple Log Service プラグインのインストール。
円グラフを使用するには、円グラフプラグインをインストールしてください： grafana-cli plugins install grafana-piechart-panel。

制限事項

Grafana ダッシュボードの変数は Prometheus データソースをサポートしていません。代わりに log-service-datasource を使用してください。
線の種類やカスタム設定などのグラフスタイルの詳細は変換されません。インポートされたダッシュボードは、SLS のデフォルトスタイルを使用します。
変換、式、アノテーション、リンク、権限などの Grafana の機能は、SLS では完全には複製できません。

1. Grafana ダッシュボード JSON のエクスポート

Grafana にログインします。
左側のメニューで、[ > 参照] をクリックします。
対象のダッシュボードを開きます。右上隅にあるアイコンをクリックします。設定ページで、左側のナビゲーションペインにある [JSON モデル] をクリックします。JSON コンテンツをファイルまたはクリップボードにコピーします。

2. Grafana ダッシュボードのインポート

ダッシュボード エリアの右側で、[+] > Grafana ゲージのインポートを選択します。
Grafana JSON 入力 ステップで、[ファイルからインポート] (10 MB 未満の JSON ファイル) または [JSON を入力してインポート] を使用してダッシュボード JSON を提供し、JSON の解析 をクリックします。変換後の時間範囲は、デフォルトで「過去 15 分」になります。
Logstore を選択してください ステップで、以下の設定を行います。

SLS は JSON を自動的に解析して、データソース ID または名前を識別します。これを使用して、関連付けられているプロジェクトと Logstore を特定します。
1. [http://] フィールドに、Grafana IP アドレス:ポート を入力します。
2. [ID] リンク をクリックします。
  
  これにより Grafana のデータソース設定ページが開き、関連付けられている SLS プロジェクトと Logstore が表示されます。Grafana は、バージョンに応じてデータソース ID または名前を表示します。この例では、データソース ID を使用します。
3. 対象のプロジェクトと Logstore を選択し、次へをクリックします。
変換メッセージ ステップで、エラーが報告されていないことを確認し、次に ゲージの生成 をクリックします。

結果には、互換性に関する警告、エラーメッセージ、フォーマット修正の提案、またはエラーが見つからなかったことの確認が含まれる場合があります。
インポートされたダッシュボードをダッシュボードページで表示します。

変換範囲

Grafana と SLS の実装の違いにより、変換がサポートされているのは、次のグラフタイプ、データソース、変数、ステートメント、およびグラフスタイルのみです。

カテゴリ	変換対象のコンテンツ
グラフタイプ	時系列棒グラフスタットゲージバーゲージテーブル円グラフ円グラフ (旧) テキスト行
データソースタイプ	Prometheus log-service-datasource
変数	クエリ (データソースには log-service-datasource を使用する必要があります。) カスタムテキストボックス
ステートメント	SQL PromQL SQL および PromQL Grafana Random Walk
グラフスタイル	グラフの位置、サイズ、タイトル、凡例のマッチング