‹ Zurück

Oracle ADRCI: Zentrale Verwaltung von Oracle  Logfiles

 

Wenn es um die Wartung und Fehlerdiagnose in Oracle-Datenbanken geht, ist das Tool ADRCI (Automatic Diagnostic Repository Command Interpreter) ein echter Geheimtipp. In diesem Blogbeitrag zeige ich dir, was ADRCI ist, wie du es nutzt und warum es für jeden DBA zur Grundausstattung gehören sollte.

 

🧠 Was ist ADRCI?

ADRCI ist ein Kommandozeilen-Tool, das Teil der Oracle-Diagnoseinfrastruktur ist. Es ermöglicht den Zugriff auf das Automatic Diagnostic Repository (ADR) – ein zentraler Speicherort für alle wichtigen Diagnoseinformationen wie:

 

• Alert-Logs

• Trace-Dateien

• Health Monitor Reports

• Incidents

Seit Oracle 11g ist ADRCI fester Bestandteil der Datenbankarchitektur und ersetzt die frühere manuelle Verwaltung von Logdateien unter $ORACLE_BASE/admin.

 

🚀 Einstieg: So startest du ADRCI

[oracle@localhost ~]$ adrci

ADRCI: Release 23.0.0.0.0 - Production on Sat Nov 15 07:22:43 2025

Copyright (c) 1982, 2025, Oracle and/or its affiliates.  All rights reserved.

ADR base = "/opt/oracle"
adrci> show homes
ADR Homes:
diag/rdbms/free/FREE
diag/clients/user_oracle/RMAN_61728193_116
diag/tnslsnr/localhost/listener
diag/orapwd/localhost/kuzr
adrci> set home diag/rdbms/free/FREE
adrci> help

🔍 Nützliche ADRCI-Kommandos

Wichtig: vorher immer das gewünschte Home auswählen. (show homes, set home ...)

 

# alert log anzeigen
show alert
# alert log mit automatischer Aktualisierung:
adrci> show alert -tail 5 -f
# trace datei anzeigen
show trace /opt/oracle/diag/rdbms/free/FREE/trace/FREE_mz00_13419.trc
# incidents anzeigen
show incident
# logfiles löscchen die älter als 30 Tage sind
purge -age 720

 

📦 Incident Packaging System (IPS)

 

Ein Highlight von ADRCI ist das Incident Packaging System. Damit kannst du alle relevanten Dateien zu einem Fehlerfall bündeln und für den Oracle Support bereitstellen:

ips create package incident [incident #]

 

🧹 Automatisches Löschen mit ADRC

 

Zeigt alle aktuellen Einstellungen an:

adrci> show control

ADR Home = /opt/oracle/diag/rdbms/free/FREE:
*************************************************************************
ADRID                SHORTP_POLICY        LONGP_POLICY         LAST_MOD_TIME                            LAST_AUTOPRG_TIME                        LAST_MANUPRG_TIME                        ADRDIR_VERSION       ADRSCHM_VERSION      ADRSCHMV_SUMMARY     ADRALERT_VERSION     CREATE_TIME                              SIZEP_POLICY         PURGE_PERIOD         FLAGS                PURGE_THRESHOLD
-------------------- -------------------- -------------------- ---------------------------------------- ---------------------------------------- ---------------------------------------- -------------------- -------------------- -------------------- -------------------- ---------------------------------------- -------------------- -------------------- -------------------- --------------------
3311357041           504                  504                  2025-10-27 05:34:38.895790 +00:00                                                                                          1                    2                    116                  1                    2025-10-27 05:34:38.895790 +00:00        18446744073709551615 0                    0                    95

Short Policy auf 30 und Long Policy auf 90 Tage einstellen

 

adrci> set control (SHORTP_POLICY=30)
adrci> set control (LONGP_POLICY=90)
adrci> select SHORTP_POLICY,LONGP_POLICY from ADR_CONTROL;

ADR Home = /opt/oracle/diag/rdbms/free/FREE:
*************************************************************************
SHORTP_POLICY        LONGP_POLICY
-------------------- --------------------
30                   90

 

LONGP_POLICY wird verwendet, um Informationen mit langer Lebensdauer zu löschen. Der Standardwert beträgt 365 Tage.

Diese Richtlinie wird verwendet von:

• ALERT
• INCIDENT
• SWEEP
• STAGE
• HM
•  

SHORTP_POLICY  wird verwendet, um Informationen mit kurzer Lebensdauer zu löschen. Der Standardwert beträgt 30 Tage. 

Diese Richtlinie wird verwendet von:

• TRACE
• CDUMP
• UTSCDMP
• IPS

 

⚠️ Achtung: Häufige Fehler und wichtige Hinweise

 

• Nicht alle Komponenten nutzen ADR: Einige ältere Oracle-Komponenten oder benutzerdefinierte Prozesse schreiben ihre Logs außerhalb des ADR.

• Wichtige Oracle Support Dokumente

  • Adrci Purge Does Not Clear the Text-formatted Alert.Log located in the Trace Folder (Doc ID 751082.1)

  • Why Are My Listener Logs & Traces Not Purged By The ADR? (Doc ID 1438242.1)

• ADR-Pfade prüfen: Wenn du mehrere Oracle-Instanzen oder Homes hast, kann es leicht passieren, dass du im falschen ADR-Home arbeitest.

 

📚 Fazit

ADRCI ist ein mächtiges Werkzeug, das dir hilft, Probleme schnell zu erkennen, zu analysieren und zu beheben. Es bringt Struktur in die Diagnose und ist ein Muss für jeden Oracle-Administrator.

 

Autor: Mark Seidenfaden