Cara menggunakan fitur diagnostik Logtail - Simple Log Service

Saat menggunakan Logtail untuk mengumpulkan log, Anda mungkin mengalami masalah seperti kegagalan penguraian ekspresi reguler, jalur file yang salah, atau lalu lintas melebihi kapasitas layanan Shard. Simple Log Service menyediakan fitur diagnostik untuk membantu Anda dengan cepat menemukan kesalahan dalam pengumpulan Logtail.

Prasyarat

Log dikumpulkan menggunakan Logtail. Untuk informasi lebih lanjut, lihat Pengumpulan data.
Pengumpulan log penting harus diaktifkan untuk proyek tempat konfigurasi Logtail berada. Untuk informasi lebih lanjut, lihat Aktifkan log layanan.

Informasi latar belakang

Ada dua cara untuk mendiagnosis masalah Logtail: diagnostik konsol dan alat diagnostik otomatis Logtail.

Diagnostik konsol mencakup diagnostik tingkat lanjut dan dasar:
- Diagnostik tingkat lanjut (direkomendasikan): Menyediakan dasbor untuk melihat dan memeriksa detail pengecualian Logtail, termasuk dari waktu sebelumnya.
  Penting
  Dasbor diagnostik tingkat lanjut bergantung pada log penting dalam proyek. Untuk informasi lebih lanjut, lihat Tipe log layanan.
- Diagnostik dasar: Hanya memberikan informasi tentang pengecualian satu jam terakhir.
Alat diagnostik otomatis Logtail hanya didukung pada server Linux dan memerlukan alat curl untuk pemeriksaan konektivitas jaringan. Prosesnya adalah sebagai berikut:

Diagnostik konsol

Masuk ke Konsol Simple Log Service.
Di bagian Proyek, klik proyek yang diinginkan.
Di tab Log Storage > Logstores, arahkan kursor ke logstore target dan klik ikon .
Lihat informasi diagnostik.
Penting
Untuk menggunakan diagnostik tingkat lanjut, pastikan pengumpulan log penting telah diaktifkan. Untuk informasi lebih lanjut, lihat Log Penting.
Diagnostik dasar
Panel Log Collection Error menampilkan semua kesalahan pengumpulan Logtail untuk logstore. Klik kode kesalahan untuk melihat detail kesalahan tersebut. Untuk informasi lebih lanjut, lihat Jenis kesalahan umum pengumpulan data di Simple Log Service.
Diagnostik tingkat lanjut
Di halaman LoongCollector/Logtail Exception Monitoring, lihat informasi seperti jumlah Logtail aktif dan semua pesan kesalahan. Untuk informasi lebih lanjut, lihat Lihat laporan data dan Jenis kesalahan umum pengumpulan data di Simple Log Service.
Setelah menyelesaikan masalah, periksa apakah ada kesalahan yang tersisa. Kesalahan historis ditampilkan hingga kedaluwarsa. Anda dapat mengabaikannya dan hanya memastikan tidak ada kesalahan baru setelah memperbaiki yang sebelumnya. Logtail melaporkan kesalahan setiap 10 menit.
Catatan
Untuk melihat log lengkap yang dibuang karena kegagalan penguraian, akses server atau kontainer Logtail Anda dan periksa log operasional. Log ini disimpan di jalur berikut:
- Skenario server: Di file /usr/local/ilogtail/ilogtail.LOG pada server tempat Logtail diinstal.
- Skenario kontainer: Di file /usr/local/ilogtail/ilogtail.LOG di kontainer tempat Logtail diinstal.

Alat diagnostik otomatis Logtail

Masuk ke server Linux tempat Logtail diinstal dan jalankan perintah berikut untuk mengunduh alat tersebut.
```
wget http://logtail-release.oss-cn-hangzhou.aliyuncs.com/linux64/checkingtool.sh -O checkingtool.sh
```

Jalankan perintah berikut untuk menjalankan alat tersebut.

chmod 744 ./checkingtool.sh
./checkingtool.sh
sh checkingtool.sh

Pilih bahasa.

