全部产品
Search
文档中心

Simple Log Service:Instalasi dan konfigurasi

更新时间:Nov 16, 2025

LoongCollector adalah kolektor untuk Simple Log Service. Untuk mengumpulkan log dari server Linux, Anda harus menginstal klien LoongCollector pada server tersebut. Metode instalasi yang dipilih bergantung pada lokasi server relatif terhadap proyek Simple Log Service Anda.

Batasan

Sistem operasi Linux yang didukung

  • 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

    • 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

    • Sistem operasi Linux lainnya berbasis glibc 2.6 atau lebih baru

    • CPU harus mendukung set instruksi sse4_2 dan avx.

  • Versi berikut dari server Linux ARM (64-bit) didukung:

    • Alibaba Cloud Linux 3.2 (ARM)

    • Anolis OS 8.2 (ARM) dan versi lebih baru

    • CentOS 8.4 (ARM)

    • Debian 11.2 dan 12.2 (ARM)

    • Ubuntu 20.04, 22.04, dan 24.04 (ARM)

    • Arsitektur CPU minimum yang diperlukan adalah ARMv8.2-A.

Prasyarat

Izin

Jika Anda masuk dengan Akun Alibaba Cloud, secara default Anda memiliki semua izin operasi dan dapat melanjutkan instalasi.

Jika Anda masuk dengan pengguna Resource Access Management (RAM), Anda harus meminta kebijakan sistem berikut dari pemilik Akun Alibaba Cloud untuk mengelola sumber daya Simple Log Service, ECS, dan OOS:

  • AliyunLogFullAccess: Memberikan izin untuk mengelola Simple Log Service.

  • AliyunOOSFullAccess: Memberikan izin untuk mengelola OOS. Izin ini memungkinkan Anda menggunakan orkestrasi OOS untuk menginstal LoongCollector secara otomatis.

  • AliyunECSFullAccess: Memberikan izin untuk mengelola ECS. Izin ini memungkinkan Anda menggunakan Asisten Cloud untuk menjalankan perintah dan menginstal LoongCollector pada beberapa Instance ECS sekaligus.

Jika kebijakan sistem tidak memenuhi kebutuhan Anda, Anda dapat membuat kebijakan kustom untuk pengelolaan izin detail halus. Untuk informasi selengkapnya, lihat Buat kebijakan izin kustom.

