All Products
Search

This Product

    Simple Log Service:Instal LoongCollector

    Document Center

    Simple Log Service:Instal LoongCollector

    Last Updated:Mar 27, 2026

    LoongCollector adalah collector data yang disediakan oleh Simple Log Service (SLS). Untuk mengumpulkan log dari server Linux, Anda harus terlebih dahulu menginstal klien LoongCollector pada server tersebut. Metode instalasi yang digunakan bergantung pada posisi server relatif terhadap proyek SLS.

    Batasan

    Versi sistem operasi Linux yang didukung

    • Sistem operasi Linux x86-64 berikut ini didukung:

      • Alibaba Cloud Linux 2, 3

      • Anolis OS 7, 8

      • CentOS Linux 6, 7, 8

      • Debian GNU/Linux 8, 9, 10, 11, 12

      • Red Hat Enterprise Linux 6, 7, 8, 9

      • openSUSE 15.1, 15.2, 42.3

      • SUSE Linux Enterprise Server 11, 12, 15

      • Ubuntu 14.04, 16.04, 18.04, 20.04, 22.04, 24.04

      • Sistem operasi Linux lain 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 for ARM

      • Anolis OS 8.2 for ARM atau lebih baru

      • CentOS Linux 8.4 for ARM

      • Debian GNU/Linux 11.2 dan 12.2 for ARM

      • Ubuntu 20.04, 22.04, dan 24.04 for ARM

      • Arsitektur CPU harus ARMv8.2-A atau lebih baru.

    Prasyarat

    Persyaratan izin

    Jika Anda login dengan akun Alibaba Cloud, secara default Anda memiliki semua izin yang diperlukan.

    Jika Anda login sebagai pengguna RAM, mintalah kebijakan sistem berikut dari pemilik akun Alibaba Cloud untuk mendapatkan izin mengelola resource Simple Log Service, ECS, dan CloudOps Orchestration Service (OOS).

    • AliyunLogFullAccess: Memberikan izin penuh untuk mengelola Simple Log Service.

    • AliyunOOSFullAccess: Memberikan izin penuh untuk mengelola CloudOps Orchestration Service (OOS), yang memungkinkan Anda menggunakan OOS untuk mengotomatiskan instalasi LoongCollector.

    • AliyunECSFullAccess: Memberikan izin penuh untuk mengelola ECS, yang memungkinkan Anda menjalankan perintah Cloud Assistant untuk menginstal LoongCollector secara batch.

    Jika kebijakan sistem tidak memenuhi kebutuhan Anda, Anda dapat menggunakan kebijakan berikut untuk membuat kebijakan kustom guna pengelolaan izin detail halus.

    Pada bidang Resource, ganti ${projectName} dengan nama Project 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 Project

    Jika Anda belum memiliki Project yang ada, ikuti langkah-langkah berikut untuk membuat Project dasar. Untuk detail seluruh opsi konfigurasi, lihat Mengelola Project.

    Login ke Konsol Simple Log Service dan klik Create Project. Konfigurasikan parameter dasar berikut dan biarkan pengaturan lainnya pada nilai default:

    • Region: Pilih wilayah tempat log Anda berasal. Pengaturan ini tidak dapat diubah setelah Project dibuat.

    • Project Name: Masukkan nama untuk Project. Nama harus unik dalam wilayah yang dipilih dan tidak dapat diubah setelah pembuatan.

    Buat LogStore

    Jika Anda belum memiliki LogStore yang ada, ikuti langkah-langkah berikut untuk membuat LogStore dasar. Untuk detail seluruh opsi konfigurasi, lihat Mengelola LogStore.

    1. Login ke Konsol Simple Log Service. Di daftar Project, klik Project target.

    2. Pada tab Log Storage > Logstores, klik ikon +.

      image

    3. Masukkan Logstore Name dan biarkan pengaturan lainnya pada nilai default.

    Persyaratan jaringan server

    1. Server tempat Anda menginstal LoongCollector harus mengizinkan lalu lintas outbound pada port 80 (HTTP) dan port 443 (HTTPS). LoongCollector menggunakan port ini untuk mengunggah data.

    2. Server harus dapat terhubung ke titik akhir layanan yang diperlukan. Untuk memverifikasi konektivitas, ikuti langkah-langkah berikut:

      1. Login ke Konsol Simple Log Service. Di daftar Project, klik Project target.

      2. Di sebelah kanan nama Project, klik ikon image untuk membuka halaman Project Overview.

      3. Pada bagian Endpoint, temukan endpoint untuk Project Anda, ganti placeholder dalam perintah berikut, lalu jalankan perintah tersebut.

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

      4. Tanggapan serupa {"Error":{"Code":"OLSInvalidMethod","Message":"The script name is invalid : /","RequestId":"5D****09"}} menunjukkan koneksi berhasil. Jika koneksi gagal, periksa pengaturan jaringan Anda, seperti konfigurasi DNS dan aturan security group, untuk memastikan endpoint dapat diakses.

        Tanggapan error ini diharapkan karena URL uji tidak lengkap. Ini mengonfirmasi konektivitas jaringan, meskipun permintaan itu sendiri tidak valid.

    Pilih metode instalasi yang sesuai

    Metode instalasi

    Kasus Penggunaan

    Same account and region

    Berlaku ketika instance ECS dan project Anda berada dalam akun Alibaba Cloud yang sama dan berada di wilayah yang sama.

    Same account, different region

    Berlaku ketika instance ECS dan project Anda berada dalam akun Alibaba Cloud yang sama tetapi berada di wilayah yang berbeda.

    Different account, same region

    Berlaku ketika instance ECS dan project Anda berada di wilayah yang sama tetapi dimiliki oleh akun Alibaba Cloud yang berbeda.

    Other cloud or on-premises server

    • Berlaku ketika server Anda bukan instance ECS, seperti server on-premises atau server dari penyedia cloud lain.

    • Jika instance ECS dan project Anda dimiliki oleh akun Alibaba Cloud yang berbeda dan berada di wilayah yang berbeda, perlakukan instance tersebut sebagai server on-premises.

    Same account and region

    Ketika server Anda adalah instance ECS yang dimiliki oleh akun Alibaba Cloud yang sama dan berada di wilayah yang sama dengan project Anda, Anda dapat menginstal LoongCollector dengan satu klik. Simple Log Service (SLS) menggunakan kemampuan orkestrasi OOS (Operation Orchestration Service) untuk mengotomatiskan instalasi, sehingga Anda tidak perlu login ke instance ECS untuk menjalankan perintah secara manual.

    Fitur instalasi satu klik terintegrasi ke dalam templat pengumpulan data di SLS. SLS menyediakan berbagai templat log teks, seperti untuk log satu baris, multi-baris, dan berbasis regex. Templat ini hanya berbeda pada plugin pemrosesan-nya. Anda dapat menambah atau menghapus plugin pemrosesan dalam suatu templat. Pilih templat berdasarkan karakteristik log Anda, atau pilih templat log teks apa pun lalu konfigurasikan plugin pemrosesan sesuai kebutuhan.

    Prosedur

    1. Login ke Konsol Simple Log Service. Di daftar project, klik project target.

    2. Klik imageLog Storage. Di daftar Logstores, temukan Logstore target dan klik ikon image di sampingnya.

    3. Klik ikon image di samping Data Collection. Di kotak dialog yang muncul, pilih templat Single Line - Text Logs dan klik Integrate Now.

    4. Klik Create Machine Group, pilih satu atau beberapa instance ECS yang berada di wilayah yang sama dengan project, 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 instance ECS. Saat memilih ulang, pastikan instance ECS berada di wilayah yang sama dengan project.

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

    7. Instalasi satu klik sekarang telah selesai. Klik Next untuk melanjutkan ke konfigurasi pengumpulan.

    Same account, different region

    Jika server Anda adalah instance ECS yang dimiliki oleh akun Alibaba Cloud yang sama dengan project tetapi berada di wilayah yang berbeda, Anda harus mengunduh paket instalasi secara manual dan menggunakan metode internet atau akselerasi transfer untuk transmisi data.

    Prosedur

    1. Unduh paket instalasi. Di server Anda, jalankan perintah unduh. Pada kode contoh, Anda dapat mengganti ${region_id} dengan cn-hangzhou. Untuk mempercepat unduhan, lihat Region ID dan ganti ${region_id} dengan ID wilayah tempat instance ECS Anda 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 project Anda berada.

      • Internet: Metode ini cocok untuk sebagian besar skenario, seperti penerapan cross-region atau pengumpulan log dari server cloud lain atau server on-premises. Namun, kinerja terbatas oleh bandwidth dan ketidakstabilan jaringan.

        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 di luar Tiongkok daratan. Metode ini menggunakan Content Delivery Network (CDN) untuk meningkatkan kinerja dan menghindari latensi tinggi serta ketidakstabilan melalui internet. Metode ini dikenai biaya tambahan untuk transfer data.

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

    3. Periksa status agen. Jalankan perintah berikut. Tanggapan loongcollector is running menunjukkan bahwa LoongCollector berhasil dimulai.

      sudo /etc/init.d/loongcollectord status

    4. Konfigurasikan kelompok mesin. Simple Log Service menggunakan kelompok mesin untuk menemukan server menggunakan pengenal kustom dan membangun koneksi heartbeat dengan agen LoongCollector di setiap server.

      1. Di server, tulis string kustom user-defined-test-1 ke file pengenal kustom. Anda akan menggunakan string ini pada langkah berikutnya.

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

      2. Login ke Konsol Simple Log Service. Di daftar project, klik project tujuan.

      3. Di panel navigasi kiri, klik imageResources, lalu klik Machine Groups.

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

      5. Konfigurasikan parameter berikut dan klik OK.

        • Machine Group Name: Masukkan nama untuk kelompok mesin. Nama harus unik dalam project, terdiri dari 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.

        • Custom Identifier: Masukkan pengenal kustom yang Anda konfigurasikan. Nilainya harus sesuai dengan string kustom dalam file pengenal kustom di server. Dalam contoh ini, nilainya adalah user-defined-test-1.

    5. Setelah kelompok mesin dibuat, temukan di daftar dan periksa status Heartbeat-nya. Jika statusnya FAIL, tunggu sekitar dua menit dan refresh halaman. Status OK menunjukkan koneksi berhasil.

    6. Setelah instalasi, Anda juga harus membuat konfigurasi pengumpulan untuk mulai mengumpulkan log.

    Different account, same region

    Jika server Anda adalah instance ECS yang berada di wilayah yang sama dengan project tetapi dimiliki oleh akun Alibaba Cloud yang berbeda, Anda harus mengunduh paket instalasi secara manual, menggunakan jaringan internal untuk transmisi data, dan mengonfigurasi ID pengguna.

    Prosedur

    1. Unduh paket instalasi. Di server Anda, jalankan perintah unduh. Pada kode contoh, Anda dapat mengganti ${region_id} dengan cn-hangzhou. Untuk mempercepat unduhan, lihat Region ID dan ganti ${region_id} dengan ID wilayah tempat instance 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 instalasi. Ganti ${region_id} dengan Region ID wilayah tempat project Anda berada.

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

    3. Periksa status agen. Jalankan perintah berikut. Tanggapan loongcollector is running menunjukkan bahwa LoongCollector berhasil dimulai.

      sudo /etc/init.d/loongcollectord status

    4. Konfigurasikan ID pengguna. File ID pengguna berisi ID akun root dari akun Alibaba Cloud yang memiliki project. ID ini memberi otorisasi kepada project untuk mengakses dan mengumpulkan log dari server ini.

      Anda perlu mengonfigurasi ID pengguna hanya saat mengumpulkan log dari instance ECS yang tidak dimiliki oleh akun Anda, server on-premises, atau server dari penyedia cloud lain. Jika beberapa akun perlu mengumpulkan log dari server yang sama, Anda dapat membuat beberapa file ID pengguna di server tersebut.

      1. Login ke Konsol Simple Log Service. Di pojok kanan atas, arahkan kursor ke gambar profil Anda untuk melihat dan 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/{root_account_ID} # Jika direktori /etc/ilogtail/users tidak ada, buat secara manual. File ID pengguna hanya memerlukan nama file dan tidak memiliki ekstensi.

    5. Konfigurasikan kelompok mesin. Simple Log Service menggunakan kelompok mesin untuk menemukan server menggunakan pengenal kustom dan membangun koneksi heartbeat dengan agen LoongCollector di setiap server.

      1. Di server, tulis string kustom user-defined-test-1 ke file pengenal kustom. Anda akan menggunakan string ini pada langkah berikutnya.

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

      2. Login ke Konsol Simple Log Service. Di daftar project, klik project tujuan.

      3. Di panel navigasi kiri, klik imageResources, lalu klik Machine Groups.

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

      5. Konfigurasikan parameter berikut dan klik OK.

        • Machine Group Name: Masukkan nama untuk kelompok mesin. Nama harus unik dalam project, terdiri dari 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.

        • Custom Identifier: Masukkan pengenal kustom yang Anda konfigurasikan. Nilainya 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, temukan di daftar dan periksa status Heartbeat-nya. Jika statusnya FAIL, tunggu sekitar dua menit dan refresh halaman. Status OK menunjukkan koneksi berhasil.

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

    Other cloud or on-premises server

    Metode ini berlaku untuk server on-premises atau server dari penyedia cloud lain. Jika server Anda adalah instance ECS, tetapi dimiliki oleh akun Alibaba Cloud yang berbeda dan berada di wilayah yang berbeda dari project Anda, perlakukan sebagai server on-premises. Untuk skenario ini, Anda harus mengunduh paket instalasi secara manual, menggunakan metode internet atau akselerasi transfer, dan mengonfigurasi ID pengguna.

    Catatan

    Untuk persyaratan server, lihat Versi sistem operasi Linux yang didukung.

    Prosedur

    1. Unduh paket instalasi. Di server Anda, jalankan perintah unduh. Pada kode contoh, Anda dapat mengganti ${region_id} dengan cn-hangzhou. Untuk mempercepat unduhan, lihat Region ID dan ganti ${region_id} dengan ID wilayah yang dekat dengan server Anda.

      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 project Anda berada.

      • Internet: Metode ini cocok untuk sebagian besar skenario, seperti penerapan cross-region atau pengumpulan log dari server cloud lain atau server on-premises. Namun, kinerja terbatas oleh bandwidth dan ketidakstabilan jaringan.

        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 di luar Tiongkok daratan. Metode ini menggunakan Content Delivery Network (CDN) untuk meningkatkan kinerja dan menghindari latensi tinggi serta ketidakstabilan melalui internet. Metode ini dikenai biaya tambahan untuk transfer data.

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

    3. Periksa status agen. Jalankan perintah berikut. Tanggapan loongcollector is running menunjukkan bahwa LoongCollector berhasil dimulai.

      sudo /etc/init.d/loongcollectord status

    4. Konfigurasikan ID pengguna. File ID pengguna berisi ID akun root dari akun Alibaba Cloud yang memiliki project. ID ini memberi otorisasi kepada project untuk mengakses dan mengumpulkan log dari server ini.

      Anda perlu mengonfigurasi ID pengguna hanya saat mengumpulkan log dari instance ECS yang tidak dimiliki oleh akun Anda, server on-premises, atau server dari penyedia cloud lain. Jika beberapa akun perlu mengumpulkan log dari server yang sama, Anda dapat membuat beberapa file ID pengguna di server tersebut.

      1. Login ke Konsol Simple Log Service. Di pojok kanan atas, arahkan kursor ke gambar profil Anda untuk melihat dan 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/{root_account_ID} # Jika direktori /etc/ilogtail/users tidak ada, buat secara manual. File ID pengguna hanya memerlukan nama file dan tidak memiliki ekstensi.

    5. Konfigurasikan kelompok mesin. Simple Log Service menggunakan kelompok mesin untuk menemukan server menggunakan pengenal kustom dan membangun koneksi heartbeat dengan agen LoongCollector di setiap server.

      1. Di server, tulis string kustom user-defined-test-1 ke file pengenal kustom. Anda akan menggunakan string ini pada langkah berikutnya.

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

      2. Login ke Konsol Simple Log Service. Di daftar project, klik project tujuan.

      3. Di panel navigasi kiri, klik imageResources, lalu klik Machine Groups.

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

      5. Konfigurasikan parameter berikut dan klik OK.

        • Machine Group Name: Masukkan nama untuk kelompok mesin. Nama harus unik dalam project, terdiri dari 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.

        • Custom Identifier: Masukkan pengenal kustom yang Anda konfigurasikan. Nilainya 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, temukan di daftar dan periksa status Heartbeat-nya. Jika statusnya FAIL, tunggu sekitar dua menit dan refresh halaman. Status OK menunjukkan koneksi berhasil.

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

    Instal LoongCollector secara batch

    • Pada skenario same-account dan same-region, fitur instalasi otomatis memungkinkan Anda memilih beberapa instance ECS sekaligus.

    • Untuk semua skenario lainnya, Anda dapat menggunakan ECS Cloud Assistant untuk menjalankan perintah instalasi batch LoongCollector pada instance ECS Anda.

      Untuk perintah unduh dan instalasi, rujuk skenario instalasi yang dijelaskan dalam topik ini. Untuk mempelajari cara menggunakan ECS Cloud Assistant, lihat Buat dan jalankan perintah.

    Peningkatan dan rollback versi

    Penting

    LoongCollector berhenti berjalan selama peningkatan dan secara otomatis dimulai ulang setelah peningkatan selesai. Proses peningkatan hanya menimpa file program yang diperlukan. Proses ini mempertahankan file konfigurasi dan file titik pemeriksaan Anda untuk mencegah kehilangan data log.

    Peningkatan ke LoongCollector

    1. Di server, jalankan perintah unduh untuk mengunduh paket instalasi terbaru. Pada kode contoh, Anda dapat mengganti ${region_id} dengan cn-hangzhou. Untuk mempercepat unduhan, lihat Region ID dan ganti ${region_id} dengan ID wilayah tempat instance 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. Anda harus menggunakan perintah upgrade. Jika Anda menggunakan perintah install, instalasi akan ditimpa dan menghapus konfigurasi yang ada.

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

    3. Output berikut menunjukkan peningkatan berhasil:

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

    Rollback dari LoongCollector ke Logtail

    Catatan

    Anda harus mengunduh skrip logtail.sh baru. Jangan gunakan versi lama skrip tersebut.

    1. Di server, jalankan perintah unduh untuk mendapatkan paket instalasi. Pada kode contoh, Anda dapat mengganti ${region_id} dengan cn-hangzhou. Untuk mempercepat unduhan, lihat Region ID dan ganti ${region_id} dengan ID wilayah tempat instance 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 rollback ke versi tertentu, seperti 1.8.7, gunakan perintah yang dikomentari 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

    Untuk menginstal versi tertentu, gunakan parameter -v. Ganti nomor versi dalam perintah berikut 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 Instalasi LoongCollector

    1. Pada kode contoh, Anda dapat mengganti ${region_id} dengan cn-hangzhou. Untuk mempercepat proses, lihat Region ID dan ganti ${region_id} dengan ID wilayah tempat instance 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 uninstalasi.

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

    FAQ

    Instalasi offline

    1. Di server tempat Anda ingin menginstal LoongCollector, jalankan perintah uname -m untuk memeriksa arsitektur sistem. Lalu, di server yang memiliki akses internet, jalankan perintah unduh untuk arsitektur sistem Anda. Ganti ${region_id} dengan region ID Project 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 instalasi yang diunduh ke server tempat Anda ingin menginstal LoongCollector, lalu jalankan perintah berikut. Ganti ${region_id} dengan region ID Project Anda.

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

    3. Jalankan perintah berikut untuk memeriksa status. Tanggapan loongcollector is running menunjukkan bahwa LoongCollector berhasil dimulai.

      sudo /etc/init.d/loongcollectord status

    4. Karena server tidak dapat mengakses internet, Anda juga perlu mengonfigurasi proxy.

    Peningkatan offline

    1. Di server tempat Anda ingin meningkatkan LoongCollector, jalankan perintah uname -m untuk memeriksa arsitektur sistem. Lalu, di server yang memiliki akses internet, jalankan perintah unduh untuk arsitektur sistem Anda. Ganti ${region_id} dengan ID wilayah Project 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 instalasi ke server tempat Anda ingin meningkatkan LoongCollector, lalu jalankan perintah berikut:

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

    Instalasi satu klik gagal

    Instalasi satu klik mengharuskan instance ECS dan Project berada dalam akun Alibaba Cloud dan wilayah yang sama. Jika tidak, pilih metode instalasi lain. Jika persyaratan ini terpenuhi, verifikasi bahwa Anda juga memenuhi persyaratan izin dan jaringan di bagian Prasyarat.

    Menangani masalah 'No heartbeat' atau 'heartbeat FAIL'

    Jika status heartbeat adalah FAIL, mungkin diperlukan waktu untuk membangun heartbeat awal. Tunggu sekitar dua menit lalu refresh status heartbeat. Jika status masih FAIL, periksa hal berikut:

    • Periksa hubungan antara server dan Project SLS. Hubungan yang berbeda memerlukan prosedur instalasi yang berbeda.

      • Jika Anda menggunakan prosedur yang salah, jalankan perintah chmod +x loongcollector.sh; sudo ./loongcollector.sh uninstall; untuk menguninstal LoongCollector. Lalu, pilih prosedur yang benar dan instal ulang.

    • Jika Anda mengikuti prosedur yang benar tetapi status heartbeat masih FAIL, periksa apakah nilai region dalam file /usr/local/ilogtail/ilogtail_config.json di server sesuai dengan region ID Project SLS Anda.

      • Jika tidak sesuai, jalankan ulang perintah instalasi dengan region ID yang benar. Ini akan memperbarui isi file.

        Metode ini melakukan instalasi timpa dan menghapus konfigurasi asli. Gunakan dengan hati-hati pada server dengan konfigurasi pengumpulan yang sudah ada.

      • Jika informasi sudah sesuai atau status heartbeat masih FAIL setelah instalasi ulang, lanjutkan ke langkah berikutnya.

    • Jika prosedur memerlukan file ID pengguna (untuk skenario cross-account), periksa hal berikut:

      • ID pengguna harus berupa ID akun Alibaba Cloud. Jika tidak, perbaiki.

      • Ini harus merupakan ID akun Alibaba Cloud dari pemilik Project SLS, bukan pemilik instance ECS.

    • Periksa apakah pengenal kustom untuk kelompok mesin di konsol SLS sesuai dengan yang ada di file pengenal kustom di server. Jika tidak sesuai, ubah salah satu nilainya agar sesuai.

    • Jika status heartbeat masih FAIL, periksa apakah persyaratan jaringan di bagian Prasyarat terpenuhi.

    Referensi

    Wilayah

    1. Login ke Konsol Simple Log Service dan klik project target di daftar Project.

    2. Klik ikon image di samping nama project untuk membuka halaman Project Overview.

    3. Di bagian Basic Information, Anda dapat melihat nama wilayah project saat ini. Tabel berikut memetakan setiap nama wilayah ke Region ID-nya.

      Wilayah merepresentasikan lokasi geografis pusat data fisik tempat resource layanan cloud berada. Region ID adalah pengenal unik untuk wilayah layanan cloud.

    Pemetaan antara nama 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

    SAU (Riyadh - Partner Region)

    me-central-1

    Titik Akhir

    Titik akhir adalah titik akses layanan untuk Simple Log Service (SLS). Ini adalah URL yang digunakan untuk mengakses project dan data log-nya, serta ditentukan oleh wilayah tempat project tersebut berada. Simple Log Service menyediakan titik akhir privat, publik, dan percepatan. Untuk melihat titik akhir, ikuti langkah-langkah berikut:

    1. Login ke Konsol Simple Log Service dan klik project target di daftar Project.

    2. Klik ikon image di samping nama project untuk membuka halaman Project Overview.

    3. Di bagian Endpoints, Anda dapat melihat informasi titik akhir untuk project saat ini. Metode transmisi jaringan yang berbeda menggunakan titik akhir yang berbeda. Memilih metode transmisi jaringan yang sesuai membantu memastikan transfer data yang lebih cepat dan stabil.

    Jenis jaringan

    Jenis titik akhir

    Deskripsi

    Skenario

    Jaringan internal Alibaba Cloud

    Private endpoint

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

    Instance ECS dan project SLS berada di wilayah yang sama, atau server on-premises terhubung ke jaringan internal.

    Catatan

    Kami menyarankan Anda membuat project SLS di wilayah yang sama dengan instance ECS Anda. Ini memungkinkan Anda mengumpulkan log dari instance ECS melalui jaringan internal Alibaba Cloud tanpa mengonsumsi bandwidth internet.

    internet

    Public endpoint

    Mengirimkan data log melalui internet dibatasi oleh bandwidth jaringan dan dipengaruhi oleh faktor seperti jitter, latensi, dan kehilangan paket.

    Anda dapat mentransmisikan data melalui internet dalam skenario berikut:

    • Instance ECS dan project SLS berada di wilayah yang berbeda.

    • Server berasal dari penyedia cloud lain atau merupakan IDC on-premises.

    Akselerasi transfer

    Acceleration endpoint

    Metode ini menggunakan node edge CDN Alibaba Cloud untuk mempercepat pengumpulan log. Metode ini mengurangi latensi dan meningkatkan stabilitas dibandingkan pengumpulan log melalui internet, tetapi dikenai biaya traffic tambahan.

    Jika Anda mentransmisikan data antara Tiongkok daratan dan wilayah lain, penggunaan internet dapat menyebabkan latensi jaringan tinggi dan ketidakstabilan. Dalam kasus ini, Anda dapat menggunakan akselerasi transfer. Untuk informasi lebih lanjut, lihat Akselerasi transfer.