データベースイベント参考資料

データベースエージェントは、データベース接続、フェールオーバー、またはデータベース レプリケーションの問題を検出すると、データベースイベントをコントローラに送信します。[Databases] > [Events] ページでイベントの詳細を表示できます。このページには、イベントの概要、トリガーされた時刻、およびデータベースタイプが表示されます。

詳細ビューでは、次の情報を表示できます。

概要
イベントの詳細を表示します。
詳細
イベントのプロパティを表示します。
実行されたアクション
：ポリシーを作成済みの場合は、実行されたアクションを表示します。
注: データベースエージェントからコントローラにデータベースイベントを送信しない場合は、エージェントレベルで dbagent.event.trigger.enabled プロパティを false に設定します。このプロパティは、デフォルトで有効になっています。

データベース イベント

次の表に、カスタム データベース イベントとサポートされるデータベースを示します。

イベント データベース
FAILOVER
  • SQL Server
  • PostgreSQL
  • Oracle
  • MySQL
DB_CONNECTION_DOWN データベースエージェントでサポートされるすべてのデータベースタイプ。「データベースの可視性がサポートされる環境」を参照してください。
DB_CONNECTION_UP データベースエージェントでサポートされるすべてのデータベースタイプ。「データベースの可視性がサポートされる環境」を参照してください。
REPLICATION_FAILURE PostgreSQL
BLOCKING_SESSION
  • SQL Server
  • Oracle
DAYS_SINCE_FULL_BACKUP Oracle
DAYS_SINCE_FULL_BACKUP_PDB Oracle
HOURS_LOG_BACKUP Oracle
BACKUP_SUCCESSFUL Oracle
BACKUP_FAILED Oracle
注: データベースエージェントは次の Oracle データベースアーキテクチャをサポートしています。コンテナデータベース（CDB）>= 12.2 非コンテナデータベース（非 CDB）リアル アプリケーション クラスタ（RAC）データベースエージェントは、Oracle Recovery Manager（RMAN）によって生成されたデータを使用してバックアップイベントをトリガーします。
注: Oracle のバックアップとブロッキング セッション イベントを有効または無効にするには、 Controller Settings > Controller Configurations に移動し、次のプロパティの値を true または falseに変更します。
  • dbagent.oracle.backup.events.enabled
  • dbagent.oracle.blocking.session.event.enabled

カスタム データベース イベントを使用してアラートポリシーを設定できます。「ポリシーの設定」を参照してください。

フェールオーバー

Description：このイベントは、プライマリノードで障害が発生したときにコントローラに送信されます。

データベースタイプ 概要
Oracle

<database-type>, <collector-name> - <database-collector-name> RAC クラスタでフェールオーバーが発生
PostgreSQL

<database-type>、データベースインスタンス <database-instance-name> にフェールオーバーが発生
SQL Server
MySQL

Severity：Error

Custom Event Type：FAILOVER

アラートポリシーの設定時に、[Custom Events] パネルを使用してカスタムイベントフィルタを追加できます。

  1. [+] をクリックして、カスタムイベントタイプを指定します。

  2. 次のプロパティの組み合わせを使用してイベントをフィルタリングします。

    プロパティ 適用可能なデータベース 説明
    availabilityGroupName SQL Server クラスタのアベイラビリティグループ名
    failedNode
    • PostgreSQL
    • Oracle
    • MySQL
    		 障害が発生したノードの名前
    failedAgName SQL Server 機能不全の可用性グループの名前
    failedReplicaHostName SQL Server 機能不全のレプリカホスト名の名前
    failedReplicaID SQL Server 機能不全のレプリカ ID
    port
    • SQL Server
    • PostgreSQL
    • Oracle
    • MySQL
    		 ノードまたは障害が発生したノードのポート
    dbCollectorName
    • SQL Server
    • PostgreSQL
    • Oracle
    • MySQL
    		 データベースコレクタの名前
    databaseType
    • SQL Server
    • PostgreSQL
    • Oracle
    • MySQL
    		 データベースタイプ
    primaryNodesAfterFailover
    • PostgreSQL
    • Oracle
    • MySQL
    		 フェールオーバー後の現在のプライマリノード
    timeStamp
    • SQL Server
    • PostgreSQL
    • Oracle
    • MySQL
    		 イベントがトリガーされた時刻

