お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

アラートの作成と管理

アラートを使用すると、ログ活動を監視し、特定の条件が満たされたときに通知を受け取ることができます。

アラートは、設定されたログクエリーを指定された間隔で実行し、クエリー結果が設定されたしきい値を満たすと通知をトリガーします。

たとえば、失敗したWebhookの実行、失敗したCodeXの実行、通常とは異なるAPI活動を監視するアラートを作成できます。

アラートの作成    

• ［設定］→［ログ監視］→［アラート］
  

• ［ログ監視］→［システムログ］→［アラートの作成］

• 「ログの詳細」ウィンドウで［アラートの作成］をクリック

• 「トレースツリー」ページで［アラートの作成］をクリック
  

ログの詳細ウィンドウまたはトレースツリーページからアラートを作成すると、アラート設定ページが開き、関連するクエリーの詳細があらかじめ入力されます。これにより、選択したログ活動の通知をすばやく設定できます。

ログページから作成されたアラートは、アラートページに自動的に表示されます。

アラートを作成するには、次の手順を実行します。

1. ［設定］→［ログ監視］→［アラート］に移動します。

2. ［新しいアラート］をクリックします。
   

アラートの設定

［アラート名］：アラートの一意の名前を入力します。

［クエリー］：監視するクエリーを設定します。

• クエリーの作成方法は、ログと監視ページでクエリーを作成する場合と同様です。詳しい手順については、ログと監視を参照してください。

• ログページからアラートを作成した場合、選択したクエリーが自動的に入力されます。

［検索］：検索を使用してログページを開き、次の操作を行います。

• クエリーを作成する

• 既存のクエリーを変更する

• クエリーを実行して結果を確認する 

例：ログ期間を過去7日間に設定すると、過去7日間に生成されたログが評価されます。

［実行頻度］：アラートを実行する頻度を定義します。

例：

• 毎時

• 毎日

• 毎週

実行頻度を毎週に設定すると、アラートは週に1回実行され、設定されたログ期間に基づいてログが評価されます。

• ［ログ期間］は、分析するログを決定します。

• ［実行頻度］は、アラートを実行する頻度を決定します。

［しきい値の設定］：アラートをトリガーする条件を定義します。

例：件数 >= 1

クエリーで一致するログレコードが1件以上返されると、アラートがトリガーされます。

［通知チャネル］：アラート通知の配信方法を選択します。

• ［メール］：メールで通知を送信します。

• 既存のメールテンプレートを選択するか、新しいメールテンプレートを作成します。

• メールの件名と本文でアラートのプレースホルダーを使用すると、通知に動的なアラート情報を含めることができます。

• ［Circuit］：Circuitで通知を送信します。

• このオプションを使用すると、次のようなカスタム通知ワークフローを連携できます。

• メッセージアプリケーション

• 顧客通知

• 社内監視ワークフロー

［Circuit］：Circuitでは、利用可能な一覧から必要なCircuitを選択します。

［Circuit入力］：Circuit通知チャネルを選択すると、アラート設定に、Circuit内で使用できるサンプル入力データが表示されます。

指定したCircuit入力がCircuitスキーマ検証で受け入れられることを確認します。

参照データには、次の情報が含まれます。

• アラートのメタデータ：以下のようなアラート設定の詳細が含まれます。

• アラートID

• アラート名

• クエリー

• ログウィンドウ

• 実行頻度

• 設定済みのしきい値

• アラート情報：以下のような実行固有の詳細が含まれます。

• 開始時刻

• 終了時刻

• 一致したログ数

この情報は、Circuit内でアラート通知を処理する際に役立ちます。

保存：［保存］をクリックします。

アラートが作成され、［アラート］ページに表示されます。

アラートの管理   

［アラート］ページには、次の2つのセクションがあります。

• アラートの詳細

• アラート履歴

アラートの詳細   

［アラートの詳細］では、設定済みのアラートを確認、管理できます。

次の情報を確認できます。

• アラート名

• クエリー

• 設定済みのしきい値

• 通知チャネル

• 次回実行時刻

• 最終更新日時

• ステータス（有効または無効） - ステータスの切り替えを使用して、アラートを有効または無効にします。無効なアラートは、再度有効にするまで実行されず、通知も送信されません。

アラート履歴    

［アラート履歴］では、以前にトリガーされたアラートを確認できます。

次の情報を確認できます。

• アラート名

• トリガー時刻

• 設定済みのしきい値

• 一致したログ数

• ログウィンドウ

アラート履歴では、アラートが想定どおりにトリガーされたかを確認でき、過去のアラート活動を把握できます。

トラブルシューティングFAQ

1. アラートがトリガーされないのはなぜですか？   

次の点を確認してください。

• アラートが有効であること。

• 設定済みのクエリーで一致するログが返されること。

• しきい値の条件を満たしていること。

• 選択した通知チャネルが正しく設定されていること。

• 通知チャネルとしてCircuitを選択している場合は、Circuitが有効であり、アラート入力スキーマ（アラートメタとアラート情報）を正しく処理するように設定されていることを確認してください。

想定どおりの結果になるか確認するには、Logs and Monitoringでクエリーを手動実行できます。

2. ログウィンドウと実行頻度の違いは何ですか？   

• ログウィンドウでは、分析対象のログが決まります。

• 実行頻度では、アラートの実行間隔が決まります。

たとえば、7日間のログウィンドウと週次の実行頻度を設定したアラートは、毎週1回実行され、過去7日間のログを評価します。

3. アラート通知が届かないのはなぜですか？   

次の点を確認してください。

• 選択した通知チャネルが有効であること。

• メールテンプレートまたはCircuit設定が正しいこと。

• 設定済みのしきい値に基づいてアラートがトリガーされていること。