Hata Ayıklama ve Loglar

Gerçekte ne olduğunu öğrenin: hatalar nereye kaydediliyor ve kabuktan nasıl okunur. Sessiz bir sayfa çoğu zaman eksik değil, yakalanmış bir hatadır.

Genel Bakış

Hatalar kendiliğinden görünmez. Hepsi, çağıranın ne göreceğine karar veren tek bir işleyiciden geçer. Bu bir HTML hata sayfası, bir JSON hata gövdesi ya da teşhisler kapalıysa hiçbir şey olabilir. Her durumda hata, hata günlüğüne yazılır ve okuduğunuz şey o günlüktür.

Ekranda mesaj olmaması size neredeyse hiçbir şey söylemez; günlük her şeyi söyler.

Ön Koşullar

• Üzerinde çalıştığınız kurulumda teşhislerin açık olması.
• Sitenin çalıştığı PHP'nin aynısına kabuk erişimi. Araç HTTP üzerinden 404 döner; yalnızca komut satırı aracıdır.

Adım Adım

Genel Görünümle Başlayın

1. php coremio/errlog.php stats çalıştırın.
2. Ölümcül ve hata sayılarını, bir de son yirmi dört saati okuyun. Sıçrayan sayı, bakılacak yerdir.
3. Komut işe yarar bir şey göstermiyorsa loglama kapalıdır ya da depolama dizini yazılabilir değildir. Önce onu düzeltin.

Hatayı Bulun

1. Son kayıtları php coremio/errlog.php list --limit=10 ile listeleyin ya da --level=FATAL ile daraltın.
2. Her kayıt bir imza, bir sayaç, dosya ve satır ile en son görülme zamanını taşır.
3. Birini php coremio/errlog.php show <imza> ile açın: tam kayıtta istek ve yığın vardır.

Bildirilen Kimliği İzleyin

1. Bir kullanıcıya ya da API çağıranına ulaşan hata, bir hata kimliği taşır.
2. php coremio/errlog.php find <kimlik> ile arayın.
3. O tek olayın kaydını alırsınız; kullanıcı bildirimini üzerinde çalışılabilir kılan şey budur.

Referans

Tek giriş noktası, sekiz komut. Argümanlar sıralıdır, seçenekler herhangi bir sırada --ad=değer biçimindedir. Komutun okumadığı seçenek yok sayılır.

İki sıralı argüman birbirinin yerine geçmez. İmza, bir çağrı noktasının 32 karakterlik parmak izidir ve her list satırının altında görünür. Hata kimliği ise hatayla karşılaşan kişiye gösterilen kısa koddur. İkisi de büyük küçük harf duyarsız eşleştirilir; birini diğerinin yerine vermek biçim kontrolüne takılır.

Seçenekler

Yazan Taraf

CLI'nin okuduğu her şey bu iki sınıf üzerinden yazıldı. İki yazma metodu da find komutunun geri aldığı hata kimliğini döndürür.

// coremio/classes/MioException.php
public static function getInstance(): MioException;
public function logError(string $message, array $context = [], string $level = 'ERROR', string $type = 'system'): string;
public function logDatabaseError(string $query, string $error, array $params = []): string;
public function sanitizeData(array $data): array;

// coremio/classes/Logger.php
public function log(string $level, string $message, array $context = [], string $type = 'system'): string;
public static function stats(): array;
public static function entries(array $filters = [], int $start = 0, int $limit = 50, array $sort = []): array;
public static function entriesCount(array $filters = []): int;
public static function cleanup(int $daysToKeep = 30, ?int $cutoffTimestamp = null, string $type = 'system'): int;
public static function deleteOne(string $signature): bool;
public static function rebuild(): int;

list komutunun arkasındaki filtre dizisi, CLI'nin açtığından fazlasını kabul eder. Bilinmeyen bir anahtar yok sayılır, yani bir yazım hatası sonucu daraltmaz, sessizce genişletir.

Sıralama dizisi ['field' => 'last_seen', 'order' => 'desc'] biçimindedir. İşe yarayan alanlar last_seen, first_seen, count ve level; sonuncusunda sıralama alfabeye göre değil ciddiyete göre yapılır.

Bir Hata Nasıl Görünür

Örnek

# Önce sağlık: düşen bir şey var mı?
php coremio/errlog.php stats

# En son beş ölümcül hata
php coremio/errlog.php list --level=FATAL --limit=5

# Yalnız tek bir alt sistemden çıkanlar, onarlık ikinci sayfa
php coremio/errlog.php list --file=modules/Servers --limit=10 --offset=10

# Yalnız veritabanı hataları
php coremio/errlog.php list --type=database --limit=5

# Tek bir imzanın tam kaydı
php coremio/errlog.php show f05bc1f49d2963a58a7c378dc3430c48

# Kullanıcı bir hata kimliği bildirdi; o olayı ara
php coremio/errlog.php find 25EE72D6527

# Düzeltilen imzayı at, kalanı bir haftaya kırp
php coremio/errlog.php delete f05bc1f49d2963a58a7c378dc3430c48 --force
php coremio/errlog.php cleanup --days=7 --force

# Log dosyaları elle taşındıktan ya da silindikten sonra yeniden dizinle
php coremio/errlog.php rebuild

Aynı kayıtlar PHP'den. Yazmanın döndürdüğü kimlik, CLI'nin geri okuduğu kimliktir.

// Yazma: `errlog.php find` komutuna vereceğiniz kimliği döndürür.
$id = MioException::getInstance()->logError(
    'Provisioning refused by the panel',
    ['service_id' => 41, 'response' => $body],
    Logger::LEVEL_ERROR,
    Logger::TYPE_SYSTEM
);

// Okuma: `errlog.php list` komutunun bastığı satırların aynısı.
$rows = Logger::entries(
    ['levels' => [Logger::LEVEL_FATAL], 'file' => 'modules/Servers'],
    0,
    10,
    ['field' => 'count', 'order' => 'desc']
);

foreach ($rows as $row)
    echo $row['signature'], '  x', (int) ($row['count'] ?? 1), '  ',
         $row['file'] ?? '-', ':', (int) ($row['line'] ?? 0), '  ',
         $row['message_preview'] ?? '', PHP_EOL;

// Toplamlar: total, system, database, fatal, error, warning, info,
// last_24h, occurrences ve seviyeye göre ayrılmış recent[].
$health = Logger::stats();

Tuzaklar

İlgili Makaleler

• Geliştirme Ortamı Kurulumu
• Hata Yönetimi
• Kod Konvansiyonları
• Çekirdek Yükseltmesini Atlatma