Elasticsearch:Gunakan APM server yang dikelola sendiri untuk mengumpulkan data ke Alibaba Cloud Elasticsearch

Prasyarat

• Anda telah membuat instans Alibaba Cloud Elasticsearch V7.10. Untuk informasi lebih lanjut, lihat Buat instans Alibaba Cloud Elasticsearch.

  Catatan

  Kami merekomendasikan mengaktifkan Indexing Service dan Openstore untuk mendukung ingest dan penyimpanan data volume tinggi yang hemat biaya untuk pemantauan kinerja aplikasi.

• Anda telah membuat instans Alibaba Cloud ECS yang menjalankan sistem operasi Linux. Untuk informasi lebih lanjut, lihat Buat instans menggunakan wizard peluncuran kustom.

• Anda telah menginstal lingkungan bahasa Go pada instans ECS.

  Catatan

  Topik ini menggunakan APM agent untuk Go, yang memerlukan lingkungan bahasa Go.

Prosedur

1. Langkah 1: Siapkan APM Server

2. Langkah 2: Konfigurasikan APM agent

3. Langkah 3: Lihat dan analisis data di Kibana

Langkah 1: Bangun APM server

1. Sambungkan ke instans ECS.

   Untuk informasi lebih lanjut, lihat Masuk ke instans Linux menggunakan Workbench.

   Catatan

   Operasi dalam topik ini dilakukan menggunakan akun pengguna biasa.

2. Instal APM Server.

   1. Unduh paket instalasi APM Server.

      wget https://artifacts.elastic.co/downloads/apm-server/apm-server-7.10.2-linux-x86_64.tar.gz

   2. Ekstrak paket instalasi.

      tar -zxf apm-server-7.10.2-linux-x86_64.tar.gz

3. Ubah konfigurasi APM Server.

   1. Masuk ke direktori tempat APM Server diinstal.

      cd apm-server-7.10.2-linux-x86_64/

   2. Ubah file konfigurasi YML.

      vim apm-server.yml

      Ubah file YML seperti pada contoh berikut.

      apm-server:
        host: "0.0.0.0:8200"
      output.elasticsearch:
        hosts: ["es-cn-*****.elasticsearch.aliyuncs.com:9200"]
        username: "elastic"
        password: "[pwd]"

      Parameter	Deskripsi
      apm-server	Titik akhir untuk APM Server. Nilai host harus diatur ke alamat IP listening:port APM Server. Pada contoh ini, diatur ke 0.0.0.0:8200.
      output.elasticsearch	Konfigurasi output Elasticsearch. hosts: Titik akhir publik atau internal instans Elasticsearch Anda. Untuk menemukan titik akhir tersebut, lihat Lihat informasi dasar instans. Penting Jika instans Elasticsearch dan instans ECS tempat APM Server diinstal berada dalam VPC yang sama, gunakan titik akhir internal. Jika tidak, Anda harus menggunakan titik akhir publik dan mengonfigurasi daftar putih alamat IP. Untuk informasi lebih lanjut, lihat Konfigurasikan daftar putih alamat IP publik atau internal untuk instans. username: Username untuk mengakses instans Elasticsearch. Nilai default-nya adalah elastic. Jika Anda menggunakan pengguna kustom, Anda harus menetapkan peran dan izin yang diperlukan. Untuk informasi lebih lanjut, lihat Gunakan peran X-Pack Elasticsearch untuk mengelola izin pengguna. password: Kata sandi untuk pengguna yang ditentukan. Kata sandi untuk pengguna elastic ditetapkan saat Anda membuat instans. Jika lupa, Anda dapat mengatur ulang. Untuk informasi lebih lanjut, lihat Atur ulang kata sandi akses instans.

4. Jalankan APM Server.

   sudo nohup ./apm-server -e > apmserver.log 2>&1 &

Langkah 2: Konfigurasikan APM agent

Topik ini menggunakan Go sebagai contoh.

