Simple Log Service:Troubleshooting masalah kelompok mesin Logtail (skenario host)

Contoh instalasi kelompok mesin

Daftar periksa troubleshooting

1. Langkah 1: Verifikasi bahwa Logtail berjalan di server.

2. Langkah 2: Pastikan alamat IP dalam kelompok mesin sesuai dengan alamat IP yang diperoleh oleh Logtail. Ketidaksesuaian menyebabkan kegagalan heartbeat.

3. Langkah 3: Periksa apakah wilayah proyek yang dikonfigurasi dalam file ilogtail_config.json sudah benar.

4. Langkah 4: Verifikasi konektivitas jaringan antara server dan proyek.

5. Langkah 5: Periksa apakah waktu sistem pada server Logtail sudah benar. Jika waktu sistem menyimpang signifikan dari waktu aktual, perbarui waktu tersebut.

6. Langkah 6: Untuk pengumpulan cross-account, jika server bukan Instance ECS atau Instance ECS dan proyek berada dalam Akun Alibaba Cloud yang berbeda, verifikasi bahwa pengenal pengguna telah dikonfigurasi.

7. Langkah 7: Untuk kelompok mesin berbasis pengenal kustom, jika kelompok mesin menggunakan pengenal kustom, verifikasi bahwa pengenal kustom telah dikonfigurasi di server.

8. Langkah 8: Setelah menyelesaikan perubahan di atas, restart Logtail.

Langkah selanjutnya

Jika log masih belum terkumpul setelah status heartbeat menjadi OK, lakukan troubleshooting berdasarkan pesan error Logtail. Untuk informasi lebih lanjut, lihat Cara melihat error pengumpulan Logtail.

Langkah 1: Verifikasi bahwa Logtail berjalan sebagaimana mestinya

1. Ambil nilai bidang ip dari file app_info.json.

   Jalur default ke file ini pada sistem yang berbeda tercantum dalam tabel berikut:

   Sistem operasi	Logtail	Jalur ke app_info.json
   Linux	Logtail (64-bit)	/usr/local/ilogtail/app_info.json
   Windows (64-bit)	Logtail (64-bit)	C:\Program Files\Alibaba\Logtail\app_info.json
   	Logtail (32-bit)	C:\Program Files (x86)\Alibaba\Logtail\app_info.json
   Windows (32-bit)	Logtail (32-bit)	C:\Program Files\Alibaba\Logtail\app_info.json

   Logtail mencatat alamat IP yang diperoleh dalam bidang ip file app_info.json.

   {
     "UUID" : "",
     "hostname" : "iZ8vbdlzf******azuhZ",
     "instance_id" : "E9633380-***********-00163E1AA597_172.16.2.200_166****11",
     "ip" : "172.**.**.200",
     "logtail_version" : "1.3.1",
     "os" : "Linux; 4.19.91-26.1.al7.x86_64; #1 SMP Tue Jul 26 17:52:28 CST 2022; x86_64",
     "update_time" : "2022-12-27 05:38:33"
   }

2. Verifikasi bahwa kelompok mesin menggunakan alamat IP yang diperoleh oleh Logtail.

   Kelompok mesin Simple Log Service mencakup kelompok mesin berbasis alamat IP dan kelompok mesin berbasis pengenal kustom. Untuk informasi lebih lanjut, lihat Kelompok mesin.

   • Kelompok mesin berbasis alamat IP: Verifikasi bahwa bidang IP Address berisi alamat IP dari langkah sebelumnya.

     Jika alamat IP tidak sesuai, konfirmasi alamat IP yang benar dari host tersebut. Jika kotak teks IP Address berisi alamat IP yang berbeda untuk host tersebut, seperti Alamat IP publik, perbarui alamat IP dalam kelompok mesin. Jika alamat IP yang diperoleh dalam langkah sebelumnya salah, ubah parameter working_ip dalam parameter startup Logtail dan restart Logtail. Kemudian, pantau heartbeat mesin. Jika heartbeat pulih, troubleshooting selesai.

   • Kelompok mesin berbasis pengenal kustom: Periksa apakah Machine Group Status mencakup alamat IP yang diperoleh dalam langkah sebelumnya. Jika status heartbeat menunjukkan OK, troubleshooting selesai.

File ilogtail_config.json menyimpan parameter startup Logtail.

1. Login ke server tempat Logtail diinstal.

2. Temukan file ilogtail_config.json.

   Jalur default ke file ini pada sistem yang berbeda tercantum dalam tabel berikut:

   Sistem operasi	Logtail	Jalur ke ilogtail_config.json
   Linux	Logtail (64-bit)	/usr/local/ilogtail/ilogtail_config.json
   Windows (64-bit)	Logtail (64-bit)	C:\Program Files\Alibaba\Logtail\ilogtail_config.json
   	Logtail (32-bit)	C:\Program Files (x86)\Alibaba\Logtail\ilogtail_config.json
   Windows (32-bit)	Logtail (32-bit)	C:\Program Files\Alibaba\Logtail\ilogtail_config.json

   1. Buka file ilogtail_config.json dan verifikasi bahwa parameter konfigurasinya sudah benar.

      {
        "config_server_address" : "http://logtail.<config_region>.log.aliyuncs.com",
        "data_server_list" :
        [
          {
            "cluster" : "<project region>",
            "endpoint" : "<endpoint>"
          }
        ],
        ...
      }

      • Jika parameter startup dalam file ilogtail_config.json sesuai dengan deskripsi dalam tabel berikut, maka parameter startup Logtail sudah benar.

      • Jika parameter startup Logtail salah, perbarui file ilogtail_config.json berdasarkan tabel berikut dan restart Logtail. Untuk detailnya, lihat Restart Logtail.

        Untuk informasi wilayah proyek, lihat Wilayah yang didukung.

        Skenario	Jenis jaringan	<config_region>	<endpoint>
        Server adalah Instance ECS di wilayah yang sama dengan proyek	Jaringan internal Alibaba Cloud	<project region>-intranet	<project region>-intranet.log.aliyuncs.com
        Skenario lainnya	Internet	<project region>	<project region>.log.aliyuncs.com
        	Transfer acceleration		log-global.aliyuncs.com

