イベントを使用してManagement Agentを監視(2026/09/24)

9月 23, 2026

イベントを使用してManagement Agentを監視(2026/09/24)

https://blogs.oracle.com/observability/use-management-agent-events-to-monitor-agents

投稿者：Goutham V | Software Engineer

Piyush Modi | Director, Software Engineering

運用チームは、OCI イベントサービスと管理エージェントを使用することで、エージェントの手動監視から、重要なライフサイクル変更に関するタイムリーな通知とイベント駆動型の自動化へと移行できます。OCI イベントルールを使用すると、新しいエージェントイメージが利用可能になったとき、アップグレードが完了または失敗したとき、エージェントがサイレント状態になったとき、またはエージェントの可用性が変更されたときに、チームに通知が届きます。

Management Agentは、Oracle Cloud Infrastructureのサービスであり、OCIとエージェントがインストールされている環境との間で低遅延の対話型通信とデータ収集を提供し、顧客が運用データを収集し、ホスト、コンパートメント、プラットフォームを横断するエージェントベースの統合を管理できるようにします。

OCI Events サービスは、リソースの状態変化に基づいて自動化を作成します。イベントがルールに一致すると、Events はそれを Notifications、Streaming、または Functions にルーティングできます。管理エージェントの場合、これによりチームはコンソールを手動で確認したり、カスタムのポーリングジョブを作成したりする代わりに、重要なライフサイクルイベントに関する最新情報をタイムリーに受け取ることができます。

Management Agentイベントとは何ですか？

Management Agentイベントは、エージェントまたはエージェントイメージのライフサイクルにおける重要な変更を記述する、サービスによって生成されるメッセージです。これらのイベントは、管理者が運用上の変更が発生した際に迅速に対応するのに役立ちます。

新しいManagement Agentまたは管理ゲートウェイのイメージが利用可能になったら、管理者に通知します。
Management Agentのアップグレードが正常に完了したことを確認してください。
Management Agentが長期間サイレント状態のままであり、自動削除される危険性がある場合、オペレーターに通知します。
Management Agentのアップグレードが失敗した場合は、管理者に通知します。
レポートManagement Agentの可用性遷移（アクティブからサイレント、またはサイレントからアクティブなど）。
OCI Functionsを使用して選択したイベントを自動化プロセスにルーティングするか、OCIストリーミングを使用して下流プロセッサにルーティングします。

よくある最初のユースケースは、メール通知です。たとえば、最新のLinux Management Agentイメージが利用可能になったとき、またはエージェントの状態がアクティブからサイレントに変わったときにメールを送信するルールを作成できます。

OCIイベントサービスがManagement Agentと連携する方法

Management Agentサービスは、サポートされているライフサイクル変更が発生するとイベントを発行します。OCIイベントサービスは、選択されたコンパートメント内のルールに基づいてイベントを評価します。イベントが構成済みのサービス、イベントタイプ、およびオプション属性に一致する場合、イベントサービスはペイロードを構成済みのアクションに送信します。

行動には以下が含まれます。

OCI通知トピックに関するメール購読などの通知。
ストリーミングは、イベントを大規模に処理する下流の消費者に向けたものです。
自動化または修復ワークフローのための機能。

ルールを作成する前に、必要なIAMポリシーが設定されていること、および通知トピックやサブスクリプションなどのアクションリソースが既に存在していることを確認してください。すべてのイベントルールには、少なくとも1つのアクションが必要です。

Management Agentイベントの種類

イベント	いつ使うべきか
Management Agent - 新バージョンが利用可能になりました	新しいManagement Agentまたは管理ゲートウェイのイメージが利用可能になった際に、チームに通知します。
Management Agent – アップグレード版	このイベントは、エージェントがあるバージョンから別のバージョンに移行したことを確認するものです。
Management Agent – 削除保留中	サイレントエージェントが自動的に削除される前に、チームに警告を発する。
Management Agent - アップグレード失敗	エージェントのアップグレードが失敗した場合に、チームに通知し、失敗の詳細を含めます。
Management Agent - 利用可能状況が変更されました	エージェントがアクティブ状態からサイレント状態に移行したとき、またはサイレント状態からアクティブ状態に移行したときに、チームに通知します。

