グラフのインタラクションイベントの設定 (Proバージョン)、統計グラフ (Proバージョン) 追加時のインタラクションイベント設定方法 - Simple Log Service

ダッシュボード上の例外の根本原因を特定するために、インタラクションイベントを使用して、Logstore のクエリ、トレース分析、別のダッシュボードを開くなどのクイックドリルダウン分析を実行します。このトピックでは、サポートされているインタラクションイベントのタイプと、ダッシュボードでの設定方法について説明します。

仕組み

2024-09-12_15-24-27 (1)

ダッシュボード上の問題を調査するには、インタラクションイベントを使用して迅速なドリルダウン分析を行います。たとえば、Logstore を開く、ダッシュボードを開く、保存された検索を開く、カスタム HTTP URL を作成する、トレース詳細を開く、またはフルスタック可観測性トレース詳細を開くことができます。

この例では、Nginx アクセスログを使用します。ステータスが 200 の円グラフセクションをクリックすると、対応する Logstore にリダイレクトされ、そのステータスのログをクエリできます。クエリでは、ダッシュボードと同じ時間範囲が使用されます。

リクエストステータスの円グラフを追加：クエリ時間範囲、Logstore、およびクエリ文を設定します。
リクエストステータスの円グラフにインタラクションイベントを追加：ダッシュボード上のpvフィールドのインタラクションイベントを [Logstoreを開く] に設定します。次に、変数を使用してクエリ文のパラメータを動的に変更する ${{status}} 変数を追加して、ダッシュボードから選択されたステータスに基づいて Logstore のログをクエリします。

Simple Log Service は、以下のインタラクションイベントをサポートしています。設定手順については、このトピックの最後を参照してください。

Logstoreを開く

インタラクションイベントを [Logstoreを開く] に設定すると、トリガー時にターゲットの Logstore ページにリダイレクトされます。

前提条件
ターゲットの Logstore が存在する必要があります。詳細については、「基本的なLogstoreの作成」をご参照ください。

設定パラメータ

パラメータ	説明
[カスタム名]	インタラクションイベントの名前。
[Project を選択]	ターゲット Logstore を含むプロジェクトを選択します。
[Logstore を選択してください]	インタラクションイベントのトリガー時に開くターゲット Logstore を指定します。
[新規タブで開く]	新規タブで開くを有効にすると、LogStore ページが新しいブラウザータブで開かれます。
[時間範囲]	ターゲット Logstore でのクエリの時間範囲を指定します。
[フィルタリング条件の継承]	フィルタリング条件の継承を有効にすると、現在のダッシュボードにある既存のフィルター条件がターゲット LogStore に渡されます。条件は、`AND` 演算子でクエリ文の先頭に追加されます。
[フィルタ文]	フィルター文を入力します。これは、ターゲット Logstore に渡され、`AND` 演算子でクエリ文の先頭に追加されます。変数の追加をクリックして、フィルター文に変数を挿入します。重要なシステム変数には以下が含まれます。 `${{__start_time__}}`：クエリの開始時刻。 `${{__end_time__}}`：クエリの終了時刻。 `${{__interval__}}`：クエリの時間間隔 (秒単位)。 `${{__project__}}`：クエリ対象のプロジェクト名。変数を挿入すると、その値がフィルター条件として使用されます。

ダッシュボードを開く

設定後、このインタラクションイベントをトリガーすると、ターゲットダッシュボードが開きます。

前提条件
ターゲットダッシュボードが存在し、グラフが含まれている必要があります。詳細については、「ダッシュボードへのグラフの追加」をご参照ください。
変数を渡すには、まずターゲットダッシュボードのグラフのクエリ文で変数を定義する必要があります。詳細については、「変数を使用してクエリ文のパラメータを動的に変更する」をご参照ください。

パラメータ

