All Products
Search
Document Center

Simple Log Service:Instal, jalankan, tingkatkan, dan uninstall Logtail

Last Updated:Aug 26, 2026

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:

  1. Login ke konsol Simple Log Service. Klik proyek yang mengelola resource log Anda untuk melihat daftar LogStore. Klik ikon image sebelum nama LogStore tempat log disimpan untuk memperluasnya, klik ikon image 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.

  2. Pada halaman Machine Group Configurations, pilih Servers dan ECS sebagai lingkungan instalasi, lalu klik Create Machine Group.

  3. 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.

  4. Setelah instalasi selesai, buka halaman imageResources > 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.sh dan menjalankan perintah ./logtail.sh install ${region_id} -v 1.8.7 untuk 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.gz

Salin 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}-acceleration

Server 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.gz

Salin 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}-acceleration

Windows

Catatan

> - 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: https://logtail-release.oss-cn-hangzhou.aliyuncs.com/win/win32/1.6.1.0/logtail_installer.zip

32-bit

Regions outside the Chinese mainland

Paket instalasi Logtail 32-bit: https://logtail-release-ap-southeast-1.oss-ap-southeast-1.aliyuncs.com/win/win32/1.6.1.0/logtail_installer.zip

64-bit

Regions in the Chinese mainland

Paket instalasi Logtail 64-bit: https://logtail-release.oss-cn-hangzhou.aliyuncs.com/win/win64/1.6.1.0/logtail_installer.zip

64-bit

Regions outside the Chinese mainland

Paket instalasi Logtail 64-bit: https://logtail-release-ap-southeast-1.oss-ap-southeast-1.aliyuncs.com/win/win64/1.6.1.0/logtail_installer.zip

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}-acceleration

Instalasi 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:

  1. Konsol ECS - Cloud AssistantDi pojok kiri atas halaman, pilih wilayah dan kelompok sumber daya.

  2. 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}-internet

    Bagaimana cara memperbarui konfigurasi kelompok mesin setelah saya mengganti instance ECS dari jaringan klasik ke VPC?.

  3. Pada 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 start

Hentikan Logtail

sudo /etc/init.d/ilogtaild stop

Windows

  1. Login ke server target.

  2. Pilih Start > Control Panel > Tools > Service.

  3. 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.

  4. 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.json

Hasil 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.

  1. Buka jendela Run, masukkan services.msc, lalu buka jendela Services.

  2. 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 perintah install, 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) adalah cn-hangzhou.

Pilih metode peningkatan Logtail dari tabel berikut:

Architecture

Download method

Upgrade method

ARM dan x86-64

Untuk server yang dapat mengakses Internet: wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh;

Setelah unduhan selesai, jalankan perintah peningkatan berikut: chmod +x logtail.sh; sudo ./logtail.sh upgrade;

ARM

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.gz;

Salin skrip instalasi dan paket instalasi ke server tempat Anda ingin meningkatkan Logtail, lalu jalankan perintah peningkatan berikut: chmod +x logtail.sh; ./logtail.sh upgrade-local;

x86-64

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.gz;

Salin skrip instalasi dan paket instalasi ke server tempat Anda ingin meningkatkan Logtail, lalu jalankan perintah peningkatan berikut: chmod +x logtail.sh; ./logtail.sh upgrade-local;

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.

Penting
  • 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 uninstall

Windows

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 uninstall

Setelah 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

  1. Login ke Konsol Manajemen Container Service

  2. Pada halaman Clusters, pilih More > Operations > Add-ons di kolom paling kanan kluster tujuan.

  3. Pada tab Logs and Monitoring, temukan logtail-ds lalu 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

  1. Login ke Konsol Manajemen Container Service

  2. Di panel navigasi sebelah kiri, klik Clusters.

  3. Pada halaman Clusters, klik Create Cluster.

  4. Pada langkah konfigurasi Component Configurations, pilih Enable Log Service.

