Application Real-Time Monitoring Service:カスタムインタラクションイベントの設定

インタラクションイベントは、データ分析に不可欠な機能です。データディメンションと分析粒度を変更することで、データからより深いインサイトを得ることができます。トレース分析では、スパンのフィールドと属性に対してインタラクションイベントを設定できます。利用可能なインタラクションイベントのタイプは次のとおりです。

• Logstore を開く：Simple Log Service (SLS) のターゲット Logstore ページにリダイレクトします。

• カスタム HTTP リンク：ターゲットの HTTP URL にリダイレクトします。

• エディターで開く：ポップアップウィンドウにフィールド値をテキストまたは JSON 形式で表示します。

• クイック検索を開く：Simple Log Service (SLS) のターゲットのクイック検索ページにリダイレクトします。

カスタムインタラクションイベントの追加

1. トレース分析 ページで、トレースの TraceID をクリックします。

2. ターゲットのスパンを選択し、右側の [スパン詳細] ペインで [イベント設定] をクリックします。

3. [ドリルダウン設定] パネルで、インタラクションイベントの範囲を選択します。

   カスタムイベントには、サービスイベント設定とグローバルイベント設定の 2 つの範囲があります。サービスイベント設定は現在のアプリケーションのトレースにのみ適用され、グローバルイベント設定は現在のリージョンのすべてのトレースに適用されます。

   [サービスイベント設定] タブで、[フィールドの追加] をクリックして SpanId と TraceID フィールドを追加します。

4. [フィールドの追加] をクリックし、イベントを設定するフィールドを選択して、[OK] をクリックします。

5. [イベントの追加] をクリックし、ドロップダウンリストからインタラクションイベントを選択します。

   利用可能なインタラクションイベントには、[Logstore を開く]、[カスタム HTTP リンク]、[エディターで開く]、および[保存済み検索を開く]があります。

6. イベントパラメーターを設定し、[OK] をクリックします。

   パラメーターの詳細については、「インタラクションイベントのパラメーター」をご参照ください。

   [サービスイベント設定] タブで、SpanId フィールドにイベントを追加します。[カスタム名] を設定し、[テキストタイプ] を選択します。[イベントの追加] をクリックして、さらにインタラクションイベントを追加できます。

カスタムイベントのトリガー

[スパン詳細] ペインで、青色でハイライト表示されているフィールドにカーソルを合わせます。ツールチップが表示され、設定されたカスタムイベントが表示されます。イベント名をクリックして、インタラクションイベントをトリガーします。

たとえば、SpanId フィールドの値にカーソルを合わせると、ポップアップメニューの [カスタムイベント] セクションに、[エディターで開く] や [関連ログのクエリ] などの設定済みイベントが表示されます。

インタラクションイベントのパラメーター

Logstore を開く

[Logstore を開く] インタラクションイベントをトリガーすると、コンソールはターゲットの SLS Logstore ページにリダイレクトします。

• 前提条件

  ターゲットの Logstore がすでに作成されている必要があります。詳細については、「Logstore の管理」をご参照ください。

• パラメーター

  パラメーター	必須	説明
  カスタム名	はい	カスタムインタラクションイベントの名前。この名前はカスタムイベントのツールチップに表示されます。
  リージョンの選択	はい	ターゲットの SLS プロジェクトが配置されているリージョン。
  プロジェクトの選択	はい	ターゲットの SLS プロジェクトの名前。
  Logstore の選択	はい	ターゲットの Logstore の名前。インタラクションイベントをトリガーすると、コンソールはこの Logstore にリダイレクトします。
  新しいウィンドウで開く	いいえ	このオプションを有効にすると、インタラクションイベントをトリガーしたときに、ターゲットの Logstore が新しいブラウザウィンドウで開きます。
  時間範囲	いいえ	ターゲット Logstore のクエリ時間範囲を指定します。オプション： プリセット：ターゲット Logstore を開いた後、SLS はデフォルトのクエリ時間範囲である 15 分 (相対) を使用します。 現在のクエリ時間を継承：ターゲット Logstore を開いた後、クエリ時間範囲は、インタラクションイベントをトリガーした瞬間のトレース分析ページから継承されます。 データポイント時間を継承：ターゲット Logstore を開いた後、クエリ開始時刻は [時間範囲フィールド] の値から [時間範囲オフセット] を引いたものになり、終了時刻は [時間範囲フィールド] の値に [時間範囲オフセット] を足したものになります。 相対時間：ターゲット Logstore を開いた後、クエリ時間は指定された相対時間範囲になります。 時間枠：ターゲット Logstore を開いた後、クエリ時間は指定された時間枠になります。
  フィルター文	いいえ	フィルター文を入力します。システムはそれをターゲット Logstore に同期し、AND 演算子でクエリ文の先頭に追加します。 フィルター文の [変数の追加] をクリックして、フィールド値をフィルター条件として挿入します。 例：traceId=${{TraceID}} AND spanId=${{SpanId}}

カスタム HTTP リンク

[カスタム HTTP リンク] インタラクションイベントをトリガーすると、コンソールはターゲットの HTTP URL にリダイレクトします。

• 前提条件

  HTTP URL が利用可能であること。

• パラメーター

  パラメーター	必須	説明
  カスタム名	はい	カスタムインタラクションイベントの名前。この名前はカスタムイベントのツールチップに表示されます。
  プロトコル	はい	HTTP URL のプロトコル (HTTP や HTTPS など)。
  URL	はい	宛先 URL。 HTTP URL のパスは、ターゲットリソースへの階層パスを表します。[変数の追加] をクリックして、URL パスに変数を挿入できます。リンクがクリックされると、システムは変数を対応するフィールド値に置き換え、更新された URL にリダイレクトします。
  URL のエンコード	いいえ	[URL のエンコード] を有効にすると、リンクコンテンツが URL エンコードされます。
  新しいウィンドウで開く	いいえ	このオプションを有効にすると、インタラクションイベントがトリガーされたときに、ターゲットの HTTP URL が新しいブラウザウィンドウで開きます。