イベントペイロードには、eventType、eventTime、source、compartmentId、resourceId、resourceNameなどの共通フィールドが含まれます。各イベントには、そのイベント固有の詳細情報も含まれています。

属性フィルタは、状態、バージョン、プラットフォーム、エラーコード、削除前日数など、イベント固有のフィールドに基づいて追加できます。サポートされている管理エージェントイベント属性の完全なリストについては、「管理エージェントイベントの使用」を参照してください。

前提条件

イベントルールを作成する前に、以下の前提条件を満たしてください。

ユーザーグループがイベントルールを管理し、選択したアクションリソースを使用する権限を持っていることを確認してください。
OCI通知トピックを作成または特定します。
そのトピックに関する購読サービス（メール購読など）を作成してください。
OCI Notificationsから送信されたメールで購読を確認してください。購読が確認されるまで、通知は保留状態となります。
ルールを作成するコンパートメントを特定します。イベントは、そのコンパートメントおよび子コンパートメント内のリソースからのメッセージを評価します。

シンプルな通知ワークフローの場合、アクションリソースは通常、メール購読が設定されたOCI通知トピックになります。

詳細については、「イベントの前提条件」をご確認ください。

イベントルールの設定手順

エージェントがアクティブでなくなったことをオペレーターに通知したい場合は、この例を使用してください。

OCIコンソールで、[オブザーバビリティと管理]に移動し、[イベントサービス]の下にある[ルール]を選択します。
目的のコンパートメントで「ルールの作成」を選択します。
表示名を入力してください（例：）ManagementAgent Silent Event。
条件セクションで、イベントタイプとサービス名として「管理エージェント」を選択します。
イベントタイプには、目的のイベントタイプを選択してください。例：管理エージェント - 可用性ステータスが変更されました。
関連する属性フィルター（例： previousstate=）を追加しますActive。
アクションセクションで、「通知」を選択し、購読している必要なトピックを選択します。
「ルールの作成」を選択します。

一致するエージェントの状態が「アクティブ」から「サイレント」に変わると、OCI Events サービスはトピックに通知を送信します。ペイロードにはpreviousstate、currentstate、silent、since、遷移の説明が含まれる場合があります。

簡略化されたペイロードは次のようになります。

クリップボードにコピーされました

エラー: コピーできませんでした

{
  "eventType": "com.oraclecloud.managementagent.agentavailabilitystatuschanged",
  "source": "managementagent",
  "eventTime": "2025-07-02T13:14:31Z",
  "data": {
    "compartmentId": "<compartment_ocid>",
    "resourceName": "my-management-agent",
    "resourceId": "<management_agent_ocid>",
    "additionalDetails": {
      "previousstate": "Active",
      "currentstate": "Silent",
      "silentsince": "2025-07-02T12:27:19.605Z",
      "description": "Agent availability has moved from Active to Silent",
      "referencedoc" : "https://docs.oracle.com/iaas/management-agents/index.html",
      "eventcategory" : "WARNING",
    }
  }
}

通知の受信と使用

メール購読機能を使用している場合、OCI Notificationsはルールがイベントに一致した際にメールを送信します。件名にはOCIイベント通知とイベントの種類が示され、メッセージ本文にはイベントのペイロードが含まれます。

通知から、オペレーターは以下の情報を特定できます。

ルールをトリガーしたイベントの種類
イベントに関連するコンパートメントとリソース
Management Agent名とOCID
イベント時間
バージョン、プラットフォーム、状態、削除予定日、エラーメッセージなどのイベント固有の詳細情報

運用ワークフローでは、同じイベントルールパターンを他のアクションタイプにも適用できます。たとえば、アップグレード失敗イベントをインシデントを作成する関数に送信したり、すべてのエージェント可用性イベントをストリームに送信して一元処理したりできます。

まとめ

Management Agentイベントを使用すると、定期的なチェックからイベント駆動型の操作へと簡単に移行できます。管理エージェントイベントタイプをOCIイベントルールおよび通知トピックと組み合わせることで、重要なエージェントライフサイクル変更が発生した際に適切なチームにアラートを送信できます。新しいエージェントイメージの可用性やアクティブからサイレントへの移行など、重要なイベントについてはメール通知から始め、その後、同じイベントフローを関数による自動化やストリーミングによる下流処理へと拡張できます。

このブログを検索

Oracle Cloud Infrastructure Blog(翻訳)