Catatan

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. ClusterID adalah 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 logtail-daemonset, yang terutama digunakan untuk pengumpulan log.

k8s-group-my-cluster-123

Machine group

k8s-group-${your_k8s_cluster_id}-statefulset

Kelompok mesin logtail-statefulset, yang terutama digunakan untuk pengumpulan data deret waktu.

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

  1. 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.sh
  2. Modifikasi 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: true

    Parameter

    Description

    SlsProjectName

    Nama proyek tempat Logtail mengunggah log.

    Region

    ID wilayah tempat proyek Anda berada. Misalnya, ID wilayah Tiongkok (Hangzhou) adalah cn-hangzhou.

    AliUid

    ID Akun Alibaba Cloud tempat proyek berada. ID harus disertakan dalam tanda kutip ganda (""), misalnya, AliUid: "11**99".

    AccessKeyID

    ID 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.

    AccessKeySercret

    Rahasia 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.

    ClusterID

    ID 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.

    SlsMonitoring

    Menentukan apakah akan mengaktifkan pengumpulan data deret waktu kluster. Nilai valid: true (default), yang mengaktifkan pengumpulan data deret waktu kluster, dan false, yang menonaktifkan pengumpulan data deret waktu kluster.

    Net

    Jenis 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, dan Intranet, yaitu jaringan internal.

    SLS_CONTAINERD_USED

    Menentukan apakah runtime kontainer adalah containerd. Nilai valid: true, yang menunjukkan bahwa runtime kontainer adalah containerd, dan false (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.

  3. Instal Logtail dan komponen dependennya.

    Anda dapat menjalankan perintah echo "$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m)" untuk menanyakan OS-architecture host Anda. Skrip k8s-custom-install.sh mendukung kombinasi OS-architecture berikut: linux-386, linux-amd64, linux-arm, linux-arm64, linux-ppc64le, linux-s390x, dan darwin-amd64.

    bash k8s-custom-install.sh; kubectl apply -R -f result

    file values.yaml yang telah Anda modifikasi.

Resource type

Resource name

Description

Example

Machine group

k8s-group-${your_k8s_cluster_id}

Kelompok mesin logtail-daemonset, yang terutama digunakan untuk pengumpulan log.

k8s-group-my-cluster-123

Machine group

k8s-group-${your_k8s_cluster_id}-statefulset

Kelompok mesin logtail-statefulset, yang terutama digunakan untuk pengumpulan data deret waktu.

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 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 dan alamat IP Logtail.

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"
}

Tingkatkan dan kembalikan Logtail

  1. 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.yaml
  2. Pilih 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

Penting

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

  1. Login ke Konsol Manajemen Container Service.

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

  3. Pada kotak dialog Update, klik OK.

Penting

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

Penting

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.

  1. Login ke Konsol Manajemen Container Service

  2. Pilih Workloads > DaemonSets.

    Catatan

    Untuk meningkatkan alibaba-log-controller, pilih Workloads > Deployments. Lalu, temukan alibaba-log-controller di namespace kube-system dan selesaikan peningkatan.

  3. Atur Namespace ke kube-system, lalu klik Edit untuk 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. Tingkatkan Logtail.

  5. Untuk Image Version, klik Select Image Version.

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

  7. Di sisi kanan halaman, klik Update.

    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.

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.

Catatan

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.

  1. 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.

  2. 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.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

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

  1. Login ke Konsol Manajemen Container Service

  2. Pada tab Logs and Monitoring, temukan logtail-ds lalu klik Uninstall.

  3. 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 running

Bagaimana 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-system

alibaba-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 deploy untuk 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.

Catatan

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.LOG

Hasil 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:0

Bagaimana 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 stop

Hasil berikut menunjukkan bahwa Logtail dihentikan.

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

Jalankan 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 start

Hasil berikut menunjukkan bahwa Logtail dijalankan.

ilogtail is running