All Products
Search

This Product

    Simple Log Service:Instal LoongCollector

    Document Center

    Simple Log Service:Instal LoongCollector

    Last Updated:Jun 22, 2026

    LoongCollector adalah agen pengumpulan log untuk Simple Log Service (SLS). Untuk mengumpulkan log dari server Linux, Anda harus terlebih dahulu menginstal LoongCollector pada server tersebut.

    Batasan

    Sistem operasi Linux yang didukung

    • Sistem operasi Linux 64-bit (x86-64) berikut ini didukung:

      • Alibaba Cloud Linux 2 dan 3

      • Anolis OS 7 dan 8

      • CentOS 6, 7, dan 8

      • Debian 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

      • Sistem operasi Linux lain yang berbasis glibc 2.6 atau lebih baru

      • CPU harus mendukung set instruksi SSE4.2 dan AVX.

    • Sistem operasi Linux ARM 64-bit berikut ini didukung:

      • Alibaba Cloud Linux 3.2 untuk ARM

      • Anolis OS 8.2 untuk ARM atau versi lebih baru

      • 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 harus ARMv8.2-A atau lebih baru.

    Prasyarat

    Izin

    Login ke konsol Alibaba Cloud dengan akun root secara default memberikan izin yang diperlukan.

    Jika Anda adalah Pengguna RAM, mintalah pemilik akun root untuk menerapkan kebijakan sistem berikut agar Anda memiliki izin yang diperlukan untuk mengelola resource SLS, ECS, dan Operation Orchestration Service (OOS).

    • AliyunLogFullAccess: Memberikan izin penuh untuk mengelola SLS.

    • AliyunOOSFullAccess: Memberikan izin penuh untuk mengelola OOS. Diperlukan untuk menggunakan OOS dalam instalasi otomatis LoongCollector.

    • AliyunECSFullAccess: Memberikan izin penuh untuk mengelola ECS. Diperlukan untuk menggunakan Cloud Assistant dalam instalasi batch LoongCollector.

    Jika kebijakan sistem default tidak memenuhi kebutuhan Anda, Anda dapat membuat kebijakan kustom untuk kontrol akses detail halus. Untuk informasi lebih lanjut, lihat contoh berikut.

    Ganti ${projectName} pada bidang Resource dengan nama proyek Anda.
    {
  "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": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:ListProject",
        "log:GetAcceleration",
        "log:ListDomains",
        "log:GetLogging",
        "log:ListTagResources"
      ],
      "Resource": [
        "acs:log:*:*:project/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:GetProject"
      ],
      "Resource": [
        "acs:log:*:*:project/${projectName}"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:ListLogStores",
        "log:GetLogStore",
        "log:GetLogStoreHistogram",
        "log:GetIndex",
        "log:CreateIndex",
        "log:UpdateIndex",
        "log:ListShards",
        "log:GetCursorOrData",
        "log:ListSavedSearch",
        "log:GetLogStoreLogs",
        "log:ListDashboard",
        "log:GetLogStoreContextLogs"
      ],
      "Resource": [
        "acs:log:*:*:project/${projectName}/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:*"
      ],
      "Resource": [
        "acs:log:*:*:project/${projectName}/logtailconfig/*",
        "acs:log:*:*:project/${projectName}/machinegroup/*"
      ]
    }
  ]
}

    Buat proyek

    Jika Anda belum memiliki Project yang tersedia, ikuti langkah-langkah berikut untuk membuat Project dasar. Untuk detail konfigurasi pembuatan, lihat Kelola Proyek.

    Login ke Konsol SLS, lalu klik Create Project. Konfigurasikan parameter berikut dan gunakan nilai default untuk pengaturan lainnya:

    • Region: Pilih wilayah Alibaba Cloud berdasarkan sumber log Anda. Pengaturan ini tidak dapat diubah setelah proyek dibuat.

    • Project Name: Masukkan nama proyek. Nama harus unik secara global dalam wilayah Alibaba Cloud yang dipilih dan tidak dapat diubah setelah pembuatan.

    Buat Logstore

    Jika Anda belum memiliki LogStore yang tersedia, buat LogStore dasar. Untuk informasi lebih lanjut tentang detail konfigurasi, lihat Kelola LogStore.

    1. Login ke Konsol SLS. Di daftar proyek, klik proyek yang diinginkan.

    2. Di bagian Log Storage, buka tab Logstores dan klik ikon +.

    3. Masukkan Logstore Name dan gunakan nilai default untuk parameter lainnya.

    Persyaratan jaringan server

    1. Server tempat LoongCollector diinstal harus mengizinkan lalu lintas outbound melalui port 80 (HTTP) dan 443 (HTTPS) untuk upload data.

    2. Server harus dapat terhubung ke Titik akhir SLS. Untuk memverifikasi konektivitas, ikuti langkah-langkah berikut:

      1. Login ke Konsol SLS. Di daftar proyek, klik proyek yang diinginkan.

      2. Klik ikon image di sebelah nama proyek untuk membuka halaman Project Overview.

      3. Di bagian Endpoint, lihat informasi titik akhir untuk proyek tersebut. Lalu, ganti variabel dalam perintah berikut dan jalankan.

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

      4. Tanggapan serupa dengan {"Error":{"Code":"OLSInvalidMethod","Message":"The script name is invalid : /","RequestId":"5D****09"}} menunjukkan bahwa koneksi jaringan normal. Jika tidak, periksa pengaturan firewall, konfigurasi DNS, dan security group Anda.

        Error ini diharapkan karena URL permintaan tidak memiliki parameter yang diperlukan. Pengujian ini hanya memverifikasi konektivitas jaringan dan tidak menggunakan URL permintaan lengkap.

    Pilih metode instalasi

    Metode instalasi

    Skenario

    Same account and region

    Server adalah instans ECS dalam akun dan wilayah yang sama dengan proyek.

    Same account, different region

    Server adalah instans ECS dalam akun yang sama dengan proyek tetapi berada di wilayah yang berbeda.

    Different accounts, same region

    Server adalah instans ECS dalam wilayah yang sama dengan proyek tetapi dalam akun yang berbeda.

    Other cloud platforms or on-premises servers

    • Server bukan instans ECS Alibaba Cloud, seperti server on-premises atau server dari penyedia cloud lain.

    • Server adalah instans ECS Alibaba Cloud, tetapi instans dan proyek berada dalam akun Alibaba Cloud yang berbeda serta di wilayah yang berbeda. Dalam kasus ini, instans ECS diperlakukan sebagai server on-premises.

    Same account and region

    Jika instans ECS dan proyek Anda berada dalam akun dan wilayah yang sama, Anda dapat menggunakan instalasi satu-klik. SLS menggunakan OOS untuk mengotomatiskan instalasi, sehingga Anda tidak perlu login ke instans secara manual.

    Fitur instalasi satu-klik terintegrasi ke dalam templat pengumpulan data SLS. SLS menyediakan berbagai templat log teks, seperti templat baris tunggal, multi-baris, dan berbasis regex. Templat-templat ini hanya berbeda pada plug-in pemrosesan-nya. Anda dapat menambahkan atau menghapus plug-in pemrosesan dalam suatu templat. Pilih templat berdasarkan karakteristik log yang ingin Anda kumpulkan, atau pilih templat log teks apa pun lalu konfigurasikan plug-in pemrosesan sesuai karakteristik log Anda.

    Prosedur

    1. Login ke Konsol SLS. Di daftar proyek, klik proyek yang diinginkan.

    2. Di panel navigasi kiri, pilih imageLog Storage > Logstores. Klik ikon image di sebelah nama Logstore yang diinginkan.

    3. Klik ikon image di sebelah Data Collection, pilih templat impor Single-line - Text Log di kotak dialog yang muncul, lalu klik Integrate Now.

    4. Klik Create Machine Group. Pilih satu atau beberapa instans ECS yang berada di wilayah yang sama dengan proyek, lalu klik Install and Create Machine Group.

    5. Tunggu hingga instalasi selesai, masukkan nama, lalu klik OK. Jika instalasi gagal, klik Recreate Installation Task dan pilih ulang instans ECS. Pastikan instans ECS yang dipilih berada di wilayah yang sama dengan proyek.

    6. Klik Next. Jika status heartbeat adalah FAIL, klik Automatic Retry dan tunggu sekitar dua menit hingga status berubah menjadi OK.

    7. Instalasi satu-klik selesai. Klik Next untuk membuat konfigurasi pengumpulan.

    Same account, different region

    Jika server adalah instans ECS Alibaba Cloud, dan instans serta proyek berada dalam akun Alibaba Cloud yang sama tetapi di wilayah yang berbeda, Anda harus mengunduh paket instalasi secara manual dan menggunakan transmisi data melalui internet atau akselerasi transfer dalam perintah instalasi.

    Prosedur

    1. Unduh paket instalasi. Jalankan perintah unduh di server. Dalam kode contoh, Anda dapat mengganti ${region_id} dengan cn-hangzhou. Untuk mempercepat unduhan, ganti ${region_id} dengan Region ID wilayah tempat instans ECS berada.

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;

    2. Pilih metode transmisi dan jalankan perintah instalasi. Ganti ${region_id} dengan Region ID wilayah tempat proyek berada.

      • Internet: Metode ini cocok untuk sebagian besar skenario, seperti penerapan cross-region dan pengumpulan data dari platform cloud lain atau server on-premises. Namun, metode ini tunduk pada batasan bandwidth dan potensi ketidakstabilan.

        chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-internet

      • Akselerasi transfer: Metode ini digunakan untuk transmisi data cross-region, seperti dari wilayah di Tiongkok daratan ke wilayah luar Tiongkok daratan. Metode ini menggunakan Content Delivery Network (CDN) untuk mempercepat transmisi data dan meningkatkan kinerja, sehingga menghindari latensi tinggi dan ketidakstabilan melalui internet. Namun, metode ini dikenai biaya transfer data.

        Anda harus mengaktifkan fitur cross-region transfer acceleration untuk proyek sebelum menjalankan perintah instalasi.
        chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-acceleration

    3. Periksa status startup. Jika dikembalikan loongcollector is running, agen telah dimulai.

      sudo /etc/init.d/loongcollectord status

    4. Konfigurasikan kelompok mesin. SLS menggunakan kelompok mesin untuk menemukan pengenal kustom dan membangun koneksi heartbeat dengan LoongCollector pada host.

      1. Di server, tulis string kustom seperti user-defined-test-1 ke file pengenal kustom. String ini akan digunakan pada langkah selanjutnya.

        # Tulis string kustom ke file yang ditentukan. Jika direktori tidak ada, buat secara manual. Jalur dan nama file ditetapkan oleh SLS dan tidak dapat diubah.
