Press ESC to close

Oracle ADRCI Essentials: Monitoring, Troubleshooting and Incident Packaging

Oracle veritabanlarında meydana gelen hatalar, performans problemleri ve sistem olayları sırasında birçok tanılama (diagnostic) verisi üretilir. Alert log kayıtları, trace dosyaları, incident raporları, core dump dosyaları ve Health Monitor çıktıları gibi bilgiler, sorun giderme süreçlerinde kritik öneme sahiptir.

Oracle, bu tanılama verilerini merkezi bir yapıda yönetebilmek için Automatic Diagnostic Repository (ADR) yapısını sunmaktadır. ADR içerisinde tutulan verilere erişmek, yönetmek ve Oracle Support için gerekli paketleri oluşturmak amacıyla kullanılan komut satırı aracı ise ADRCI (Automatic Diagnostic Repository Command Interpreter)’dır.

Bu yazıda Oracle DBA’ların günlük operasyonlarda sıklıkla ihtiyaç duyacağı ADRCI komutlarını ve kullanım örneklerini inceleyeceğiz.

ADRCI Nedir?

  • Alert log görüntüleme
  • Trace dosyalarını inceleme
  • Incident ve problem kayıtlarını görüntüleme
  • ADR alanını temizleme
  • Otomatik silme (purge) politikalarını yönetme
  • Oracle Support için IPS paketleri oluşturma

işlemlerini gerçekleştirmemizi sağlayan Oracle tarafından sunulan komut satırı aracıdır.

ADRCI başlatmak için:

adrci

adrci> show alert
DIA-48494: ADR home is not set, the corresponding operation cannot be done

adrci> show base;
No ADR base is set

ORACLE_HOME ve ORACLE_BASE set edilmediyse yukarıdaki gibi bir uarı alıyoruz (DIA-48494: ADR home is not set,)

ADR Base (ADR Ana Dizini) Değiştirme

ADR verilerinin tutulduğu ana dizini görmek için aşağıdaki show base  komut kullanılabilir.set etmek yada değiştirmek için

adrci> set base /u01/app/grid

adrci> show base
ADR base is "/u01/app/grid"

adrci> show alert

Choose the home from which to view the alert log:

1: diag/asm/user_root/host_893029603_110
2: diag/asm/+asm/+ASM8
3: diag/crs/tdb08/crs
4: diag/clients/user_root/host_893029603_110
5: diag/clients/user_grid/host_893029603_110
.....
12: diag/kfod/tndb08/kfod
Q: to quit

ADR Home Bilgilerini Görüntüleme

Sistemde bulunan tüm ADR Home dizinlerini listelemek için:

adrci> show home

diag/rdbms/prod/PROD
diag/asm/+ASM
diag/tnslsnr/server/LISTENER

ADR Home Değiştirme

Belirli bir veritabanı veya bileşenin loglarını incelemek için ilgili ADR Home seçilebilir.

adrci> set homepath diag/rdbms/prod/PROD

Alert Log Görüntüleme

Oracle DBA’ların ADRCI kullanırken en sık yaptığı işlemlerden biri alert log incelemektir.

Tüm alert log içeriğini görüntülemek için: show alert dedğimizde birden fazla alert için liste çıkıyorsa set home ile istediğimizi seçip show alert tekrar dedğimizde onu açacaktır yada alttaki komutlar o şekilde o alert log için çalışacaktır.

adrci> show alert

-- SOn 100 Satırı Görüntülemek için;

adrci> show alert -tail 100

-- Veya Sürekli akışı takip etmek için

adrci> show alert -tail -f

Eski Alert ve Trace Dosyalarını Temizleme

Zaman içerisinde ADR dizinleri ciddi boyutlara ulaşabilir. Özellikle yoğun çalışan sistemlerde trace dosyaları disk alanı tüketimine neden olabilir.

600 dakikadan eski alert kayıtlarını temizlemek için:

adrci> purge -age 600 -type ALERT

--TRACE dosyalarını temizlemek için

adrci> purge -age 600 -type TRACE

--INCIDENT Kayıtlarını temizlemek için

adrci> purge -age 600 -type INCIDENT

-- Core Dump Dosyalarını Temizlemek İçin;

adrci> purge -age 10080 -type CDUMP

