Simple Log Service：Kumpulkan log Log4j

Prasyarat

• Proyek dan logstore telah dibuat. Untuk informasi lebih lanjut, lihat Buat sebuah proyek dan Buat sebuah logstore.

• Jika Anda menggunakan Pengguna Resource Access Management (RAM) alih-alih akun Alibaba Cloud, Pengguna RAM harus memiliki izin untuk menulis data ke logstore tertentu. Untuk memberikan izin, pertama-tama buat kebijakan kustom, lalu berikan izin kepada Pengguna RAM.

Prosedur

Langkah 1: Tambahkan file konfigurasi Log4j2 ke proyek

1. Tambahkan dependensi ke proyek Maven.

   <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, sistem mencari file konfigurasi di jalur classpath. Jika file konfigurasi tidak ada, Anda harus membuat file tersebut secara manual. Dalam contoh berikut, dua appender didefinisikan dalam file log4j2.xml. Appender tersebut digunakan untuk mengeluarkan log ke Simple Log Service dan file app.log, masing-masing. Tingkat log dari root logger didefinisikan sebagai ERROR, dan log dikeluarkan ke Simple Log Service. Tingkat log dari logger bernama com.example.demo.log didefinisikan sebagai WARN, dan log dikeluarkan ke file app.log. Untuk informasi lebih lanjut tentang cara mengonfigurasi Log4j2, lihat Log4j - Configuring Log4j 2 (apache.org).

   !" -- status="WARN". Status internal Log4j2. Parameter ini tidak digunakan untuk menangkap dan melaporkan masalah potensial selama konfigurasi.  -->
   <Configuration status="WARN">
       <! -- Definisikan dua appender  mulai  -->
       <Appenders>
           <! -- Definisikan appender bernama Console untuk mencetak log ke output standar sistem.  -->
           <Console name="Console" target="SYSTEM_OUT">
               <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss:SSS zzz} [%t] %-5level %logger{36} - %msg%n"/>
           </Console>
           <! -- Definisikan appender bernama MyFile untuk mencetak log 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>
       <! -- Definisikan dua appender   selesai  -->
   
       <!-- Konfigurasikan logger      mulai  -->
       <Loggers>
           <! -- Definisikan logger bernama com.example.demo.log dan atur tingkat log menjadi TRACE. Logger com.example.demo.log merujuk pada appender MyFile. Logger mengeluarkan log yang tingkatnya adalah TRACE dan lebih tinggi ke appender MyFile.  -->
           <Logger name="com.example.demo.log" level="warn">
               <AppenderRef ref="MyFile" />
           </Logger>
           <!-- Definisikan root logger dan atur tingkat log menjadi ERROR. Root logger merujuk pada appender Console. Logger mengeluarkan log yang tingkatnya adalah ERROR dan lebih tinggi ke konsol Simple Log Service.  -->
           <Root level="error">
               <AppenderRef ref="Console" />
           </Root>
       </Loggers>
       <!-- Konfigurasikan logger      selesai  -->
   </Configuration>

3. Mulai mengeluarkan log.

   Tulis kode uji untuk membaca appender yang telah didefinisikan dan mengeluarkan log. Contoh kode:

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

4. Contoh kode berikut memberikan contoh keluaran log:

   2024-05-28 13:37:16:295 CST [http-nio-8080-exec-8] TRACE com.example.demo.log - tingkat trace
   2024-05-28 13:37:16:296 CST [http-nio-8080-exec-8] DEBUG com.example.demo.log - tingkat debug
   2024-05-28 13:37:16:296 CST [http-nio-8080-exec-8] INFO  com.example.demo.log - tingkat info
   2024-05-28 13:37:16:296 CST [http-nio-8080-exec-8] WARN  com.example.demo.log - tingkat warn
   2024-05-28 13:37:16:296 CST [http-nio-8080-exec-8] ERROR com.example.demo.log - tingkat error
   2024-05-28 13:37:16:296 CST [http-nio-8080-exec-8] FATAL com.example.demo.log - tingkat fatal

Langkah 2: Kumpulkan log Log4j ke Simple Log Service

Langkah 3: Lihat log