echo "user-defined-test-1" > /etc/ilogtail/user_defined_id

      2. Login ke Konsol SLS. Di daftar proyek, klik proyek yang diinginkan.

      3. Di panel navigasi kiri, pilih imageResources > Machine Groups.

      4. Klik ikon image di sebelah Machine Groups, lalu klik Create Machine Group.

      5. Konfigurasikan parameter berikut dan klik OK.

        • Machine Group Name: Masukkan nama untuk kelompok mesin. Nama harus unik dalam proyek, panjang 3 hingga 128 karakter, dimulai dan diakhiri dengan huruf kecil atau angka, serta hanya boleh berisi huruf kecil, angka, tanda hubung (-), dan garis bawah (_).

        • Machine Group Identifier: Pilih Custom Identifier.

        • Pengenal kustom: Masukkan pengenal yang sesuai dengan string kustom dalam file pengenal kustom di server. Misalnya, user-defined-test-1.

    5. Setelah kelompok mesin dibuat, klik kelompok mesin tersebut di daftar kelompok mesin untuk memeriksa status Heartbeat. Jika statusnya FAIL, tunggu sekitar dua menit lalu refresh secara manual. Status OK berarti kelompok mesin berhasil dibuat.

    6. Setelah instalasi, buat konfigurasi pengumpulan untuk mengumpulkan log.

    Different accounts in the same region

    Jika server Anda adalah instans ECS Alibaba Cloud, dan instans serta proyek berada di wilayah yang sama tetapi dalam akun Alibaba Cloud yang berbeda, Anda harus mengunduh paket instalasi secara manual. Gunakan metode transmisi jaringan internal dalam perintah instalasi dan konfigurasikan ID pengguna.

    Ikuti langkah-langkah berikut:

    1. Unduh paket instalasi. Jalankan perintah unduh di server. Dalam kode contoh, Anda dapat mengganti ${region_id} dengan cn-hangzhou. Untuk mempercepat unduhan, lihat Region ID dan ganti ${region_id} dengan wilayah instans ECS.

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;

    2. Jalankan perintah instalasi. Ganti ${region_id} dengan Region ID proyek.

      Jika terjadi timeout koneksi, kemungkinan Anda menggunakan ${region_id} yang salah. Jaringan internal tidak dapat membangun koneksi antar wilayah yang berbeda. Perbaiki Region ID dan jalankan kembali perintah instalasi.
      chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}

    3. Periksa status startup. Jalankan perintah. Jika dikembalikan loongcollector is running, startup berhasil.

      sudo /etc/init.d/loongcollectord status

    4. Konfigurasikan ID pengguna. File ID pengguna berisi ID akun root Alibaba Cloud yang memiliki proyek. ID ini menunjukkan bahwa akun tersebut memiliki izin untuk mengakses dan mengumpulkan log dari server ini.

      Anda hanya perlu mengonfigurasi ID pengguna saat mengumpulkan log dari instans ECS di bawah akun lain, server yang dikelola sendiri, atau server dari penyedia cloud lain. Jika beberapa akun mengumpulkan log dari server yang sama, Anda dapat membuat beberapa file ID pengguna di server tersebut.

      1. Login ke Konsol SLS. Arahkan pointer ke gambar profil Anda di pojok kanan atas. Di tab yang muncul, lihat dan salin ID akun. Pastikan Anda menyalin ID akun root.

      2. Di server tempat LoongCollector diinstal, buat file ID pengguna. Gunakan ID akun root sebagai nama file.

        touch /etc/ilogtail/users/{Alibaba Cloud Account ID} # Jika direktori /etc/ilogtail/users tidak ada, buat secara manual. File ID pengguna hanya memerlukan nama file dan tidak memerlukan ekstensi.

    5. Konfigurasikan kelompok mesin. SLS menggunakan kelompok mesin untuk menemukan pengenal kustom dan membangun koneksi heartbeat dengan LoongCollector pada host.

      1. Di server, tulis string kustom user-defined-test-1 ke file pengenal kustom. String ini digunakan pada langkah selanjutnya.

        # Tulis string kustom ke file yang ditentukan. Jika direktori tidak ada, buat secara manual.
