Log4j2 tarafından kaydedilen Java uygulama günlüklerini toplamak ve sorgulama ile analiz için Simple Log Service'e göndermek üzere Log4j2 appender veya Logtail kullanabilirsiniz.
Log4j'a genel bakış
Log4j konsollar, dosyalar, GUI bileşenleri, soket sunucuları, NT olay kayıt cihazları ve UNIX Syslog daemon'ları gibi günlük hedeflerini yapılandırmanıza olanak tanıyan açık kaynaklı bir Apache projesidir. Uygulama kodunu değiştirmeden, yalnızca bir yapılandırma dosyası aracılığıyla her günlük girdisinin çıktı biçimini kontrol edebilir ve günlük düzeylerini tanımlayarak günlük oluşturmayı hassas bir şekilde ayarlayabilirsiniz. Log4j üç bileşenden oluşur:
-
düzenler (layouts)
Düzenler, günlük mesajlarını biçimlendirir. Yaygın düzenler şunlardır:
Düzen
Açıklama
HTMLLayout
Günlükleri HTML tabloları olarak biçimlendirir.
SimpleLayout
INFO düzeyindeki mesajlar için varsayılan biçim gibi basit bir çıktı biçimi kullanır.
PatternLayout
Günlükleri özel bir biçimde çıkarır. Zaman damgası, günlük düzeyi, iş parçacığı adı, sınıf adı, yöntem adı ve günlük mesajı gibi öğelerin sırasını ve biçimini belirtebilirsiniz.
-
ekleyiciler (appenders)
Ekleyiciler, günlük çıktı hedeflerini tanımlar. Yaygın ekleyiciler şunlardır:
Ekleyici
Açıklama
ConsoleAppender
Günlükleri konsola çıkarır.
FileAppender
Günlükleri bir dosyaya çıkarır.
DailyRollingFileAppender
Günlükleri bir dosyaya çıkarır ve her gün yeni bir günlük dosyası oluşturur.
RollingFileAppender
Günlük mesajlarını belirtilen boyuta kadar bir dosyaya çıkarır. Dosya boyut sınırına ulaştığında yeniden adlandırılır ve yeni bir dosya oluşturulur.
JDBCAppender
Günlük mesajlarını bir veritabanına kaydeder.
-
günlükleyiciler (loggers)
Günlükleyici, günlük mesajlarını yakalar ve günlüğe kaydetme için giriş noktası olarak hizmet verir. Her günlükleyiciye önem derecesine göre bir günlük düzeyi atanır. Log4j, öncelik sırasına göre azalan düzende sekiz günlük düzeyi tanımlar: OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE ve ALL. Alt günlükleyiciler, günlük düzeylerini üstlerinden devralır. Aşağıdaki tabloda günlük düzeyleri açıklanmaktadır.
Günlük düzeyi
Açıklama
OFF
Tüm günlüğü kapatır.
FATAL
Uygulamanın çıkmasına neden olacak ciddi bir hata olayını gösterir.
ERROR
Sistemin çalışmaya devam etmesine hala izin verebilecek bir hata olayını gösterir.
WARN
Potansiyel olarak zararlı bir durumu gösterir.
INFO
Uygulamanın ilerlemesini kaba granüler düzeyde vurgular.
DEBUG
Uygulamaların hata ayıklamasında yararlı olan ince granüler bilgiler sağlar.
TRACE
Program yürütmesini izler, değişkenleri çıkarır ve yürütme akışını gösterir.
ALL
Tüm günlük kayıtlarını yazdırır.
Bir günlükleyici birden fazla ekleyiciyle ilişkilendirilebilir ancak bir ekleyici yalnızca bir düzenle ilişkilendirilebilir.
Ön koşullar
Bir Project ve bir Logstore oluşturulmuştur. Daha fazla bilgi için bkz. Projeleri Yönetme ve Logstore'ları Yönetme.
Bir Alibaba Cloud hesabı yerine bir RAM kullanıcısı kullanıyorsanız, RAM kullanıcısına Logstore'a veri yazma izinlerini vermelisiniz. İzinleri vermek için önce özel bir ilke oluşturmanız ve ardından RAM kullanıcısına izin vermeniz gerekir.
Yordam
Bu konudaki örnekler Java ve Log4j2 kullanır. C, C++, .NET ve PL/SQL gibi diğer dillerdeki programlar için de Log4j kullanabilirsiniz. Söz dizimi ve kullanım Java'dakiyle aynıdır.
Adım 1: Log4j2 yapılandırma dosyasını ekleme
-
Maven projenize bağımlılıkları ekleyin.
<dependencies> <dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-api</artifactId> <version>2.23.1</version> </dependency> <dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-core</artifactId> <version>2.23.1</version> </dependency> </dependencies> -
Yapılandırma dosyasını değiştirin.
Varsayılan olarak Log4j2, yapılandırma dosyasını classpath içinde arar. Dosya yoksa manuel olarak oluşturun. Aşağıdaki örnekte log4j2.xml kullanılmaktadır. Günlükleri sırasıyla konsola ve
app.logdosyasına çıkarmak için iki ekleyici tanımlanmıştır. Kök günlükleyici düzeyierrorolarak ayarlanmış ve konsola çıktı verilmiştir.com.example.demo.logadlı günlükleyiciwarnolarak ayarlanmış ve dosyaya çıktı verilmiştir. Log4j2'yi yapılandırma hakkında daha fazla bilgi için Log4j – Log4j 2'yi Yapılandırma (apache.org) adresindeki resmi belgelere bakın.<!-- status="WARN" sets the internal status of Log4j 2 itself, not the application's logging. It is used to capture and report potential issues during the configuration process. --> <Configuration status="WARN"> <!-- Start: Define two appenders for log output --> <Appenders> <!-- Defines a console appender named "Console". Logs are printed to the standard system output. --> <Console name="Console" target="SYSTEM_OUT"> <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss:SSS zzz} [%t] %-5level %logger{36} - %msg%n"/> </Console> <!-- Defines a file appender named "MyFile". Logs are written to the "app.log" file. --> <File name="MyFile" fileName="app.log"> <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss:SSS zzz} [%t] %-5level %logger{36} - %msg%n"/> </File> </Appenders> <!-- End: Define two appenders for log output --> <!-- Start: Configure logger behavior --> <Loggers> <!-- Defines a logger named "com.example.demo.log" and sets its level to warn. It references the "MyFile" appender, which means logs at the warn level and above from this logger are sent to "MyFile". --> <Logger name="com.example.demo.log" level="warn"> <AppenderRef ref="MyFile" /> </Logger> <!-- Defines the root logger and sets its level to error. It references the "Console" appender, which means logs at the error level and above are sent to the console. --> <Root level="error"> <AppenderRef ref="Console" /> </Root> </Loggers> <!-- End: Configure logger behavior --> </Configuration> -
Günlükleyiciyi kullanın.
Bir günlükleyici örneği almak ve günlük oluşturmak için test kodu yazın:
public void logExampleDemo() { // Get the logger instance named "com.example.demo.log". Logger logger = LogManager.getLogger("com.example.demo.log"); // Record log messages at different levels. logger.trace("trace level"); logger.debug("debug level"); logger.info("info level"); logger.warn("warn level"); logger.error("error level"); logger.fatal("fatal level"); } -
Örnek günlük çıktısı:
2024-05-28 13:37:16:295 CST [http-nio-8080-exec-8] TRACE com.example.demo.log - trace level 2024-05-28 13:37:16:296 CST [http-nio-8080-exec-8] DEBUG com.example.demo.log - debug level 2024-05-28 13:37:16:296 CST [http-nio-8080-exec-8] INFO com.example.demo.log - info level 2024-05-28 13:37:16:296 CST [http-nio-8080-exec-8] WARN com.example.demo.log - warn level 2024-05-28 13:37:16:296 CST [http-nio-8080-exec-8] ERROR com.example.demo.log - error level 2024-05-28 13:37:16:296 CST [http-nio-8080-exec-8] FATAL com.example.demo.log - fatal level
Adım 2: Log4j günlüklerini toplama
Log4j2 appender yerleşik bir toplama yöntemidir. Log4j2 ile zaten entegre edilmiş uygulamalar için, günlükleri sunucu diskine yazmadan gerçek zamanlı olarak göndermek üzere minimal yapılandırma gerekir. Bu yöntem, büyük hacimli günlük verilerinin gerçek zamanlı işlenmesini gerektiren büyük veri uygulamaları için uygundur.
Logtail kullanarak günlükleri toplamak için sunucunuza Logtail aracısını yüklemeniz gerekir. Logtail aracısı çeşitli işleme eklentilerini destekler.
Log4j2 appender aracılığıyla
-
Maven projenize bağımlılıkları ekleyin.
<dependency> <groupId>com.google.protobuf</groupId> <artifactId>protobuf-java</artifactId> <version>2.5.0</version> </dependency> <dependency> <groupId>com.aliyun.openservices</groupId> <artifactId>aliyun-log-log4j2-appender</artifactId> <version>0.1.12</version> </dependency> -
Yapılandırma dosyasını değiştirin.
Aşağıdaki örnekte XML yapılandırma dosyası
log4j2.xmlkullanılmaktadır. Dosya yoksa projenin kök dizininde oluşturun.Loghubekleyicisini ve günlükleyiciyi aşağıdaki gibi yapılandırın:<Appenders> <Loghub name="Loghub" project="your project" logStore="your logStore" endpoint="your project endpoint" accessKeyId="your accessKey id" accessKeySecret="your accessKey secret" totalSizeInBytes="104857600" maxBlockMs="0" ioThreadCount="8" batchSizeThresholdInBytes="524288" batchCountThreshold="4096" lingerMs="2000" retries="10" baseRetryBackoffMs="100" maxRetryBackoffMs="100" topic="your topic" source="your source" timeFormat="yyyy-MM-dd'T'HH:mmZ" timeZone="UTC" ignoreExceptions="true"> <PatternLayout pattern="%d %-5level [%thread] %logger{0}: %msg"/> </Loghub> </Appenders> <Loggers> <Root level="warn"> <AppenderRef ref="Loghub"/> </Root> </Loggers>project,Logstore,endpoint,accessKeyIdveaccessKeySecretparametreleri zorunludur. İsteğe bağlı parametreler belirtilmezse varsayılan değerler kullanılır. Aşağıdaki tabloda parametreler açıklanmaktadır.Parametre
Açıklama
project
Simple Log Service'deki Project adınız.
Logstore
Simple Log Service'deki Logstore adınız.
endpoint
Simple Log Service için genel uç nokta. Daha fazla bilgi için bkz. Hizmet uç noktası.
accessKeyId
AccessKey ID. Daha fazla bilgi için bkz. AccessKey Oluşturma.
accessKeySecret
AccessKey gizli anahtarı. Daha fazla bilgi için bkz. AccessKey Oluşturma.
-
Test kodu örneği:
import org.apache.logging.log4j.LogManager; import org.apache.logging.log4j.Logger; public class Log4j2AppenderExample { private static final Logger LOGGER = LogManager.getLogger(Log4j2AppenderExample.class); public static void main(String[] args) throws InterruptedException { LOGGER.trace("log4j2 trace log"); LOGGER.debug("log4j2 debug log"); LOGGER.info("log4j2 info log"); LOGGER.warn("log4j2 warn log"); LOGGER.error("log4j2 error log", new RuntimeException("Runtime Exception")); Thread.sleep(1000 * 5); } }
Logtail aracılığıyla
Logtail'i yapılandırırken dosya yolunu belirtmeniz gerekir. Uygulama günlüklerinin günlük dosyalarına yazılabilmesini sağlayın.
Simple Log Service, Logtail kullanarak metin günlüklerini hızlıca toplamak için bir yapılandırma sihirbazı sağlar. ECS örneğiniz ve Simple Log Service Project'iniz aynı hesap altında ve aynı bölgede ise bkz. Sunuculardan metin günlüklerini toplama. Aksi takdirde bkz. Sunuculardan metin günlüklerini toplamak için Logtail'i manuel olarak yükleme.
Adım 3: Günlükleri görüntüleme
Simple Log Service konsolu üzerinde oturum açın.
-
Projects bölümünde istediğiniz projeyi tıklayın.

-
sekmesinde istediğiniz logstore'u tıklayın.

Günlük verilerinin yüklendiğini doğrulayın. Logstore'da günlükleri hızlıca görüntülemek için Consumption Preview öğesini tıklayın. Daha fazla bilgi için bkz. Sorgulama ve analiz hızlı başlangıcı.
-
Günlükleri sorgulayın ve analiz edin.
ÖnemliGünlükler bir Logstore'a yüklendikten sonra, bunları sorgulayıp analiz edebilmeniz için bir dizin oluşturmanız gerekir. Dizin yapılandırması hakkında bilgi için bkz. Dizin oluşturma.
Bir sorgu ifadesi girin ve ardından bir zaman aralığı belirtmek için Last 15 Minutes öğesini tıklayın. Aşağıda örnek bir günlük gösterilmektedir:
level: ERROR location: com.aliyun.openservices.log.log4j.example.Log4jAppenderExample.main(Log4jAppenderExample.java:16) message: error log throwable: java.lang.RuntimeException: xxx thread: main time: 2018-01-02T03:15+0000 log: 0 [main] ERROR com.aliyun.openservices.log.log4j.example.Log4jAppenderExample - error log __source__: xxx __topic__: yyyLogstore sayfasında günlükleri sorgulayın ve analiz edin.
Günlük verilerini görüntülemek, aramak ve filtrelemek için bir sorgu ifadesi girin. Daha fazla bilgi için bkz. Günlükleri sorgulama ve analiz etme. Örnekler:
-
Son bir saatte en çok hata içeren ilk üç konumu sorgulayın.
level: ERROR | select location ,count(*) as count GROUP BY location ORDER BY count DESC LIMIT 3 -
Son 15 dakikadaki her günlük düzeyi için günlük sayısını sayın.
| select level ,count(*) as count GROUP BY level ORDER BY count DESC
-
Sorun giderme
Log4j2 appender'ı yapılandırdıktan sonra günlük toplama başarısız olursa aşağıdaki yaygın nedenleri kontrol edin.
1. Bağımlılık seçimi
Spring Boot varsayılan olarak Logback kullanır. Uygulamanız Spring Boot kullanıyorsa Log4j2 appender yerine aliyun-log-logback-appender bağımlılığını ekleyin. Uygulamanız Log4j2 kullanıyorsa aliyun-log-log4j2-appender bağımlılığını kullanın.
2. Uç nokta yapılandırması
cn-hangzhou.log.aliyuncs.com gibi doğru genel uç noktayı yapılandırdığınızdan emin olun.
3. AccessKey ID ve AccessKey gizli anahtar izinleri
RAM kullanıcısına AliyunLogFullAccess izninin veya hedef LogStore üzerindeki yazma izinlerinin verildiğinden emin olun.
4. Project ve LogStore adları
Yapılandırmanızdaki Project ve LogStore adlarının Simple Log Service konsolunda gösterilen adlarla eşleştiğinden emin olun.
İlgili belgeler
Logtail kullanarak bir sunucudan günlükleri nasıl toplayacağınızı öğrenmek için bkz. Sunuculardan metin günlüklerini toplama. İşleme için çeşitli eklentiler mevcuttur. Daha fazla bilgi için bkz. Veri ayrıştırma eklentileri.
Logtail kullanarak günlükleri topladıktan sonra önizleme sayfası boşsa veya sorgu sayfasında veri görünmüyorsa bkz. Logtail toplama hatalarını giderme. Regex ayrıştırma hataları, yanlış dosya yolları veya trafiğin parça kapasitesini aşması gibi hatalar oluşabilir. Logtail toplama hatalarını görüntülemek için bkz. Logtail toplama hatalarını nasıl görüntülerim?. Yaygın veri toplama hataları için bkz. Yaygın toplama hataları.
Log4j2 appender ile Log4j günlüklerini toplama kullanım durumları ve sık sorulan sorular (SSS) için bkz. Log4j2 Appender. Daha eski sürümler için bkz. Log4j Appender.
Log4j günlüklerini toplamak için Log4j2 appender kullanırken
accessKeyIdveaccessKeySecretdeğerlerini yapılandırmanız gerekir. Bunları nasıl alacağınız hakkında bilgi için bkz. AccessKey Oluşturma. Simple Log Service uç noktasını yapılandırmak için bkz. Hizmet uç noktası.