Ganti ${projectName} dalam Resource dengan nama proyek yang ingin Anda akses.
{
  "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 proyek, ikuti langkah-langkah berikut untuk membuatnya. Untuk informasi selengkapnya, lihat Kelola proyek.

Masuk ke Konsol Simple Log Service, klik Create Project, lengkapi konfigurasi dasar berikut, dan biarkan konfigurasi lainnya tetap default:

  • Region: Pilih wilayah Alibaba Cloud yang sesuai berdasarkan sumber log dan persyaratan lainnya. Wilayah tidak dapat diubah setelah proyek dibuat.

  • Project Name: Tetapkan nama yang unik secara global dalam wilayah Alibaba Cloud. Nama tidak dapat diubah setelah proyek dibuat.

Buat penyimpanan log

Jika Anda belum memiliki penyimpanan log aktif, ikuti langkah-langkah berikut untuk membuatnya. Untuk informasi selengkapnya, lihat Kelola penyimpanan log.

  1. Masuk ke Konsol Simple Log Service, lalu klik proyek target di Daftar Proyek.

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

    image

  3. Masukkan nama penyimpanan log, dan biarkan konfigurasi lainnya tetap default.

Persyaratan jaringan server

  1. Server tempat Anda menginstal LoongCollector harus mengaktifkan lalu lintas keluar pada port 80 (HTTP) dan port 443 (HTTPS) agar LoongCollector dapat mengunggah data.

  2. Server tempat Anda menginstal LoongCollector harus dapat terhubung ke titik akhir berikut:

    1. Masuk ke Konsol Simple Log Service. Di bagian Proyek, klik proyek target.

    2. Klik ikon image di samping nama proyek untuk membuka halaman ringkasan proyek.

    3. Pada tab Titik Akhir, lihat informasi nama domain untuk proyek saat ini. Lalu, ganti placeholder dalam perintah dan jalankannya.

      curl https://${projectName}.${domainNameInfo}
    4. Tanggapan serupa dengan {"Error":{"Code":"OLSInvalidMethod","Message":"The script name is invalid : /","RequestId":"5D****09"}} menunjukkan bahwa koneksi jaringan normal. Jika tidak, periksa apakah alamat tujuan diblokir atau ada masalah jaringan lainnya, seperti konfigurasi DNS yang salah atau aturan grup keamanan.

      Pesan kesalahan dikembalikan karena tautan akses tidak memiliki parameter yang diperlukan. Pengujian ini hanya memverifikasi konektivitas jaringan dan tidak menggunakan tautan lengkap. Oleh karena itu, pesan kesalahan diharapkan jika jaringan terhubung.

Pilih metode instalasi

Metode instalasi

Skenario

Akun dan wilayah sama

Server Anda adalah Instance ECS Alibaba Cloud, dan Instance ECS serta proyek berada dalam akun Alibaba Cloud yang sama dan wilayah yang sama.

Akun sama, wilayah berbeda

Server Anda adalah Instance ECS Alibaba Cloud, dan Instance ECS serta proyek berada dalam akun Alibaba Cloud yang sama tetapi dalam wilayah yang berbeda.

Akun berbeda, wilayah sama

Server Anda adalah Instance ECS Alibaba Cloud, dan Instance ECS serta proyek berada dalam wilayah yang sama tetapi dalam akun Alibaba Cloud yang berbeda.

Server cloud lain atau server on-premises

  • Server Anda bukan Instance ECS Alibaba Cloud, seperti server on-premises atau server dari penyedia layanan cloud lainnya.

  • Server Anda adalah Instance ECS Alibaba Cloud, tetapi instance dan proyek berada dalam akun Alibaba Cloud yang berbeda dan wilayah yang berbeda. Dalam kasus ini, Anda dapat memperlakukannya sebagai server on-premises.

Akun dan wilayah sama

Jika server Anda adalah Instance ECS Alibaba Cloud, dan Instance ECS serta proyek berada dalam akun Alibaba Cloud yang sama dan wilayah yang sama, Anda dapat menggunakan fitur instalasi otomatis Simple Log Service untuk menginstal LoongCollector. Fitur ini menggunakan orkestrasi OOS dan tidak mengharuskan Anda masuk ke Instance ECS untuk menjalankan perintah instalasi.

Fitur instalasi otomatis terintegrasi ke dalam templat impor data Simple Log Service. Simple Log Service menyediakan berbagai templat log teks, seperti templat log baris tunggal dan multi-baris. Templat-templat ini hanya berbeda dalam plugin pemrosesan-nya. Anda dapat menambahkan atau menghapus plugin pemrosesan dalam suatu templat. Pilih templat berdasarkan karakteristik log yang ingin Anda kumpulkan, atau pilih templat log teks apa pun lalu konfigurasikan plugin pemrosesan sesuai kebutuhan.

Prosedur:

  1. Masuk ke Konsol Simple Log Service. Di bagian Proyek, klik proyek target.

  2. Klik image Penyimpanan Log. Di daftar Penyimpanan Log, klik ikon image di samping Penyimpanan Log target untuk memperluasnya.

  3. Klik ikon image di samping Data Ingestion, pilih templat Log Teks - Baris Tunggal di kotak dialog, lalu klik Ingest Now.

  4. Klik Create Machine Group, pilih satu atau beberapa Instance ECS dalam wilayah yang sama dengan proyek, lalu klik Install And Create Machine Group.

  5. Tunggu hingga instalasi selesai. Masukkan nama dan klik OK. Jika instalasi gagal, klik Buat Ulang Tugas Instalasi dan pilih ulang Instance ECS. Pastikan Instance ECS yang dipilih berada dalam wilayah yang sama dengan proyek.

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

  7. Instalasi otomatis selesai. Klik Berikutnya untuk melanjutkan ke konfigurasi pengumpulan.

Akun sama, wilayah berbeda

Jika server Anda adalah Instance ECS Alibaba Cloud, dan Instance ECS serta proyek berada dalam akun Alibaba Cloud yang sama tetapi dalam wilayah yang berbeda, Anda harus mengunduh paket instalasi secara manual dan menggunakan transfer Internet atau akselerasi transfer dalam perintah instalasi.

Prosedur:

  1. Unduh paket instalasi. Jalankan perintah unduh di server Anda. Dalam contoh kode, Anda dapat mengganti ${region_id} dengan cn-hangzhou. Untuk mempercepat unduhan, ganti ${region_id} dengan ID Wilayah wilayah tempat Instance 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 transfer dan jalankan perintah instalasi. Ganti ${region_id} dengan ID Wilayah wilayah tempat proyek berada.

    • Internet: Metode ini cocok untuk sebagian besar skenario, seperti transfer lintas wilayah atau transfer dari server cloud lain atau server on-premises. Namun, metode ini dibatasi oleh bandwidth dan mungkin tidak stabil.

      chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-internet
    • Akselerasi transfer: Metode ini digunakan untuk transfer lintas wilayah, seperti dari Daratan Tiongkok ke wilayah di luar Tiongkok. Metode ini menggunakan CDN untuk meningkatkan kinerja dan mencegah latensi tinggi serta ketidakstabilan melalui Internet. Namun, Anda akan dikenai biaya atas lalu lintas tersebut.

      Anda harus terlebih dahulu mengaktifkan fitur Akselerasi Transfer Log Lintas Wilayah untuk proyek Anda sebelum menjalankan perintah instalasi.
      chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-acceleration
  3. Periksa status startup. Jalankan perintah. Tanggapan loongcollector is running menunjukkan startup berhasil.

    sudo /etc/init.d/loongcollectord status
  4. Konfigurasikan kelompok mesin. Simple Log Service 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 ID kustom. String ini digunakan dalam langkah-langkah selanjutnya.

      # Tulis string kustom ke file yang ditentukan. Jika direktori tidak ada, buat secara manual. Jalur dan nama file ditetapkan oleh Simple Log Service dan tidak dapat dikustomisasi.
      echo "user-defined-test-1" > /etc/ilogtail/user_defined_id 
    2. Masuk ke Konsol Simple Log Service. Di bagian Proyek, klik proyek target.

    3. Klik image Sumber Daya, lalu klik Kelompok Mesin.

    4. Klik image di samping Kelompok Mesin, lalu klik Buat Kelompok Mesin.image

    5. Konfigurasikan parameter berikut dan klik OK.

      • Nama Kelompok Mesin: Masukkan nama yang unik dalam proyek. Nama harus 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 (_).

      • Untuk ID Kelompok Mesin, pilih Custom Identifier.

      • Pengenal Kustom: Masukkan ID kustom yang dikonfigurasi. Harus sama dengan string kustom dalam file ID kustom di server. Dalam contoh ini, nilainya adalah user-defined-test-1.

  5. Setelah kelompok mesin dibuat, klik di daftar. Periksa status Heartbeat. Jika statusnya FAIL, tunggu sekitar dua menit dan muat ulang halaman secara manual. Jika statusnya OK, kelompok mesin berhasil dibuat.

  6. Setelah instalasi selesai, Anda juga harus melakukan konfigurasi pengumpulan untuk mengumpulkan log.

Akun berbeda, wilayah sama

Jika server Anda adalah Instance ECS Alibaba Cloud, dan Instance ECS serta proyek berada dalam wilayah yang sama tetapi dalam akun Alibaba Cloud yang berbeda, Anda harus mengunduh paket instalasi secara manual, menggunakan transfer jaringan internal dalam perintah instalasi, dan mengonfigurasi ID pengguna.

Prosedur:

  1. Unduh paket instalasi. Jalankan perintah unduh di server Anda. Dalam contoh kode, Anda dapat mengganti ${region_id} dengan cn-hangzhou. Untuk mempercepat unduhan, ganti ${region_id} dengan ID Wilayah wilayah tempat Instance ECS 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 ID Wilayah wilayah tempat proyek berada.

    Jika terjadi timeout koneksi, nilai ${region_id} mungkin salah. Transfer jaringan internal tidak dapat dibuat antar wilayah yang berbeda. Perbaiki nilai tersebut dan jalankan kembali perintah instalasi.
    chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}
  3. Periksa status startup. Jalankan perintah. Tanggapan loongcollector is running menunjukkan startup berhasil.

    sudo /etc/init.d/loongcollectord status
  4. Konfigurasikan ID pengguna. File ID pengguna berisi ID Akun 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 Instance ECS milik akun lain, server on-premises, atau server dari penyedia layanan cloud lainnya. Jika beberapa akun mengumpulkan log dari server yang sama, Anda dapat membuat beberapa file ID pengguna di server tersebut.
    1. Masuk ke Konsol Simple Log Service. Arahkan kursor ke gambar profil di pojok kanan atas. Di tab yang muncul, lihat dan salin ID akun. Pastikan untuk menyalin ID Akun Alibaba Cloud.

    2. Di server tempat LoongCollector diinstal, buat file ID pengguna dengan ID Akun Alibaba Cloud sebagai nama file.

      touch /etc/ilogtail/users/{ID akun Alibaba Cloud} # Jika direktori /etc/ilogtail/users tidak ada, buat secara manual. File ID pengguna hanya memerlukan nama file, tanpa ekstensi.
  5. Konfigurasikan kelompok mesin. Simple Log Service 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 ID kustom. String ini digunakan dalam langkah-langkah selanjutnya.

      # Tulis string kustom ke file yang ditentukan. Jika direktori tidak ada, buat secara manual. Jalur dan nama file ditetapkan oleh Simple Log Service dan tidak dapat dikustomisasi.
      echo "user-defined-test-1" > /etc/ilogtail/user_defined_id 
    2. Masuk ke Konsol Simple Log Service. Di bagian Proyek, klik proyek target.

    3. Klik image Sumber Daya, lalu klik Kelompok Mesin.

    4. Klik image di samping Kelompok Mesin, lalu klik Buat Kelompok Mesin.image

    5. Konfigurasikan parameter berikut dan klik OK.

      • Nama Kelompok Mesin: Masukkan nama yang unik dalam proyek. Nama harus 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 (_).

      • Untuk ID Kelompok Mesin, pilih Custom Identifier.

      • Pengenal Kustom: Masukkan ID kustom yang dikonfigurasi. Harus sama dengan string kustom dalam file ID kustom di server. Dalam contoh ini, nilainya adalah user-defined-test-1.

  6. Setelah kelompok mesin dibuat, klik di daftar dan periksa status Heartbeat. Jika statusnya FAIL, tunggu sekitar dua menit lalu muat ulang halaman secara manual. Status OK menunjukkan bahwa kelompok mesin berhasil dibuat.

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

