Simple Log Service:Unggah log menggunakan protokol syslog

Batasan

• Protokol syslog harus mematuhi RFC 5424. Untuk protokol syslog lainnya, kami menyarankan Anda mengumpulkan syslog dari server Linux.

• Ukuran maksimum satu log adalah 64 KB.

• Untuk memastikan keamanan transmisi data, data harus ditransmisikan melalui TCP dengan Transport Layer Security (TLS) 1.2.

Konfigurasi

Saat mengunggah log menggunakan protokol syslog, Anda harus mengonfigurasi alamat unggah log dalam format ProjectName.endpoint:SyslogPort, misalnya test-project-1.cn-hangzhou-intranet.log.aliyuncs.com:10009. Pilih titik akhir berdasarkan wilayah tempat proyek Simple Log Service Anda berada. Untuk informasi selengkapnya, lihat Endpoints. Port syslog adalah 10009. Anda juga harus mengonfigurasi informasi proyek, logstore, dan AccessKey Simple Log Service di bidang STRUCTURED-DATA.

Contoh 1: Kumpulkan log dengan syslog-ng

1. Buka file konfigurasi syslog-ng.

   File konfigurasi biasanya berada di /etc/syslog-ng/syslog-ng.conf.

2. Tambahkan konfigurasi berikut ke bagian akhir file konfigurasi syslog-ng.

   ### Syslog-ng Logging Config for LogService ### 
   template LogServiceFormat { 
       template("<${PRI}>1 ${ISODATE} ${HOST:--} ${PROGRAM:--} ${PID:--} ${MSGID:--} [logservice project=\"test-project-1\" logstore=\"test-logstore-1\" access-key-id=\"<yourAccessKeyId>\" access-key-secret=\"<yourAccessKeySecret>\"] $MSG\n"); template_escape(no); 
   }; 
   destination d_logservice{ 
        tcp("test-project-1.cn-hangzhou.log.aliyuncs.com" port(10009) 
        tls(peer-verify(required-untrusted)) 
        template(LogServiceFormat)); 
   }; 
   log { 
        source(s_sys); # default use s_sys 
        destination(d_logservice); 
   }; 
   ### END Syslog-ng Logging Config for LogService ###

3. Restart syslog-ng.

   Jalankan salah satu perintah berikut untuk merestart syslog-ng: sudo /etc/init.d/syslog-ng restart, sudo service syslog-ng restart, atau sudo systemctl restart syslog-ng.

4. Gunakan perintah logger untuk membuat log uji.

   Misalnya, jalankan perintah logger hello world! untuk membuat log.

Contoh log

Setelah log diunggah, Anda harus membuat dan mengonfigurasi indeks untuk melihat log di Konsol Simple Log Service. Untuk informasi selengkapnya, lihat Buat indeks.

FAQ dan troubleshooting

• Uji pengunggahan log

  Anda dapat menggunakan Netcat untuk menguji pengunggahan log. Hal ini membantu memverifikasi konektivitas jaringan dan memeriksa apakah AccessKey memiliki izin unggah yang diperlukan.

  1. Login ke server yang akan digunakan untuk pengujian.

  2. Jalankan perintah berikut untuk menginstal Netcat.

     sudo yum install nmap-ncat

  3. Jalankan perintah berikut untuk terhubung ke Simple Log Service.

     ncat --ssl <yourProject>.<yourEndpoint> 10009

     Contoh:

     ncat --ssl test-project-1.cn-hangzhou.log.aliyuncs.com 10009

  4. Netcat tidak secara otomatis mendeteksi koneksi yang terputus. Dalam waktu 30 detik setelah menjalankan perintah ncat, masukkan log yang ingin dikirim lalu tekan Enter.

     <34>1 2019-03-28T03:00:15.003Z mymachine.example.com su - ID47 [logservice project="<yourProject>" logstore="<yourLogstore>" access-key-id="<yourAccessKeyID>" access-key-secret="<yourAccessKeySecret>"] this is a test message

     Contoh:

     <34>1 2019-03-28T03:00:15.003Z mymachine.example.com su - ID47 [logservice project="trace-doc-test" logstore="doc-test-001-logs" access-key-id="<yourAccessKeyID>" access-key-secret="<yourAccessKeySecret>"] this is a test message

  5. Pratinjau log di Konsol Simple Log Service untuk memverifikasi bahwa pengunggahan berhasil.

     Untuk informasi selengkapnya, lihat Pratinjau log.

     

• Diagnosis error pengumpulan

  Jika pengunggahan log gagal, Anda dapat mendiagnosis error pengumpulan untuk melihat pesan error detail. Untuk informasi selengkapnya, lihat Lihat error pengumpulan Logtail.