# Jalur dan nama file ditetapkan oleh SLS dan tidak dapat diubah.
echo "user-defined-test-1" > /etc/ilogtail/user_defined_id

      2. Login ke Konsol SLS. Di daftar proyek, klik proyek target.

      3. Klik image Resources, lalu klik Machine Groups.

      4. Di sebelah kanan daftar Machine Groups, klik ikon image, lalu klik Create Machine Group. Anda juga dapat mengklik ikon empat persegi di pojok kanan atas dan memilih Create Machine Group dari menu drop-down.

      5. Konfigurasikan pengaturan berikut dan klik OK.

        • Tetapkan Machine Group Name: Nama harus unik dalam proyek. Panjang nama harus 3 hingga 128 karakter. Nama harus dimulai dan diakhiri dengan huruf kecil atau angka, serta hanya boleh berisi huruf kecil, angka, tanda hubung (-), dan garis bawah (_).

        • Tetapkan Machine Group Identifier: ke Custom Identifier.

        • Pengenal Kustom: Masukkan pengenal kustom yang telah Anda konfigurasi. Pengenal ini harus sama dengan string kustom dalam file pengenal kustom di server. Dalam contoh ini, pengenalnya adalah user-defined-test-1.

    6. Setelah kelompok mesin dibuat, klik kelompok mesin target di daftar. Di bagian status kelompok mesin, periksa status Heartbeat. Jika statusnya FAIL, tunggu sekitar dua menit lalu refresh halaman. Jika status heartbeat OK, kelompok mesin berhasil dibuat.

    7. Setelah instalasi selesai, Anda harus membuat konfigurasi pengumpulan untuk mengumpulkan log.

    Other cloud or on-premises servers

    Jika server Anda di-host di platform cloud lain atau merupakan server on-premises, Anda harus mengunduh paket instalasi secara manual. Gunakan metode jaringan publik atau akselerasi transfer dalam perintah instalasi dan konfigurasikan ID pengguna. Instans ECS Alibaba Cloud juga dianggap sebagai server on-premises jika instans dan proyek berada dalam akun Alibaba Cloud yang berbeda atau di wilayah yang berbeda.

    Catatan

    Untuk batasan penggunaan server, lihat Distribusi Linux yang didukung.

    Prosedur

    1. Unduh paket instalasi. Jalankan perintah unduh di server Anda. Dalam kode contoh, Anda dapat mengganti ${region_id} dengan cn-hangzhou. Untuk mempercepat unduhan paket, lihat Region ID dan ganti ${region_id} dengan Region ID instans ECS Anda.

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;

    2. Pilih metode transfer dan jalankan perintah instalasi. Ganti ${region_id} dengan Region ID wilayah tempat proyek Anda berada.

      • Jaringan publik: Metode ini berfungsi untuk sebagian besar skenario, termasuk transfer cross-region dan server di cloud lain atau on-premises. Namun, metode ini tunduk pada batasan bandwidth dan potensi ketidakstabilan.

        chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-internet

      • Akselerasi transfer: Gunakan metode ini untuk transfer cross-region, seperti dari Tiongkok daratan ke wilayah luar negeri. Metode ini menggunakan akselerasi CDN untuk meningkatkan kinerja dan menghindari latensi tinggi serta ketidakstabilan jaringan publik. Lalu lintas ini dikenai biaya tambahan.

        Aktifkan fitur cross-region log transfer acceleration untuk proyek Anda sebelum menjalankan perintah instalasi.
        chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-acceleration

    3. Periksa status startup. Jalankan perintah. Jika dikembalikan loongcollector is running, startup berhasil.

      sudo /etc/init.d/loongcollectord status

    4. Konfigurasikan ID pengguna. File ID pengguna berisi ID akun root Alibaba Cloud yang memiliki proyek. ID ini memverifikasi bahwa akun tersebut memiliki izin untuk mengakses dan mengumpulkan log dari server ini.

      Konfigurasikan ID pengguna hanya saat mengumpulkan log dari instans ECS yang tidak berada di bawah akun Anda, server on-premises, atau server dari penyedia cloud lain. Jika beberapa akun mengumpulkan log dari server yang sama, Anda dapat membuat beberapa file ID pengguna di server tersebut.

      1. Login ke Konsol SLS. Arahkan kursor ke avatar pengguna Anda di pojok kanan atas. Di tab yang muncul, lihat dan salin ID akun. Pastikan Anda menyalin ID akun root.

      2. Di server tempat LoongCollector diinstal, buat file ID pengguna. Gunakan ID akun root sebagai nama file.

        touch /etc/ilogtail/users/{Alibaba Cloud Account ID} # Jika direktori /etc/ilogtail/users tidak ada, buat secara manual. File ID pengguna hanya memerlukan nama file dan tidak memerlukan ekstensi.

    5. Konfigurasikan kelompok mesin. SLS menggunakan kelompok mesin untuk menemukan pengenal kustom dan membangun koneksi heartbeat dengan LoongCollector pada host.

      1. Di server, tulis string kustom user-defined-test-1 ke file pengenal kustom. String ini akan digunakan pada langkah selanjutnya.

        # Tulis string kustom ke file yang ditentukan. Jika direktori tidak ada, buat secara manual. Jalur dan nama file ditetapkan oleh SLS dan tidak dapat dikustomisasi.