Server cloud lain atau server on-premises

Jika server Anda dihosting oleh penyedia layanan cloud lain atau merupakan server on-premises, Anda harus mengunduh paket instalasi secara manual, menggunakan transfer Internet atau akselerasi transfer dalam perintah instalasi, dan mengonfigurasi ID pengguna. Jika server Anda adalah Instance ECS Alibaba Cloud, tetapi instance dan proyek berada dalam akun Alibaba Cloud yang berbeda dan wilayah yang berbeda, Anda juga dapat memperlakukannya sebagai server on-premises.

Catatan

Untuk persyaratan server, lihat Sistem operasi Linux yang didukung.

Prosedur:

  1. Unduh paket instalasi. Jalankan perintah unduh di server Anda. Dalam contoh kode, Anda dapat mengganti ${region_id} dengan cn-hangzhou. Untuk mempercepat unduhan, ganti ${region_id} dengan ID Wilayah wilayah tempat Instance 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 transfer dan jalankan perintah instalasi. Ganti ${region_id} dengan ID Wilayah wilayah tempat proyek berada.

    • Internet: Metode ini cocok untuk sebagian besar skenario, seperti transfer lintas wilayah atau transfer dari server cloud lain atau server on-premises. Namun, metode ini dibatasi oleh bandwidth dan mungkin tidak stabil.

      chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-internet
    • Akselerasi transfer: Metode ini digunakan untuk transfer lintas wilayah, seperti dari Daratan Tiongkok ke wilayah di luar Tiongkok. Metode ini menggunakan CDN untuk meningkatkan kinerja dan mencegah latensi tinggi serta ketidakstabilan melalui Internet. Namun, Anda akan dikenai biaya atas lalu lintas tersebut.

      Anda harus terlebih dahulu mengaktifkan fitur Akselerasi Transfer Log Lintas Wilayah untuk proyek Anda sebelum menjalankan perintah instalasi.
      chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-acceleration
  3. Periksa status startup. Jalankan perintah. Tanggapan loongcollector is running menunjukkan startup berhasil.

    sudo /etc/init.d/loongcollectord status
  4. Konfigurasikan ID pengguna. File ID pengguna berisi ID Akun 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 Instance ECS milik akun lain, server on-premises, atau server dari penyedia layanan cloud lainnya. Jika beberapa akun mengumpulkan log dari server yang sama, Anda dapat membuat beberapa file ID pengguna di server tersebut.
    1. Masuk ke Konsol Simple Log Service. Arahkan kursor ke gambar profil di pojok kanan atas. Di tab yang muncul, lihat dan salin ID akun. Pastikan untuk menyalin ID Akun Alibaba Cloud.

    2. Di server tempat LoongCollector diinstal, buat file ID pengguna dengan ID Akun Alibaba Cloud sebagai nama file.

      touch /etc/ilogtail/users/{ID akun Alibaba Cloud} # Jika direktori /etc/ilogtail/users tidak ada, buat secara manual. File ID pengguna hanya memerlukan nama file, tanpa ekstensi.
  5. Konfigurasikan kelompok mesin. Simple Log Service 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 ID kustom. String ini digunakan dalam langkah-langkah selanjutnya.

      # Tulis string kustom ke file yang ditentukan. Jika direktori tidak ada, buat secara manual. Jalur dan nama file ditetapkan oleh Simple Log Service dan tidak dapat dikustomisasi.
      echo "user-defined-test-1" > /etc/ilogtail/user_defined_id 
    2. Masuk ke Konsol Simple Log Service. Di bagian Proyek, klik proyek target.

    3. Klik image Sumber Daya, lalu klik Kelompok Mesin.

    4. Klik image di samping Kelompok Mesin, lalu klik Buat Kelompok Mesin.image

    5. Konfigurasikan parameter berikut dan klik OK.

      • Nama Kelompok Mesin: Masukkan nama yang unik dalam proyek. Nama harus 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 (_).

      • Untuk ID Kelompok Mesin, pilih Custom Identifier.

      • Pengenal Kustom: Masukkan ID kustom yang dikonfigurasi. Harus sama dengan string kustom dalam file ID kustom di server. Dalam contoh ini, nilainya adalah user-defined-test-1.

  6. Setelah kelompok mesin dibuat, klik di daftar untuk memeriksa status Heartbeat. Jika statusnya FAIL, tunggu sekitar dua menit lalu muat ulang halaman secara manual. Jika statusnya OK, kelompok mesin berhasil dibuat.

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