データベース接続ダウン

Description：このイベントは、コレクタがデータベースとの接続を確立できない場合、または既存の接続が失敗した場合にコントローラに送信されます。クラスタの場合、各ノードの障害は個別のイベントとして送信されます。このイベントは、2 分、4 分、8 分、16 分、32 分など、24 時間については累乗の時間差で報告されます。その後、イベントは 24 時間ごとに報告されます。

ノード 概要
シングル

<database-type>, <database-collector-name, collector-name> で接続に失敗

Cluster

<database-instance-name: node-name> で接続に失敗

Severity：Error

Custom Event Type：DB_CONNECTION_DOWN

アラートポリシーの設定時に、[Custom Events] パネルを使用してカスタムイベントフィルタを追加できます。

  1. [+] をクリックして、カスタムイベントタイプを指定します。

  2. 次のプロパティの組み合わせを使用してイベントをフィルタリングします。

    プロパティ 説明
    dbCollectorName データベースコレクタの名前
    nodeName ノードの名前
    databaseType データベースタイプ
    timeStamp イベントがトリガーされた時刻
    port ノードのポート

データベース接続アップ

Description：このイベントは、DB_CONNECTION_DOWN イベントのトリガー後、データベースが接続されたときにコントローラへ送信されます。

Severity：情報

Custom Event Type：DB_CONNECTION_UP

アラートポリシーの設定時に、[Custom Events] パネルを使用してカスタムイベントフィルタを追加できます。

  1. [+] をクリックして、カスタムイベントタイプを指定します。

  2. 次のプロパティの組み合わせを使用してイベントをフィルタリングします。

    プロパティ 説明
    dbCollectorName データベースコレクタの名前
    nodeName ノードの名前
    databaseType データベースタイプ
    timeStamp イベントがトリガーされた時刻
    port ノードのポート

レプリケーションの失敗

Description：このイベントは、pg_stat_replication テーブルのステータスプロパティが stopping または failed に変更されたときにコントローラに送信されます。

Summary：データベースインスタンス（<database-type>、<database-instance-name>）にレプリケーションエラーが発生

Severity：Error

Custom Event Type：REPLICATION_FAILURE

アラートポリシーの設定時に、[Custom Events] パネルを使用してカスタムイベントフィルタを追加できます。

  1. [+] をクリックして、カスタムイベントタイプを指定します。

  2. 次のプロパティの組み合わせを使用してイベントをフィルタリングします。

    プロパティ 説明
    confl_bufferpin

    バッファ固定に関連する競合が発生した回数を表します。バッファ固定の競合は、複数のトランザクションが同じバッファ（キャッシュページ）に同時にアクセスしようとすると発生します。
    confl_deadlock

    データベースでデッドロック状況が検出された回数を表します。デッドロックは、2 つ以上のトランザクションが相互にロックを解放するのを待機している場合に発生し、循環依存関係が発生します。
    confl_lock

    ロックに関連する競合が発生した回数を表します。ロックの競合は、あるトランザクションが別のトランザクションによってすでに保持されているロックを取得しようとすると発生します。
    confl_snapshot

    同時スナップショットに関連する競合が発生した回数を表します。スナップショットの競合は、あるトランザクションが行へのアクセスを試みたときに、別のトランザクションが同じ行を更新または削除していると発生します。
    confl_tablespace

    テーブルスペースの割り当てに関連する競合が発生した回数を表します。テーブルスペースの競合は、複数のトランザクションが同じテーブルスペース内のスペースを同時に割り当てようとすると発生します。
    conninfo

    WAL 受信機プロセスがプライマリサーバーに接続するために使用する接続文字列。
    databaseType データベースタイプ
    dbCollectorName データベースコレクタの名前
    failedApplicationNode 該当する場合、WAL 受信機プロセスによって使用されるレプリケーションスロット名を表します。レプリケーションスロットは、レプリケーションの進行状況をトラッキングするために使用されます。

    failedNode

    		 ノードの名前
    last_msg_receipt_time スタンバイサーバーがマスターサーバーから受信した最後のメッセージのタイムスタンプを示します。
    last_msg_send_time マスターサーバーからスタンバイサーバーに送信された最後のメッセージのタイムスタンプを示します。
    latest_end_lsn

    スタンバイサーバーで最後に完了した WAL レコードの LSN を示します。これは、最後に適用されたトランザクションの終了を表します。
    latest_end_time

    スタンバイ サーバーで最後に完了したトランザクションのタイムスタンプを示します。
    port ノードのポート
    reason 失敗した理由
    status

    WAL 受信機プロセスの現在のステータスを示します。指定できる値は、次のとおりです。

    • stopped：WAL 受信機が停止しています。
    • streaming：WAL 受信機は、マスターサーバーから WAL データをアクティブにストリーミングしています。
    timeStamp イベントがトリガーされた時刻