[Info]:     Versi alat pemeriksaan Logtail : 0.3.1
[Input]:  Silakan pilih bahasa Silakan pilih bahasa : 
                1. Bahasa Cina. 
                2. Bahasa Inggris. 
        Bahasa :

Pilih proses pemeriksaan.

[Input]:  silakan pilih tipe mana yang ingin Anda periksa : 
                1. Gagal detak jantung MachineGroup. 
                2. Detak jantung MachineGroup baik, tetapi file log belum dikumpulkan. 
        Tipe :

1: Jika status detak jantung grup mesin tidak normal, pilih opsi ini.
2: Jika status detak jantung grup mesin normal tetapi file log tidak dikumpulkan, pilih opsi ini.

Periksa status detak jantung grup mesin

Jika Anda memilih opsi 1, alat melakukan pemeriksaan berikut:

Periksa informasi dasar.

Logtail terinstal.
Logtail sedang berjalan.
Status enkripsi Secure Sockets Layer (SSL) normal.
Konektivitas jaringan ada antara server dan Simple Log Service.

[Info]:     Periksa file instalasi Logtail
[Info]:     File instalasi: ilogtail_config.json ada.                          [ OK ]
[Info]:     File instalasi: /etc/init.d/ilogtaild ada.                         [ OK ]
[Info]:     File instalasi: ilogtail ada.                                      [ OK ]
[Info]:     File bin: /usr/local/ilogtail/ilogtail_2.0.8 ada.                [ OK ]
[Info]:     Versi Logtail : 2.0.8                                             [ OK ]

[Info]:     Periksa status berjalan Logtail
[Info]:     Logtail sedang berjalan.                                                [ OK ]
[Info]:     Periksa status jaringan
[Info]:     Logtail menggunakan ip: 172.31.0.246
[Info]:     Logtail menggunakan UUID: D1BA8F5A-FA52-11EF-8935-00163E4C****
[Info]:     Periksa status SSL
Mengarahkan ke /bin/systemctl status iptables.service
Unit iptables.service tidak ditemukan.
[Info]:     Status SSL OK.                                                      [ OK ]
[Info]:     Periksa server konfigurasi logtail
[Info]:     Alamat server konfigurasi: http://logtail.cn-hangzhou-intranet.log.aliyuncs.com
[Info]:     Server konfigurasi Logtail HTTP OK                                       [ OK ]
[Info]:     Server konfigurasi Logtail HTTPS OK                                      [ OK ]

Periksa apakah server Anda adalah instance ECS Alibaba Cloud dan termasuk dalam akun yang sama dengan proyek saat ini.

Jika ya, masukkan y untuk melanjutkan ke langkah berikutnya.

Jika tidak, masukkan N. Alat akan menampilkan informasi pengenal pengguna yang dikonfigurasi secara lokal. Jika ID akun Alibaba Cloud Anda tidak termasuk, konfigurasikan ulang pengenal pengguna.

[Input]:  Apakah server Anda adalah ECS Alibaba Cloud dan termasuk dalam akun yang sama dengan proyek SLS saat ini? (y/N)n
[Info]:     Periksa ID pengguna aliyun
[Info]:     ID pengguna aliyun : 198********815 .                                 [ OK ]