Instal LoongCollector secara batch

  • Untuk skenario di mana Instance ECS dan proyek berada dalam akun dan wilayah yang sama, Anda dapat memilih beberapa Instance ECS selama instalasi otomatis.

  • Untuk skenario lainnya, Anda dapat menggunakan ECS Cloud Assistant untuk menjalankan perintah dan melakukan instalasi batch LoongCollector pada Instance ECS Anda.

    Untuk perintah unduh dan instalasi, rujuk ke skenario instalasi yang dijelaskan di atas. Untuk informasi selengkapnya tentang cara menggunakan ECS Cloud Assistant, lihat Buat dan jalankan perintah.

FAQ

Bagaimana cara menginstal LoongCollector jika server tidak dapat terhubung ke Internet?

  1. Di server tempat Anda ingin menginstal LoongCollector, jalankan uname -m untuk memeriksa arsitektur sistem. Lalu, di server yang dapat mengakses Internet, jalankan perintah unduh yang sesuai. Ganti ${region_id} dengan ID Wilayah wilayah tempat proyek berada.

    • 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 diunduh ke server tempat Anda ingin menginstal LoongCollector. Jalankan perintah berikut. Ganti ${region_id} dengan ID Wilayah wilayah tempat proyek berada.

    chmod +x loongcollector.sh; ./loongcollector.sh install-local ${region_id}-internet
  3. Jalankan perintah pemeriksaan. Tanggapan loongcollector is running menunjukkan startup berhasil.

    sudo /etc/init.d/loongcollectord status
  4. Karena server tidak dapat mengakses Internet, Anda juga harus mengonfigurasi proxy untuk membuat koneksi ke Internet.