echo "user-defined-test-1" > /etc/ilogtail/user_defined_id

      2. Login ke Konsol SLS. Di daftar proyek, klik proyek target.

      3. Klik image Resources, lalu klik Machine Groups.

      4. Di sebelah kanan Machine Groups, klik image, lalu klik Create Machine Group.

      5. Konfigurasikan pengaturan berikut dan klik OK.

        • Nama kelompok mesin: Nama harus unik dalam proyek. Panjangnya harus 3 hingga 128 karakter, dimulai dan diakhiri dengan huruf kecil atau angka, serta hanya boleh berisi huruf kecil, angka, tanda hubung (-), dan garis bawah (_).

        • Machine Group Identifier: Pilih Custom Identifier.

        • Pengenal Kustom: Masukkan pengenal kustom yang telah dikonfigurasi. Pengenal ini harus sesuai dengan string kustom dalam file pengenal kustom di server. Dalam contoh ini, nilainya adalah user-defined-test-1.

    6. Setelah kelompok mesin dibuat, klik kelompok mesin tersebut di daftar kelompok mesin. Di panel status kelompok mesin, periksa status Heartbeat. Jika statusnya FAIL, tunggu sekitar dua menit lalu refresh halaman. Status OK berarti pembuatan berhasil.

    7. Setelah instalasi, buat konfigurasi pengumpulan untuk mengumpulkan log.

    Instal LoongCollector secara batch

    • Fitur instalasi otomatis mendukung pemilihan beberapa instans ECS saat instans dan proyek berada dalam akun dan wilayah yang sama.

    • Dalam skenario lain, gunakan ECS Cloud Assistant untuk menjalankan perintah sebagai tugas temporary. Ini memungkinkan Anda menjalankan perintah instalasi LoongCollector secara batch pada instans ECS.

      Untuk perintah unduh dan instalasi, lihat skenario instalasi yang dijelaskan sebelumnya. Untuk mempelajari cara menggunakan ECS Cloud Assistant, lihat Buat dan jalankan perintah.

    Peningkatan dan rollback

    Penting

    LoongCollector berhenti berjalan selama peningkatan dan secara otomatis dimulai kembali setelah peningkatan selesai. Peningkatan hanya menimpa file yang diperlukan. File konfigurasi dan file titik pemeriksaan dipertahankan untuk memastikan tidak ada log yang hilang selama peningkatan.

    Peningkatan LoongCollector atau upgrade Logtail ke LoongCollector

    1. Jalankan perintah unduh di server untuk mendapatkan paket instalasi terbaru. Dalam kode contoh, ganti ${region_id} dengan ID wilayah seperti cn-hangzhou. Untuk mempercepat unduhan paket, lihat Wilayah dan ganti ${region_id} dengan wilayah tempat instans ECS Anda berada.

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;

    2. Jalankan perintah peningkatan. Gunakan perintah upgrade untuk meningkatkan. Jika Anda menggunakan perintah install, ini akan melakukan instalasi timpa, dan konfigurasi asli Anda akan hilang.

      chmod +x loongcollector.sh; sudo ./loongcollector.sh upgrade;

    3. Jika informasi berikut ditampilkan, peningkatan berhasil. 

      Upgrade loongcollector files successfully.