パラメータ	説明
[カスタム名]	インタラクションイベントの名前。
[Project を選択]	ターゲットダッシュボードを含むプロジェクト。
[ダッシュボードの選択]	インタラクションイベントのトリガー時に開くダッシュボード。
[新規タブで開く]	新規タブで開くを有効にすると、対象のダッシュボードが新しいブラウザータブで開きます。
[時間範囲]	ターゲットダッシュボードの時間範囲。
[フィルタリング条件の継承]	フィルタリング条件の継承を有効にすると、現在のダッシュボードのフィルター条件がターゲットダッシュボードに渡されます。
[変数の継承]	変数の継承を有効にすると、現在のダッシュボードからターゲットダッシュボードに変数が渡されます。
[フィルタ文]	ターゲットダッシュボードに適用するフィルター文。フィルター文に変数を挿入できます。変数の追加をクリックして、フィルターステートメントに変数を挿入します。主なシステム変数には、次のものがあります。 `${{__start_time__}}`：クエリの開始時刻。 `${{__end_time__}}`：クエリの終了時刻。 `${{__interval__}}`：クエリの時間間隔 (秒単位)。 `${{__project__}}`：クエリ対象のプロジェクト名。変数を挿入すると、その値がフィルター条件として使用されます。
[動的変数]	ターゲットダッシュボードに渡す動的変数を指定します。 [Dynamic Variable Name]：動的変数の名前。 [Column for Dynamic Variable Value]：動的変数の値を提供する列。説明最大 5 つの動的変数を追加できます。
[静的変数]	ターゲットダッシュボードに渡す静的変数を指定します。 [Static Variable Name]：静的変数の名前。 [Static Value]：ターゲットダッシュボードに渡す固定値。説明最大 5 つの静的変数を追加できます。

カスタムHTTP URL

インタラクションイベントがカスタム HTTP URL として設定されている場合、イベントをトリガーするとターゲットページが開きます。

前提条件
ターゲットの HTTP URL が必要です。

パラメータ

パラメータ	説明
[カスタム名]	インタラクションイベントの名前。
[プロトコル]	URL のプロトコル。
[URL]	イベントのトリガー時に開く宛先 URL。 URL には、以下の Simple Log Service システム変数を埋め込むことができます。例：`https://sls.console.alibabacloud.com/lognext/project/${{__project__}}/logsearch/test`。 `${{__start_time__}}`：クエリの開始時刻。 `${{__end_time__}}`：クエリの終了時刻。 `${{__interval__}}`：クエリ間隔 (秒単位)。 `${{__project__}}`：クエリ対象のプロジェクト名。
[トランスコード]	トランスコードを有効にすると、URL コンテンツがエンコードされます。
[新規タブで開く]	新規タブで開くを有効にすると、URL が新しいブラウザーウィンドウまたはタブで開きます。

保存された検索

インタラクションイベントを [保存された検索を開く] ように設定すると、トリガー時にターゲットの「保存された検索」ページにリダイレクトされます。

前提条件
ターゲットの「保存された検索」が存在する必要があります。詳細については、「保存された検索」をご参照ください。
変数を使用するには、まずターゲットの「保存された検索」のクエリ文で変数を定義する必要があります。詳細については、「変数を使用してクエリ文のパラメータを動的に変更する」をご参照ください。

パラメータ

パラメータ	説明
[カスタム名]	インタラクションイベントの名前を指定します。
[Project を選択]	ターゲットの「保存された検索」を含むプロジェクトを選択します。
[クイック検索の選択]	イベントのトリガー時に開く「保存された検索」を選択します。
[新規タブで開く]	新規タブで開くを有効にすると、対象の保存済み検索が新しいブラウザータブで開きます。
[時間範囲]	ターゲットの「保存された検索」の時間範囲を設定します。
[フィルタリング条件の継承]	フィルタリング条件の継承を有効にすると、現在のダッシュボードの既存のフィルター条件がターゲットの保存済み検索に渡され、`AND` 演算子でクエリ文の先頭に追加されます。
[フィルタ文]	ターゲットの「保存された検索」に渡すフィルター文を入力します。システムは、この文を `AND` 演算子でクエリ文の先頭に追加します。フィルター文に変数を挿入できます。変数が挿入されると、その値がフィルター条件として使用されます。
[動的変数]	変数を使用して、ターゲットの「保存された検索」のクエリ文を動的に変更できます。ここで追加された変数がターゲットクエリ文の変数と同じ名前の場合、イベントをトリガーしたフィールドの値がターゲットクエリの変数を置き換えます。 [Dynamic Variable Name]：動的変数の名前を指定します。 [Column for Dynamic Variable Value]：動的変数の値を提供する列を選択します。説明最大 5 つの動的変数を追加できます。
[静的変数]	変数を使用して、ターゲットの「保存された検索」のクエリ文を動的に変更できます。ここで追加された変数がターゲットクエリ文の変数と同じ名前の場合、指定した静的値がターゲットクエリの変数を置き換えます。 [Static Variable Name]：静的変数の名前を指定します。 [Static Value]：静的変数に割り当てる値を指定します。説明最大 5 つの静的変数を追加できます。

操作手順

例 1: Logstoreを開くイベント

1. リクエストステータス分布グラフの追加

1.1 ダッシュボードの追加

