Ikhtisar grup mesin

Grup mesin adalah kumpulan virtual dari server. Layanan Log Sederhana menggunakan Logtail untuk mengelola dan mengumpulkan log dari server-server tersebut. Anda dapat mengumpulkan log dari banyak server ke dalam sebuah logstore menggunakan grup mesin.

Prasyarat

Sebuah proyek telah dibuat.
Logtail telah diinstal pada server Anda.

Proyek Simple Log Service memungkinkan Anda menerapkan konfigurasi Logtail ke beberapa grup mesin atau mengikat satu grup ke beberapa konfigurasi Logtail. Untuk mengumpulkan data dari banyak server, kelompokkan mereka ke dalam grup mesin berdasarkan wilayah penyebaran atau kategori mereka, lalu terapkan konfigurasi Logtail ke grup yang ditentukan. Simple Log Service menyampaikan konfigurasi ke semua server dalam grup untuk mengumpulkan data dari mereka.

Buat grup mesin

Langkah 1: Konfigurasikan pengenal pengguna (opsional)

Konfigurasikan pengenal pengguna pada server jika salah satu kondisi berikut terpenuhi. Jika instance Elastic Compute Service (ECS) Anda dan Layanan Log Sederhana termasuk dalam akun Alibaba Cloud yang sama, lewati langkah ini.

Server tersebut bukan instance ECS.
Server tersebut adalah instance ECS, tetapi instance ECS dan Layanan Log Sederhana termasuk dalam akun Alibaba Cloud yang berbeda.

Catatan

Pengenal pengguna memungkinkan server diakses oleh akun Alibaba Cloud dan memungkinkan proyek Layanan Log Sederhana menggunakan Logtail untuk pengumpulan log dari server tersebut.

Gunakan akun Alibaba Cloud Anda untuk masuk ke konsol Layanan Log Sederhana. Gerakkan kursor Anda ke atas foto profil di sudut kanan atas, lalu lihat dan salin Account ID dari tab yang muncul. Jika Anda menggunakan pengguna RAM untuk masuk, salin Main Account.
Masuk ke server dari mana Anda ingin mengumpulkan data. Lalu konfigurasikan pengenal pengguna dengan menggunakan salah satu metode berikut untuk mengonfigurasi file ID akun Alibaba Cloud.
Linux
- Buat file ID akun Alibaba Cloud di direktori /etc/ilogtail/users.
```
touch /etc/ilogtail/users/{Alibaba Cloud account ID}
```
  Penting
  Jika direktori /etc/ilogtail/users tidak ada, buatlah.
  Setelah Anda mengonfigurasi atau menghapus pengenal pengguna, perubahan akan berlaku dalam waktu 1 menit.
- Untuk menggunakan beberapa proyek Layanan Log Sederhana yang termasuk dalam akun Alibaba Cloud yang berbeda untuk mengumpulkan log dari server yang sama, buat beberapa file yang namanya adalah ID akun Alibaba Cloud pada server tersebut. Contohnya:
```
touch /etc/ilogtail/users/{Alibaba Cloud account ID 1}
touch /etc/ilogtail/users/{Alibaba Cloud account ID 2}
```
Windows
- Buat file ID akun Alibaba Cloud di direktori C:\LogtailData\users.
  - Gunakan Windows PowerShell.
    ni C:\LogtailData\users\{Alibaba Cloud account ID}
  - Jalankan perintah berikut di Command Prompt untuk membuat file:
    type nul > C:\LogtailData\users\{Alibaba Cloud account ID}
- Untuk menggunakan beberapa proyek Layanan Log Sederhana yang termasuk dalam akun Alibaba Cloud yang berbeda untuk mengumpulkan log dari server yang sama, buat beberapa file yang namanya adalah ID akun Alibaba Cloud pada server tersebut.
Lingkungan kontainer
Jika Logtail diterapkan di kluster Kubernetes Alibaba Cloud dan versi Logtail-ds adalah 1.7.3 atau lebih baru, Anda dapat menetapkan pengenal kustom di konsol Container Service for Kubernetes. Pada halaman Components, modifikasi komponen logtail-ds dan atur parameter LogtailDSExternalUserDefinelDs. Untuk informasi lebih lanjut, lihat Kelola Komponen.
Catatan
- Untuk menyiapkan pengenal pengguna, konfigurasikan hanya nama file, bukan ekstensi file.
- Anda dapat memiliki beberapa pengenal pengguna untuk server, tetapi hanya satu untuk kontainer Logtail.
- Jika Anda tidak lagi memerlukan pengenal pengguna, hapus file ID akun Alibaba Cloud dari server.

