Oracle自動診断リポジトリ(ADR)の仕組みと運用ガイド

Oracle Databaseの運用において、エラー解析の効率化は不可欠です。本記事では、診断情報を一元管理する「Oracle自動診断リポジトリ（ADR）」の基本概念から、ADRを用いたトラブルシューティングの効率的な手順までを解説します。

💰 【PR】Oracleエンジニアの市場価値、調べてみませんか？

Oracleのスキルは需要が高く、特定の資格や経験を持っていると年収が大幅にアップするケースがあります。まずはIT専門のエージェントで非公開求人をチェックしてみませんか？

ADR（自動診断リポジトリ）とは

ADR（Automatic Diagnostic Repository）は、データベースの障害やエラーに関連する情報を一元管理するファイルベースのディレクトリ構造です。アラートログ、トレースファイル、ダンプファイルなどが階層的に整理されており、DBAはここを参照することで迅速な状況把握が可能です。

ADRの基点は DIAGNOSTIC_DEST 初期化パラメータで定義され、デフォルトでは $ORACLE_BASE/diag です。

以下のSQLを実行し、現在の設定値を確認します。

-- 現在の診断情報格納先を確認
SHOW PARAMETER DIAGNOSTIC_DEST

ディレクトリは、以下の構成でコンポーネントごとに分類されています。

ADRの詳細なパス情報は、動的パフォーマンスビュー V$DIAG_INFO を使用してSQLから確認できます。

-- ADR関連パスの一覧を表示
SELECT NAME, VALUE FROM V$DIAG_INFO;

-- アラートログの絶対パスのみを取得
SELECT VALUE FROM V$DIAG_INFO WHERE NAME = 'Diag Alert';

ADRの操作には専用のコマンドラインツール adrci（Automatic Diagnostic Repository Command Interpreter）を使用します。

診断先ホームの確認
adrci> show homes
アラートログの閲覧
# 全表示
adrci> show alert # ORAエラーの抽出
adrci> show alert -p "message_text like '%ORA-%'"
古い診断情報の削除（領域解放）不要なファイルが蓄積するとディスクを圧迫するため、定期的な削除が必要です。
# 1440分（24時間）経過した古いデータを削除
adrci> purge -age 1440

障害発生時は、以下の順序で調査を進めるのが定石です。

Q1. ADRのデータ削除は安全ですか？

A. はい。adrci の purge コマンドを使用すれば、整合性を保ちながら古い情報を削除できます。手動で rm コマンドを実行することは非推奨です。

Q2. DIAGNOSTIC_DESTを変更する影響は？

A. 変更すると新規ログはその先に出力されます。運用中に変更する場合は、OS上の権限設定とディレクトリ作成を事前に済ませる必要があります。

Q3. ログが非常に大きいです。どうすればよいですか？

A. adrci で古い情報をパージしてください。それでも大きい場合は、トレースファイルの出力レベル（SQL_TRACE等）が過剰になっていないか見直す必要があります。

本記事は Oracle Database 19c を対象に解説します（他バージョンは画面や既定値が異なる場合があります）。

💰 【PR】Oracleエンジニアの市場価値、調べてみませんか？