Gunakan Logtail untuk mengumpulkan log lintas wilayah - Simple Log Service

Topik ini menjelaskan cara menggunakan Logtail untuk mengumpulkan log dari Server Linux di wilayah berbeda tetapi dalam Akun Alibaba Cloud yang sama.

Ikhtisar solusi

Sebagai contoh, sebuah perusahaan menerapkan aplikasi situs webnya pada Instance ECS di Wilayah A dan Simple Log Service proyek di Wilayah B. Perusahaan tersebut ingin menggunakan Konfigurasi Logtail untuk mengumpulkan log dari Instance ECS di Wilayah A dan mengirimkannya ke Simple Log Service proyek di Wilayah B. Untuk melakukannya, ikuti langkah-langkah berikut:

Langkah 1: Instal Logtail pada Instance ECS di Wilayah A
Langkah 2: Konfigurasikan pengenal kustom untuk Instance ECS di Wilayah A
Langkah 3: Buat kelompok mesin berbasis pengenal kustom di Proyek Simple Log Service di Wilayah B
Langkah 4: Buat konfigurasi Logtail di Proyek Simple Log Service di Wilayah B

Bagan alir berikut menunjukkan prosedur konfigurasi.

Prasyarat

Diperlukan sebuah proyek dan Logstore. Untuk informasi lebih lanjut, lihat Kelola proyek dan Buat Logstore.

Langkah 1: Instal Logtail pada Instance ECS di Wilayah A

Transmisi jaringan

Mode transmisi	Skenario
Internet	Instance ECS Alibaba Cloud dan proyek Simple Log Service berada di wilayah yang berbeda. Server disediakan oleh penyedia layanan cloud pihak ketiga atau berlokasi di pusat data lokal.
Akselerasi transfer	Server disediakan oleh penyedia layanan cloud pihak ketiga di luar Tiongkok atau berlokasi di pusat data di luar Tiongkok. Transfer data melalui Internet dapat menyebabkan latensi jaringan tinggi dan koneksi tidak stabil. Dalam hal ini, gunakan fitur akselerasi transfer. Untuk informasi lebih lanjut, lihat Kelola akselerasi transfer.

Masuk ke Instance ECS di Wilayah A. Lihat Transmisi jaringan untuk memilih skrip instalasi Logtail sesuai dengan lingkungan jaringan Anda. Untuk informasi tentang sistem operasi Linux yang didukung oleh Logtail, lihat Batasan.

Internet

Peroleh nilai parameter Simple Log Service untuk wilayah tempat proyek Simple Log Service berada. Ganti parameter ${region_id} dengan nilai yang diperoleh dan jalankan perintah instalasi.

Penting

Untuk informasi lebih lanjut tentang nilai parameter ${region_id} untuk setiap wilayah, lihat Wilayah yang didukung. Sebagai contoh, nilai parameter ${region_id} untuk wilayah Singapura adalah ap-southeast-1.

wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh install ${region_id}-internet

Akselerasi transfer

Peroleh nilai parameter Simple Log Service untuk wilayah tempat proyek Simple Log Service berada. Ganti parameter ${region_id} dengan nilai yang diperoleh dan jalankan perintah instalasi.

Penting

Untuk informasi lebih lanjut tentang nilai parameter ${region_id} untuk setiap wilayah, lihat Wilayah yang didukung. Sebagai contoh, nilai parameter ${region_id} untuk wilayah Tiongkok (Hangzhou) adalah cn-hangzhou.
Setelah menginstal Logtail menggunakan akselerasi transfer, Anda perlu mengaktifkan fitur akselerasi transfer agar berfungsi. Untuk informasi lebih lanjut, lihat Aktifkan fitur akselerasi transfer untuk proyek.

wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh install ${region_id}-acceleration

Langkah 2: Konfigurasikan pengenal kustom untuk Instance ECS di Wilayah A

Buat file bernama user_defined_id di direktori yang ditentukan dan tambahkan pengenal kustom ke file tersebut.
Penting
- Machine Group tidak dapat berisi server Linux dan Windows sekaligus, dan Custom Identifier yang sama tidak dapat digunakan untuk keduanya.
- Anda dapat mengonfigurasi beberapa Custom Identifiers untuk server, dipisahkan oleh baris baru.

Lingkungan Linux

Masuk ke server Linux tempat Logtail diinstal dan jalankan perintah berikut untuk mengonfigurasi Custom Identifier.
Catatan
Jika direktori /etc/ilogtail/ tidak ada, buat direktori tersebut.
```
echo "user-defined-1" > /etc/ilogtail/user_defined_id
```
(Opsional) Jalankan perintah berikut untuk memeriksa apakah Custom Identifier telah dikonfigurasi. Jika user-defined-1 dikembalikan, pengenal kustom telah dikonfigurasi.
```
cat /etc/ilogtail/user_defined_id
```
Setelah Anda membuat, menghapus, atau memodifikasi file user_defined_id, pengaturan baru akan berlaku dalam waktu 1 menit secara default. Untuk membuat pengaturan berlaku segera, Anda dapat menjalankan perintah berikut untuk me-restart Logtail.
```
/etc/init.d/ilogtaild stop
/etc/init.d/ilogtaild start
```

Lingkungan Windows

