Mengumpulkan log Apache Tomcat

Dokumen ini menjelaskan cara menyerap log Apache Tomcat ke Google Security Operations menggunakan Bindplane. Parser mengekstrak kolom dari log berformat JSON, lalu mengubahnya menjadi Model Data Terpadu (UDM). Fungsi ini menginisialisasi nilai default, mengurai payload JSON, menangani potensi kesalahan penguraian JSON, dan memetakan berbagai kolom dari log mentah ke kolom UDM yang sesuai, termasuk metadata, principal, observer, dan informasi hasil keamanan, sekaligus menambahkan label kustom untuk konteks lingkungan.

Sebelum memulai

Pastikan Anda memenuhi prasyarat berikut:

• Instance Google SecOps
• Host Windows 2016 atau yang lebih baru, atau host Linux dengan systemd
• Jika dijalankan di belakang proxy, port firewall terbuka
• Apache Tomcat versi 9.0.70 atau yang lebih baru
• Akses tulis ke $CATALINA_BASE/conf dan $CATALINA_BASE/logs

Mendapatkan file autentikasi penyerapan Google SecOps

1. Login ke konsol Google SecOps.
2. Buka Setelan SIEM > Agen Pengumpulan.
3. Download File Autentikasi Penyerapan. Simpan file dengan aman di sistem tempat BindPlane akan diinstal.

Mendapatkan ID pelanggan Google SecOps

1. Login ke konsol Google SecOps.
2. Buka Setelan SIEM > Profil.
3. Salin dan simpan ID Pelanggan dari bagian Detail Organisasi.

Instal agen BindPlane di server Tomcat untuk mengumpulkan file log

Instal agen Bindplane di sistem operasi Windows atau Linux Anda sesuai dengan petunjuk berikut.

Penginstalan Windows

1. Buka Command Prompt atau PowerShell sebagai administrator.

2. Jalankan perintah berikut:

   msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
   

Penginstalan Linux

1. Buka terminal dengan hak istimewa root atau sudo.

2. Jalankan perintah berikut:

   sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
   

Referensi penginstalan tambahan

Untuk opsi penginstalan tambahan, lihat panduan penginstalan.

Mengonfigurasi agen BindPlane untuk menyerap Syslog dan mengirimkannya ke Google SecOps

1. Akses file konfigurasi:
   • Cari file config.yaml. Biasanya, file ini berada di direktori /etc/bindplane-agent/ di Linux atau di direktori penginstalan di Windows.
   • Buka file menggunakan editor teks (misalnya, nano, vi, atau Notepad).

2. Edit file config.yaml sebagai berikut:

   receivers:
       filelog/tomcat:
       include: [ /path/to/tomcat/logs/access-log.*.json ]
       start_at: beginning
   
   exporters:
       chronicle/chronicle_w_labels:
           compression: gzip
           # Adjust the path to the credentials file you downloaded in Step 1
           creds_file_path: '/path/to/ingestion-authentication-file.json'
           # Replace with your actual customer ID from Step 2
           customer_id: <customer_id>
           endpoint: malachiteingestion-pa.googleapis.com
           # Add optional ingestion labels for better organization
           log_type: 'TOMCAT'
           raw_log_field: body
           ingestion_labels:
   
   service:
       pipelines:
           logs/source0__chronicle_w_labels-0:
               receivers:
                   - filelog/tomcat
               exporters:
                   - chronicle/chronicle_w_labels
   

   • Ganti /path/to/tomcat/logs.
   • Ganti <customer_id> dengan ID pelanggan yang sebenarnya.
   • Perbarui /path/to/ingestion-authentication-file.json ke jalur tempat file autentikasi disimpan di bagian Dapatkan file autentikasi penyerapan Google SecOps.

Mulai ulang agen Bindplane untuk menerapkan perubahan

• Untuk memulai ulang agen Bindplane di Linux, jalankan perintah berikut:

  sudo systemctl restart bindplane-agent
  

• Untuk memulai ulang agen Bindplane di Windows, Anda dapat menggunakan konsol Services atau memasukkan perintah berikut:

  net stop BindPlaneAgent && net start BindPlaneAgent
  

Mengonfigurasi Log Akses JSON di Tomcat

1. Buka file Tomcat di $CATALINA_BASE/conf/server.xml.

2. Temukan tag <Host> dan tambahkan kode ini di dalamnya:

   <Valve className="org.apache.catalina.valves.JsonAccessLogValve"
         directory="logs"
         prefix="access-log"
         suffix=".json"
         rotatable="true"
         maxDays="7"/>
   

3. Mulai ulang Tomcat untuk menerapkan perubahan:

   cd /path/to/tomcat
   bin/catalina.sh stop
   bin/catalina.sh start
   

4. File log JSON baru akan muncul setiap hari (misalnya, logs/access-log.2025-07-02.json).

Tabel pemetaan UDM

Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.