全部产品
Search
文档中心

Elasticsearch:Gunakan Elastic Agent untuk mengumpulkan data log NGINX

更新时间:Mar 06, 2026

NGINX adalah server web berkinerja tinggi yang banyak digunakan. Stabilitas server merupakan perhatian utama bagi pengembang. Gunakan Fleet Server di Kibana untuk mengelola log NGINX yang dikumpulkan oleh Elastic Agent, lalu kirim log tersebut ke Kibana guna analitik visual. Hal ini membantu Anda memantau dan mengoptimalkan kinerja serta keamanan server NGINX. Topik ini menjelaskan cara menggunakan Fleet Server untuk mengelola log NGINX dari dua instans sumber Elastic Compute Service (ECS) menggunakan kebijakan integrasi yang sama.

Batasan

Fitur ini hanya berfungsi dengan kluster Elasticsearch yang menggunakan arsitektur Basic Management (V2). Kluster Elasticsearch yang menggunakan arsitektur cloud-native Next-Gen Management (V3) tidak mendukung pembuatan kebijakan agent di Kibana Fleet. Solusi pengganti dan panduan pengguna akan dirilis kemudian. Untuk memeriksa arsitektur manajemen kluster Anda, buka Basic Information > Control Architecture Type.

Istilah

Istilah

Deskripsi

Fleet

Solusi manajemen terpusat yang andal di Elasticsearch. Fleet mengelola Elastic Agent di seluruh lingkungan Anda.

Fleet Agent

Agent pengumpulan data ringan yang mengumpulkan data dari sistem sumber.

Fleet Agent berjalan di berbagai sistem operasi dan mengumpulkan berbagai jenis data.

Fleet Server

Layanan yang mentransfer data yang dikumpulkan oleh Fleet Agent ke Elasticsearch.

Persiapkan lingkungan Anda

  • Buat kluster Alibaba Cloud Elasticsearch. Untuk informasi lebih lanjut, lihat Buat kluster Alibaba Cloud Elasticsearch. Contoh ini menggunakan Elasticsearch 8.5.

    Catatan
    • Instans Elasticsearch versi 7.10 atau lebih baru didukung.

    • Alibaba Cloud Elasticsearch 7.16 tidak didukung.

  • Buat dua instans ECS. Untuk informasi lebih lanjut, lihat Custom launch ECS instances.

    • Instans ECS harus berada dalam virtual private cloud (VPC) yang sama dengan kluster Elasticsearch.

    • Asosiasikan elastic IP addresses (EIPs) dengan instans ECS. Untuk informasi lebih lanjut, lihat Associate or Disassociate an EIP with an ECS Instance.

      Catatan

      Instans ECS bertindak sebagai server sumber. Elastic Agent mengumpulkan log NGINX dari instans tersebut.

Buat kebijakan agent dan tambahkan integrasi

Langkah 1: Buat kebijakan agent

  1. Login ke Konsol Kibana. Untuk informasi lebih lanjut, lihat Log on to the Kibana console.

  2. Klik Management > Fleet.

  3. Pada halaman Fleet, klik tab Agent policies.

  4. Klik Create agent policy. Pada panel Create agent policy, konfigurasikan kebijakan tersebut.

    1. Pada bidang Name, masukkan nginx-log.

    2. Hapus centang pada Collect System Logs and Metrics.

    3. Klik Advanced options. Pada bagian Agent monitoring, kosongkan pilihan Collect agent logs dan Collect agent metrics.

      image.png

      Catatan

      Skenario ini hanya mengumpulkan log NGINX. Jangan kumpulkan log sistem, metrik, atau data khusus agent.

  5. Klik Create agent policy di pojok kanan bawah halaman.

Langkah 2: Tambahkan integrasi Fleet Server

  1. Pada halaman Fleet, klik tab Agent policies. Klik kebijakan baru bernama nginx-log.

  2. Pada tab Integrations, klik Add integration.

  3. Pada tab Browse integrations, cari Fleet Server lalu klik Fleet Server.

  4. Instal integrasi Fleet Server.

    1. Pada halaman Fleet Server, klik tab Settings.

    2. Klik Install Fleet Server assets. Di kotak dialog, klik Install Fleet Server.

      Catatan

      Setelah instalasi, versi integrasi akan muncul di tab Settings.

  5. Di pojok kanan atas halaman, klik Add Fleet Server.

  6. Pada halaman Add Fleet Server integration, masukkan nama untuk integrasi tersebut. Secara default, kebijakan agent nginx-log telah dipilih.

  7. Di pojok kanan bawah halaman, klik Save and continue. Di kotak dialog, klik Add Elastic Agent later.