Langkah 2: Buat grup mesin

Catatan

Proyek Layanan Log Sederhana dapat membuat grup mesin menggunakan pengenal kustom (direkomendasikan) atau alamat IP. Membuat grup dengan alamat IP lebih mudah, tetapi pengenal kustom menawarkan manfaat berikut:

Mencegah konflik IP yang dapat terjadi di jaringan kustom seperti VPC, memastikan pengumpulan Logtail tidak gagal.
Mendukung skalabilitas elastis. Server baru dengan pengenal yang sama secara otomatis ditambahkan ke grup mesin. Untuk menghentikan pengumpulan log dari server, hapus file pengenal kustom. Server tersebut akan secara otomatis dihapus dari grup.

Buat grup mesin berbasis pengenal kustom

Secara umum, sistem memiliki beberapa modul, dan Anda dapat memperluas setiap modul dengan menambahkan server. Untuk mengumpulkan dan mengatur log secara efisien, buat grup mesin untuk setiap modul. Pastikan semua server dalam modul berbagi pengenal pengguna yang sama untuk memastikan mereka termasuk dalam grup mesin yang benar.

Sebagai contoh, sebuah situs web memiliki modul untuk permintaan HTTP, caching, pemrosesan logika, dan penyimpanan, dengan pengenal seperti http_module, cache_module, logic_module, dan store_module.

Penting

Server Linux dan Windows tidak dapat berada dalam grup mesin yang sama. Hindari menggunakan Pengenal Kustom yang sama untuk server Linux dan Windows.
Sebuah server dapat memiliki beberapa Pengenal Kustom, dipisahkan oleh baris baru.

Konfigurasikan pengenal kustom.
Linux
1. Masuk ke server Linux tempat Logtail diinstal, lalu jalankan perintah berikut untuk mengonfigurasi pengenal kustom.
  Catatan
  Buat direktori /etc/ilogtail/ jika tidak ada.
```
echo "user-defined-1" > /etc/ilogtail/user_defined_id
```
2. (Opsional) Jalankan perintah berikut untuk memeriksa konfigurasi. Jika user-defined-1 dikembalikan, pengenal kustom telah dikonfigurasi.
```
cat /etc/ilogtail/user_defined_id
```
3. Secara default, perubahan pada file user_defined_id berlaku dalam waktu 1 menit setelah pembuatan, penghapusan, atau modifikasi. Untuk menerapkan perubahan segera, mulai ulang Logtail dengan perintah berikut:
```
/etc/init.d/ilogtaild stop
/etc/init.d/ilogtaild start
```
Windows
1. Masuk ke server Windows tempat Logtail diinstal, buat file user_defined_id di direktori C:\LogtailData, lalu tulis user-defined-1 ke file tersebut. Simpan file.
  Catatan
  Buat direktori C:\LogtailData jika tidak ada.
2. Secara default, perubahan pada file user_defined_id berlaku dalam waktu 1 menit setelah pembuatan, penghapusan, atau modifikasi. Untuk menerapkan perubahan segera, mulai ulang Logtail dengan langkah-langkah berikut:
  1. Pilih Start > Control Panel > Administrative Tools > Services.
  2. Di kotak dialog Services, pilih layanan yang sesuai.
  3. Untuk Logtail V0.x.x.x, pilih LogtailWorker.
  4. Untuk Logtail V1.0.0.0 atau lebih baru, pilih LogtailDaemon.
  5. Klik kanan Restart untuk menerapkan konfigurasi.
Kontainer
Pengenal kustom dikonfigurasi dalam variabel lingkungan ALIYUN_LOGTAIL_USER_DEFINED_ID dari kontainer Logtail. Jalankan perintah docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_DEFINED_ID untuk melihatnya.
Masuk ke konsol Layanan Log Sederhana. Di bagian Projects, klik proyek target. Di panel navigasi di sebelah kiri, pilih Resources > Machine Groups. Di halaman Machine Groups, klik ikon dan pilih Create Machine Group.

Di panel Create Machine Group, konfigurasikan parameter berikut, lalu klik OK.

Parameter	Deskripsi
Name	Nama grup mesin. Nama 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 grup mesin, Anda tidak dapat mengubah namanya. Lanjutkan dengan hati-hati.
Machine Group Identifier	Pilih Custom Identifier.
Machine Group Topic (opsional)	Topik grup mesin. Digunakan untuk membedakan data log yang dihasilkan di server yang berbeda.
Custom Identifier	Masukkan pengenal kustom yang dikonfigurasi di Langkah 1, misalnya, `user-defined-1`.