Starting loongcollector ...
Upgrade loongcollector successfully.

    Rollback LoongCollector ke Logtail

    Catatan

    Unduh kembali skrip logtail.sh. Jangan gunakan versi skrip sebelumnya.

    1. Jalankan perintah unduh di server untuk mendapatkan paket instalasi. Dalam kode contoh, ganti ${region_id} dengan ID wilayah seperti cn-hangzhou. Untuk mempercepat unduhan paket, lihat Wilayah dan ganti ${region_id} dengan wilayah tempat instans ECS Anda berada.

      wget https://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh;

    2. Jalankan perintah rollback. Untuk menentukan versi, seperti 1.8.7, lihat baris komentar dan ganti nomor versi sesuai kebutuhan.

      chmod +x logtail.sh; sudo ./logtail.sh upgrade;
#chmod +x logtail.sh; sudo ./logtail.sh upgrade -v 1.8.7;

    Instal versi tertentu

    Gunakan parameter -v untuk menginstal versi tertentu. Lihat perintah berikut dan ganti nomor versi sesuai kebutuhan.

    • LoongCollector

      chmod +x loongcollector.sh; sudo ./loongcollector.sh install ${region_id} -v 3.2.6;

    • Logtail

      chmod +x logtail.sh; sudo ./logtail.sh install ${region_id} -v 1.8.7;

    Hapus instalan LoongCollector

    1. Dalam kode contoh, ganti ${region_id} dengan ID wilayah seperti cn-hangzhou. Untuk mempercepat eksekusi, lihat Wilayah dan ganti ${region_id} dengan wilayah tempat instans ECS Anda berada.

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;

    2. Jalankan perintah uninstall.

      chmod +x loongcollector.sh; sudo ./loongcollector.sh uninstall;

    Pertanyaan umum

    Instal LoongCollector pada server tanpa koneksi internet

    1. Di server tempat Anda ingin menginstal LoongCollector, jalankan uname -m untuk memeriksa arsitektur sistem. Lalu, di server yang memiliki akses internet, jalankan perintah unduh yang sesuai. Ganti ${region_id} dengan Region ID proyek Anda.

      • Arsitektur ARM:

        wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/aarch64/main/loongcollector-linux64.tar.gz;

      • Arsitektur x86-64:

        wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/x86_64/main/loongcollector-linux64.tar.gz;

    2. Salin skrip instalasi dan paket yang telah diunduh ke server tempat Anda ingin menginstal LoongCollector. Lalu, jalankan perintah berikut. Ganti ${region_id} dengan Region ID proyek Anda.

      chmod +x loongcollector.sh; ./loongcollector.sh install-local ${region_id}-internet

    3. Jalankan perintah status. Jika output-nya adalah loongcollector is running, LoongCollector telah berhasil dimulai.

      sudo /etc/init.d/loongcollectord status

    4. Karena server tidak dapat mengakses internet, Anda juga harus membangun koneksi dengan mengonfigurasi proxy.

    Peningkatan LoongCollector pada server tanpa koneksi internet

    1. Di server tempat Anda ingin meningkatkan LoongCollector, jalankan uname -m untuk memeriksa arsitektur sistem. Lalu, di server yang memiliki akses internet, jalankan perintah yang sesuai. Ganti ${region_id} dengan wilayah proyek Anda.

      • Arsitektur ARM:

        wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/aarch64/main/loongcollector-linux64.tar.gz;

      • Arsitektur x86-64:

        wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/x86_64/main/loongcollector-linux64.tar.gz;

    2. Salin skrip instalasi dan paket ke server tempat Anda ingin meningkatkan LoongCollector. Lalu, jalankan perintah berikut:

      chmod +x loongcollector.sh;./loongcollector.sh upgrade-local;

    Instalasi satu-klik gagal

    Instalasi otomatis hanya didukung saat instans ECS dan proyek berada dalam akun dan wilayah yang sama. Jika kondisi ini tidak terpenuhi, gunakan metode instalasi lain. Jika pengaturan Anda memenuhi persyaratan ini, periksa apakah Anda telah memenuhi persyaratan izin dan jaringan. Untuk informasi lebih lanjut, lihat Prasyarat.

    Atasi heartbeat yang hilang atau gagal

    Jika status heartbeat adalah FAIL, kemungkinan koneksi awal memerlukan waktu. Tunggu sekitar dua menit, lalu refresh statusnya. Jika status masih FAIL, ikuti langkah-langkah berikut untuk pemecahan masalah:

    • Konfirmasi hubungan antara server dan proyek SLS. Prosedur instalasi bervariasi berdasarkan hubungan ini.

      • Jika Anda menggunakan prosedur yang salah, jalankan perintah chmod +x loongcollector.sh; sudo ./loongcollector.sh uninstall; di server untuk meng-uninstal. Lalu, ulangi instalasi menggunakan prosedur yang benar.

    • Jika Anda menggunakan prosedur yang benar tetapi status heartbeat masih FAIL, periksa server tempat LoongCollector diinstal. Verifikasi bahwa region dalam file /usr/local/ilogtail/ilogtail_config.json sesuai dengan Region ID proyek SLS Anda.

      • Jika tidak sesuai, ganti ${region_id} dalam perintah instalasi dengan Region ID yang benar dan jalankan kembali perintah tersebut. LoongCollector akan memperbarui file tersebut.

        Tindakan ini akan menimpa instalasi yang ada dan menghapus konfigurasi asli Anda. Gunakan metode ini dengan hati-hati pada server yang sudah dikonfigurasi untuk pengumpulan.

      • Jika informasinya sudah benar, atau jika status heartbeat masih FAIL setelah Anda menginstal ulang, lanjutkan ke langkah berikutnya.

    • Jika prosedur Anda melibatkan skenario cross-account yang memerlukan file ID pengguna, periksa hal berikut:

      • ID pengguna harus merupakan ID akun root. Jika bukan, ubahlah.

      • ID akun root harus milik akun yang memiliki proyek SLS, bukan akun yang memiliki server ECS.

    • Periksa pengenal kustom yang dikonfigurasi untuk kelompok mesin di konsol SLS. Pastikan pengenal tersebut sesuai dengan isi file pengenal kustom di server. Jika tidak sesuai, modifikasi konfigurasi konsol atau file agar identik.

    • Jika status heartbeat masih FAIL, periksa apakah Anda telah memenuhi persyaratan jaringan. Untuk informasi lebih lanjut, lihat Prasyarat.

    Referensi terkait

    Wilayah

    1. Login ke Konsol SLS. Di daftar proyek, klik proyek target.

    2. Klik ikon image di sebelah kanan nama proyek untuk membuka halaman ikhtisar proyek.

    3. Di bagian Informasi Dasar, lihat nama wilayah proyek saat ini. Lihat tabel berikut untuk Region ID yang sesuai.

      Wilayah merepresentasikan lokasi geografis pusat data fisik untuk sumber daya cloud. Region ID adalah pengenal unik untuk wilayah layanan cloud.

    Tabel pemetaan Wilayah dan Region ID

    Nama wilayah

    Region ID

    China (Qingdao)

    cn-qingdao

    China (Beijing)

    cn-beijing

    China (Zhangjiakou)

    cn-zhangjiakou

    China (Hohhot)

    cn-huhehaote

    China (Ulanqab)

    cn-wulanchabu

    China (Hangzhou)

    cn-hangzhou

    China (Shanghai)

    cn-shanghai

    China (Nanjing) - Local Region - Decommissioning

    cn-nanjing

    China (Fuzhou) - Local Region - Decommissioning

    cn-fuzhou

    China (Shenzhen)

    cn-shenzhen

    China (Heyuan)

    cn-heyuan

    China (Guangzhou)

    cn-guangzhou

    Filipina (Manila)

    ap-southeast-6

    Korea Selatan (Seoul)

    ap-northeast-2

    Malaysia (Kuala Lumpur)

    ap-southeast-3

    Jepang (Tokyo)

    ap-northeast-1

    Thailand (Bangkok)

    ap-southeast-7

    China (Chengdu)

    cn-chengdu

    Singapura

    ap-southeast-1

    Indonesia (Jakarta)

    ap-southeast-5

    China (Hong Kong)

    cn-hongkong

    Jerman (Frankfurt)

    eu-central-1

    AS (Virginia)

    us-east-1

    AS (Silicon Valley)

    us-west-1

    Inggris (London)

    eu-west-1

    UEA (Dubai)

    me-east-1

    Arab Saudi (Riyadh)

    me-central-1

    Jenis transfer jaringan LoongCollector

    Titik akhir adalah nama domain akses untuk SLS. Ini adalah URL yang digunakan untuk mengakses proyek dan data log-nya. Titik akhir spesifik untuk wilayah tempat proyek berada. SLS menyediakan Titik akhir pribadi, Titik akhir publik, dan Titik akhir percepatan transfer. Lihat titik akhir sebagai berikut:

    1. Login ke Konsol SLS. Di daftar proyek, klik proyek target.

    2. Klik ikon image di sebelah kanan nama proyek untuk membuka halaman ikhtisar proyek.

    3. Di bagian Access Endpoints, lihat informasi titik akhir untuk proyek saat ini. Metode transfer jaringan yang berbeda sesuai dengan titik akhir yang berbeda. Memilih metode transfer jaringan yang tepat membantu memastikan transmisi data log yang lebih cepat dan stabil.

    Jenis jaringan

    Jenis titik akhir yang sesuai

    Deskripsi

    Skenario

    Jaringan internal Alibaba Cloud

    Titik akhir pribadi

    Jaringan internal Alibaba Cloud adalah jaringan bersama gigabit. Mentransfer data log melalui jaringan internal lebih cepat dan stabil dibandingkan melalui internet publik. Jaringan internal mencakup VPC dan jaringan klasik.

    Instans ECS dan proyek SLS berada di wilayah yang sama, atau Anda telah menghubungkan server on-premises Anda ke jaringan internal.

    Catatan

    Buat proyek SLS di wilayah yang sama dengan instans ECS Anda. Ini memungkinkan Anda mengumpulkan log dari instans ECS melalui jaringan internal Alibaba Cloud tanpa mengonsumsi bandwidth publik.

    Internet publik

    Titik akhir publik

    Saat Anda mentransfer data log melalui internet publik, kecepatan dan stabilitas pengumpulan data dapat terpengaruh oleh batasan bandwidth, fluktuasi jaringan, latensi, dan kehilangan paket.

    Transfer data melalui internet publik dalam dua kasus berikut.

    • Instans ECS dan proyek SLS berada di wilayah yang berbeda.

    • Server di-host oleh penyedia cloud lain atau di pusat data on-premises Anda.

    Akselerasi transfer

    Titik akhir percepatan transfer

    Menggunakan node edge CDN Alibaba Cloud untuk mempercepat pengumpulan log menawarkan keunggulan signifikan dalam latensi dan stabilitas jaringan dibandingkan pengumpulan melalui internet publik, tetapi lalu lintasnya dikenai biaya tambahan.

    Jika server aplikasi dan proyek SLS Anda masing-masing berada di wilayah Tiongkok dan internasional, mentransfer data melalui internet publik dapat menyebabkan latensi tinggi dan ketidakstabilan. Gunakan akselerasi transfer untuk mentransfer data dalam kasus ini. Untuk informasi lebih lanjut, lihat Akselerasi transfer.