Langkah 3: Tambahkan integrasi NGINX

  1. Pada halaman kebijakan agent nginx-log, klik tab Integrations. Klik Add integration.

  2. Pada tab Browse integrations, cari NGINX lalu klik NGINX.

  3. Instal integrasi NGINX.

    1. Pada halaman NGINX, klik tab Settings.

    2. Klik Install NGINX assets. Di kotak dialog, klik Install NGINX.

      Catatan

      Setelah instalasi, versi integrasi akan muncul di tab Settings.

  4. Di pojok kanan atas halaman, klik Add NGINX.

  5. Pada halaman Add NGINX integration, konfigurasikan integrasi tersebut.

    1. Pada bagian Configure integration, pertahankan nilai default nginx-1 pada bidang Integration name.

    2. Di samping Collect logs from NGINX instances, klik Change defaults untuk mengatur path log kustom.

    3. Pada bagian Where to add this integration, klik tab Existing hosts. Dari daftar kebijakan agent, pilih nginx-log.

  6. Di pojok kanan bawah halaman, klik Save and continue. Di kotak dialog, klik Add Elastic Agent later.

Tambahkan Agent

Langkah 1: Konfigurasikan host Fleet Server

  1. Klik Management > Fleet.

  2. Pada halaman Fleet, klik tab Settings. Konfigurasikan pengaturan Fleet.

    1. Pada bagian Fleet server hosts, klik Edit hosts.

    2. Pada panel Fleet Server hosts, masukkan titik akhir pribadi sumber Anda dalam format https://<Private IP address>:<Port>. Contohnya: https://172.16.*.***:8220.

      Catatan

      Contoh ini menggunakan Alamat IP pribadi utama dari instans ECS. Untuk informasi lebih lanjut, lihat Fleet Server hosts.

    3. Pada bagian Outputs, klik ikon image.png di kolom Actions.

    4. Pada panel Edit output, masukkan titik akhir pribadi kluster Elasticsearch Anda dalam format http://<Private endpoint>:<Port>. Contohnya: http://es-cn-uqm3auln80001****.elasticsearch.aliyuncs.com:9200.

    5. Klik Save and apply settings. Di kotak dialog, klik Save and deploy.

Langkah 2: Tambahkan Elastic Agent

  1. Pada halaman Fleet, klik tab Agent policies.

  2. Temukan kebijakan agent nginx-log, klik ikon image.png di kolom Actions, lalu pilih Add Agent.

  3. Pada bagian Select a policy for Fleet Server, pertahankan kebijakan agent default nginx-log.

  4. Pada bagian Choose a deployment mode for security, pertahankan default Quick start.

  5. Pada bagian Add your Fleet Server host, klik Add host.

  6. Pada bagian Generate a service token, klik Generate service token.

  7. Pada bagian Install Fleet Server to a centralized host, salin blok kode yang dihasilkan secara otomatis. Jalankan kode tersebut pada instans ECS pertama.

    image.png

    Jika muncul Successfully setelah menjalankan kode, Elastic Agent telah terinstal dan berjalan pada instans ECS tersebut.

  8. Ulangi langkah sebelumnya untuk menambahkan Elastic Agent ke instans ECS kedua.

Lihat data

Anda dapat melihat log NGINX dengan tiga cara.

Metode 1: Lihat data NGINX di Dashboards

  1. Klik Management > Fleet.

  2. Pada halaman Fleet, klik tab Data streams. Log NGINX muncul dalam daftar dataset.

  3. Pada kolom Actions dataset tersebut, pilih image.png > View Dashboards, lalu pilih informasi yang ingin dilihat. Misalnya, pilih [Metrics Nginx] Overview.

    image.png

Metode 2: Lihat data indeks di Discover

  1. Klik Analytics > Discover.

  2. Di pojok kanan atas halaman, pilih tampilan data. Misalnya, pilih metrics-*.

    image.png

Metode 3: Kueri data dengan Kibana

  1. Klik Management > Dev Tools.

  2. Anda dapat menjalankan perintah berikut untuk melihat data log terkait Nginx.

    GET logs-nginx.access-*/_search
    GET logs-nginx.error-*/_search