Simple Log Service コンソールにログインし、ターゲットプロジェクトを選択します。[ダッシュボード] > [ダッシュボード] ページで、「リクエストステータス分布グラフ」という名前のダッシュボードを作成します。
右上隅の [+] アイコンをクリックし、ドロップダウンメニューから [ダッシュボードを追加] を選択します。

1.2 グラフの追加

グラフを追加するには、新しいチャートを追加する をクリックします。
グラフを設定して保存します。
1. 左側のペインで、クエリ時間範囲、Logstore、およびクエリ文を設定します。
2. 右側のペインで、グラフの種類、カテゴリ、値列を設定します。ページ上部の適用をクリックしてグラフをプレビューし、次に OK をクリックして保存します。
```
* | 
select 
  count(1) as pv ,status 
group by 
  status
```

2. インタラクションイベントの追加

設定後、ダッシュボード上の 200 などのステータスコードをクリックすると、Logstore にリダイレクトされ、status が 200 のログをクエリできます。Logstore でのクエリ時間範囲は、ダッシュボードの時間範囲と一致します。

2.1 フィールドへのインタラクションイベント追加

右側のペインの インタラクションの発生 タブで 設定の追加 をクリックし、ドロップダウンリストからフィールドを選択します。
たとえば、[A > pv] を選択します。
イベントの追加 をクリックし、ドロップダウンリストから Logstore を開く を選択して、ダイアログボックスで Logstore と動的変数を設定します。
Logstore はクエリの宛先です。時間範囲はクエリ期間を定義し、フィルター文は実行するクエリを定義します。
ダイアログボックスでは、[カスタム名] を指定し、[nginx-dashboard] などのプロジェクトを選択し、オプションで [新しいウィンドウで開く] スイッチを切り替えます。

2.2 グラフとダッシュボードの保存

「チャートの編集」ページの右上隅で、OK をクリックします。
ダッシュボード編集ページの右上隅で、保存をクリックします。

2.3 インタラクションイベントの検証

チャートでステータス 200 のデータポイントをクリックし、次に Logstore を開く をクリックします。クエリ文が status: 200、クエリ時間が 一昨日 に設定され、ダッシュボードで選択した時間範囲と一致するログストアにリダイレクトされます。

例 2: ダッシュボードを開くイベント

この例では、「website_log」という名前の Logstore に収集された NGINX アクセスログを使用します。[RequestMethod] と [destination_drilldown] という 2 つのダッシュボードを作成し、それらの間にインタラクションを設定します。

[RequestMethod] ダッシュボードで、リクエストメソッドを分類するテーブルを追加し、[destination_drilldown] ダッシュボードを開くインタラクションイベントを設定します。
[destination_drilldown] ダッシュボードで、時間経過に伴う PV トレンドを示す折れ線グラフを追加します。

設定が完了すると、[RequestMethod] ダッシュボード上のリクエストメソッドをクリックして [destination_drilldown] ダッシュボードに移動し、対応する PV トレンドを表示できます。

[destination_drilldown] ダッシュボードで、時間経過に伴う PV トレンドを示す折れ線グラフを追加します。
クエリ文は次のとおりです。ここで、${{method|PUT}} は変数です。詳細については、「ダッシュボードへのグラフの追加」をご参照ください。
```
request_method: ${{method|PUT}} | SELECT __time__ - __time__ %60 AS time, COUNT(1) AS PV GROUP BY time ORDER BY time
```
[RequestMethod] ダッシュボードで、リクエストメソッドを分類するテーブルを追加し、インタラクションイベントを設定します。
クエリ文は次のとおりです。詳細については、「ダッシュボードへのグラフの追加」をご参照ください。
データソースとして [website_log] を選択し、クエリ文 *|SELECT request_method, COUNT(1) AS count GROUP BY request_method ORDER BY count DESC LIMIT 10 を入力し、[インタラクションイベント] タブで request_method フィールドに [ダッシュボードを開く] アクションを追加します。
設定例：
- ダッシュボードの選択 を destination_drilldown に設定します。
- Dynamic Variable Name を method に設定し、request_method 列を選択します。
インタラクションイベントタイプとして [ダッシュボードを開く] を選択し、[変数の継承] スイッチを有効にします。
結果を検証します。
RequestMethod ダッシュボードのテーブルで GET をクリックし、次に ダッシュボードを開く をクリックすると、destination_drilldown ダッシュボードにリダイレクトされます。
[destination_drilldown] ダッシュボードには、GET リクエストの時間経過に伴う PV トレンドが表示されます。