Simple Log Service：Instalasi, menjalankan, peningkatan, dan menguninstall Logtail

Instal Logtail

Instal Logtail menggunakan instalasi satu-klik atau instalasi manual. Instalasi satu-klik hanya didukung jika Anda menggunakan instance ECS yang berada di wilayah yang sama dan termasuk dalam akun Alibaba Cloud yang sama dengan proyek tersebut. Jika tidak, Anda harus menginstal Logtail secara manual.

# Unduh menggunakan jaringan internal
wget http://logtail-release-${region_id}.oss-${region_id}-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; 
# Unduh menggunakan internet
wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; 

# Untuk instalasi menggunakan internet
chmod +x logtail.sh; ./logtail.sh install ${region_id}-internet
# Jika server Anda berada di pusat data lokal atau dari vendor cloud di luar China, transfer data melalui internet dapat menyebabkan latensi tinggi dan ketidakstabilan. Kami merekomendasikan penggunaan akselerasi transfer.
chmod +x logtail.sh; ./logtail.sh install ${region_id}-acceleration
# Untuk instalasi menggunakan jaringan internal, cocok untuk pusat data lokal dengan akses jaringan internal
chmod +x logtail.sh; ./logtail.sh install ${region_id}

# Untuk instalasi menggunakan internet
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-internet
# Jika server Anda berada di pusat data lokal atau dari vendor cloud di luar China, transfer data melalui internet dapat menyebabkan latensi tinggi dan ketidakstabilan. Kami merekomendasikan penggunaan akselerasi transfer.
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-acceleration

# Untuk instalasi menggunakan internet
.\logtail_installer.exe install ${region_id}-internet
# Jika server Anda berada di pusat data lokal atau dari vendor cloud di luar China, transfer data melalui internet dapat menyebabkan latensi tinggi dan ketidakstabilan. Kami merekomendasikan penggunaan akselerasi transfer.
.\logtail_installer.exe install ${region_id}-acceleration

Instalasi batch Logtail

Gunakan salah satu metode berikut untuk menginstal Logtail secara batch.

• Orkestrasi OOS: Metode ini cocok untuk skenario dengan persyaratan izin. Mendukung konkurensi tinggi dan ideal untuk operasi batch berskala besar. Untuk informasi lebih lanjut, lihat Gunakan OOS untuk menginstal atau meningkatkan Logtail secara batch.

• ECS Cloud Assistant: Metode ini mudah digunakan. Jalankan perintah untuk mengeksekusi tugas temporary. Prosedurnya sebagai berikut.

1. Buka ECS console - ECS Cloud Assistant.

2. Di bilah navigasi atas, pilih wilayah dan kelompok sumber daya dari resource yang ingin Anda kelola.

3. Di pojok kanan atas halaman ECS Cloud Assistant, klik Create/Run Command.

4. Pada panel Create Command, masukkan perintah instalasi di bidang Command content. Contoh ini menggunakan metode instalasi internet. Untuk perintah instalasi lainnya, lihat Instal Logtail.

   

   Perintah instalasi yang digunakan di sini adalah sebagai berikut:

   #!/bin/bash
   region_id='cn-hangzhou'
   wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh
   chmod +x logtail.sh
   ./logtail.sh install ${region_id}-internet

   Penting

   Setelah Anda menginstal Logtail, jika Anda mengubah jenis jaringan instance ECS dari jaringan klasik ke VPC, Anda harus memperbarui konfigurasi Logtail. Untuk informasi lebih lanjut, lihat Bagaimana cara memperbarui konfigurasi kelompok mesin setelah saya mengubah instance ECS dari jaringan klasik ke VPC?.

5. Pada bagian Select Instance, pastikan status agen instance target adalah Normal. Jika statusnya bukan Normal, lihat Instal Cloud Assistant Agent untuk menginstal Cloud Assistant. Pilih instance target dan klik Run. Status eksekusi kemudian menjadi Successful. Jika eksekusi gagal, lihat Lihat hasil eksekusi dan perbaiki masalah umum.

Memulai dan menghentikan Logtail

Periksa status dan versi Logtail

cat /usr/local/ilogtail/app_info.json

{
   "logtail_version" : "0.16.30",
}

{
    "logtail_version" : "1.0.0.0"
}

Peningkatan Logtail

stop successfully
Stop logtail successfully.
Upgrading logtail files ...
Upgrade logtail files successfully.
Starting logtail ...
ilogtail is running
Upgrade logtail successfully.
{
        "UUID" : "XXXXXXXX-XXXX",
        "compiler" : "GCC 9.3.1",
        "hostname" : "xxx",
        "instance_id" : "XXXXXXXX-XXXX_172.16.0.75_1730950372",
        "ip" : "172.16.0.75",
        "logtail_version" : "2.0.8",
        "os" : "Linux; 5.10.134-13.an8.x86_64; #1 SMP Mon Jan 9 10:39:46 CST 2023; x86_64",
        "update_time" : "2024-11-07 11:32:52"
}