Instalasi otomatis gagal

Instalasi otomatis hanya didukung ketika Instance ECS dan proyek berada dalam akun dan wilayah yang sama. Jika kondisi ini tidak terpenuhi, pilih metode instalasi lainnya. Jika kondisi ini terpenuhi, periksa apakah persyaratan izin dan jaringan dalam Prasyarat telah dipenuhi.

Apa yang harus saya lakukan jika tidak ada heartbeat atau status heartbeat adalah FAIL?

Jika status heartbeat adalah FAIL, kemungkinan karena koneksi awal memerlukan waktu. Tunggu sekitar dua menit lalu muat ulang status heartbeat. Jika status masih FAIL, lakukan pemeriksaan berikut:

  • Konfirmasi hubungan antara server dan proyek Simple Log Service. Hubungan yang berbeda sesuai dengan prosedur instalasi yang berbeda.

    • Jika Anda menemukan bahwa Anda memilih prosedur yang salah, jalankan perintah chmod +x loongcollector.sh; sudo ./loongcollector.sh uninstall; di server untuk meng-uninstall LoongCollector. Lalu, pilih dan jalankan prosedur yang benar.

  • Jika Anda memilih prosedur yang benar tetapi status heartbeat tetap FAIL, periksa apakah informasi region dalam file /usr/local/ilogtail/ilogtail_config.json di server tempat LoongCollector diinstal sesuai dengan ID Wilayah wilayah proyek Simple Log Service.

    • Jika tidak sesuai, ganti ${region_id} dalam perintah instalasi dan jalankan kembali perintah tersebut. LoongCollector akan memperbarui isi file.

      Metode ini melakukan instalasi timpa dan menghapus konfigurasi asli. Gunakan metode ini dengan hati-hati pada server yang sudah memiliki konfigurasi pengumpulan.
    • Jika informasi sudah sesuai atau status heartbeat tetap FAIL setelah instalasi ulang, lanjutkan dengan pemeriksaan berikut.

  • Jika prosedur mengharuskan Anda menyetel file ID pengguna untuk skenario lintas akun, periksa hal berikut:

    • Nilai ID pengguna harus berupa ID Akun Alibaba Cloud. Jika tidak, ubah nilainya.

    • ID Akun Alibaba Cloud ini harus merupakan ID akun yang memiliki proyek Simple Log Service, bukan ID akun yang memiliki server ECS.

  • Periksa apakah isi pengenal kustom yang dikonfigurasi dalam kelompok mesin di Konsol Simple Log Service konsisten dengan isi file ID kustom di server. Jika tidak konsisten, ubah salah satunya agar sesuai.

  • Jika status heartbeat tetap FAIL, periksa apakah persyaratan jaringan dalam Prasyarat telah dipenuhi.

