Simple Log Service：Memecahkan masalah detak jantung abnormal

Penyebab detak jantung abnormal

LoongCollector pada server menggunakan item konfigurasi berikut untuk mengidentifikasi proyek tujuan dan melaporkan detak jantung. Memecahkan masalah detak jantung abnormal melibatkan pemeriksaan item konfigurasi dan verifikasi konektivitas jaringan.

• Akun Alibaba Cloud dengan Proyek SLS: Akun ini harus memiliki izin untuk mengakses server dan mengumpulkan log-nya.

• Wilayah dan Jenis Jaringan Proyek: Titik akhir SLS dibuat secara dinamis berdasarkan wilayah dan jenis jaringan. Pastikan server dapat terhubung ke titik akhir. Untuk informasi lebih lanjut, lihat Jenis Jaringan dan Titik Akhir.

• Pengenal kustom atau alamat IP: Detak jantung dibentuk dengan mengaitkan server dengan kelompok mesin menggunakan alamat IP-nya atau pengenal kustom.

Prosedur pembentukan heartbeat

1. LoongCollector membaca konfigurasinya untuk mendapatkan ID Akun Alibaba Cloud, titik akhir, serta alamat IP server atau pengenal kustom.

2. LoongCollector melaporkan detak jantung dengan informasi ini ke proyek di wilayah yang ditentukan.

3. Backend SLS membandingkan alamat IP atau pengenal kustom yang dilaporkan oleh LoongCollector dengan konfigurasi dalam kelompok mesin Anda.

4. Jika informasinya cocok, detak jantung berhasil dibentuk dengan satu atau lebih proyek yang sesuai. Status detak jantung kelompok mesin berubah menjadi OK.

Kasus penggunaan umum detak jantung abnormal

Heartbeat server baru GAGAL

Ketika status detak jantung adalah FAIL, mungkin diperlukan waktu untuk membentuk detak jantung awal. Tunggu sekitar dua menit lalu segarkan status detak jantung. Jika status masih FAIL, lakukan langkah-langkah berikut:

1. Verifikasi bahwa Anda memilih metode instalasi yang benar untuk LoongCollector. Jika metode tersebut benar, lanjutkan ke langkah berikutnya. Jika tidak, uninstall lalu instal ulang LoongCollector.

   Metode instalasi	Kasus penggunaan
   Akun dan wilayah yang sama	Metode ini hanya berlaku jika server adalah Instance ECS Alibaba Cloud, dan baik Instance ECS maupun proyek milik akun Alibaba Cloud yang sama dan berada di wilayah yang sama wilayah.
   Akun yang sama tetapi wilayah berbeda	Metode ini berlaku jika server adalah Instance ECS Alibaba Cloud, dan baik Instance ECS maupun proyek milik akun Alibaba Cloud yang sama tetapi berada di wilayah yang berbeda wilayah.
   Akun berbeda tetapi wilayah sama	Metode ini berlaku jika server adalah Instance ECS Alibaba Cloud, dan baik Instance ECS maupun proyek berada di wilayah yang sama wilayah tetapi milik akun Alibaba Cloud yang berbeda.
   Server cloud lain atau on-premises	Metode ini berlaku jika server bukan Instance ECS Alibaba Cloud, seperti server on-premises atau server dari penyedia cloud lain. Metode ini berlaku jika server adalah Instance ECS Alibaba Cloud, tetapi Instance ECS dan proyek milik akun Alibaba Cloud yang berbeda dan berada di wilayah yang berbeda wilayah. Dalam kasus ini, server dapat diperlakukan sebagai server on-premises.

2. Di server, jalankan perintah sudo /etc/init.d/loongcollectord status untuk memeriksa status LoongCollector. Jika `loongcollector is running` dikembalikan, LoongCollector telah dimulai. Jika tidak, jalankan perintah berikut untuk memulai LoongCollector:

   Jika Anda menggunakan kolektor Logtail, jalankan sudo /etc/init.d/ilogtaild status untuk memeriksa statusnya dan sudo /etc/init.d/ilogtaild start untuk memulainya.

   sudo /etc/init.d/loongcollectord start

3. Jika Anda berada dalam kasus penggunaan lintas akun di mana proyek dan server milik Akun Alibaba Cloud yang berbeda, Anda harus secara manual mengonfigurasi file ID pengguna untuk memberikan izin kepada akun proyek untuk mengakses server dan mengumpulkan log-nya.

   Periksa isi file ID pengguna

   1. Periksa apakah file /etc/ilogtail/users/{Alibaba Cloud account ID} ada. Jika tidak, buatlah.

      1. Masuk ke Konsol Layanan Log Sederhana. Arahkan mouse ke foto profil di sudut kanan atas. Di menu yang muncul, lihat dan salin ID Akun Alibaba Cloud.

      2. Di server tempat LoongCollector diinstal, buat file ID pengguna bernama sesuai dengan ID akun Alibaba Cloud.

         touch /etc/ilogtail/users/{Alibaba Cloud account ID} # File ID pengguna hanya membutuhkan nama file dan tidak memerlukan ekstensi file.

   2. Periksa apakah nama file memenuhi persyaratan berikut. Jika tidak, ubahlah.

      • {Alibaba Cloud account ID} harus merupakan ID akun Alibaba Cloud.

      • {ID Akun Alibaba Cloud} harus merupakan ID Akun Alibaba Cloud yang memiliki proyek SLS, bukan akun yang memiliki server.