[Input]:  Apakah ID akun pemilik proyek Anda termasuk dalam ID di atas? (y/N)n
[Error]:    silakan konfigurasikan ID pengguna (ID akun), dokumen ini akan membantu
            [ https://www.alibabacloud.com/help/doc-detail/49007.htm ]          [ Error ]

Periksa apakah wilayah proyek Anda sama dengan wilayah yang Anda pilih saat menginstal Logtail.
- Jika ya, masukkan y untuk melanjutkan ke langkah berikutnya.
- Jika tidak, masukkan N. Alat akan meminta Anda untuk menginstal ulang Logtail atau membuat ulang proyek untuk memastikan bahwa wilayah proyek dan wilayah instalasi Logtail sama. Untuk informasi lebih lanjut, lihat Instal Logtail di Server Linux.
```
[Input]:  silakan pastikan proyek Anda berada di wilayah ini : { cn-hangzhou } (y/N) :n
[Error]:    silakan instal ulang Logtail Anda atau buat ulang proyek Anda untuk
            memastikan proyek Anda berada di wilayah yang sama dengan Logt [ Error ]
```
Periksa apakah alamat IP atau ID kustom di grup mesin Anda cocok dengan yang ada di pesan yang dikembalikan.
- Jika ya, masukkan y. Alat akan menghasilkan laporan. Jika masalah masih ada, salin isi laporan keluaran dan ajukan tiket.
- Jika tidak, masukkan N. Alat akan meminta Anda untuk memperbaiki alamat IP atau ID kustom di grup mesin. Untuk informasi lebih lanjut, lihat Ubah Informasi Grup Mesin.
```
[Input]:  silakan pastikan alamat IP grup mesin Anda sama dengan : { 172.31.0.246 } atau ID kustom grup mesin Anda ada di : { user-defined-linux-1 } (y/N) :n
[Error]:    silakan perbaiki alamat IP atau ID kustom grup mesin Anda,
            simpan konfigurasi, tunggu 1 menit dan periksa lagi               [ Error ]
```

Periksa apakah terjadi kesalahan saat Logtail mengumpulkan log

Jika Anda memilih opsi 2, alat melakukan pemeriksaan berikut:

Pastikan status detak jantung grup mesin normal dan alamat IP-nya cocok dengan yang ada di pesan yang dikembalikan.
- Jika ya, masukkan y untuk melanjutkan ke langkah berikutnya.
- Jika tidak, masukkan N. Alat akan meminta Anda untuk kembali ke periksa status detak jantung grup mesin.
```
[Input]:  silakan pastikan detak jantung mesin Anda baik-baik saja dan alamat IP grup mesin sama dengan : { 172.31.0.246 } (y/N) :n
[Error]:    silakan jalankan ulang skrip dan pilih tipe 1 untuk memeriksa detak jantung grup mesin  [ Error ]
```
Periksa apakah konfigurasi Logtail Anda diterapkan ke grup mesin.
- Jika ya, masukkan y untuk melanjutkan ke langkah berikutnya. Untuk informasi lebih lanjut, lihat Lihat Konfigurasi Grup Mesin.
- Jika tidak, masukkan N. Alat akan meminta Anda untuk terapkan konfigurasi Logtail ke grup mesin.
```
[Input]:  silakan pastikan Anda telah menerapkan konfigurasi pengumpulan ke grup mesin (y/N) :n
[Error]:    silakan terapkan konfigurasi pengumpulan ke grup mesin                 [ Error ]
```

Periksa apakah jalur file log dalam konfigurasi Logtail valid.

Anda harus memasukkan jalur lengkap file log. Jika tidak ada file yang cocok, periksa apakah jalur yang ditentukan dapat mencocokkan file.

Jika konfigurasi salah, ubahlah, tunggu sekitar 1 menit, lalu jalankan skrip lagi untuk memeriksa.

[Input]:  silakan masukkan jalur lengkap file log Anda (misalnya. /var/log/nginx/access.log) : /var/log/nginx/access.log
[Info]:     Periksa file log spesifik
[Info]:     Periksa apakah file log spesifik [ /var/log/nginx/access.log ] termasuk dalam konfigurasi log pengguna.
[Info]:     File log spesifik ada.                                           [ OK ]
[Error]:    Tidak ada konfigurasi yang cocok untuk file log Anda.                                  [ Error ]
[Suggestion]:  Silakan periksa apakah konfigurasi pengumpulan dibuat di SLS Project/Logstore dan pastikan Anda telah menerapkan konfigurasi ke grup mesin Anda

Jika masalah masih ada, salin laporan diagnostik dan ajukan tiket.

[Input]:  silakan pastikan semua item pemeriksaan di atas telah lulus. Jika masalah masih ada, silakan salin semua keluaran dan ajukan tiket di sistem tiket. : (y/N)y
[Info]:     Periksa dukungan sistem
[Info]:     Periksa dukungan sistem OK.                                            [ OK ]

[Info]:     Periksa file instalasi Logtail
[Info]:     File instalasi: ilogtail_config.json ada.                          [ OK ]
[Info]:     File instalasi: /etc/init.d/ilogtaild ada.                         [ OK ]
[Info]:     File instalasi: ilogtail ada.                                      [ OK ]
[Info]:     File bin: /usr/local/ilogtail/ilogtail_2.0.8 ada.                [ OK ]
[Info]:     Versi Logtail : 2.0.8                                             [ OK ]
......
......

Pemeriksaan cepat

Kegagalan pengumpulan sering kali berasal dari pengenal pengguna yang salah. Periksa dengan cepat dan keluarkan ID akun Alibaba Cloud yang dikonfigurasi dan pengenal pengguna kustom di klien Logtail. Tidak ada peringatan yang terjadi jika ini hilang. Jika dikonfigurasi, pastikan sesuai dengan pengaturan Anda. Jika tidak, konfigurasikan ulang dengan merujuk ke Grup Mesin.

Gunakan perintah berikut untuk melakukan pemeriksaan cepat:

./checkingtool.sh --logFile [LogFileFullPath]

Jika file log yang ditentukan lulus pemeriksaan dan lingkungan runtime Logtail normal, lihat log kesalahan parameter terkait di konsol Simple Log Service. Untuk informasi lebih lanjut, lihat Diagnostik Konsol.

Parameter umum alat diagnostik

Parameter umum	Deskripsi
`--help`	Lihat dokumentasi bantuan.
`--logFile [LogFileFullPath]`	Periksa apakah Logtail mengumpulkan log dari jalur `LogFileFullPath`. Kemudian periksa lingkungan runtime Logtail dasar, seperti integritas file instalasi, status berjalan, ID akun Alibaba Cloud, dan konektivitas jaringan.
`--logFileOnly [LogFileFullPath]`	Hanya periksa apakah Logtail mengumpulkan log dari jalur `LogFileFullPath`.
`--envOnly`	Hanya periksa lingkungan runtime Logtail.

Masalah umum dengan pengumpulan Logtail

Tabel berikut menjelaskan penyebab kesalahan pengumpulan Logtail umum dan solusinya.

Catatan

Logtail hanya mengumpulkan log tambahan. Jika file log di server tidakdiperbarui setelah konfigurasi Logtail yang diterapkan dikirim ke server, Logtail tidak akan mengumpulkan log dari file tersebut. Untuk informasi lebih lanjut, lihat Baca File Log.

Masalah	Solusi
File instalasi hilang.	Instal ulang Logtail.
Logtail tidak berjalan.	Jalankan perintah `/etc/init.d/ilogtaild start` untuk memulai Logtail.
Ada beberapa proses Logtail.	Jalankan perintah `/etc/init.d/ilogtaild stop` untuk menghentikan Logtail. Jalankan perintah `/etc/init.d/ilogtaild start` untuk memulai Logtail.
Port 443 dinonaktifkan.	Konfigurasikan firewall Anda untuk mengaktifkan port 443.
Server konfigurasi tidak dapat ditemukan.	Periksa apakah Logtail diinstal dengan benar. Jika Logtail tidak diinstal pada server Linux, jalankan ulang perintah instalasi. Untuk informasi lebih lanjut, lihat Instal Logtail di Server Linux.
Konfigurasi pengguna tidak ada.	Periksa apakah operasi berikut telah dilakukan: Konfigurasi Logtail dibuat. Server termasuk dalam grup mesin. Konfigurasi Logtail diterapkan ke grup mesin.
File log yang ditentukan tidak dapat ditemukan.	Periksa apakah konfigurasi Logtail valid.
File log yang ditentukan cocok dengan dua atau lebih konfigurasi Logtail.	Jika file log cocok dengan dua atau lebih konfigurasi Logtail, Logtail secara acak memilih salah satu. Gunakan hanya satu konfigurasi Logtail untuk mencocokkan file log tersebut.