Simple Log Service:Kumpulkan event Docker

Batasan

• Logtail dapat berjalan dalam kontainer atau pada host dan memerlukan izin untuk mengakses file /var/run/docker.sock.

  Untuk mengumpulkan log Kubernetes, lihat Kumpulkan log Kubernetes. Untuk mengumpulkan log kontainer standar, lihat Kumpulkan log kontainer Docker (standard output dan file).

• Logtail tidak dapat mengumpulkan event kontainer saat sedang restart atau berhenti.

Skenario

• Pantau event start dan stop semua kontainer serta segera picu alert jika kontainer inti berhenti.

• Kumpulkan semua event kontainer untuk keperluan audit, analitik keamanan, dan troubleshooting.

• Pantau semua event pull image dan segera picu alert jika image ditarik dari path yang tidak sah.

Prosedur

1. Masuk ke Konsol Simple Log Service.

2. Pada bagian Import Data, pilih Custom Data Plug-in.

3. Pilih proyek dan Logstore tujuan, lalu klik Next.

4. Pada langkah Machine Group Configurations, konfigurasikan kelompok mesin.

   1. Konfigurasikan parameter Scenario dan Installation Environment sesuai kebutuhan.

      Penting

      Anda harus mengonfigurasi parameter Scenario dan Installation Environment terlepas dari apakah kelompok mesin tersedia atau tidak. Pengaturan parameter ini memengaruhi konfigurasi selanjutnya.

   2. Pastikan kelompok mesin ditampilkan di bagian Applied Server Groups, lalu klik Next.

      Kelompok mesin tersedia

      Pilih kelompok mesin dari bagian Source Machine Group.

      

      Tidak ada kelompok mesin yang tersedia

      Klik Create Machine Group. Pada panel Create Machine Group, konfigurasikan parameter-parameter tersebut. Anda dapat mengatur parameter Machine Group Identifier menjadi IP Address atau Custom Identifier. Untuk informasi selengkapnya, lihat Buat kelompok mesin berbasis pengenal kustom atau Buat kelompok mesin berbasis alamat IP.

      Penting

      Jika Anda menerapkan kelompok mesin segera setelah membuatnya, status heartbeat kelompok mesin mungkin menunjukkan FAIL. Masalah ini terjadi karena kelompok mesin belum terhubung ke Simple Log Service. Untuk mengatasinya, Anda dapat mengklik Automatic Retry. Jika masalah tetap berlanjut, lihat Apa yang harus saya lakukan jika tidak ada koneksi heartbeat yang terdeteksi pada Logtail?

5. Pada tab Data Source Settings, atur Configuration Name dan Plug-in Configuration, lalu klik Next.

   • inputs wajib diisi dan digunakan untuk mengonfigurasi pengaturan sumber data pada konfigurasi Logtail.

     Penting

     Anda hanya dapat menentukan satu jenis sumber data dalam inputs.

   • processors bersifat opsional dan digunakan untuk mengonfigurasi pengaturan pemrosesan data pada konfigurasi Logtail guna mengurai data. Anda dapat menentukan satu atau beberapa metode pemrosesan.

     Jika log Anda tidak dapat diurai hanya berdasarkan pengaturan inputs, Anda dapat mengonfigurasi processors pada kolom Plug-in Configuration untuk menambahkan plugin guna pemrosesan data. Misalnya, ekstraksi field, ekstraksi waktu log, masking data, dan filter log. Untuk informasi selengkapnya, lihat Plugin Logtail untuk pemrosesan data.

   {
     "inputs": [
       {
         "detail": {},
         "type": "service_docker_event"
       }
     ]
   }

   Parameter	Type	Required	Description
   type	string	Yes	Jenis sumber data. Tetapkan nilainya ke service_docker_event.
   EventQueueSize	int	No	Ukuran antrian buffer event. Nilai default: 10. Gunakan nilai default kecuali Anda memiliki kebutuhan khusus.

6. Buat indeks dan pratinjau data. Lalu, klik Next. Secara default, indeks teks penuh diaktifkan di Simple Log Service. Anda juga dapat membuat indeks bidang secara manual untuk log yang dikumpulkan atau klik Automatic Index Generation. Setelah itu, Simple Log Service akan menghasilkan indeks bidang. Untuk informasi selengkapnya, lihat Buat indeks.

   Penting

   Jika Anda ingin melakukan kueri terhadap semua field dalam log, kami sarankan menggunakan indeks teks penuh. Jika Anda hanya ingin melakukan kueri terhadap field tertentu, kami sarankan menggunakan indeks bidang. Hal ini membantu mengurangi trafik indeks. Jika Anda ingin menganalisis field, Anda harus membuat indeks bidang. Anda harus menyertakan pernyataan SELECT dalam pernyataan kueri Anda untuk analisis.

7. Klik Query Log untuk menuju halaman Query & Analysis untuk Logstore tersebut.

   Anda mungkin perlu menunggu sekitar satu menit hingga indeks berlaku. Setelah itu, Anda dapat melihat log yang dikumpulkan pada tab Raw Logs. Untuk informasi selengkapnya, lihat Panduan cepat untuk kueri dan analisis log.

Troubleshooting

Jika tidak ada data yang muncul pada halaman pratinjau atau kueri setelah Anda mengonfigurasi Logtail untuk mengumpulkan log, lihat Troubleshoot kegagalan pengumpulan Logtail.

Contoh log

Contoh berikut menunjukkan contoh event Docker.

• Contoh 1: Event pull image

  __source__:  10.10.10.10
  __tag__:__hostname__:  logtail-ds-77brr
  __topic__:  
  _action_:  pull
  _id_:  registry.cn-hangzhou.aliyuncs.com/ringtail/eventer:v1.6.1.3
  _time_nano_:  1547910184047414271
  _type_:  image
  name:  registry.cn-hangzhou.aliyuncs.com/ringtail/eventer

• Contoh 2: Event destroy kontainer di Kubernetes

  __source__:  10.10.10.10
  __tag__:__hostname__:  logtail-ds-xnvz2
  __topic__:  
  _action_:  destroy
  _id_:  af61340b0ac19e6f5f32be672d81a33fc4d3d247bf7dbd4d3b2c030b8bec4a03
  _time_nano_:  1547968139380572119
  _type_:  container
  annotation.kubernetes.io/config.seen:  2019-01-20T15:03:03.114145184+08:00
  annotation.kubernetes.io/config.source:  api
  annotation.scheduler.alpha.kubernetes.io/critical-pod:  
  controller-revision-hash:  2630731929
  image:  registry-vpc.cn-hangzhou.aliyuncs.com/acs/pause-amd64:3.0
  io.kubernetes.container.name:  POD
  io.kubernetes.docker.type:  podsandbox
  io.kubernetes.pod.name:  logtail-ds-44jbg
  io.kubernetes.pod.namespace:  kube-system
  io.kubernetes.pod.uid:  6ddcf598-1c81-11e9-9ddf-00163e0c7cbe
  k8s-app:  logtail-ds
  kubernetes.io/cluster-service:  true
  name:  k8s_POD_logtail-ds-44jbg_kube-system_6ddcf598-1c81-11e9-9ddf-00163e0c7cbe_0
  pod-template-generation:  9
  version:  v1.0

Tabel berikut menjelaskan field log event Docker. Untuk informasi selengkapnya, lihat dokumentasi resmi Docker.