エディターで開く

[エディターで開く] インタラクションイベントをトリガーすると、コンソールはフィールド値をテキストまたは JSON 形式でポップアップウィンドウに表示します。

保存済み検索を開く

[クイック検索を開く] インタラクションイベントをトリガーすると、コンソールはターゲットの SLS クイック検索ページにリダイレクトします。

• 前提条件

  ターゲットのクイック検索が SLS で既に作成されている必要があります。詳細については、「クイック検索」をご参照ください。

  変数を使用するには、ターゲットのクイック検索のクエリ文で変数を設定します。詳細については、「変数を使用してクエリ文のパラメーターを動的に調整する」をご参照ください。

• パラメーター

  パラメーター	必須	説明
  カスタム名	はい	カスタムインタラクションイベントの名前。この名前はカスタムイベントのツールチップに表示されます。
  リージョンの選択	はい	ターゲットの SLS プロジェクトが配置されているリージョン。
  プロジェクトの選択	はい	ターゲットの SLS プロジェクトの名前。
  クイック検索の選択	はい	SLS のターゲットのクイック検索。インタラクションイベントをトリガーすると、コンソールはこのクイック検索のページを開きます。
  新しいウィンドウで開く	いいえ	このオプションを有効にすると、インタラクションイベントがトリガーされたときに、ターゲットのクイック検索ページが新しいブラウザウィンドウで開きます。
  時間範囲	いいえ	ターゲットのクイック検索のクエリ時間範囲を指定します。オプション： プリセット：ターゲットのクイック検索ページを開いた後、SLS はデフォルトのクエリ時間範囲である 15 分 (相対) を使用します。 現在のクエリ時間を継承：ターゲットのクイック検索ページを開いた後、クエリ時間範囲は、インタラクションイベントをトリガーした瞬間のトレース分析ページから継承されます。 データポイント時間を継承：ターゲットのクイック検索ページを開いた後、クエリ開始時刻は [時間範囲フィールド] の値から [時間範囲オフセット] を引いたものになり、終了時刻は [時間範囲フィールド] の値に [時間範囲オフセット] を足したものになります。 相対時間：ターゲットのクイック検索ページを開いた後、クエリ時間は指定された相対時間範囲になります。 時間枠：ターゲットのクイック検索ページを開いた後、クエリ時間は指定された時間枠になります。
  フィルター文	いいえ	フィルター文を入力します。システムはそれをターゲットのクイック検索ページに同期し、AND 演算子でクエリ文の先頭に追加します。 フィルター文の [変数の追加] をクリックして、フィールド値をフィルター条件として挿入します。
  動的変数	いいえ	SLS では、変数を使用してターゲットのクイック検索のクエリ文を柔軟に変更できます。ここに追加された変数がターゲットのクイック検索クエリの変数と同じ名前を持つ場合、インタラクションイベントをトリガーするフィールドの値がクエリ文の変数を置き換えます。 説明 最大 5 つの動的変数と 5 つの静的変数を追加できます。 動的変数 変数名：変数の名前。 変数値列：クイック検索クエリの変数を動的に置き換える値を持つ列。 静的変数 変数名：変数の名前。 静的な値：クイック検索クエリの変数を置き換える固定値。
  静的変数	いいえ

プリセットインタラクションイベント

トレース分析には、次のプリセットインタラクションイベントが含まれています。

スパンフィールドの値を右クリックすると、コンテキストメニューが表示されます。このメニューは、[詳細設定] セクションと [カスタムイベント] セクションに分かれています。[詳細設定] セクションには、[現在の条件でトレースをクエリ] や [アプリケーション詳細の表示] などの組み込みイベントが表示されます。[カスタムイベント] セクションには、ユーザーが設定したイベントが表示されます。メニューの下部にある [イベント設定] オプションを使用すると、カスタムイベントを管理できます。

よくある質問

仮想ドメイン名を使用してトレース分析ページにアクセスする場合 (たとえば、ARMS ページが自己管理の Web ページに埋め込まれている場合)、[Logstore を開く] または [クイック検索を開く] イベントをトリガーすると、SLS コンソールではなくログインページにリダイレクトされることがあります。この問題を回避するには、[カスタム HTTP リンク] インタラクションイベントを使用して同じ効果を実現します。次の手順に従ってください。

1. [カスタム HTTP リンク] インタラクションイベントを作成します。

2. [プロトコル] として https を選択し、[URL] フィールドに宛先 URL を入力します。

3. ターゲットの SLS URL を準備します。標準のドメイン名 (sls.console.alibabacloud.com) を SLS 仮想ドメイン名 (sls4servims.console.alibabacloud.com) に置き換えます。詳細については、「共有可能なリンクの準備」をご参照ください。[URL のエンコード] を無効にし、[新しいウィンドウで開く] を有効にします。

4. Logstore にリダイレクトするときにクエリパラメーターを渡したい場合は、[変数の追加] をクリックして追加する変数を選択します。

   次の URL の例では、プロジェクト test-project 内の test-logstore という名前の Logstore を開き、traceId が現在のトレースの TraceID と等しいログをフィルターします。

   https://sls4servims.console.alibabacloud.com/lognext/project/test-project/logsearch/test-logstore?queryString=traceId=${{TraceID}}