Simple Log Service:Troubleshooting masalah kelompok mesin Logtail

Contoh instalasi kelompok mesin

Daftar periksa troubleshooting

1. Langkah 1: Verifikasi bahwa Logtail sedang berjalan: Periksa apakah proses Logtail aktif di server.

2. Langkah 2: Verifikasi bahwa alamat IP kelompok mesin sesuai dengan alamat IP yang diperoleh Logtail: Ketidaksesuaian alamat IP antara kelompok mesin dan file app_info.json Logtail dapat menyebabkan kegagalan heartbeat.

3. Langkah 3: Periksa apakah parameter startup Logtail benar: Pastikan wilayah Proyek yang dikonfigurasi dalam file ilogtail_config.json sudah benar.

4. Langkah 4: Periksa konektivitas jaringan: Pastikan server dapat terhubung ke titik akhir Proyek.

5. Langkah 5: Verifikasi waktu sistem di server Logtail: Jika waktu sistem berbeda signifikan dari waktu aktual, koreksi waktu tersebut.

6. Langkah 6: Verifikasi pengenal pengguna untuk pengumpulan cross-account: Langkah ini diperlukan jika server bukan Instance ECS atau jika instans dan Proyek termasuk dalam Akun Alibaba Cloud yang berbeda.

7. Langkah 7: Verifikasi pengenal kustom untuk kelompok mesin berbasis pengenal kustom: Jika Anda menggunakan kelompok mesin berbasis pengenal kustom, pastikan pengenal kustom telah dikonfigurasi di server.

8. Langkah 8: Restart Logtail: Setelah melakukan perubahan, restart Logtail agar perubahan diterapkan.

Langkah selanjutnya

Lihat error pengumpulan Logtail: Jika status heartbeat OK tetapi log tetap tidak terkumpul, periksa pesan error Logtail untuk melanjutkan troubleshooting.

Langkah 1: Verifikasi status Logtail

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

   Tabel berikut mencantumkan lokasi default file ini pada sistem operasi yang berbeda.

   Sistem operasi	Logtail	Lokasi 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 dikumpulkan 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 Logtail.

   Simple Log Service menyediakan dua jenis kelompok mesin: kelompok mesin berbasis alamat IP dan kelompok mesin berbasis pengenal kustom. Untuk informasi lebih lanjut, lihat Kelompok mesin.

   • Kelompok mesin berbasis alamat IP: Periksa apakah daftar IP Address berisi alamat IP yang Anda peroleh pada langkah sebelumnya.

     Jika alamat IP tidak termasuk, pertama-tama konfirmasi alamat IP yang benar dari server. Jika alamat dalam daftar IP Address salah, perbarui di pengaturan kelompok mesin. Jika alamat IP yang diperoleh Logtail pada langkah sebelumnya salah, modifikasi parameter working_ip seperti dijelaskan dalam Atur parameter startup Logtail dan restart Logtail. Setelah koreksi dilakukan, pantau heartbeat mesin. Jika status menjadi normal, masalah telah terselesaikan.

   • Kelompok mesin berbasis pengenal kustom: Di daftar Machine Group Status, periksa alamat IP yang Anda peroleh pada langkah sebelumnya. Jika status Heartbeat adalah OK, masalah telah terselesaikan.

File ilogtail_config.json berisi parameter startup untuk Logtail.

1. Login ke server tempat Logtail diinstal.

2. Cari file ilogtail_config.json.

   Tabel berikut mencantumkan lokasi default file ini pada sistem operasi yang berbeda.

   Sistem operasi	Logtail	Lokasi 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 periksa apakah parameter konfigurasinya 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 berikut, maka konfigurasi tersebut sudah benar.

      • Jika parameter startup salah, modifikasi file ilogtail_config.json berdasarkan tabel berikut lalu restart Logtail. Untuk informasi lebih lanjut, lihat Restart Logtail.

        Untuk informasi tentang wilayah Proyek, lihat Wilayah yang didukung.

        Skenario	Jenis jaringan	<config_region>	<endpoint>
        Server adalah Instance ECS, dan berada 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 unggahan data berhasil, server Logtail 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>.

   • Anda dapat menemukan nama dan wilayah Proyek seperti yang ditunjukkan pada gambar berikut.

     

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

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

Ikuti langkah-langkah berikut untuk memeriksa dan menyelesaikan masalah jaringan:

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.

   • Atur waktu sistem ke waktu yang benar.

   • Jika Anda tidak dapat mengubah waktu sistem, modifikasi parameter startup Logtail dengan menambahkan item konfigurasi "enable_log_time_auto_adjust": true ke file ilogtail_config.json. Setelah memodifikasi file, restart Logtail. Untuk informasi lebih lanjut, lihat Restart Logtail. Untuk lokasi file ilogtail_config.json, lihat Langkah 3: Periksa apakah parameter startup Logtail benar.

Windows

1. Login ke server tempat Logtail diinstal.

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

   • Atur waktu sistem ke waktu yang benar.

   • Jika Anda tidak dapat mengubah waktu sistem, modifikasi parameter startup Logtail. Tambahkan konfigurasi "enable_log_time_auto_adjust": true ke file ilogtail_config.json. Setelah modifikasi, Anda harus restart Logtail. Untuk informasi lebih lanjut, lihat Restart Logtail. Untuk lokasi file ilogtail_config.json, lihat Langkah 3: Verifikasi parameter startup.

Langkah 6: Verifikasi pengenal pengguna

Periksa keberadaan file pengenal pengguna di direktori yang ditentukan untuk memverifikasi konfigurasinya. File ini memberikan izin kepada akun Proyek untuk mengakses server.

• Jika file pengenal pengguna tidak ada di lokasi yang ditentukan atau salah konfigurasi, ikuti langkah-langkah berikut untuk menyelesaikan masalah:

  • Untuk sistem Linux: Jalankan perintah cd /etc/ilogtail/users/ && touch <uid> untuk membuat file pengenal pengguna. Dalam perintah ini, <uid> adalah ID akun Alibaba Cloud tempat Proyek berada.

  • Pada Windows, buka direktori C:\LogtailData\users\ dan buat file kosong bernama <uid>, di mana <uid> adalah ID akun Alibaba Cloud dari Proyek.

• Jika file bernama sesuai dengan ID akun Alibaba Cloud Proyek ada di lokasi yang ditentukan, pengenal pengguna telah dikonfigurasi dengan benar.

Langkah 7: Verifikasi pengenal kustom

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

• Jika hasilnya kosong, Anda perlu memeriksa apakah file user_defined_id ada atau apakah pengenal yang ditentukan pengguna telah dikonfigurasi dalam file tersebut.

  Catatan

  Lokasi file user_defined_id adalah:

  • Linux: /etc/ilogtail/user_defined_id

  • Windows: C:\LogtailData\user_defined_id

  • Jika file user_defined_id tidak ada, buat file tersebut dan masukkan pengenal kustom untuk kelompok mesin. Untuk informasi lebih lanjut, lihat Konfigurasi pengenal kustom.

  • Jika file user_defined_id ada tetapi tidak berisi pengenal kustom yang benar, tambahkan pengenal kustom untuk kelompok mesin ke dalam file tersebut. Untuk informasi lebih lanjut, lihat Konfigurasi pengenal kustom.

  • Jika file user_defined_id sudah berisi pengenal kustom yang Anda atur untuk kelompok mesin, konfigurasi sudah benar.

Langkah 8: Restart Logtail

Setelah menyelesaikan perubahan ini, Anda harus restart Logtail.