Masuk ke server Windows tempat Logtail diinstal. Di direktori C:\LogtailData, buat file bernama user_defined_id yang berisi user-defined-1 dan simpan file tersebut.
Catatan
Jika direktori C:\LogtailData tidak ada, buat direktori tersebut.
Setelah Anda membuat, menghapus, atau memodifikasi file user_defined_id, pengaturan baru akan berlaku dalam waktu 1 menit secara default. Untuk membuat pengaturan berlaku segera, Anda dapat me-restart Logtail.
1. Pilih Start > Control Panel > Administrative Tools > Services.
2. Di kotak dialog Services, pilih layanan yang ingin dikelola.
3. Untuk Logtail V0.x.x.x, pilih layanan LogtailWorker.
4. Untuk Logtail V1.0.0.0 atau versi lebih baru, pilih layanan LogtailDaemon.
5. Klik kanan layanan dan pilih Restart.

Lingkungan kontainer

Pengenal kustom diatur dalam variabel lingkungan ALIYUN_LOGTAIL_USER_DEFINED_ID dari kontainer Logtail. Anda dapat menjalankan perintah docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_DEFINED_ID untuk melihat pengaturan ini.

Langkah 3: Buat kelompok mesin berbasis pengenal kustom di Proyek Simple Log Service di Wilayah B

Masuk ke Konsol Simple Log Service. Di bagian Projects, klik yang Anda inginkan.
Di panel navigasi di sebelah kiri, pilih Resources > Machine Groups. Di daftar Machine Groups, pilih > Create Machine Group.

Di panel Create Machine Group, konfigurasikan parameter dan klik OK. Tabel berikut menjelaskan parameter tersebut.

Parameter	Deskripsi
Name	Nama kelompok mesin harus memenuhi persyaratan berikut: Hanya berisi huruf kecil, angka, tanda hubung (-), dan garis bawah (_). Dimulai dan diakhiri dengan huruf kecil atau angka. Panjangnya 2 hingga 128 karakter. Penting Setelah Anda membuat kelompok mesin, Anda tidak dapat mengubah namanya. Lanjutkan dengan hati-hati.
Machine Group Identifier	Tipe pengenal kelompok mesin. Pilih IP Address.
Machine Group Topic	Opsional. Topik digunakan untuk mengidentifikasi log yang dihasilkan oleh server yang berbeda.
IP Address	Alamat IP. Masukkan alamat IP yang diperoleh secara otomatis oleh Logtail. Penting Jika Anda ingin menambahkan beberapa server ke kelompok mesin, kami sarankan Anda memasukkan alamat IP server secara manual dan memisahkan alamat IP dengan baris baru. Kelompok mesin tidak dapat mencakup server Linux dan Windows sekaligus. Jangan tambahkan alamat IP server Linux dan Windows ke machine group yang sama.

Di daftar Machine Groups, klik kelompok mesin target. Di halaman Machine Group Configurations, periksa konfigurasi kelompok mesin dan status server.

Langkah 4: Buat konfigurasi Logtail di Proyek Simple Log Service di Wilayah B

Penting

Port 80 (HTTP) dan 443 (HTTPS) harus dibuka untuk lalu lintas keluar di host tempat Logtail diinstal. Jika host tersebut adalah Instance ECS, port-port tersebut dikontrol oleh aturan grup keamanan. Untuk informasi lebih lanjut tentang cara menambahkan aturan grup keamanan, lihat Tambahkan aturan grup keamanan.
Logtail hanya mengumpulkan log tambahan dari file yang terus diperbarui. Jika file log tidak diperbarui setelah Anda menerapkan konfigurasi Logtail, Logtail tidak akan mengumpulkan log dari file tersebut. Untuk informasi lebih lanjut, lihat Baca file log.
Untuk mengumpulkan data historis, lihat Impor file log historis.

Referensi

Jika halaman pratinjau kosong atau halaman kueri tidak menampilkan data saat Anda menggunakan Logtail untuk mengumpulkan log, Anda dapat memecahkan masalah tersebut dengan mengikuti instruksi yang diberikan di Apa yang harus saya lakukan jika terjadi kesalahan saat saya menggunakan Logtail untuk mengumpulkan log? Jika Anda menggunakan Logtail untuk mengumpulkan log, kesalahan mungkin terjadi. Misalnya, ekspresi reguler mungkin gagal diurai, jalur file tidak valid mungkin ada, dan lalu lintas mungkin melebihi kemampuan pemrosesan shard. Anda dapat melihat kesalahan pengumpulan Logtail dengan mengikuti instruksi yang diberikan di Bagaimana cara melihat kesalahan pengumpulan Logtail? Untuk informasi lebih lanjut tentang jenis kesalahan umum dalam pengumpulan data Layanan Log Sederhana, lihat Jenis kesalahan umum dalam pengumpulan data Layanan Log Sederhana.
Secara default, Anda hanya dapat menggunakan satu konfigurasi Logtail untuk mengumpulkan log dari file log. Jika Anda ingin mengumpulkan beberapa salinan log dalam file, Anda dapat mengikuti instruksi yang diberikan di Bagaimana cara mengumpulkan beberapa salinan log dalam file?
Untuk informasi lebih lanjut tentang cara mengumpulkan log dari server di intranet perusahaan ke Layanan Log Sederhana, lihat Kumpulkan log dari server di intranet perusahaan.