Instal klien Logtail pada setiap server target sebelum menggunakan proyek Simple Log Service untuk mengumpulkan log server. Topik ini menjelaskan cara menginstal, menjalankan, menghentikan, meningkatkan, dan meng-uninstall Logtail di lingkungan server maupun lingkungan kontainer.
Ikhtisar
Logtail digunakan dalam salah satu dari dua skenario berikut, tergantung pada jenis server target:
untuk lingkungan komputasi tradisional seperti server fisik dan instance Elastic Compute Service (ECS);
untuk beban kerja yang diterapkan pada platform kontainer Kubernetes.
Pilih solusi yang sesuai dengan lingkungan runtime server Anda. Prosedur dan persyaratan konfigurasi berbeda untuk kedua skenario tersebut. Dalam penerapan hibrida, lakukan instalasi dan konfigurasi secara terpisah pada masing-masing lingkungan.
Servers
Instal Logtail
Anda dapat menginstal Logtail dengan dua cara: instalasi satu klik atau instalasi manual. Simple Log Service hanya mendukung instalasi satu klik jika Anda menggunakan instance ECS dan instance tersebut serta proyek berada dalam Akun Alibaba Cloud yang sama serta berada di wilayah yang sama. Untuk semua kasus lainnya, instal Logtail secara manual.
Instalasi satu klik
Simple Log Service dapat menginstal Logtail pada instance ECS dengan satu klik. Instalasi ini bergantung pada kemampuan orkestrasi CloudOps Orchestration Service (OOS), sehingga Anda tidak perlu login ke instance ECS dan menjalankan langkah-langkah instalasi secara manual. Jika Anda login dengan Akun Alibaba Cloud, Anda secara default memiliki semua izin yang diperlukan dan dapat langsung melakukan operasi tersebut.
Jika Anda login sebagai Pengguna RAM, mintalah pemilik Akun Alibaba Cloud untuk memberikan izin kepada Anda guna mengelola sumber daya OOS. Pemilik akun dapat menggunakan kebijakan sistem atau kebijakan kustom untuk membuat Pengguna RAM dan memberikan izin kepada Pengguna RAM tersebut:
Kebijakan sistem:
AliyunOOSFullAccess: memberikan izin penuh untuk mengelola CloudOps Orchestration Service (OOS).AliyunECSFullAccess: memberikan izin untuk mengelola ECS.
Kebijakan kustom: Jika Anda memiliki persyaratan keamanan data yang ketat, Anda dapat membuat kebijakan kustom untuk otorisasi detail halus. Kebijakan berikut memberikan izin untuk mengelola sumber daya OOS:
{
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Action": [
"ecs:DescribeTagKeys",
"ecs:DescribeTags",
"ecs:DescribeInstances",
"ecs:DescribeInvocationResults",
"ecs:RunCommand",
"ecs:DescribeInvocations",
"ecs:InvokeCommand"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"oos:ListTemplates",
"oos:StartExecution",
"oos:ListExecutions",
"oos:GetExecutionTemplate",
"oos:ListExecutionLogs",
"oos:ListTaskExecutions"
],
"Resource": "*"
}
]
}Untuk menginstal Logtail pada instance ECS dan membuat serta mengonfigurasi kelompok mesin secara bersamaan, lakukan langkah-langkah berikut:
Login ke konsol Simple Log Service. Klik proyek yang mengelola resource log Anda untuk melihat daftar LogStore. Klik ikon
sebelum nama LogStore tempat log disimpan untuk memperluasnya, klik ikon
yang muncul setelah Data Collection, pilih templat log teks di kotak dialog, lalu klik Integrate Now.Simple Log Service menyediakan beberapa templat log teks, seperti templat ekspresi reguler, baris tunggal, dan multi-baris. Templat-templat tersebut hanya berbeda pada plug-in penguraian log-nya. Konfigurasi lainnya identik. Anda juga dapat menambahkan atau menghapus plug-in penguraian log dalam templat. Pilih templat berdasarkan karakteristik log yang ingin Anda kumpulkan, atau pilih templat log teks apa pun lalu konfigurasikan plug-in berdasarkan karakteristik log Anda.
Pada halaman Machine Group Configurations, pilih Servers dan ECS sebagai lingkungan instalasi, lalu klik Create Machine Group.
Pada panel Create Machine Group, pilih satu atau beberapa instance ECS yang berada di wilayah yang sama dengan proyek, klik Install and Create Machine Group, tunggu hingga instalasi selesai, tentukan Name kelompok mesin, lalu klik OK.
Jika instalasi gagal atau tetap dalam status menunggu, periksa apakah instance ECS berada di wilayah yang sama dengan proyek.
Setelah instalasi selesai, buka halaman
Resources > Machine Groups, klik kelompok mesin yang telah Anda buat, lalu periksa status Heartbeat pada bagian Machine Group Configurations > Machine Group Status. Status heartbeat OK menunjukkan bahwa kelompok mesin telah berhasil dibuat.
Instalasi manual
Pilih metode unduh dan instalasi Logtail berdasarkan sistem operasi dan arsitektur CPU server Anda.
Pada contoh kode, ${region_id} adalah wilayah tempat proyek Simple Log Service berada. Ganti dengan ID wilayah aktual dengan merujuk ke Wilayah yang didukung. Misalnya, ${region_id} untuk Tiongkok (Hangzhou) adalah cn-hangzhou.
Sebelum menginstal Logtail, pertimbangkan hal-hal berikut:
Kompatibilitas Logtail 2.0: Jika mesin Anda memiliki spesifikasi rendah atau menjalankan sistem operasi lama, Logtail 2.0 dapat menyebabkan masalah kompatibilitas yang menghalangi perangkat lunak berjalan dengan baik. Dalam kasus ini, kami merekomendasikan agar Anda mengunduh versi 1.8.7 dari
https://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/1.8.7/logtail.shdan menjalankan perintah./logtail.sh install ${region_id} -v 1.8.7untuk menginstalnya.
Linux
Versi berikut dari server Linux x86-64 (64-bit) didukung: Alibaba Cloud Linux 2 dan 3.
Anolis OS 7 dan 8, CentOS Linux 6, 7, dan 8, serta Debian GNU/Linux 8, 9, 10, 11, dan 12
Red Hat Enterprise Linux 6, 7, 8, dan 9
openSUSE 15.1, 15.2, dan 42.3
SUSE Linux Enterprise Server 11, 12, dan 15; Ubuntu 14.04, 16.04, 18.04, 20.04, 22.04, dan 24.04; serta sistem operasi Linux lain berbasis glibc 2.5 atau lebih baru. Logtail 2.0 atau versi lebih baru memerlukan glibc 2.6 atau lebih baru.
CPU harus mendukung set instruksi sse4_2 dan avx untuk Logtail 2.0 atau versi lebih baru. Versi berikut dari server Linux ARM (64-bit) didukung: Alibaba Cloud Linux 3.2 untuk ARM, Anolis OS 8.2 untuk ARM atau versi lebih baru, serta CentOS 8.4 untuk ARM.
Debian 11.2 dan 12.2 untuk ARM; Ubuntu 20.04, 22.04, dan 24.04 untuk ARM
Arsitektur CPU minimum yang diperlukan adalah ARMv8.2-A untuk Logtail 2.0 atau versi lebih baru.
Server yang dapat mengakses Internet (ARM dan x86-64)
Untuk server yang dapat mengakses Internet, unduh Logtail secara langsung:
# Unduh melalui jaringan internal
wget http://logtail-release-${region_id}.oss-${region_id}-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh;
# Unduh melalui Internet
wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh;Pilih perintah instalasi berdasarkan kondisi jaringan Anda:
# Instal melalui Internet.
chmod +x logtail.sh; ./logtail.sh install ${region_id}-internet
# Jika server Anda berada di pusat data lokal di luar Tiongkok daratan atau disediakan oleh penyedia cloud di luar Tiongkok daratan, transfer data melalui Internet dapat menyebabkan latensi jaringan tinggi dan transfer tidak stabil. Kami merekomendasikan agar Anda menggunakan akselerasi transfer untuk mentransfer data.
chmod +x logtail.sh; ./logtail.sh install ${region_id}-acceleration
# Instal melalui jaringan internal. Metode ini berlaku untuk pusat data lokal yang terhubung ke jaringan internal.
chmod +x logtail.sh; ./logtail.sh install ${region_id}Server ARM yang offline
Untuk server offline, unduh terlebih dahulu skrip instalasi dan paket instalasi pada server yang dapat mengakses Internet:
wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh; wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/aarch64/logtail-linux64.tar.gzSalin skrip instalasi dan paket instalasi ke server tempat Anda ingin menginstal Logtail, lalu pilih perintah instalasi berdasarkan kondisi jaringan Anda:
# Instal melalui Internet.
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-internet
# Jika server Anda berada di pusat data lokal di luar Tiongkok daratan atau disediakan oleh penyedia cloud di luar Tiongkok daratan, transfer data melalui Internet dapat menyebabkan latensi jaringan tinggi dan transfer tidak stabil. Kami merekomendasikan agar Anda menggunakan akselerasi transfer untuk mentransfer data.
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-accelerationServer x86-64 yang offline
Untuk server offline, unduh terlebih dahulu skrip instalasi dan paket instalasi pada server yang dapat mengakses Internet:
wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh; wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail-linux64.tar.gzSalin skrip instalasi dan paket instalasi ke server tempat Anda ingin menginstal Logtail, lalu pilih perintah instalasi berdasarkan kondisi jaringan Anda:
# Instal melalui Internet.
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-internet
# Jika server Anda berada di pusat data lokal di luar Tiongkok daratan atau disediakan oleh penyedia cloud di luar Tiongkok daratan, transfer data melalui Internet dapat menyebabkan latensi jaringan tinggi dan transfer tidak stabil. Kami merekomendasikan agar Anda menggunakan akselerasi transfer untuk mentransfer data.
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-accelerationWindows
> - Pada Microsoft Windows Server 2008 dan Microsoft Windows 7, Anda dapat menginstal Logtail pada versi x86 atau x86_64. > - Pada sistem operasi Windows lainnya, Anda hanya dapat menginstal Logtail pada versi x86_64.
Versi Windows berikut didukung: - Microsoft Windows Server 2008, 2012, 2016, 2019, 2022, dan 2025 - Microsoft Windows 7 - Microsoft Windows 10 - Microsoft Windows Server Versi 1909 - Microsoft Windows Server Versi 2004
Unduh paket instalasi yang sesuai dengan arsitektur server Anda dan wilayah proyek Anda:
Architecture | Region of the project | Installation package |
32-bit | Regions in the Chinese mainland | Paket instalasi Logtail 32-bit: |
32-bit | Regions outside the Chinese mainland | Paket instalasi Logtail 32-bit: |
64-bit | Regions in the Chinese mainland | Paket instalasi Logtail 64-bit: |
64-bit | Regions outside the Chinese mainland | Paket instalasi Logtail 64-bit: |
Ekstrak paket instalasi, jalankan Windows PowerShell sebagai administrator, lalu masuk ke direktori logtail_installer, yaitu direktori tempat Anda mengekstrak paket instalasi. Pilih perintah instalasi berdasarkan kondisi jaringan Anda:
# Instal melalui Internet.
.\logtail_installer.exe install ${region_id}-internet
# Jika server Anda berada di pusat data lokal di luar Tiongkok daratan atau disediakan oleh penyedia cloud di luar Tiongkok daratan, transfer data melalui Internet dapat menyebabkan latensi jaringan tinggi dan transfer tidak stabil. Kami merekomendasikan agar Anda menggunakan akselerasi transfer untuk mentransfer data.
.\logtail_installer.exe install ${region_id}-accelerationInstalasi batch Logtail
Anda dapat menginstal Logtail secara batch dengan salah satu dari dua cara berikut:
Orkestrasi OOS: berlaku untuk skenario yang memiliki persyaratan izin. Metode ini mendukung konkurensi tinggi dan cocok untuk operasi batch skala besar. Untuk informasi selengkapnya, lihat Gunakan OOS untuk menginstal atau meningkatkan Logtail secara batch.
ECS Cloud Assistant: mudah digunakan. Anda menjalankan perintah untuk melakukan tugas satu kali.
Untuk menginstal Logtail secara batch menggunakan ECS Cloud Assistant, ikuti langkah-langkah berikut:
Konsol ECS - Cloud Assistant,Di pojok kiri atas halaman, pilih wilayah dan kelompok sumber daya.
Pada panel Create Command, masukkan perintah instalasi di bidang Command Content. Contoh ini menggunakan instalasi melalui Internet.
Perintah instalasi berikut digunakan dalam contoh ini:
#!/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}-internetPada bagian Select Instances, pastikan status Agent pada instance tujuan adalah Normal. Jika status abnormal, lihat Instal Cloud Assistant Agent untuk menyelesaikan instalasi Cloud Assistant. Pilih instance tujuan dan klik Execute. Status eksekusi kemudian berubah menjadi Execution Succeeded. Jika eksekusi gagal, lihat Lihat hasil eksekusi dan atasi masalah umum.
Jalankan dan hentikan Logtail
Linux
Jalankan Logtail
sudo /etc/init.d/ilogtaild startHentikan Logtail
sudo /etc/init.d/ilogtaild stopWindows
Login ke server target.
Pilih Start > Control Panel > Tools > Service.
Pada kotak dialog Service, temukan layanan yang diperlukan.
Untuk versi 0.x.x.x, pilih layanan LogtailWorker.
Untuk versi 1.0.0.0 atau lebih baru, pilih layanan LogtailDaemon.
Klik kanan layanan tersebut dan pilih operasi yang diperlukan, seperti Start, Stop, atau Restart.
Periksa status dan versi Logtail
Linux
Periksa status Logtail di Linux
Jalankan perintah sudo /etc/init.d/ilogtaild status untuk memeriksa status Logtail. Jika sistem mengembalikan ilogtail is running, Logtail telah terinstal. Jika Logtail tidak berjalan, uninstall lalu instal ulang.
Periksa versi Logtail di Linux
Logtail menyimpan informasi versinya di bidang logtail_version pada file /usr/local/ilogtail/app_info.json. Jalankan perintah berikut untuk melihat informasi versi Logtail.
cat /usr/local/ilogtail/app_info.jsonHasil berikut dikembalikan:
{
"logtail_version" : "0.16.30",
}Windows
Periksa status Logtail di Windows
Periksa status Logtail untuk menentukan apakah Logtail telah terinstal pada server target.
Buka jendela Run, masukkan
services.msc, lalu buka jendela Services.Periksa status berjalan layanan LogtailDaemon, yang berlaku untuk Logtail 1.0.0.0 atau lebih baru, atau layanan LogtailWorker, yang berlaku untuk Logtail 0.x.x.x.
Status Running menunjukkan bahwa Logtail telah terinstal.
Periksa versi Logtail di Windows
Anda dapat memeriksa versi Logtail di bidang logtail_version pada file app_info.json di path instalasi.
Misalnya, konten berikut menunjukkan bahwa versi Logtail adalah 1.0.0.0.
{
"logtail_version" : "1.0.0.0"
}Tingkatkan Logtail
Linux
Sebelum meningkatkan Logtail pada server Linux, pertimbangkan hal-hal berikut:
Perintah upgrade: Untuk meningkatkan Logtail, gunakan perintah
upgrade. Jika Anda menggunakan perintahinstall, instalasi overwrite akan dilakukan dan konfigurasi asli akan hilang.Interrupsi layanan: Selama peningkatan, Logtail berhenti sejenak. Setelah peningkatan selesai, Logtail akan mulai secara otomatis dan didaftarkan sebagai item startup. Peningkatan hanya menimpa file yang diperlukan. File konfigurasi dan file checkpoint dipertahankan, sehingga memastikan tidak ada log yang hilang selama peningkatan.
Pada contoh kode,
${region_id}merujuk pada wilayah tempat proyek Simple Log Service berada. Gantilah dengan ID wilayah aktual dengan mengacu pada Wilayah yang didukung. Sebagai contoh,${region_id}untuk Tiongkok (Hangzhou) adalahcn-hangzhou.
Pilih metode peningkatan Logtail dari tabel berikut:
Architecture | Download method | Upgrade method |
ARM dan x86-64 | Untuk server yang dapat mengakses Internet: | Setelah unduhan selesai, jalankan perintah peningkatan berikut: |
ARM | Untuk server offline, unduh terlebih dahulu skrip instalasi dan paket instalasi pada server yang dapat mengakses Internet: | Salin skrip instalasi dan paket instalasi ke server tempat Anda ingin meningkatkan Logtail, lalu jalankan perintah peningkatan berikut: |
x86-64 | Untuk server offline, unduh terlebih dahulu skrip instalasi dan paket instalasi pada server yang dapat mengakses Internet: | Salin skrip instalasi dan paket instalasi ke server tempat Anda ingin meningkatkan Logtail, lalu jalankan perintah peningkatan berikut: |
Informasi berikut menunjukkan bahwa peningkatan berhasil.
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"
}Windows
Prosedur peningkatan sama dengan prosedur instalasi. Unduh dan ekstrak paket instalasi terbaru, lalu lakukan langkah-langkah instalasi.
Peningkatan setara dengan uninstallasi dan instalasi ulang otomatis. Konten di direktori instalasi asli akan dihapus. Backup data Anda sebelum melakukan peningkatan.
Pada sistem operasi Windows 64-bit, untuk meningkatkan Logtail 32-bit ke Logtail 64-bit, Anda harus terlebih dahulu meng-uninstall Logtail 32-bit lalu menginstal Logtail 64-bit.
Uninstall Logtail
Linux
Dapatkan ${region_id} wilayah tempat proyek Simple Log Service Anda berada. Ganti ${region_id} lalu jalankan perintah berikut untuk meng-uninstall Logtail.
Untuk ${region_id} setiap wilayah, lihat Wilayah yang didukung. Misalnya, ${region_id} untuk Tiongkok (Hangzhou) adalah 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 uninstallWindows
Jalankan Windows PowerShell atau cmd sebagai administrator, masuk ke direktori logtail_installer, yaitu direktori tempat Anda mengekstrak paket instalasi, lalu jalankan perintah berikut.
.\logtail_installer.exe uninstallSetelah uninstallasi selesai, direktori instalasi Logtail akan dihapus, tetapi beberapa konfigurasi tetap disimpan di direktori C:\LogtailData. Anda dapat menghapusnya secara manual sesuai kebutuhan. Informasi yang disimpan meliputi:
checkpoint: menyimpan informasi checkpoint semua plug-in Logtail. File ini hanya ada setelah Anda menggunakan plug-in Logtail.
user_config.d: direktori yang menyimpan konfigurasi pengumpulan lokal. File dengan ekstensi .json dianggap sebagai konfigurasi pengumpulan. Formatnya mirip dengan /usr/local/ilogtail/user_log_config.json.
logtail_check_point: menyimpan informasi checkpoint komponen utama Logtail.
users: menyimpan file identifier pengguna yang telah Anda konfigurasikan.
Skenario kontainer
Instal komponen Logtail
Jika Anda menggunakan kluster ACK dan kluster tersebut berada dalam Akun Alibaba Cloud yang sama dengan Simple Log Service, rujuk metode instalasi untuk kluster ACK. Jika Anda menggunakan kluster yang dikelola sendiri, atau kluster ACK yang berada dalam Akun Alibaba Cloud berbeda dengan Simple Log Service, rujuk metode instalasi untuk kluster yang dikelola sendiri.
Kluster ACK
Operasi ini hanya berlaku untuk kluster Kubernetes khusus dan kluster Kubernetes yang dikelola.
Instal komponen Logtail untuk kluster ACK yang sudah ada
Login ke Konsol Manajemen Container Service
Pada halaman Clusters, pilih More > Operations > Add-ons di kolom paling kanan kluster tujuan.
Pada tab Logs and Monitoring, temukan
logtail-dslalu klik Install.Setelah instalasi selesai, Simple Log Service secara otomatis membuat proyek bernama
k8s-log-${your_k8s_cluster_id}.
Instal komponen Logtail saat membuat kluster ACK
Login ke Konsol Manajemen Container Service
Di panel navigasi sebelah kiri, klik Clusters.
Pada halaman Clusters, klik Create Cluster.
Pada langkah konfigurasi Component Configurations, pilih Enable Log Service.
Bagian ini hanya menjelaskan langkah-langkah utama untuk mengaktifkan Simple Log Service. Untuk informasi selengkapnya tentang cara membuat kluster, lihat Buat kluster ACK yang dikelola.
Setelah Anda memilih Enable Log Service, muncul pesan yang meminta Anda membuat proyek. Untuk informasi selengkapnya tentang cara Simple Log Service mengorganisasi log, lihat Project. Anda dapat membuat proyek dengan salah satu dari dua cara berikut:
Select Project: Anda dapat memilih proyek yang sudah ada untuk mengelola log kontainer yang dikumpulkan.
Create Project: Simple Log Service secara otomatis membuat proyek untuk mengelola log kontainer yang dikumpulkan.
ClusterIDadalah identifier unik kluster Kubernetes yang Anda buat.Pada bagian Log Service, pilih Enable Log Service. Setelah Anda memilih Create a new project, sistem secara otomatis membuat proyek bernama
k8s-log-{ClusterID}.
Setelah instalasi selesai, resource Simple Log Service berikut secara otomatis dibuat di proyek yang dipilih.
Resource type | Resource name | Description | Example |
Machine group | k8s-group-${your_k8s_cluster_id} | Kelompok mesin | k8s-group-my-cluster-123 |
Machine group | k8s-group-${your_k8s_cluster_id}-statefulset | Kelompok mesin | k8s-group-my-cluster-123-statefulset |
Machine group | k8s-group-${your_k8s_cluster_id}-singleton | Kelompok mesin instans tunggal, yang terutama digunakan untuk beberapa konfigurasi pengumpulan instans tunggal. | k8s-group-my-cluster-123-singleton |
LogStore | config-operation-log | Menyimpan log alibaba-log-controller dalam komponen Logtail. Kami merekomendasikan agar Anda tidak membuat konfigurasi pengumpulan di LogStore ini. Anda dapat menghapus LogStore ini. Setelah LogStore dihapus, log operasional alibaba-log-controller tidak lagi dikumpulkan. LogStore ini ditagih dengan cara yang sama seperti LogStore biasa. Untuk informasi selengkapnya, lihat Penagihan berdasarkan data yang ditulis. | config-operation-log |
Kluster yang dikelola sendiri
Login ke kluster Kubernetes Anda dan pilih perintah berdasarkan wilayah untuk mengunduh Logtail dan komponen dependennya.
# Wilayah di Tiongkok daratan wget https://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/kubernetes/0.5.5/alibaba-cloud-log-all.tgz; tar xvf alibaba-cloud-log-all.tgz; chmod 744 ./alibaba-cloud-log-all/k8s-custom-install.sh # Wilayah di luar Tiongkok daratan wget https://logtail-release-ap-southeast-1.oss-ap-southeast-1.aliyuncs.com/kubernetes/0.5.5/alibaba-cloud-log-all.tgz; tar xvf alibaba-cloud-log-all.tgz; chmod 744 ./alibaba-cloud-log-all/k8s-custom-install.shModifikasi file konfigurasi
./alibaba-cloud-log-all/values.yaml.File konfigurasi berisi parameter berikut:
# ===================== Required content ===================== # Nama proyek tujuan. SlsProjectName: # Wilayah tempat proyek berada. Region: # ID Akun Alibaba Cloud tempat proyek berada. Sertakan ID dalam tanda kutip ganda (""). AliUid: "11099" # ID AccessKey dan Rahasia AccessKey dari Akun Alibaba Cloud atau Pengguna RAM. Izin AliyunLogFullAccess diperlukan. AccessKeyID: AccessKeySercret: # ID kluster kustom. ID hanya boleh berisi huruf, angka, dan tanda hubung (-). ClusterID: # ========================================================== # Menentukan apakah akan mengaktifkan komponen terkait pengumpulan data deret waktu. Nilai valid: true dan false. Nilai default: true. SlsMonitoring: true # Jenis jaringan. Nilai valid: Internet dan Intranet. Nilai default: Internet. Net: Internet # Menentukan apakah runtime kontainer adalah containerd. Nilai valid: true dan false. Nilai default: false. SLS_CONTAINERD_USED: trueParameter
Description
SlsProjectNameNama proyek tempat Logtail mengunggah log.
RegionID wilayah tempat proyek Anda berada. Misalnya, ID wilayah Tiongkok (Hangzhou) adalah
cn-hangzhou.AliUidID Akun Alibaba Cloud tempat proyek berada. ID harus disertakan dalam tanda kutip ganda (""), misalnya,
AliUid: "11**99".AccessKeyIDID AccessKey dari Akun Alibaba Cloud tempat proyek berada. Kami merekomendasikan agar Anda menggunakan Pasangan Kunci Akses Pengguna RAM dan memberikan izin AliyunLogFullAccess kepada Pengguna RAM tersebut.
AccessKeySercretRahasia AccessKey dari Akun Alibaba Cloud tempat proyek berada. Kami merekomendasikan agar Anda menggunakan Pasangan Kunci Akses Pengguna RAM dan memberikan izin AliyunLogFullAccess kepada Pengguna RAM tersebut.
ClusterIDID kluster kustom. ID hanya boleh berisi huruf, angka, dan tanda hubung (-). Parameter ini sesuai dengan
${your_k8s_cluster_id}dalam operasi selanjutnya. Jangan konfigurasikan ID kluster yang sama untuk kluster Kubernetes yang berbeda.SlsMonitoringMenentukan apakah akan mengaktifkan pengumpulan data deret waktu kluster. Nilai valid:
true(default), yang mengaktifkan pengumpulan data deret waktu kluster, danfalse, yang menonaktifkan pengumpulan data deret waktu kluster.NetJenis jaringan yang digunakan Logtail untuk mentransfer data. Jika kluster Anda tidak terhubung ke jaringan internal Alibaba Cloud, gunakan internet. Nilai valid:
Internet(default), yaitu internet, danIntranet, yaitu jaringan internal.SLS_CONTAINERD_USEDMenentukan apakah runtime kontainer adalah containerd. Nilai valid:
true, yang menunjukkan bahwa runtime kontainer adalah containerd, danfalse(default), yang menunjukkan bahwa runtime kontainer bukan containerd. Di kluster Kubernetes yang dikelola sendiri yang menggunakan containerd sebagai runtime kontainer, log mungkin tidak dikumpulkan oleh Logtail jika parameter ini tidak diaktifkan.Instal Logtail dan komponen dependennya.
Anda dapat menjalankan perintah
echo "$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m)"untuk menanyakanOS-architecturehost Anda. Skripk8s-custom-install.shmendukung kombinasiOS-architectureberikut: linux-386, linux-amd64, linux-arm, linux-arm64, linux-ppc64le, linux-s390x, dan darwin-amd64.bash k8s-custom-install.sh; kubectl apply -R -f resultfile
values.yamlyang telah Anda modifikasi.
Resource type | Resource name | Description | Example |
Machine group | k8s-group-${your_k8s_cluster_id} | Kelompok mesin | k8s-group-my-cluster-123 |
Machine group | k8s-group-${your_k8s_cluster_id}-statefulset | Kelompok mesin | k8s-group-my-cluster-123-statefulset |
Machine group | k8s-group-${your_k8s_cluster_id}-singleton | Kelompok mesin instans tunggal, yang terutama digunakan untuk beberapa konfigurasi pengumpulan instans tunggal. | k8s-group-my-cluster-123-singleton |
LogStore | config-operation-log | Menyimpan log alibaba-log-controller dalam komponen Logtail. Kami merekomendasikan agar Anda tidak membuat konfigurasi pengumpulan di LogStore ini. Anda dapat menghapus LogStore ini. Setelah LogStore dihapus, log operasional alibaba-log-controller tidak lagi dikumpulkan. LogStore ini ditagih dengan cara yang sama seperti LogStore biasa. Untuk informasi selengkapnya, lihat Penagihan berdasarkan data yang ditulis. | N/A |
Status, versi, dan alamat IP Logtail
Jalankan perintah berikut untuk memeriksa status Logtail.
kubectl get po -n kube-system | grep logtailHasil berikut dikembalikan:
NAME READY STATUS RESTARTS AGE
logtail-ds-gb92k 1/1 Running 0 2h
logtail-ds-wm7lw 1/1 Running 0 4dJalankan perintah berikut untuk melihat informasi seperti nomor versi dan alamat IP Logtail.
kubectl exec logtail-ds-gb92k -n kube-system cat /usr/local/ilogtail/app_info.jsonHasil 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"
}Tingkatkan dan kembalikan Logtail
Sebelum peningkatan, backup file deskripsi komponen Logtail.
Jika latensi pengumpulan yang signifikan sudah ada sebelum peningkatan, peningkatan Logtail dapat menyebabkan sejumlah kecil data log hilang.
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.yamlPilih metode peningkatan komponen berdasarkan kluster Anda. Jika Anda menggunakan kluster ACK dan kluster tersebut berada dalam Akun Alibaba Cloud yang sama dengan Simple Log Service, rujuk metode peningkatan untuk kluster ACK. Jika Anda menggunakan kluster yang dikelola sendiri, atau kluster ACK yang berada dalam Akun Alibaba Cloud berbeda dengan Simple Log Service, rujuk metode peningkatan untuk kluster yang dikelola sendiri.
Kluster ACK
Dalam kebanyakan kasus, kami merekomendasikan agar Anda menggunakan metode peningkatan otomatis. Jika Anda memodifikasi parameter, seperti variabel lingkungan, dalam DaemonSet logtail-ds atau dalam Deployment alibaba-log-controller, gunakan metode peningkatan manual untuk mencegah modifikasi Anda direset.
Peningkatan otomatis
Peningkatan otomatis mereset konfigurasi yang Anda modifikasi secara manual dalam logtail-ds dan alibaba-log-controller.
Login ke Konsol Manajemen Container Service.
Pada tab Logs and Monitoring, temukan
logtail-dslalu klik Upgrade.Pada kotak dialog Update, klik OK.
Jika Anda tidak dapat meningkatkan ke versi Logtail terbaru, versi kluster Kubernetes Anda terlalu lama. Tingkatkan kluster Kubernetes terlebih dahulu, atau gunakan metode peningkatan manual.
Setelah Anda melakukan peningkatan, Anda dapat memeriksa status pod logtail-ds di konsol manajemen Container Service. Jika semua pod logtail-ds berada dalam status Running, peningkatan berhasil.
Peningkatan manual
Peningkatan manual tidak memperbarui konfigurasi Anda berdasarkan versi terbaru komponen Logtail, sehingga beberapa optimasi fitur mungkin tidak tersedia.
Peningkatan manual mencakup logtail-ds dan alibaba-log-controller. Dalam kebanyakan kasus, Anda hanya perlu meningkatkan logtail-ds untuk mendapatkan kemampuan pengumpulan versi Logtail baru. Untuk mendapatkan kemampuan pengumpulan yang disediakan oleh CRD Logtail baru, Anda harus meningkatkan alibaba-log-controller. Langkah-langkah berikut menggunakan logtail-ds sebagai contoh.
Login ke Konsol Manajemen Container Service
Pilih Workloads > DaemonSets.
CatatanUntuk meningkatkan alibaba-log-controller, pilih Workloads > Deployments. Lalu, temukan alibaba-log-controller di namespace kube-system dan selesaikan peningkatan.
Atur Namespace ke kube-system, lalu klik Edit untuk
logtail-ds.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. Tingkatkan Logtail.
Untuk Image Version, klik Select Image Version.
Pada kotak dialog Image Version, klik versi terbaru, lalu klik OK.
Di sisi kanan halaman, klik Update.
Setelah Anda melakukan peningkatan, Anda dapat memeriksa status pod
logtail-dsdi konsol manajemen Container Service. Jika semua podlogtail-dsberada dalam status Running, peningkatan berhasil.
Kluster yang dikelola sendiri
Kami merekomendasikan agar Anda meningkatkan dengan menginstal komponen Logtail terbaru. Jika Anda hanya memperbarui nomor versi gambar beberapa komponen, seperti logtail-ds atau alibaba-log-controller, peningkatan mungkin gagal.
Untuk menyelesaikan peningkatan otomatis, instal ulang komponen Logtail.
Untuk mengembalikan ke versi tertentu, lakukan langkah-langkah berikut.
File YAML yang Anda backup sebelum peningkatan berisi informasi berlebihan. Anda harus menghapus informasi berlebihan tersebut secara manual sebelum dapat menggunakan file tersebut untuk memulihkan konfigurasi Logtail. Anda dapat menggunakan tool kubectl-neat untuk melakukan operasi ini. Bidang yang harus Anda hapus adalah metadata.creationTimestamp, metadata.generation, metadata.resourceVersion, metadata.uid, dan status.
Tentukan apakah akan mempertahankan konfigurasi Logtail baru yang dibuat setelah peningkatan berdasarkan kebutuhan bisnis Anda.
Jika Anda tidak ingin mempertahankannya, Anda dapat menghapus konfigurasi Logtail baru yang dibuat setelah peningkatan.
Hapus informasi berlebihan 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.yamlTerapkan 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
Uninstall komponen Logtail
Pilih metode uninstallasi komponen berdasarkan kluster Anda. Jika Anda menggunakan kluster ACK dan kluster tersebut berada dalam Akun Alibaba Cloud yang sama dengan Simple Log Service, rujuk metode uninstallasi untuk kluster ACK. Jika Anda menggunakan kluster yang dikelola sendiri, atau kluster ACK yang berada dalam Akun Alibaba Cloud berbeda dengan Simple Log Service, rujuk metode uninstallasi untuk kluster yang dikelola sendiri.
Kluster ACK
Login ke Konsol Manajemen Container Service
Pada tab Logs and Monitoring, temukan
logtail-dslalu klik Uninstall.Ikuti petunjuk di layar untuk mengklik OK dan selesaikan uninstallasi.
Kluster yang dikelola sendiri
Jalankan perintah kubectl delete -R -f result untuk meng-uninstall komponen yang telah diinstal seperti logtail-ds dan alibaba-log-controller.
Perintah ini menghapus semua resource di direktori result secara rekursif. Gunakan dengan hati-hati jika direktori tersebut berisi resource lain.
FAQ tentang kluster
Bagaimana beberapa kluster Kubernetes berbagi satu proyek Simple Log Service?
Jika Anda ingin mengumpulkan log kontainer dari beberapa kluster ke proyek Simple Log Service yang sama, pertahankan parameter instalasi sama dengan parameter yang Anda gunakan saat menginstal komponen Simple Log Service untuk kluster pertama.
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 kontainer Logtail tidak bermakna. Abaikan 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 runningBagaimana cara memeriksa status komponen Simple Log Service di kluster Kubernetes?
Jalankan perintah berikut.
kubectl get deploy alibaba-log-controller -n kube-system
kubectl get ds logtail-ds -n kube-systemalibaba-log-controller gagal dimulai. Apa yang harus saya lakukan?
Periksa apakah Anda melakukan instalasi dengan cara berikut.
Jalankan perintah instalasi pada node master kluster Kubernetes.
Masukkan ID kluster Anda dalam parameter perintah instalasi.
Jika instalasi gagal karena salah satu alasan di atas, jalankan perintah
kubectl delete -f deployuntuk menghapus templat instalasi yang dihasilkan, lalu jalankan kembali perintah instalasi.
Bagaimana cara memeriksa status DaemonSet Logtail-ds di kluster Kubernetes?
Jalankan perintah kubectl get ds -n kube-system untuk memeriksa status DaemonSet Logtail-ds.
Secara default, kontainer Logtail berada di namespace kube-system.
Bagaimana cara melihat log operasional Logtail?
Log operasional Logtail disimpan di direktori /usr/local/ilogtail/. Nama file-nya adalah ilogtail.LOG, dan file yang telah diputar disimpan dalam bentuk terkompresi sebagai ilogtail.LOG.x.gz. Misalnya, jalankan perintah berikut untuk melihat log.
kubectl exec logtail-ds-gb92k -n kube-system tail /usr/local/ilogtail/ilogtail.LOGHasil berikut dikembalikan:
[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:0Bagaimana cara me-restart Logtail di pod?
Jalankan perintah berikut untuk menghentikan Logtail. Dalam perintah ini, logtail-ds-gb92k adalah nama kontainer dan kube-system adalah namespace. Ganti dengan nilai aktual.
kubectl exec logtail-ds-gb92k -n kube-system /etc/init.d/ilogtaild stopHasil berikut menunjukkan bahwa Logtail dihentikan.
kill process Name: ilogtail pid: 7
kill process Name: ilogtail pid: 9
stop successJalankan perintah berikut untuk menjalankan Logtail. Dalam perintah ini, logtail-ds-gb92k adalah nama kontainer dan kube-system adalah namespace. Ganti dengan nilai aktual.
kubectl exec logtail-ds-gb92k -n kube-system /etc/init.d/ilogtaild startHasil berikut menunjukkan bahwa Logtail dijalankan.
ilogtail is running