Simple Log Service:,

Prasyarat

• Project dan Logstore telah dibuat. Untuk informasi lebih lanjut, lihat Kelola Project dan Kelola Logstore.

• Jika Anda menggunakan pengguna Resource Access Management (RAM) alih-alih Akun Alibaba Cloud, Anda harus memberikan izin untuk menulis data ke Logstore kepada pengguna RAM tersebut. Untuk memberikan izin ini, Anda harus terlebih dahulu membuat kebijakan kustom lalu memberikan izin kepada pengguna RAM.

Prosedur

Langkah 1: Tambahkan file konfigurasi Log4j2

1. Tambahkan dependensi ke proyek Maven Anda.

   <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>

2. Ubah file konfigurasi.

   Secara default, Log4j2 mencari file konfigurasi di classpath. Jika file tidak ada, buat secara manual. Contoh berikut menggunakan log4j2.xml. Dua appender didefinisikan untuk mengeluarkan log ke console dan file app.log. Tingkat logger root diatur ke error dengan output ke console. Logger bernama com.example.demo.log diatur ke warn dengan output ke file. Untuk informasi lebih lanjut tentang mengonfigurasi Log4j2, lihat dokumentasi resmi di Log4j – Configuring Log4j 2 (apache.org).

   <!-- status="WARN" mengatur status internal Log4j 2 itu sendiri, bukan logging aplikasi. Digunakan untuk menangkap dan melaporkan potensi masalah selama proses konfigurasi. -->
   <Configuration status="WARN">
       <!-- Start: Definisikan dua appender untuk output log -->
       <Appenders>
           <!-- Mendefinisikan appender console bernama "Console". Log dicetak ke output sistem standar. -->
           <Console name="Console" target="SYSTEM_OUT">
               <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss:SSS zzz} [%t] %-5level %logger{36} - %msg%n"/>
           </Console>
           <!-- Mendefinisikan appender file bernama "MyFile". Log ditulis ke file "app.log". -->
           <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: Definisikan dua appender untuk output log -->
       <!-- Start: Konfigurasikan perilaku logger -->
       <Loggers>
           <!-- Mendefinisikan logger bernama "com.example.demo.log" dan mengatur tingkatnya ke warn. Logger ini mereferensikan appender "MyFile", artinya log pada tingkat warn ke atas dari logger ini dikirim ke "MyFile". -->
           <Logger name="com.example.demo.log" level="warn">
               <AppenderRef ref="MyFile" />
           </Logger>
           <!-- Mendefinisikan logger root dan mengatur tingkatnya ke error. Logger ini mereferensikan appender "Console", artinya log pada tingkat error ke atas dikirim ke console. -->
           <Root level="error">
               <AppenderRef ref="Console" />
           </Root>
       </Loggers>
       <!-- End: Konfigurasikan perilaku logger -->
   </Configuration>

3. Gunakan logger.

   Tulis kode uji untuk mendapatkan instance logger dan menghasilkan log:

       public void logExampleDemo() {
           // Dapatkan instance logger bernama "com.example.demo.log".
           Logger logger = LogManager.getLogger("com.example.demo.log");
           // Catat pesan log pada berbagai tingkat.
           logger.trace("trace level");
           logger.debug("debug level");
           logger.info("info level");
           logger.warn("warn level");
           logger.error("error level");
           logger.fatal("fatal level");
       }

4. Contoh output log:

   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

Langkah 2: Kumpulkan log Log4j

Langkah 3: Lihat log

1. Masuk ke Konsol Simple Log Service.

2. Pada bagian Projects, klik Project yang diinginkan.

   

3. Pada tab Log Storage > Logstores, klik logstore yang diinginkan.

   

4. Verifikasi bahwa data log telah diunggah. Di Logstore, klik Consumption Preview untuk melihat log secara cepat. Untuk informasi lebih lanjut, lihat Query and analysis quick start.

5. Kueri dan analisis log.

   Penting

   Setelah log diunggah ke Logstore, Anda harus membuat indeks sebelum dapat melakukan kueri dan analisis. Untuk informasi tentang konfigurasi indeks, lihat Create indexes.

   Masukkan pernyataan kueri, lalu klik Last 15 Minutes untuk menentukan rentang waktu. Berikut contoh log:

   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__: yyy

   Kueri dan analisis log pada halaman Logstore.

   Masukkan pernyataan kueri untuk melihat, mencari, dan memfilter data log. Untuk informasi lebih lanjut, lihat Query and analyze logs. Contoh:

   • Kueri tiga lokasi teratas dengan error terbanyak dalam satu jam terakhir.

     level: ERROR | select location ,count(*) as count GROUP BY  location  ORDER BY count DESC LIMIT 3

   • Hitung jumlah log untuk setiap tingkat log dalam 15 menit terakhir.

     | select level ,count(*) as count GROUP BY level ORDER BY count DESC

Pemecahan Masalah

Jika pengumpulan log gagal setelah Anda mengonfigurasi appender Log4j2, periksa penyebab umum berikut.

Dokumen Terkait

• Untuk mempelajari cara menggunakan Logtail mengumpulkan log dari server, lihat Collect text logs from servers. Berbagai plugin tersedia untuk pemrosesan. Untuk informasi lebih lanjut, lihat Data parsing plugins.

• Jika halaman pratinjau kosong atau tidak ada data yang muncul di halaman kueri setelah menggunakan Logtail untuk mengumpulkan log, lihat Troubleshoot Logtail collection errors. Kesalahan seperti kegagalan parsing regex, path file salah, atau traffic melebihi kapasitas shard dapat terjadi. Untuk melihat kesalahan pengumpulan Logtail, lihat How do I view Logtail collection errors?. Untuk kesalahan pengumpulan data umum, lihat Common collection errors.

• Untuk kasus penggunaan dan pertanyaan umum (FAQ) tentang mengumpulkan log Log4j dengan appender Log4j2, lihat Log4j2 Appender. Untuk versi sebelumnya, lihat Log4j Appender.

• Saat menggunakan appender Log4j2 untuk mengumpulkan log Log4j, Anda harus mengonfigurasi accessKeyId dan accessKeySecret Anda. Untuk informasi cara memperolehnya, lihat Create an AccessKey. Untuk mengonfigurasi titik akhir Simple Log Service, lihat Service endpoint.