Menguninstall Logtail

wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh uninstall

.\logtail_installer.exe uninstall

Instal komponen Logtail

Jika Anda menggunakan kluster ACK dan kluster tersebut termasuk dalam akun Alibaba Cloud yang sama dengan SLS, ikuti petunjuk untuk kluster ACK. Jika Anda menggunakan kluster yang dikelola sendiri, atau jika kluster ACK dan SLS termasuk dalam akun Alibaba Cloud yang berbeda, ikuti petunjuk untuk kluster yang dikelola sendiri.

Periksa status, versi, dan alamat IP Logtail

• Jalankan perintah berikut untuk memeriksa status Logtail.

  kubectl get po -n kube-system | grep logtail

  Hasil berikut dikembalikan:

  NAME            READY     STATUS    RESTARTS   AGE
  logtail-ds-gb92k   1/1       Running   0          2h
  logtail-ds-wm7lw   1/1       Running   0          4d

• Jalankan perintah berikut untuk melihat informasi, seperti nomor versi Logtail dan alamat IP.

  kubectl exec logtail-ds-gb92k -n kube-system cat /usr/local/ilogtail/app_info.json

  Hasil berikut dikembalikan:

  {
     "hostname" : "logtail-ds-gb92k",
     "instance_id" : "0EBB2B0E-0A3B-11E8-B0CE-0A58AC140402_172.20.4.2_1517810940",
     "ip" : "192.0.2.0",
     "logtail_version" : "0.16.2",
     "os" : "Linux; 3.10.0-693.2.2.el7.x86_64; #1 SMP Tue Sep 12 22:26:13 UTC 2017; x86_64",
     "update_time" : "2021-02-05 06:09:01"
  }

Peningkatan dan rollback Logtail

1. Sebelum meningkatkan, backup file deskripsi terkait komponen Logtail.

   Penting

   Jika terdapat latensi pengumpulan signifikan sebelum peningkatan, peningkatan tersebut dapat menyebabkan sedikit kehilangan log.

   kubectl get ds -n kube-system logtail-ds -o yaml > logtail-ds.yaml
   kubectl get deployment -n kube-system alibaba-log-controller -o yaml > alibaba-log-controller.yaml
   kubectl get crd aliyunlogconfigs.log.alibabacloud.com -o yaml > aliyunlogconfigs-crd.yaml
   kubectl get cm -n kube-system alibaba-log-configuration -o yaml > alibaba-log-configuration.yaml
   kubectl get aliyunlogconfigs --all-namespaces -o yaml > aliyunlogconfigs-cr.yaml