1. Masuk ke Konsol Simple Log Service.

2. Di bagian Proyek, klik yang ingin Anda kelola.

   

3. Pada tab Log Storage > Logstores, klik logstore yang ingin Anda kelola.

   

4. Periksa apakah log telah diunggah ke logstore. Panduan untuk pencarian dan analisis log di logstore. Kemudian, klik Consumption Preview untuk melihat log.

   

5. Cari dan analisis log

   Penting

   Setelah log diunggah ke logstore, Anda harus membuat indeks untuk mencari dan menganalisis log. Untuk informasi lebih lanjut, lihat Buat indeks. Untuk informasi tentang cara membuat indeks, lihat Buat indeks.

   Masukkan pernyataan pencarian di kotak pencarian, klik Last 15 Minutes, lalu tentukan rentang waktu pencarian.

   Contoh kode berikut memberikan contoh log:

   tingkat: ERROR
   lokasi: com.aliyun.openservices.log.log4j.example.Log4jAppenderExample.main(Log4jAppenderExample.java:16)
   pesan: log error
   pengecualian: java.lang.RuntimeException: xxx
   thread: main
   waktu: 2018-01-02T03:15+0000
   log: 0 [main] ERROR com.aliyun.openservices.log.log4j.example.Log4jAppenderExample - log error
   __source__: xxx
   __topic__: yyy

   Cari dan analisis log di halaman logstore.

   

   Anda dapat memasukkan pernyataan pencarian untuk melihat, mencari, dan memfilter data log. Untuk informasi lebih lanjut, lihat Cari dan analisis log. Pernyataan berikut disediakan sebagai contoh.

   • Cari tiga lokasi tempat kesalahan paling banyak terjadi dalam satu jam terakhir.

     tingkat: ERROR | select lokasi ,count(*) as jumlah GROUP BY lokasi ORDER BY jumlah DESC LIMIT 3

   • Cari jumlah log di setiap tingkat log yang dihasilkan dalam 15 menit terakhir.

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

Referensi

• Untuk informasi tentang cara menggunakan Logtail untuk mengumpulkan log dari server, lihat Kumpulkan log teks dari server. Beberapa Plugin tersedia. Untuk informasi lebih lanjut, lihat Plugin asli: Pemrosesan Data (Mode Regex).

• Jika halaman pratinjau kosong atau halaman kueri tidak menampilkan data saat Anda menggunakan Logtail untuk mengumpulkan log, Anda dapat memecahkan masalah tersebut dengan mengikuti petunjuk yang diberikan dalam topik Apa yang harus saya lakukan jika terjadi kesalahan saat saya menggunakan Logtail untuk mengumpulkan log?. Jika Anda menggunakan Logtail untuk mengumpulkan log, kesalahan mungkin terjadi. Sebagai contoh, ekspresi reguler mungkin gagal diproses, jalur file tidak valid mungkin ada, dan lalu lintas mungkin melebihi kemampuan pemrosesan shard. Anda dapat melihat kesalahan pengumpulan Logtail dengan mengikuti petunjuk yang diberikan dalam topik Bagaimana cara saya melihat kesalahan pengumpulan Logtail?. Untuk informasi tentang kesalahan umum dalam pengumpulan data, lihat Bagaimana cara saya memecahkan masalah kesalahan umum yang mungkin terjadi saat Simple Log Service mengumpulkan log?.

• Untuk informasi tentang studi kasus dan pertanyaan yang sering diajukan (FAQ) tentang penggunaan Log4j2 appenders untuk mengumpulkan log Log4j, lihat Log4j2 Appender. Untuk informasi tentang studi kasus dan FAQ tentang penggunaan versi Log4j sebelum Log4j2 untuk mengumpulkan log Log4j, lihat Log4j Appender.

• Saat menggunakan Log4j2 appender untuk mengumpulkan log Log4j, Anda harus mengonfigurasi sepasang AccessKey. Untuk informasi tentang cara mendapatkan sepasang AccessKey, lihat Buat sepasang AccessKey. Untuk informasi tentang cara mengonfigurasi Titik akhir yang disediakan oleh Simple Log Service, lihat Titik akhir.