Agar Logtail dapat mengunggah data, server harus dapat terhubung ke alamat-alamat berikut.

1. Alamat yang ditentukan oleh bidang config_server_address dalam file ilogtail_config.json dan versi HTTPS-nya.

2. http://<project name>.<endpoint>.

   • Lihat nama proyek dan wilayah seperti di bawah ini.

     

   • <endpoint> adalah alamat yang ditentukan oleh bidang data_server_list.endpoint dalam file ilogtail_config.json.

3. http://ali-<project region>-sls-admin.<endpoint>. Di sini, <endpoint> adalah alamat yang ditentukan oleh bidang data_server_list.endpoint dalam file ilogtail_config.json.

Lakukan pemeriksaan dan solusi berikut:

Linux

1. Login ke server tempat Logtail diinstal.

2. Jalankan perintah date untuk melihat waktu sistem.

   Wed Dec 28 06:59:26 UTC 2022

   Jika waktu sistem menyimpang signifikan dari waktu aktual, lakukan salah satu tindakan berikut.

   • Sesuaikan waktu sistem ke waktu aktual.

   • Jika Anda tidak dapat mengubah waktu sistem, tambahkan item konfigurasi "enable_log_time_auto_adjust": true ke file ilogtail_config.json. Setelah memodifikasi file, restart Logtail. Untuk detailnya, lihat Restart Logtail. Untuk jalur file ilogtail_config.json, lihat Langkah 3: Verifikasi parameter startup Logtail.

Windows

1. Login ke server tempat Logtail diinstal.

2. Periksa waktu di taskbar di pojok kanan bawah desktop.

   • Sesuaikan waktu sistem ke waktu aktual.

   • Jika Anda tidak dapat mengubah waktu sistem, tambahkan item konfigurasi "enable_log_time_auto_adjust": true ke file ilogtail_config.json. Setelah memodifikasi file, restart Logtail. Untuk detailnya, lihat Restart Logtail. Untuk jalur file ilogtail_config.json, lihat Langkah 3: Verifikasi parameter startup Logtail.

Langkah 6: Verifikasi pengenal pengguna untuk pengumpulan cross-account

Periksa file pengenal pengguna di direktori yang ditentukan. Jika hasilnya kosong, verifikasi apakah file pengenal pengguna ada di jalur yang ditentukan. Pengenal pengguna mengonfirmasi bahwa akun memiliki izin untuk mengakses server.

• Jika tidak ada file pengenal pengguna di jalur yang ditentukan atau file tersebut salah konfigurasi, selesaikan masalah sebagai berikut.

  • Linux: Jalankan perintah cd /etc/ilogtail/users/ && touch <uid> untuk membuat file pengenal pengguna. Ganti <uid> dengan ID akun Alibaba Cloud dari proyek.

  • Windows: Buka direktori C:\LogtailData\users\ dan buat file kosong bernama <uid>. Ganti <uid> dengan ID akun Alibaba Cloud dari proyek.

• Jika file bernama ID akun Alibaba Cloud dari proyek saat ini ada di jalur yang ditentukan, pengenal pengguna telah dikonfigurasi dengan benar.

Langkah 7: Verifikasi pengenal kustom untuk kelompok mesin berbasis pengenal kustom

Jika Anda menggunakan kelompok mesin berbasis pengenal kustom, periksa file user_defined_id di direktori yang ditentukan untuk memverifikasi apakah pengenal kustom telah dikonfigurasi di server.

• Jika hasilnya kosong, periksa apakah file user_defined_id ada dan apakah berisi pengenal kustom tersebut.

  Catatan

  Jalur ke file user_defined_id:

  • Linux: /etc/ilogtail/user_defined_id

  • Windows: C:\LogtailData\user_defined_id

  • Jika file user_defined_id tidak ada, buat file bernama user_defined_id dan masukkan pengenal kustom dari kelompok mesin tersebut. Untuk detailnya, lihat Mengonfigurasi pengenal kustom.

  • Jika file user_defined_id tidak berisi pengenal kustom atau pengenal tersebut salah, tambahkan baris baru dan masukkan pengenal kustom dari kelompok mesin tersebut. Untuk detailnya, lihat Mengonfigurasi pengenal kustom.

  • Jika file user_defined_id sudah berisi pengenal kustom yang Anda tetapkan untuk kelompok mesin tersebut, pengenal kustom telah dikonfigurasi dengan benar.

Langkah 8: Restart Logtail

Setelah menyelesaikan perubahan di atas, restart Logtail.