2. Pilih metode peningkatan berdasarkan tipe kluster Anda. Jika Anda menggunakan kluster ACK dan kluster tersebut termasuk dalam akun Alibaba Cloud yang sama dengan SLS, ikuti petunjuk untuk kluster ACK. Jika Anda menggunakan kluster yang dikelola sendiri, atau jika kluster ACK dan SLS termasuk dalam akun Alibaba Cloud yang berbeda, ikuti petunjuk untuk kluster yang dikelola sendiri.

   Peningkatan pada kluster ACK

   Kami menyarankan Anda menggunakan metode peningkatan otomatis. Jika Anda telah memodifikasi parameter, seperti variabel lingkungan, pada DaemonSet logtail-ds atau deployment alibaba-log-controller, gunakan metode peningkatan manual untuk mencegah perubahan Anda direset.

   Peningkatan otomatis

   Penting

   Peningkatan otomatis akan mereset konfigurasi yang Anda modifikasi secara manual pada logtail-ds dan alibaba-log-controller.

   1. Login ke Konsol ACK.

   Pada halaman Clusters, temukan kluster target dan pilih More > Operations > Manage Components di kolom Actions.

   2. Pada tab Logs and Monitoring, temukan logtail-ds dan klik Upgrade.

   3. Pada kotak dialog Upgrade Component, klik OK.

      Penting

      Jika Anda tidak dapat meningkatkan ke versi Logtail terbaru, versi kluster Kubernetes Anda mungkin terlalu lama. Tingkatkan kluster Kubernetes Anda terlebih dahulu atau gunakan metode peningkatan manual.

      Setelah Anda melakukan peningkatan, lihat status pod logtail-ds di Konsol ACK. Jika semua pod logtail-ds berada dalam status running, berarti peningkatan berhasil.

   Peningkatan manual

   Penting

   Peningkatan manual tidak memperbarui konfigurasi Anda berdasarkan komponen Logtail terbaru. Beberapa optimasi fitur mungkin tidak tersedia.

   Peningkatan manual mencakup peningkatan logtail-ds dan alibaba-log-controller. Biasanya, Anda hanya perlu meningkatkan logtail-ds untuk mendapatkan kemampuan pengumpulan yang disediakan oleh versi Logtail baru. Saat Anda perlu mendapatkan kemampuan pengumpulan metode CRD Logtail baru, Anda perlu meningkatkan alibaba-log-controller. Langkah-langkah berikut menggunakan logtail-ds sebagai contoh.

   1. Login ke Konsol ACK.

   Pada halaman Clusters, temukan kluster target dan pilih More > Operations > Manage Components di kolom Actions.

   2. Pilih Workloads > DaemonSets.

      Catatan

      Untuk melakukan upgrade alibaba-log-controller, pilih Workloads > Deployments. Kemudian, di namespace kube-system, temukan alibaba-log-controller dan selesaikan proses upgrade-nya.

   3. Atur Namespace ke kube-system, lalu klik Edit pada baris logtail-ds.

   4. Periksa apakah variabel lingkungan berikut ada.

      Jika variabel lingkungan ALIYUN_LOGTAIL_CONFIG, ALIYUN_LOGTAIL_USER_ID, dan ALIYUN_LOGTAIL_USER_DEFINED_ID tidak ada, versi Logtail Anda mungkin terlalu lama. Kirimkan tiket untuk menanyakan metode upgrade.

   5. Klik Select Image Tag di sebelah Image Tag.

   6. Pada kotak dialog Image Tag, klik versi terbaru, lalu klik OK.

   7. Di sisi kanan halaman, klik Update.

      Setelah Anda melakukan upgrade, lihat status Pod logtail-ds di Konsol ACK. Jika semua Pod logtail-ds berada dalam status Running, upgrade berhasil.

   Upgrade pada kluster yang dikelola sendiri

   Catatan

   Kami menyarankan Anda melakukan upgrade dengan menginstal komponen Logtail terbaru. Jika Anda hanya memperbarui versi gambar dari beberapa komponen, seperti logtail-ds atau alibaba-log-controller, upgrade tersebut dapat gagal.

   Instal ulang komponen Logtail untuk menyelesaikan upgrade secara otomatis. Untuk informasi selengkapnya, lihat Install the Logtail component.

3. Untuk melakukan rollback ke versi tertentu, ikuti langkah-langkah berikut.

   Catatan

   File YAML yang dibackup sebelum upgrade berisi informasi redundan yang perlu Anda hapus secara manual sebelum menggunakannya untuk memulihkan konfigurasi Logtail. Anda dapat menggunakan tool kubectl-neat untuk melakukan hal ini. Bidang-bidang yang harus dihapus adalah metadata.creationTimestamp, metadata.generation, metadata.resourceVersion, metadata.uid, dan status.

   1. Tentukan apakah Anda perlu menyimpan konfigurasi Logtail baru setelah upgrade berdasarkan kebutuhan bisnis Anda.

      Jika tidak perlu menyimpannya, hapus konfigurasi Logtail baru tersebut.

   2. Hapus informasi redundan dari file backup.

      cat logtail-ds.yaml | kubectl-neat > neat-logtail-ds.yaml
      cat alibaba-log-controller.yaml | kubectl-neat > neat-alibaba-log-controller.yaml
      cat aliyunlogconfigs-crd.yaml | kubectl-neat > neat-aliyunlogconfigs-crd.yaml
      cat alibaba-log-configuration.yaml | kubectl-neat > neat-alibaba-log-configuration.yaml
      cat aliyunlogconfigs-cr.yaml | kubectl-neat > neat-aliyunlogconfigs-cr.yaml

   3. Terapkan file backup yang telah disederhanakan untuk memulihkan konfigurasi Logtail.

      kubectl apply -f neat-logtail-ds.yaml
      kubectl apply -f neat-alibaba-log-controller.yaml
      kubectl apply -f neat-aliyunlogconfigs-crd.yaml
      kubectl apply -f neat-alibaba-log-configuration.yaml
      kubectl apply -f neat-aliyunlogconfigs-cr.yaml

Uninstal Logtail

Pilih metode uninstal berdasarkan tipe kluster Anda. Jika Anda menggunakan kluster ACK dan kluster tersebut berada dalam Akun Alibaba Cloud yang sama dengan SLS, ikuti petunjuk untuk kluster ACK. Jika Anda menggunakan kluster self-managed, atau jika kluster ACK dan SLS berada dalam Akun Alibaba Cloud yang berbeda, ikuti petunjuk untuk kluster self-managed.

