Atasi kegagalan instalasi Beats - Elasticsearch - Alibaba Cloud Documentation Center

Gunakan panduan ini untuk mendiagnosis dan mengatasi kegagalan instalasi atau heartbeat tidak normal pada Beats shipper di Alibaba Cloud Elasticsearch.

Prasyarat

Sebelum memulai, pastikan Anda telah:

Mengakses instans Elastic Compute Service (ECS) tempat Beats diinstal.
Memiliki izin untuk terhubung ke instans ECS dan menjalankan perintah shell.

Atasi kegagalan instalasi

Lakukan pemeriksaan berikut secara berurutan. Setiap pemeriksaan menangani akar penyebab yang berbeda.

Langkah 1: Verifikasi sistem operasi

Beats shipper pada Alibaba Cloud Elasticsearch memerlukan sistem operasi yang didukung. Pastikan instans ECS menjalankan salah satu sistem berikut:

Alibaba Cloud Linux
Red Hat Enterprise Linux (RHEL)
CentOS

Jika instans menjalankan sistem operasi lain, migrasikan Beats ke instans yang didukung.

Langkah 2: Verifikasi konektivitas jaringan

Instans ECS dan kluster Elasticsearch atau Logstash Anda harus berada dalam virtual private cloud (VPC) yang sama. Jika berada di VPC berbeda, Beats tidak dapat terhubung ke output dan instalasi akan gagal.

Langkah 3: Periksa Cloud Assistant dan Docker

Beats berjalan di dalam kontainer Docker yang dikelola oleh Cloud Assistant. Jika salah satu layanan tersebut tidak tersedia atau berhenti, shipper tidak dapat dimulai.

Hubungkan ke instans ECS, lalu jalankan perintah berikut.

Periksa Cloud Assistant:

systemctl status aliyun.service

Cloud Assistant yang sehat menghasilkan output serupa berikut:

Jika Cloud Assistant tidak berjalan, lihat Instal klien Cloud Assistant.

Periksa Docker:

systemctl status docker

Layanan Docker yang sehat menghasilkan output serupa berikut:

Jika Docker tidak berjalan, lihat Deploy dan gunakan Docker pada instans Alibaba Cloud Linux 2.

Langkah 4: Periksa file konfigurasi YAML

Parameter yang salah konfigurasi dalam file konfigurasi YAML shipper merupakan penyebab umum kegagalan instalasi. Pastikan file tersebut mencakup hal berikut:

- type: log
  # Ubah menjadi true untuk mengaktifkan konfigurasi input ini.
  enabled: true
  # Path yang harus di-crawl dan diambil. Path berbasis glob.
  paths:
    - /var/log/*.log

Parameter	Deskripsi
`enabled`	Atur ke `true` untuk mengaktifkan input. Nilai default-nya adalah `false`.
`paths`	Path ke file log yang akan dikumpulkan. Mendukung wildcard, seperti `*.log`.

Penting

Perhatikan batasan berikut:

paths vs. Filebeat Log File Path: Nilai paths dalam file YAML dan Filebeat Log File Path pada halaman konfigurasi memiliki tujuan berbeda. Docker memetakan path yang ditentukan oleh Filebeat Log File Path; hanya setelah pemetaan tersebut data mencapai lokasi yang ditentukan oleh paths. Atur keduanya ke nilai yang sama untuk menghindari celah pengumpulan data.
Konfigurasi Output ganda: Jika Anda telah menentukan Output pada halaman konfigurasi, jangan tambahkan bagian output dalam file YAML. Konfigurasi output ganda memicu error instalasi.
Parameter yang dikomentari: Berhati-hatilah saat mengaktifkan kembali parameter yang dikomentari dengan #, seperti parameter terkait X-Pack. Nilai yang salah pada parameter tersebut dapat mencegah shipper terinstal.

Langkah 5: Verifikasi direktori instans Beats

Setelah instalasi berhasil, Beats membuat direktori di /opt/aliyunbeats/ dengan tiga subfolder: conf, data, dan logs.

Hubungkan ke instans ECS dan pastikan direktori serta folder-folder tersebut ada:

Jika direktori tidak ada, instalasi belum selesai. Tinjau langkah-langkah sebelumnya untuk mengidentifikasi penyebabnya.

Jika direktori ada, periksa folder logs untuk pesan error yang dapat membantu mengidentifikasi masalah:

Langkah 6: Periksa status kontainer Docker

Jika shipper masih tidak berfungsi setelah pemeriksaan sebelumnya, periksa langsung kontainer Docker.

Periksa status kontainer:
```
docker ps -a | grep filebeat
```
Jika kontainer berada dalam status exited, ambil log-nya untuk mengidentifikasi error:
```
docker logs -f <container-id>
```
Ganti <container-id> dengan ID kontainer dari output perintah sebelumnya.