ブロッキングセッション

Description：このイベントは、別のセッションによってブロックされているセッションがある場合にコントローラに送信されます。

Severity：Error

Custom Event Type：BLOCKING_SESSION

アラートポリシーの設定時に、[Custom Events] パネルを使用してカスタムイベントフィルタを追加できます。

  1. [+] をクリックして、カスタムイベントタイプを指定します。

  2. 次のプロパティの組み合わせを使用してイベントをフィルタリングします。

    プロパティ 説明
    blockedObject ブロックされたオブジェクト
    blockedSessionId ブロックされたセッションの ID
    blockedSqlStatement ブロックされたクエリテキスト
    blockedSqlStatementHash ブロックされたクエリテキストのハッシュ
    blockingSessionId セッションをブロックしているセッションの ID
    blockingSqlStatementHash ブロックしているクエリテキストのハッシュ
    databaseType データベースタイプ
    dbCollectorName データベースコレクタの名前
    dbInstanceName データベースインスタンスの名前
    duration (hh:mm:ss)

    セッションがブロックされる期間

    eventRuleName

    		 イベントルールの名前
    eventType

    報告されたイベントの名前
    timeStamp イベントがトリガーされた時刻
    violationID 違反の一意の ID

完全バックアップ以降の日数

Description：このイベントは、最後のバックアップから指定された日数が経過したときにコントローラに送信されます。

Severity：次のシビラティタイプに設定できます。

タイプ 説明
警告 警告しきい値を日数で設定します。
クリティカル クリティカルのしきい値を日数で設定します。

Custom Event Type：DAYS_SINCE_FULL_BACKUP

アラートポリシーの設定時に、[Custom Events] パネルを使用してカスタムイベントフィルタを追加できます。

  1. [+] をクリックして、カスタムイベントタイプを指定します。

  2. 次のプロパティの組み合わせを使用してイベントをフィルタリングします。

    プロパティ 説明
    databaseName データベースの名前
    dbCollectorName データベースコレクタの名前
    containerID マルチテナント コンテナ データベース（CDB）内のコンテナの一意の ID
    containerPDBName プラガブルデータベース（PDB）の名前
    eventRuleName イベントルールの名前

    lastBackupTimeStamp

    		 最後のバックアップが作成された時刻
    nodeName ノードの名前
    timeStamp イベントがトリガーされた時刻
    userName ユーザー名
    violationID 違反の一意の ID

完全バックアップ以降の日数（PDB）

Description：このイベントは、Oracle Pluggable Database（PDB）で最後の完全バックアップから指定された日数が経過したときにコントローラに送信されます。このイベントは、マルチテナント コンテナ データベース（CDB）とルートを考慮しません。

Severity：次のシビラティタイプに設定できます。

タイプ 説明
警告 警告しきい値を日数で設定します。
クリティカル クリティカルのしきい値を日数で設定します。

Custom Event Type：DAYS_SINCE_FULL_BACKUP_PDB