4. Konfirmasikan bahwa wilayah dan jenis jaringan sudah benar dan Anda dapat terhubung ke titik akhir. Periksa apakah file /usr/local/ilogtail/ilogtail_config.json di server berisi informasi region yang benar dan sesuai dengan ID Wilayah proyek SLS. Jika sesuai, lanjutkan ke langkah berikutnya. Jika tidak, ubahlah:

   Uji konektivitas titik akhir dan modifikasi konfigurasi server

   1. Masuk ke Konsol Simple Log Service. Di bagian Proyek, klik proyek target.

   2. Klik ikon di sebelah kanan nama proyek untuk pergi ke halaman gambaran proyek.

   3. Di bagian Endpoints, lihat informasi nama domain proyek saat ini. Ganti ${project_name} dengan nama proyek dan ${domain_name_information} dengan titik akhir Internet. Lalu, jalankan perintah di server.

      curl https://${project_name}.${domain_name_information}

   4. Jika tanggapan serupa dengan {"Error":{"Code":"OLSInvalidMethod","Message":"Nama skrip tidak valid : /","RequestId":"5D****09"}} dikembalikan, koneksi jaringan normal. Jika tidak, periksa apakah alamat tujuan diblokir dan lakukan pemeriksaan jaringan lainnya. Misalnya, periksa apakah port 80 (HTTP) dan 443 (HTTPS) terbuka untuk lalu lintas keluar dan periksa konfigurasi DNS dan grup keamanan.

      Kesalahan ini diharapkan dan menunjukkan bahwa koneksi jaringan berfungsi. Kesalahan terjadi karena perintah curl hanya menguji konektivitas jaringan dan tidak termasuk parameter API yang diperlukan untuk permintaan yang valid.

   5. Ubah parameter dalam /usr/local/ilogtail/ilogtail_config.json:

      • config_servers: Parameter ini menentukan jalur untuk mendapatkan konfigurasi koleksi. Ubah nilainya menjadi "http://logtail.${domain_name_information}", di mana ${domain_name_information} adalah titik akhir Internet.

      • data_servers:

        • wilayah: Parameter ini menentukan wilayah untuk transmisi data. Ubah nilainya menjadi "${RegionID}", di mana ${RegionID} adalah ID Wilayah proyek SLS.

        • endpoint_list: Parameter ini menentukan jalur untuk transmisi data. Ubah nilainya menjadi "${domain_name_information}", di mana ${domain_name_information} adalah titik akhir Internet.

   6. Setelah menyimpan perubahan, mulai ulang LoongCollector.

      Jika Anda menggunakan kolektor Logtail, jalankan sudo /etc/init.d/ilogtaild restart

      sudo /etc/init.d/loongcollectord restart

5. Periksa nilai pengenal kustom atau alamat IP:

   1. Masuk ke Konsol Simple Log Service. Di bagian Proyek, klik proyek target.

   2. Di panel navigasi di sebelah kiri, pilih Sumber Daya > Kelompok Mesin. Di halaman Kelompok Mesin, klik kelompok mesin target.

   3. Di halaman Machine Group Settings, lihat Machine Group Identifier dan lakukan operasi yang sesuai:

      Pengenal kustom

      1. Pastikan file /etc/ilogtail/user_defined_id ada di server. Jika tidak, buatlah.

      2. Tulis string kustom ke file sebagai pengenal kustom. Contoh ini menggunakan user-defined-test-1.

         # Tulis string kustom ke file yang ditentukan.
         echo "user-defined-test-1" > /etc/ilogtail/user_defined_id 

      3. Atur Custom Identifier ke string kustom. Dalam contoh ini, nilainya adalah user-defined-test-1.

      Alamat IP

      Tambahkan nilai bidang ip dari /usr/local/ilogtail/app_info.json di server ke bidang IP Address.

      Aturan nilai IP: Jika Anda telah menyetel pemetaan hostname ke alamat IP di file /etc/hosts di server, alamat IP yang dipetakan akan otomatis diambil. Jika tidak ada pemetaan hostname yang disetel, alamat IP dari kartu antarmuka jaringan pertama (NIC) akan otomatis diambil. Jika parameter working_ip disetel di /usr/local/ilogtail/ilogtail_config.json, nilainya digunakan sebagai alamat IP server. Pastikan alamat IP dapat diambil setidaknya dengan salah satu cara ini. Jika tidak, bidang ip kosong dan detak jantung tidak dapat dibentuk.

Detak jantung sebelumnya berhasil tetapi sekarang FAIL

Detak jantung yang sebelumnya berhasil menunjukkan bahwa item konfigurasi sudah benar. Jika kelompok mesin menggunakan pengenal kustom, konfigurasinya bersifat statis. Masalahnya kemungkinan besar terkait jaringan. Verifikasi konektivitas jaringan ke titik akhir SLS. Jika kelompok mesin menggunakan alamat IP, status GAGAL kemungkinan besar disebabkan oleh konflik alamat IP atau perubahan alamat IP. Lakukan langkah-langkah berikut untuk menyelesaikan masalah:

1. Di server, mulai ulang LoongCollector untuk mendapatkan informasi alamat IP terbaru.

   Jika Anda menggunakan kolektor Logtail, jalankan sudo /etc/init.d/ilogtaild restart

   sudo /etc/init.d/loongcollectord restart

2. Di server, lihat informasi di bidang ip dari file /usr/local/ilogtail/app_info.json.

   Aturan nilai IP: Jika Anda telah menyetel pemetaan hostname ke alamat IP di file /etc/hosts di server, alamat IP yang dipetakan akan otomatis diambil. Jika tidak ada pemetaan hostname yang disetel, alamat IP dari NIC pertama akan otomatis diambil. Jika parameter working_ip disetel di /usr/local/ilogtail/ilogtail_config.json, nilainya digunakan sebagai alamat IP server.

3. Masuk ke Konsol Simple Log Service. Di bagian Proyek, klik proyek target.

4. Di panel navigasi di sebelah kiri, pilih Sumber Daya > Kelompok Mesin. Di halaman Kelompok Mesin, klik kelompok mesin target.

5. Di halaman Machine Group Settings, periksa apakah bidang IP Address berisi nilai bidang ip dari /usr/local/ilogtail/app_info.json. Jika tidak, tambahkan nilai bidang ip ke bidang IP Address.

6. Jika alamat IP cocok tetapi detak jantung tetap GAGAL, ini mungkin menunjukkan bahwa alamat IP server tidak stabil atau bertentangan. Pertimbangkan beralih ke pengenal kustom untuk identifikasi yang lebih andal.

Detak jantung adalah FAIL setelah mengganti tipe pengenal kelompok mesin

Ketika terjadi konflik atau perubahan alamat IP, kelompok mesin berbasis IP tidak lagi cocok. Anda perlu beralih ke kelompok mesin yang menggunakan pengenal kustom. Mengganti tipe kelompok mesin tidak memengaruhi konektivitas jaringan, informasi akun Alibaba Cloud, atau pengaturan wilayah dan jenis jaringan. Oleh karena itu, Anda hanya perlu memastikan bahwa nilai pengenal kustom benar.

1. Pastikan file /etc/ilogtail/user_defined_id ada. Jika tidak, buatlah.

2. Tulis string kustom ke file sebagai pengenal kustom. Contoh ini menggunakan user-defined-test-1.

   # Tulis string kustom ke file yang ditentukan.
   echo "user-defined-test-1" > /etc/ilogtail/user_defined_id 

3. Masuk ke Konsol Simple Log Service. Di bagian Proyek, klik proyek target.

4. Di panel navigasi di sebelah kiri, pilih Sumber Daya > Kelompok Mesin. Di halaman Kelompok Mesin, klik kelompok mesin target.

5. Di halaman Machine Group Settings, konfirmasi nilai dari dua parameter berikut. Jika salah, klik Modify di pojok kanan atas, buat perubahan yang diperlukan, lalu simpan.

   • Machine Group Identifier: Pengidentifikasi kustom.

   • Pengenal Kustom: String kustom. Dalam contoh ini, nilainya adalah user-defined-test-1.

FAQ

Mengapa status detak jantung GAGAL meskipun semua konfigurasi sudah benar?

Jika Anda yakin bahwa konfigurasi sudah benar dan jaringan normal, status detak jantung mungkin GAGAL karena dua alasan berikut:

• Kolektor mengurangi frekuensi detak jantung karena tidak ada konfigurasi koleksi yang diterapkan di wilayah tersebut untuk waktu yang lama.

  • Untuk mengurangi beban server, kolektor mengurangi frekuensi permintaan konfigurasi dari wilayah jika tidak ada konfigurasi yang dikembalikan. Interval permintaan dapat meningkat hingga maksimum 12 menit. Jika interval ini melebihi ambang batas FAIL detak jantung wilayah, status detak jantung berubah menjadi FAIL.

  • Solusi: Abaikan status detak jantung GAGAL. Terapkan konfigurasi koleksi ke kelompok mesin yang berisi server. Detak jantung akan pulih selama permintaan berikutnya ke wilayah. Untuk memulihkan detak jantung segera, mulai ulang kolektor.

• Konfigurasi aktif tidak sesuai dengan file ilogtail_config.json.

  • Contoh: Kolektor dimulai dengan konfigurasi non-default. Kemudian, file ilogtail_config.json dimodifikasi, tetapi kolektor tidak dimulai ulang.

  • Cara memeriksa:

    • Metode paling langsung adalah memulai ulang kolektor untuk secara otomatis memuat konfigurasi terbaru.

    • Jika Anda khawatir tentang dampak pada pengumpulan log, lihat file /usr/local/ilogtail/ilogtail.LOG. Dari awal file, cari kata kunci load logtail config file. Entri log pada baris itu berisi konfigurasi yang sedang digunakan. Periksa apakah itu sesuai dengan file lokal.