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

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

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

Summary: イベントの詳細を表示します。
Details: イベントのプロパティを表示します。
Actions Executed：ポリシーを作成済みの場合は、実行されたアクションを表示します。

データベースエージェントからコントローラにデータベースイベントを送信しない場合は、エージェントレベルで dbagent.event.trigger.enabled プロパティを false に設定します。このプロパティは、デフォルトで有効になっています。

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

イベント	データベース
`FAILOVER`	SQL Server PostgreSQL Oracle MySQL
`DB_CONNECTION_DOWN`	データベースエージェントでサポートされるすべてのデータベースタイプ。「データベースの可視性がサポートされる環境」を参照してください。
`DB_CONNECTION_UP`	データベースエージェントでサポートされるすべてのデータベースタイプ。「データベースの可視性がサポートされる環境」を参照してください。
`REPLICATION_FAILURE`	PostgreSQL

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

Failover

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

データベースタイプ	要約
Oracle	`<database-type>, <collector-name> - <database-collector-name>` RAC クラスタでフェールオーバーが発生
PostgreSQL SQL Server MySQL	`<database-type>`、データベースインスタンス `<database-instance-name>` にフェールオーバーが発生

Severity：Error

Custom Event Type：FAILOVER

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

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

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

プロパティ	説明
`availabilityGroupName` これは、SQL Server データベースにのみ適用されます。	クラスタのアベイラビリティグループ名
`failedNode`	障害が発生したノードの名前
`port`	ノードまたは障害が発生したノードのポート
`dbCollectorName`	データベースコレクタの名前
`databaseType`	データベースタイプ
`primaryNodesAfterFailover`	フェールオーバー後の現在のプライマリノード
`timeStamp`	イベントがトリガーされた時刻

Database Connection Down

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

Node	要約
シングル	`<database-type>, <database-collector-name, collector-name>` で接続に失敗
Cluster	`<database-instance-name: node-name>` で接続に失敗

Severity: エラー

Custom Event Type：DB_CONNECTION_DOWN

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

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

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

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

Database Connection Up

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

Severity: 情報

Custom Event Type：DB_CONNECTION_UP

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

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

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

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

Replication Failure

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

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

Severity：Error

Custom Event Type：REPLICATION_FAILURE

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

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

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

プロパティ	説明
`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`	イベントがトリガーされた時刻