IBM® FileNet Workplace XT günlüğe kaydetme işlevini yönetmek için Apache log4j ürününü kullanır. Günlüğe kayıt sırasında, uygulama etkinliklerine ilişkin bilgiler konsol ya da dosyalar gibi çıkış yerlerine yazılır. Destek ve geliştirme görevlileri, sorunları tanılamak ve çözmek üzere uygulama etkinliklerini çözümlemek için günlük girişlerindeki bilgileri kullanır. Günlüğe kaydetme yalnızca tanılama amacına yöneliktir; güvenlik ya da denetleme izi bilgilerini içermez.
log4j ürünü Workplace XT kuruluşu sırasında kurulur. Varsayılan olarak, kuruluş sırasında günlüğe kaydetme etkin değildir.
Günlüğe kaydetmeyi etkinleştirmek ya da geçersiz kılmak için:
Günlüğe kaydetme ayarlarının yapılandırılması
Örnek log4j.properties dosyası, keyword=value (anahtar sözcük=değer) çiftleri olarak belirtilmiş bir varsayılan seçenekler kümesini içerir. Varsayılanları değiştirmek için log4j.properties dosyasını bir metin düzenleyicisiyle açın, gereken değişiklikleri yapın ve dosyayı saklayın. Günlüğe kaydetme ayarlarını kuruluştan sonra istediğiniz zaman yapılandırabilirsiniz. Günlüğe kaydetme yapılanışı dosyasında yaptığınız değişiklikler otomatik olarak tanınır; uygulamayı ya da uygulama sunucusunu yeniden başlatmanız gerekmez.
Aşağıdaki kısımlarda, dosyada göreceğiniz günlüğe kaydetme seçeneklerinden bazıları hakkında kısaca bilgi verilmektedir. Günlüğe kaydetme seçenekleri hakkında daha fazla bilgi edinmek için Apache web sitesinde (http://apache.org) Logging Project altındaki bilgilere ve Apache günlüğe kaydetme web sitesine (http://logging.apache.org/log4j/) bakın.
Kaydedici
Kaydedici, etkinleştirilen günlüğe kaydetme isteklerini ekleyiciye yazar. log4j.properties dosyasındaki ilk anahtar sözcük kök kaydediciyi tanımlar. Kök kaydedici, sıradüzeninin en üst düzeyindeki kaydedicidir ve genel varsayılan değerleri sağlar; belirtik olarak ayarlanmış seçenekleri olmayan her alt kaydedici, davranışını kök kaydediciden edinir.
Ekleyici
Bir ekleyici yapılandırarak günlük verilerinin nereye yazılacağını belirtebilirsiniz; ekleyici, biçimlenen günlük girişlerini belirlenmiş çıkış hedefine gönderir. Hedef bir dosya ya da konsol olabilir; çıkış Windows olay günlüğüne (event log) yeniden yönlendirilebilir, uzak bir log4j sunucusuna iletilebilir vb. (Tüm çıkış hedefi ve biçimleme seçenekleri için Apache log4j belgelerine bakın.) Tek bir kaydedicinin birden çok ekleyicisi olabilir. Örneğin, çıkışı aynı zamanda hem bir dosyaya, hem de konsola yazabilirsiniz. Hedef sayısının artırılması başarımı olumsuz etkileyebilir.
Workplace XT olanağında, varsayılan olarak iki ekleyici yapılandırılır. Ekleyicilerin biri, günlük verilerini IBM Support Assistant araçları tarafından günlüğü işlemek için kullanılan IBM Common Base Event (CBE) biçiminde yazar; diğer ekleyici, daha çok kullanıcı tarafından okunabilen bir biçimde yazar. Çıkış miktarını azaltmak için bu ikinci ekleyiciyi değiştirebilir ya da tümüyle kapatabilirsiniz.
Düzey
Toplanacak bilgilerin tipini ve miktarını, belirteceğiniz günlüğe kaydetme düzeyi belirler. Toplanan bilgi miktarı ile sistem başarımının olumsuz etkinlenmesi arasında doğrudan bir ilişki vardır.
Workplace XT uygulama günlüğü standart INFO (bilgi), WARN (uyarı), ERROR (hata), FATAL (onarılmaz) düzeylerinin yanı sıra ALL (tümü) ve OFF (kapalı) düzeylerini de destekler. Aşağıdaki çizelge standart düzeyleri kısaca açıklamaktadır; düzeylerle ilgili ek bilgi için Apache log4j belgelerinize bakın.
Düzey | Açıklama |
---|---|
INFO | Uygulamanın ilerleyişini ayrıntılı olmayan bir düzeyde açıklayan bilgi iletilerini ister. |
WARN | Zararlı olabilecek durumların günlüğe kaydedilmesini ister. |
ERROR | Uygulamanın yayınladığı kural dışı durumların günlüğe kaydedilmesini ister. |
FATAL | Uygulama arızasına neden olabilecek çok önemli hata olaylarının günlüğe kaydedilmesini ister. |
Toplanacak bilgi miktarını, belirttiğiniz düzey belirler. Toplanan bilgi miktarı ile sistem başarımının olumsuz etkinlenmesi arasında doğrudan bir ilişki vardır.
Çıkış dosyası biçimi
Ekleyici yapılandırılırken, verilerin yazılacağı biçimi belirtmek için layout anahtar sözcüğünü kullanabilirsiniz. Bir PatternLayout ve ConversionPattern seçersiniz. PatternLayout, günlük girişleri için belirli bir örüntüyü belirtir; ekleyiciye yazılan öğelerin örüntüsünü saptayan ConversionPattern ise, örüntüyü tanımlar. Aşağıdaki örneği inceleyin:
log4j.appender.ErrorOutputFile=org.apache.log4j.RollingFileAppender log4j.appender.ErrorOutputFile.layout=org.apache.log4j.PatternLayout log4j.appender.ErrorOutputFile.layout.ConversionPattern=%d [%t] - %-5p %m\r\n
Bu örnek, aşağıdaki gibi biçimlenmiş bir günlük girişiyle sonuçlanır:
2007-05-31 17:36:12:801 [cwrap] - Document/Checkin ConnectionWrapper.send send.before
Biçimleme seçenekleriyle ilgili ek bilgi için Apache log4j belgelerine bakın.
Çıkışın çözümlenmesi
Destek görevlileri günlük dosyasındaki girişleri inceleyerek uygulama etkinliklerini çözümleyebilir ve uygulamada oluşan sorunları tanılayabilirler. IBM Support Assistant (ISA) araçları ise çözümleme evresini otomatikleştirir. ISA araçları log4j ürününün günlüğe kaydetme çıkışındaki CBE girişlerini kullanır.
Ayrıca, CBE biçimli olmayan günlük girişlerini kendiniz incelemek için, Apache Chainsaw gibi, grafik kullanıcı arabirimi tabanlı bir günlük görüntüleyiciyi kullanabilirsiniz.