1. Instal APM agent.

   1. Inisialisasi file go.mod.

      sudo go mod init demo

   2. Instal paket APM Go agent.

      sudo go get go.elastic.co/apm
      sudo go get go.elastic.co/apm/module/apmhttp

      Catatan

      Error golang.org xxxx: i/o timeout menunjukkan bahwa golang.org tidak dapat diakses. Untuk mengatasinya, ubah sumber unduhan.

2. Konfigurasikan APM agent.

   1. Buka file konfigurasi variabel lingkungan.

      vim ~/.bash_profile

   2. Pada file konfigurasi, tambahkan pengaturan berikut untuk menginisialisasi APM agent. Kemudian, simpan perubahan tersebut.

      # Tetapkan nama layanan. Karakter yang diizinkan: a-z, A-Z, 0-9, -, _, dan spasi.
      # Jika ELASTIC_APM_SERVICE_NAME tidak diatur, nama file executable akan digunakan.
      export ELASTIC_APM_SERVICE_NAME=zijian
      
      # Tetapkan URL kustom APM Server (default: http://localhost:8200).
      export ELASTIC_APM_SERVER_URL=
      
      # Gunakan token rahasia jika diperlukan oleh APM Server.
      export ELASTIC_APM_SECRET_TOKEN=

   3. Jalankan perintah berikut agar file konfigurasi berlaku:

      source ~/.bash_profile

3. Gunakan APM agent untuk mendeteksi aplikasi.

   1. Buat file aplikasi contoh bernama apm.go.

      vim apm.go

   2. Tambahkan informasi berikut ke file apm.go dan simpan file tersebut.

      Untuk menginstrumentasi aplikasi Go Anda, gunakan salah satu modul instrumentasi yang tersedia atau tracer API.

      package main
      
        import (
          "net/http"
      
          "go.elastic.co/apm/module/apmhttp"
        )
      
        func main() {
          mux := http.NewServeMux()
          http.ListenAndServe(":8080", apmhttp.Wrap(mux))
        }

   3. Jalankan file apm.go.

      sudo go run apm.go

Langkah 3: Lihat dan analisis data yang dikumpulkan oleh APM server di Konsol Kibana

1. Masuk ke Konsol Kibana kluster Elasticsearch.

   Untuk informasi lebih lanjut, lihat Masuk ke Konsol Kibana.

   Catatan

   Topik ini menggunakan contoh instans Alibaba Cloud Elasticsearch V7.10. UI dan operasi mungkin berbeda untuk versi lain.

2. Di halaman utama Kibana, klik Dev tools di pojok kanan atas.

3. Pada tab Console, jalankan skrip berikut untuk mengaktifkan pembuatan otomatis indeks onboarding APM.

   Catatan

   • Alibaba Cloud Elasticsearch menerapkan konvensi penamaan tertentu untuk indeks yang dibuat secara otomatis. Karena nama default indeks onboarding APM tidak sesuai, Anda harus menjalankan perintah ini untuk mengizinkan pembuatannya.

   • Pada skrip berikut, 7.10.2 adalah versi APM Server yang Anda instal.

   PUT _cluster/settings
   {
     "persistent": {
       "action.auto_create_index":"+.*,+apm-7.10.2-onboarding-*,-*"
     }
   }

4. Lihat layanan yang dipantau oleh APM.

   Halaman Services APM menampilkan semua layanan yang telah onboard dalam bentuk tabel. Tabel tersebut berisi kolom Name, Environment, Avg. response time, Trans. per minute, dan Error rate %, yang menunjukkan setiap layanan yang telah onboard beserta metrik kinerjanya.

   1. Di pojok kiri atas, klik ikon untuk memperluas panel navigasi sebelah kiri.

   2. Di panel navigasi, di bawah Observability, klik APM.

   3. Tab Services menampilkan semua layanan APM.

   4. Klik nama layanan dan lihat serta analisis data terkait layanan tersebut.