アラートポリシーの設定時に、[Custom Events] パネルを使用してカスタムイベントフィルタを追加できます。

  1. [+] をクリックして、カスタムイベントタイプを指定します。

  2. 次のプロパティの組み合わせを使用してイベントをフィルタリングします。

    プロパティ 説明
    databaseName データベースの名前
    dbCollectorName データベースコレクタの名前
    containerID マルチテナント コンテナ データベース（CDB）内のコンテナの一意の ID
    containerPDBName プラガブルデータベース（PDB）の名前
    eventRuleName イベントルールの名前

    lastBackupTimeStamp

    		 最後のバックアップが作成された時刻
    nodeName ノードの名前
    timeStamp イベントがトリガーされた時刻
    userName ユーザー名
    violationID 違反の一意の ID

最後のログバックアップ再試行以降の時間

Description：このイベントは、バックアップが再実行されてから指定された日数が経過したときにコントローラに送信されます。このイベントは、マルチテナント コンテナ データベース（CDB）と非 CDB データベースのみを考慮します。

Severity：次のシビラティタイプに設定できます。

タイプ 説明
警告 警告しきい値を時間単位で設定します。
クリティカル クリティカルのしきい値を時間単位で設定します。

Custom Event Type：HOURS_LOG_BACKUP

アラートポリシーの設定時に、[Custom Events] パネルを使用してカスタムイベントフィルタを追加できます。

  1. [+] をクリックして、カスタムイベントタイプを指定します。

  2. 次のプロパティの組み合わせを使用してイベントをフィルタリングします。

    プロパティ 説明
    databaseName データベースの名前
    dbCollectorName データベースコレクタの名前
    eventRuleName イベントルールの名前

    lastBackupTimeStamp

    		 最後のバックアップが作成された時刻
    nodeName ノードの名前
    timeStamp イベントがトリガーされた時刻
    userName ユーザー名
    violationID 違反の一意の ID

バックアップ成功

Description：このイベントは、CBD、非 CBD、および PDB Oracle データベースのバックアップが完了するとコントローラに送信されます。

Severity：情報

Custom Event Type：BACKUP_SUCCESSFUL

アラートポリシーの設定時に、[Custom Events] パネルを使用してカスタムイベントフィルタを追加できます。

  1. [+] をクリックして、カスタムイベントタイプを指定します。

  2. 次のプロパティの組み合わせを使用してイベントをフィルタリングします。

    プロパティ 説明
    databaseName データベースの名前
    dbCollectorName データベースコレクタの名前
    containerID マルチテナント コンテナ データベース（CDB）内のコンテナの一意の ID
    containerPDBName プラガブルデータベース（PDB）の名前
    eventRuleName イベントルールの名前
    eventType

    報告されたイベントの名前

    lastBackupTimeStamp

    		 最後のバックアップが作成された時刻
    nodeName ノードの名前
    timeStamp イベントがトリガーされた時刻
    userName ユーザー名
    violationID 違反の一意の ID

バックアップに失敗（Backup Failed）

Description：このイベントは、CBD、非 CBD、および PDB データベースのバックアップが失敗するとコントローラに送信されます。このイベントでは、Oracle データベース 19c 以降がサポートされます。

Severity：情報

Custom Event Type：BACKUP_FAILED

アラートポリシーの設定時に、[Custom Events] パネルを使用してカスタムイベントフィルタを追加できます。

  1. [+] をクリックして、カスタムイベントタイプを指定します。

  2. 次のプロパティの組み合わせを使用してイベントをフィルタリングします。

    プロパティ 説明
    databaseName データベースの名前
    dbCollectorName データベースコレクタの名前
    containerID マルチテナント コンテナ データベース（CDB）内のコンテナの一意の ID
    containerPDBName プラガブルデータベース（PDB）の名前
    eventRuleName イベントルールの名前
    eventType

    報告されたイベントの名前

    lastBackupTimeStamp

    		 最後のバックアップが作成された時刻
    nodeName ノードの名前
    timeStamp イベントがトリガーされた時刻
    violationID 違反の一意の ID