Buat grup mesin berbasis alamat IP

Masuk ke konsol Layanan Log Sederhana. Di bagian Projects, klik proyek target.
Di panel navigasi di sebelah kiri, pilih Resources > Machine Groups. Di halaman Machine Groups, pilih Machine Groups > > Create Machine Group.

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

Parameter	Deskripsi
Name	Nama Machine Group. Nama harus memenuhi persyaratan berikut: Nama hanya dapat berisi huruf kecil, angka, tanda hubung (-), dan garis bawah (_). Nama harus dimulai dan diakhiri dengan huruf kecil atau angka. Nama harus memiliki panjang 2 hingga 128 karakter. Penting Setelah grup mesin dibuat, Anda tidak dapat mengubah nama grup mesin. Lanjutkan dengan hati-hati.
Identifier	Pilih IP Address.
Topic	(Opsional) Topic grup mesin. Topik digunakan untuk membedakan data log yang dihasilkan di server yang berbeda. Untuk informasi lebih lanjut, lihat Topik Log.
IP Address	Masukkan alamat IP yang diperoleh secara otomatis oleh Logtail: Pada server tempat Logtail diinstal, buka file `app_info.json` dan lihat nilai bidang `ip`. Path file `app_info.json` adalah sebagai berikut. Alamat IP yang diperoleh secara otomatis oleh Logtail dicatat di bidang `ip` file `app_info.json`, seperti yang ditunjukkan pada gambar berikut. Penting Jika Anda ingin menambahkan beberapa server ke grup mesin, masukkan secara manual alamat IP server dan pisahkan alamat IP dengan baris baru. Grup mesin tidak dapat mencakup server Linux dan Windows. Jangan tambahkan alamat IP server Windows dan Linux ke Machine Group yang sama.

Lihat konfigurasi grup mesin

Di daftar Machine Groups, klik salah satu untuk masuk ke halaman Konfigurasi Grup Mesin. Di sini Anda dapat melihat Machine Group Information, Machine Group Status, dan manajemen konfigurasi.

Jika status Heartbeat adalah OK, instans Logtail di server terhubung ke proyek Simple Log Service.
Jika status Heartbeat adalah FAIL, konfigurasi mungkin belum berlaku. Tunggu sekitar 2 menit. Jika status masih FAIL, mungkin ada masalah konfigurasi lainnya. Lihat Bagaimana cara saya menyelesaikan kesalahan yang terkait dengan grup mesin Logtail di lingkungan host?

Terapkan konfigurasi Logtail ke grup mesin

Di daftar Machine Groups, klik salah satu untuk masuk ke halaman Machine Group Configurations. Lalu, klik Modify di pojok kanan atas halaman.
Di bagian Manage Configuration, pilih konfigurasi Logtail dari sisi kiri, lalu klik ikon > untuk memindahkan konfigurasi ke bagian Applied Logtail Configurations di sisi kanan.
Penting
Menambahkan konfigurasi Logtail ke grup mesin akan menerapkannya ke setiap instans Logtail pada server. Menghapusnya akan menghilangkan konfigurasi tersebut dari setiap instans Logtail dalam grup.
Klik Save.

Ubah informasi grup mesin

Di daftar Machine Groups, klik salah satu untuk masuk ke halaman Machine Group Configurations. Lalu, klik Modify di pojok kanan atas halaman.
Ubah informasi berikut:
- Machine Group Identifier: Jenis grup mesin, yang dapat berupa IP Address atau Custom Identifier.
- Machine Group Topic: Lihat Topik Log.
- Custom Identifier atau IP Address: Anda dapat menambahkan atau menghapus mesin dari grup mesin, dengan setiap mesin dipisahkan oleh baris baru. Pastikan konsistensi dengan jenis yang dipilih dalam pengenal grup mesin.
  Penting
  Mesin yang baru ditambahkan harus memiliki Logtail terinstal. Jika tidak, menambahkannya ke grup mesin tidak akan secara otomatis menginstal Logtail, yang berpotensi menyebabkan kegagalan detak jantung.
Klik Save.

Hapus grup mesin

Di daftar Machine Groups, pilih yang ingin Anda hapus, lalu pilih > Delete.
Di kotak dialog yang muncul, masukkan nama grup mesin dan klik Confirm Deletion.

Referensi

Instalasi Manual Logtail untuk Mengumpulkan Log Teks dari Server.
API berikut tersedia untuk mengelola grup mesin:

Prasyarat