カスタム・イベントの定義

カスタムイベントを作成するには、以下の手順に従ってください：

1. サイドバーで「設定」をクリックします。

2. 「イベント」 ->「 新規イベント」をクリックします。

3. イベントの基本的なイベント情報を入力します。

   • イベントの名前と説明を入力します。 (これらのフィールドでは、ハイフンは検索中に予期しない結果をもたらす可能性があるため、使用を避けてください。)
   • 問題の深刻度を選択してください： 警告または重大。
   • イベントをインシデントと見なすかどうかを選択し、猶予期間 (条件に一致しなくなった場合に問題をクローズするまでの待機期間) を設定します。

4. カスタム・イベントの条件を構成します。

   このイベントをトリガーするために使用されるメトリクスを提供するデータソースを選択し、カスタムイベントの条件を作成します：

   • 組み込みメトリック: 対応するエンティティーがインスツルメントされている場合に使用可能なメトリックです。

     • 例えば JVM をモニターしている場合、Instana は使用中のメモリーの量などのメトリックを提供します。 JVM タイプの各エンティティーには、すぐに使用可能な memory.used メトリックがあります。
     • それとは別に、一部の 動的 組み込みメトリックは、単一のサブエンティティーごとに 1 つずつ、エンティティーごとに複数回存在します。 例えば、ホストの使用可能なディスク・スペースがあります。 Instana はホストのディスクごとに個別の fs.{device}.free メトリック (例: fs./dev/xvda1.free) を提供します。 カスタム・イベントは、マッチングするデバイス ( 次で始まる /devなど) を指定することによって定義できます。

   • カスタム・メトリック: モニター対象のアプリケーションが明示的に公開しているメトリックです。 例えば、アプリケーションは以下のカスタム・カスタム・メトリックを公開できます。

     • Dropwizard 指標
     • Finagle 指標
     • JMX メトリック
     • .NETのカスタムパフォーマンスカウンター
     • OpenTelemetry メトリック
     • Prometheus メトリック
     • StatsD メトリック

   • システム・ルール:

     • オフライン・イベント検出: このルールは、エンティティー (JVM やプロセスなど) がオフラインになるとアクティブになります。
     • 一致するエンティティーが実行されていないホスト: このルールは、カスタム・イベントの範囲内にあるホストで一致するエンティティー (JVM やプロセスなど) が実行されていない場合にアクティブになります。
     • ホスト可用性の検出: このルールは、以前に確認されたホストが指定された期間オフラインであった場合にアクティブになります。
     • ホスト上で予期しない数のエンティティが実行されている場合 ：このルールは、ホスト上で実行されている一致するエンティティ（ JVM やprocessなど）の数が、カスタムイベントの範囲内で予期しない数である場合に有効になります。

   メトリックのタイプに応じて、カスタム・イベントをトリガーする条件を定義する方法が異なります。 例えば、5 分の時間枠内のエラー率が 10% を超える場合にイベントを構成することができます。

   最大 5 つのメトリック条件を定義できます。 AND 論理演算子を使用する場合、ルールをトリガーするには、これらの条件をすべて満たす必要があります。 OR 論理演算子を使用する場合、ルールをトリガーするために必要な条件は 1 つのみです。

   

   動的メトリック が通常のメトリック ( fs.{device}.free with cpu.usedなど) と結合されている場合、各デバイスのメトリックは CPU メトリックと 1 つずつ結合されます。 結果として、動的メトリックのメトリック・パターンが単一ホストの 3 つのデバイスに一致する場合、同時に最大 3 つのアクティブな問題を確認できます。これらの問題は、それぞれ以下のメトリックに関連しています。

   • fs./dev/first.free および cpu.used
   • fs./dev/second.free および cpu.used
   • fs./dev/third.free および cpu.used

5. イベントの範囲を定義する：

   通常、アプリケーションまたはシステム・ランドスケープ内のすべてのエンティティーでイベントをトリガーする必要はありませんが、イベントを特定のエンティティー・セットに制限する必要があります。 範囲を使用して、イベントを評価するエンティティーを定義できます。

   • アプリケーション・パースペクティブ ： アプリケーション・パースペクティブを参照します。
   • 選択された対象: 動的フォーカス照会 を定義します (DFQ.md)。 イベントを評価する際に、このクエリーに一致するエンティティーのみが対象となります。
   • 選択されたエンティティー (タグによるホストの範囲指定): タグが一致するホスト・エンティティーのみが考慮されます。 タグは、ホスト上で実行されているエンティティーではなく、ホスト上で定義する必要があります。
   • 使用可能なすべてのエンティティー: 制限はありません。アプリケーションまたはシステム・ランドスケープ内のすべてのエンティティーでイベントが評価されます。

   制限: アプリケーションを明示的に選択するかまたは DFQ を使用し、特定のアプリケーションの範囲を使用してサービスまたはエンドポイントに対してカスタム・イベントが定義される場合、問題検出はその範囲内のサービスとエンドポイントに適用されます。 ただし、選択された各サービスまたはエンドポイントの KPI は、範囲内のアプリケーションのコンテキストで行われる呼び出しのみではなく、エンティティー全体に対する呼び出しに基づいています。 したがって、範囲はエンティティーを選択する目的でのみ使用されますが、使用する KPI には影響しません。

6. 一時的なイベントの設定（任意）：多くのイベントは、何らかの対応を行う前に、数分以内に自然に解消されます。 ノイズを低減するため、 Instana は過去のパターンに基づいて、こうした短時間のイベントを潜在的な過渡現象として特定します。 ユーザーはイベントビューでそれらを除外するように設定できます。 この機能はデフォルトで有効になっています。

   • 機能の有効化または無効化 ：トグルスイッチを使用して、機能を有効または無効にします（デフォルト： enabled）。

   • 過渡現象の閾値を設定する ：過渡現象として認識される条件を定義する時間範囲（分または時間単位）を選択します。 イベントの継続時間がこの閾値未満と予測される場合、そのイベントは一時的なものとみなされます。 この閾値は、ある問題に対処する必要があると判断するまでに、どれくらいの期間待つことができるかを示しています。

   • 通知の動作を選択してください ：

     • 直ちにアラートを送信する ：イベントが開始されるとアラートがトリガーされます。 これは通常のイベントにおけるデフォルトの動作です。

     • しきい値を超えた後もイベントが継続する場合にのみアラートを送信します。一時的なものと見込まれるイベントについては、アラートは抑制されます。 イベントがしきい値を超える時間続いた場合、アラートが送信されます。 それ以外の場合、閾値の範囲内で終了すればアラートは発動されず、一時的な問題による不要な通知を減らすことができます。

   注： 一時的なイベント検出機能を有効にしても、イベントは生成されません。 その代わりに、この機能は既存のイベントを一時的なものとして識別・分類するため、それらのフィルタリングや分析に役立ちます。 詳細については、FAQセクションの 「設定の概要」 をご覧ください。
7. 新しいカスタム・イベントを保存するため、「作成」をクリックします。