Örneğin 30 günden eski trace dosyalarını temizlemek için:

adrci> purge -age 43200 -type TRACE

ADR Otomatik Temizleme (Purge) Politikaları

Oracle, ADR içerisindeki dosyaları belirlenen saklama sürelerine göre otomatik olarak temizleyebilir.

Mevcut ayarları görüntülemek için:

adrci> show control

İki farklı politika bulunmaktadır.

SHORTP_POLICY

Varsayılan değer: 30 Gün 

Aşağıdaki dosya türleri için kullanılır:

  • TRACE
  • CDUMP
  • UTSCDMP
  • IPS

10 gün olarak ayarlamak için:

adrci> set control (SHORTP_POLICY = 240)
adrci> set control (LONGP_POLICY = 600)

LONGP_POLICY

Varsayılan değer: 365 Gün

Aşağıdaki nesneler için kullanılır:

  • ALERT
  • INCIDENT
  • SWEEP
  • STAGE
  • HM (Health Monitor)

Not: Değerler saat cinsinden tanımlanır.

Örneğin 25 gün olarak değiştirmek için:

adrci> set control (LONGP_POLICY = 600)

Incident Paketleri Oluşturma (IPS)

Oracle Support’a SR (Service Request) açıldığında çoğu zaman ilgili incident dosyalarının paylaşılması gerekir.

ADRCI içerisinde yer alan IPS (Incident Packaging Service) özelliği sayesinde gerekli dosyalar otomatik olarak paketlenebilir.

Öncelikle mevcut incident kayıtları görüntülenir:

adrci> show incident

--Belirli bir incident için paket oluşturmak:

adrci> ips create package incident 12345

-- Veya

adrci> ips pack incident 12345 in /tmp

Özel IPS Paketi Oluşturma

Boş bir paket oluşturulabilir:

adrci> ips create package

--Oluşturulan pakete incident eklenebilir:

adrci> ips add incident 12345 package 2

--Alert log veya trace dosyaları da pakete dahil edilebilir:

adrci> ips add file /u01/app/oracle/diag/rdbms/prod/trace/alert_prod.log package 2

Paket oluşturma işlemi:

adrci> ips generate package 2 in /tmp/support

Belirli Tarih Aralığındaki Incident’ları Paketleme

Bakım çalışmaları veya belirli bir zaman aralığında yaşanan sorunlar için kullanılabilir.

Aşağıdaki komut  belirtilen zaman aralığında oluşan incident kayıtlarını tek paket altında toplar.

adrci> ips pack time
'2026-05-01 12:00:00.00'
to
'2026-05-02 23:00:00.00'

IPS Paketlerini Görüntüleme

Mevcut paketleri listelemek için:

adrci> ips show package

--Bir Paket İle İlgili Detaylı bilgi almak için:

adrci> ips show package 12 detail

Bu sayede;

  • Pakette bulunan incident kayıtları
  • Problem anahtarları (Problem Key)
  • Eklenen dosyalar
  • Paket durumu

görüntülenebilir.

IPS Paketini Açma (Unpack)

Daha önce oluşturulmuş bir IPS paketinin içeriğini açmak için:

adrci> ips unpack file ORA_98928.zip into /tmp/ips_review

IPS Paketlerinden Incident veya Problem Silme

Paketi tamamen silmek için:

adrci> ips delete package 2

--Paket içerisinden belirli bir incident kaldırmak için:

adrci> ips remove incident 2 package 7

--Problem kaydını kaldırmak için:

adrci> ips remove problem 4 package 8

DBA’lar İçin Faydalı Öneriler

  • ADR alanının büyümesi düzenli olarak takip edilmelidir.
  • Özellikle Grid Infrastructure ve RAC ortamlarında alert log incelemeleri ADRCI üzerinden yapılmalıdır.
  • Disk alanı sorunlarının önüne geçebilmek için SHORTP_POLICY ve LONGP_POLICY değerleri kurum standartlarına göre gözden geçirilmelidir.
  • Oracle Support’a dosya gönderirken manuel dosya toplamak yerine IPS paketleri kullanılmalıdır.
  • Büyük upgrade ve patch işlemleri sonrasında trace dizinlerinin boyutları kontrol edilmelidir.

Bir yanıt yazın

E-posta adresiniz yayınlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir