アラートの処理
IBM Cloud Logs の管理者として、電子メール、SMS、その他サポートされている配信チャネルを使用して、 IBM Cloud Logs のイベント通知を他のユーザー、または人間の宛先に送信したい場合があります。 さらに、例えば、Webhookを使用したイベント・ドリブン・プログラミングを使用してロジックを作成するために、これらのイベント通知を他のアプリケーションに送信することもできます。 これは IBM Cloud Logs と IBM Cloud Event Notifications の統合によって可能になった。
概要
IBM Cloud Logsでは、通知を受けたいフィルタリングされたデータのトリガー条件を定義するアラートを設定します。 IBM Cloud Event Notificationsでは、アラートの通知先と、イベントがどの通知先にルーティングされるかを定義する条件を設定します。 設定した条件に基づいて、イベントを1つまたは複数の宛先にルーティングすることができます。 WebhookやPagerDuty,のようなサービス宛、またはメールやslackのような人間宛に通知することができます。
次の図は、IBM Cloud Logsで設定したアラートがトリガーされたときに、イベントがルーティングされるさまざまな宛先を示しています:
Event Notificationsにイベントを送信するには、IBM Cloud LogsインスタンスをEvent Notificationsにアウトバウンド・インテグレーションを構成して接続する必要があります。 サービス間認可は、 IBM Cloud Logs サービスが Event Notifications サービスにイベントを送ることを認可するために使用される。 詳細については、 IBM Cloud Logs と IBM Cloud Event Notifications を接続するためのアウトバウンド統合の設定を 参照してください。
IBM Cloud Logs サービスのインスタンスによって生成されたイベントは、同じアカウントまたは異なるアカウント利用可能な Event Notifications サービスインスタンスに転送することができます。
- IBM Cloud Logs インスタンスでは、 IBM Cloud Logs インスタンスと1つの Event Notifications サービスインスタンス間のアウトバウンド統合を構成できます。
- 同じEvent NotificationsインスタンスをIBM Cloudアカウントで、すべてのIBM Cloud Logsインスタンスに使用できます。
- アカウント複数の Event Notifications インスタンスがある場合は、 IBM Cloud Logs インスタンスに近い Event Notifications インスタンスの使用を検討してください。 詳しくは、 Event Notifications 地域を 参照。
IBM Cloud Logs インスタンスで関心のあるイベントが発生すると、 IBM Cloud Logs は接続されている Event Notifications インスタンスと通信し、 サポートされている宛先に 通知を転送します。
IBM Cloud Logsインスタンスでアラートを構成する場合は、以下の情報を考慮してください:
- 標準アラート、フローアラート、新値アラートなど、さまざまなタイプのアラートを定義できます。 サポートされているアラートの種類については、アラート を参照してください。
- ページを使用して、トリガーされたアラートを管理することができます
Incidents詳細については、トリガーされたアラートの管理 を参照してください。 - アラートはIBM Cloud Event Notificationsサービスを通じてトリガーされる。 IBM Cloud Event Notificationsサービスで、アラートをトリガーする通知チャネルと条件を構成します。
次の図は、IBM Cloud Logsインスタンスと、構成する可能性のあるIBM Cloud Event Notificationsサービスの上位ビューを示しています:
エンド・ツー・エンドのアラート設定
IBM Cloud Logsでアラートを設定するには、以下の手順を実行します:
-
IBM Cloud Logsでは、IBM Cloud Event Notificationsサービスを通じてアラートがトリガーされる。 詳細については、 IBM Cloud Logs のアウトバウンド統合の設定を 参照してください。
-
IAMで、IBM Cloud LogsインスタンスとIBM Cloud Event Notificationsインスタンス間の認可をサービスするサービスを定義する。 詳細については、IBM Cloud Event Notificationsサービスで動作するS2S認可を作成する を参照してください。
-
IBM Cloud Logsインスタンスにアウトバウンド統合を設定して、IBM Cloud Event Notificationsインスタンスと接続します。 詳細については、IBM Cloud Event Notificationsサービスとの統合を設定する を参照してください。
このタスクは、IBM Cloud Event Notificationsインスタンスにソース定義を作成し、IBM Cloud Logsインスタンスに統合構成を作成します。
-
IBM Cloud Logsインスタンスでアラートを定義します。 アラートがトリガーされたときに通知する送信統合を選択します。 詳細については、 IBM Cloud Logs のアラートの設定を 参照してください。
-
IBM Cloud Event Notificationsインスタンスを設定して、IBM Cloud Logsでアラートがトリガーされたときにイベント通知をターゲット宛先にルーティングします。
-
1つ以上のトピックを定義する。
トピックは、グループ化するアラート条件を定義します。
例えば、IBM Cloud Logsインスタンスに複数のアラート定義があり、それが同じスラックチャンネルを通して通知される場合、同じトピック内でこれらのアラートを構成することができます。
別の例として、IBM Cloud Logsインスタンスに複数のアラート定義があり、異なるスラックチャンネルを通して通知する場合、使用するスラックチャンネルの数だけトピックを構成し、同じスラックチャンネルを通して通知するアラートをトピックに含める必要があります。
-
1つ以上の目的地を定義します。
宛先は、アラートがトリガーされたときに通知するために使用できる通知チャネルを定義します。
目的地の詳細については、「サポートされている目的地」を参照してください。
-
1つ以上のサブスクリプションを定義します。
サブスクリプションは、1つのトピックと1つの宛先をリンクします。
トピックで構成されたアラートがサブスクリプション構成で選択された宛先を通じて通知されるものであることを定義するには、サブスクリプションを追加する必要があります。
サブスクリプションは1つのトピックと通知チャネルを関連付ける。
同じトピックで複数のサブスクリプションを持つことができるので、複数の配信先チャンネルを通じてアラートを出すことができます。
-
アラートの設定 IBM Cloud Logs
IBM Cloud Logsでアラートを設定する場合、アラートごとに以下の情報を定義します:
- アラートの重大度
- アラートの種類によって簡単にフィルタリングできるラベル。
env:prodようなキーと値のペアでラベルを定義します。 - アラートの種類。 詳細については、アラートの種類 を参照。
- 取り込み時に分析されるデータを定義するフィルター条件。 検索クエリ、1 つまたは複数のアプリケーション、1 つまたは複数のサブシステム、および 1 つまたは複数のログの重大度値を定義できます。
- アラートがいつトリガーされるかを定義する条件。
- 通知に使用する送信統合。
- アラートがアクティブになるスケジュール。
- どのような通知内容を含むのか。
アラートの設定の詳細については、アラートの設定 を参照してください。
アラートの設定 IBM Cloud Event Notifications
IBM Cloud Logs の通知を有効にしたら、 Event Notifications でトピックと購読を作成し、選択した宛先にアラートを転送および配信できるようにする必要があります。
IBM Cloud Event Notificationsでアラートを設定する場合、以下のコンポーネントを定義します:
- Event Notificationsインスタンスから監視されるアラートを定義するトピック。
- イベントがルーティングされる通知チャネルを定義するデスティネーション。
- 宛先チャネルを通じて通知されるアラートを定義するサブスクリプション。
詳しくは、以下を参照してください。
アラート管理ページでアラートを管理する
アラート管理ページを使用して、UIからアラートを管理することができます。
以下の手順を実行して、 アラート管理ページを起動します:
-
IBM Cloud Logs インスタンスに移動します: Observability > Logging > Cloud Logs > Your Service Instance > Open Dashboard.
-
アラート > アラート管理を選択します。
アラート管理
アラート管理ページが開きます。
アラート管理ページでは、以下のタスクを実行できます:
-
アラートの種類、アラートの優先度、ステータスの有効/無効、ラベルによって表示されるアラートをフィルタリングします。
-
クエリーセクションでアラート名で検索できます。
アラート管理クエリ -
アラートの編集、複製、削除、スヌーズができます。
アラート管理はオプションを管理する
インシデントページのアラート監視
インシデントページを使用して、UIを通じてトリガーされるアラートを監視できます。 詳細については、トリガーされたアラートの管理 を参照してください。