Perbedaan antara kelompok mesin berbasis IP dan berbasis ID kustom

Meskipun kelompok mesin berbasis ID kustom lebih kompleks konfigurasinya dibandingkan kelompok mesin berbasis IP, kelompok mesin berbasis ID kustom berlaku untuk cakupan skenario yang lebih luas. Oleh karena itu, kami merekomendasikan Anda menggunakan kelompok mesin berbasis ID kustom untuk semua metode instalasi, kecuali instalasi otomatis yang menggunakan kelompok mesin berbasis IP untuk menyederhanakan proses.

Kelompok mesin berbasis IP

Saat menggunakan kelompok mesin berbasis IP, Anda harus menambahkan informasi alamat IP ke kelompok mesin untuk mengaitkannya dengan server.

  • Metode ini lebih sederhana dalam pembuatan dan konfigurasi.

  • Konflik alamat IP atau perubahan alamat IP dapat menyebabkan kegagalan heartbeat dan memengaruhi pengumpulan data.

Kelompok mesin berbasis ID kustom

Metode ini mengaitkan kelompok mesin dengan server dengan mengonfigurasi string kustom sebagai pengenal dalam kelompok mesin dan menambahkan string tersebut ke file ID di server. Anda dapat mengonfigurasi beberapa pengenal kustom dalam file ID server dengan memisahkan pengenal menggunakan line feed.

  • Proses konfigurasi lebih kompleks dibandingkan kelompok mesin berbasis IP. Namun, dalam lingkungan jaringan kustom seperti VPC, konflik alamat IP dapat menyebabkan kegagalan pengumpulan. Pengenal kustom dapat mencegah masalah tersebut.

  • Memungkinkan skalabilitas elastis otomatis kelompok mesin. Jika Anda mengonfigurasi ID kustom yang sama untuk server baru, Simple Log Service dapat secara otomatis mendeteksi dan menambahkannya ke kelompok mesin. Jika Anda tidak lagi perlu mengumpulkan log dari server, Anda cukup menghapus file ID yang dikonfigurasi di server tersebut, dan kelompok mesin secara otomatis menghapus server tersebut.

  • Sistem bisnis sering terdiri dari beberapa modul, yang masing-masing dapat diskalakan secara horizontal dengan menambahkan lebih banyak server. Untuk mengumpulkan dan mengklasifikasikan data log secara efisien, kami merekomendasikan Anda membuat kelompok mesin terpisah untuk setiap modul. Misalnya, situs web tipikal terdiri dari modul permintaan HTTP, modul logika, dan modul penyimpanan. Anda dapat menentukan pengenal kustomnya masing-masing sebagai http_module, logic_module, dan store_module.