Bagaimana cara menggunakan satu Proyek SLS untuk beberapa kluster Kubernetes?

Jika Anda ingin mengumpulkan log kontainer dari beberapa kluster ke proyek SLS yang sama, atur parameter instalasi untuk komponen SLS kluster lainnya agar sama dengan yang Anda gunakan saat pertama kali menginstal komponen tersebut.

Bagaimana cara melihat log Logtail?

Log Logtail disimpan di direktori /usr/local/ilogtail/ dalam kontainer Logtail. Nama file-nya adalah ilogtail.LOG dan logtail_plugin.LOG.

Output standar dalam kontainer Logtail tidak untuk referensi. Anda dapat mengabaikan konten output standar berikut.

start umount useless mount points, /shm$|/merged$|/mqueue$
umount: /logtail_host/var/lib/docker/overlay2/3fd0043af174cb0273c3c7869500fbe2bdb95d13b1e110172ef57fe840c82155/merged: must be superuser to unmount
umount: /logtail_host/var/lib/docker/overlay2/d5b10aa19399992755de1f85d25009528daa749c1bf8c16edff44beab6e69718/merged: must be superuser to unmount
umount: /logtail_host/var/lib/docker/overlay2/5c3125daddacedec29df72ad0c52fac800cd56c6e880dc4e8a640b1e16c22dbe/merged: must be superuser to unmount
......
xargs: umount: exited with status 255; aborting
umount done
start logtail
ilogtail is running
logtail status:
ilogtail is running

Bagaimana cara memeriksa status komponen SLS dalam kluster Kubernetes?

Jalankan perintah berikut untuk memeriksa.

kubectl get deploy alibaba-log-controller -n kube-system
kubectl get ds logtail-ds -n kube-system

Apa yang harus saya lakukan jika alibaba-log-controller gagal dimulai?

Pastikan Anda telah mengikuti petunjuk instalasi berikut.

• Jalankan perintah instalasi pada node master kluster Kubernetes.

• Masukkan ID kluster Anda sebagai parameter dalam perintah instalasi.

Jika instalasi gagal karena masalah ini, jalankan perintah kubectl delete -f deploy untuk menghapus templat instalasi yang dihasilkan lalu jalankan perintah instalasi lagi.

Bagaimana cara memeriksa status DaemonSet Logtail-ds dalam kluster Kubernetes?

Jalankan perintah kubectl get ds -n kube-system untuk memeriksa status DaemonSet Logtail-ds.

Bagaimana cara melihat log runtime Logtail?

Log runtime Logtail disimpan di direktori /usr/local/ilogtail/. Nama file-nya adalah ilogtail.LOG. File yang telah dirotasi dikompresi dan disimpan sebagai ilogtail.LOG.x.gz. Sebagai contoh, jalankan perintah berikut untuk melihat log.

kubectl exec logtail-ds-gb92k -n kube-system tail /usr/local/ilogtail/ilogtail.LOG

Hasilnya sebagai berikut:

[2018-02-05 06:09:02.168693] [INFO] [9] [build/release64/sls/ilogtail/LogtailPlugin.cpp:104] logtail plugin Resume:start
[2018-02-05 06:09:02.168807] [INFO] [9] [build/release64/sls/ilogtail/LogtailPlugin.cpp:106] logtail plugin Resume:success
[2018-02-05 06:09:02.168822] [INFO] [9] [build/release64/sls/ilogtail/EventDispatcher.cpp:369] start add existed check point events, size:0
[2018-02-05 06:09:02.168827] [INFO] [9] [build/release64/sls/ilogtail/EventDispatcher.cpp:511] add existed check point events, size:0 cache size:0 event size:0 success count:0

Bagaimana cara me-restart Logtail di pod tertentu?

1. Hentikan Logtail.

   logtail-ds-gb92k adalah nama kontainer dan kube-system adalah namespace. Gantilah sesuai kebutuhan.

   kubectl exec logtail-ds-gb92k -n kube-system /etc/init.d/ilogtaild stop

2. Hasil berikut menunjukkan bahwa Logtail telah dihentikan.

   kill process Name: ilogtail pid: 7
   kill process Name: ilogtail pid: 9
   stop success

3. Mulai Logtail.

   logtail-ds-gb92k adalah nama kontainer dan kube-system adalah namespace. Gantilah sesuai kebutuhan.

   kubectl exec logtail-ds-gb92k -n kube-system /etc/init.d/ilogtaild start

Hasil berikut menunjukkan bahwa Logtail telah dimulai.

ilogtail is running