Referensi terkait

Wilayah

  1. Masuk ke Konsol Simple Log Service. Di bagian Proyek, klik proyek target.

  2. Klik ikon image di samping nama proyek untuk membuka halaman ringkasan proyek.

  3. Di bagian Informasi Dasar, Anda dapat melihat nama wilayah proyek saat ini. Untuk ID Wilayah yang sesuai dengan setiap nama wilayah, lihat tabel berikut.

    Wilayah adalah lokasi geografis pusat data fisik tempat layanan Alibaba Cloud dihosting. ID Wilayah adalah pengenal unik suatu wilayah.

Tabel pemetaan Wilayah dan ID Wilayah

Nama wilayah

ID Wilayah

Tiongkok (Qingdao)

cn-qingdao

Tiongkok (Beijing)

cn-beijing

Tiongkok (Zhangjiakou)

cn-zhangjiakou

Tiongkok (Hohhot)

cn-huhehaote

Tiongkok (Ulanqab)

cn-wulanchabu

Tiongkok (Hangzhou)

cn-hangzhou

Tiongkok (Shanghai)

cn-shanghai

Tiongkok (Nanjing - Wilayah Lokal - Dihentikan)

cn-nanjing

Tiongkok (Fuzhou - Wilayah Lokal - Dihentikan)

cn-fuzhou

Tiongkok (Shenzhen)

cn-shenzhen

Tiongkok (Heyuan)

cn-heyuan

Tiongkok (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

Tiongkok (Chengdu)

cn-chengdu

Singapura

ap-southeast-1

Indonesia (Jakarta)

ap-southeast-5

Tiongkok (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 - Wilayah Mitra)

me-central-1

Jenis transfer jaringan LoongCollector

Titik akhir adalah nama domain yang digunakan untuk mengakses Simple Log Service. Ini adalah URL untuk mengakses proyek dan data log-nya, serta spesifik untuk wilayah tempat proyek tersebut berada. Simple Log Service menyediakan titik akhir internal, publik, dan akselerasi transfer. Anda dapat melihat titik akhir sebagai berikut:

  1. Masuk ke Konsol Simple Log Service. Di bagian Proyek, klik proyek target.

  2. Klik ikon image di samping nama proyek untuk membuka halaman ringkasan proyek.

  3. Pada tab Titik Akhir, Anda dapat melihat informasi nama domain untuk proyek saat ini. Jenis transfer jaringan yang berbeda sesuai dengan titik akhir yang berbeda. Memilih jenis transfer jaringan yang tepat dapat membantu membuat transmisi data log lebih cepat dan stabil.

Jenis jaringan

Jenis titik akhir yang sesuai

Deskripsi

Skenario

Jaringan internal Alibaba Cloud

Titik akhir internal

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

Instance ECS dan proyek Simple Log Service berada dalam wilayah yang sama, atau server on-premises terhubung ke jaringan internal.

Catatan

Kami merekomendasikan Anda membuat proyek Simple Log Service dalam wilayah yang sama dengan Instance ECS Anda. Hal ini memungkinkan Anda mengumpulkan log dari Instance ECS melalui jaringan internal Alibaba Cloud tanpa mengonsumsi bandwidth publik.

Internet

Titik akhir publik

Mengirim data log melalui Internet tidak hanya dibatasi oleh bandwidth jaringan tetapi juga dapat dipengaruhi oleh fluktuasi jaringan, latensi, dan kehilangan paket, yang dapat memengaruhi kecepatan dan stabilitas pengumpulan data.

Anda dapat memilih untuk mentransfer data melalui Internet dalam dua kasus berikut:

  • Instance ECS dan proyek Simple Log Service berada dalam wilayah yang berbeda.

  • Server berasal dari penyedia layanan cloud lain atau pusat data on-premises.

Akselerasi transfer

Titik akhir akselerasi

Metode ini menggunakan titik keberadaan (POPs) CDN Alibaba Cloud untuk mempercepat pengumpulan log. Metode ini menawarkan keunggulan signifikan dalam latensi dan stabilitas jaringan dibandingkan pengumpulan melalui Internet. Namun, Anda akan dikenai biaya atas lalu lintas tersebut. 

Jika server bisnis Anda dan proyek Simple Log Service masing-masing berada di wilayah di Daratan Tiongkok dan wilayah di luar Daratan Tiongkok, mentransfer data melalui Internet dapat menyebabkan latensi jaringan tinggi dan ketidakstabilan. Anda dapat memilih untuk menggunakan akselerasi transfer untuk mentransfer data. Untuk informasi selengkapnya, lihat Akselerasi transfer.