Penginstalan Dasbor Pemantauan Beta

Edge for Private Cloud v. 4.17.05

Persyaratan sistem

Anda harus menginstal apigee-telegraf di semua node Edge untuk mengumpulkan data dasbor. Oleh karena itu, persyaratan sistem untuk apigee-telegraf sama dengan persyaratan untuk node Edge tempat Anda menginstalnya.

Anda dapat menginstal apigee-grafana pada node terpisah, atau menggunakan kembali salah satu node Edge yang ada seperti node Management Server atau Edge UI.

Untuk apigee-influxdb, Anda dapat menginstalnya di node Edge yang ada, seperti node Server Pengelolaan atau node UI Edge, tanpa mengubah persyaratan sistem.

Jika Anda memutuskan untuk menginstal apigee-influxdb di nodenya sendiri karena alasan performa, node tersebut harus memiliki persyaratan berikut:

• CPU 2 core
• RAM 4 GB
• Kapasitas disk 250 GB (data pemantauan dihapus setelah 1 bulan)
• IOPS 1.000 atau lebih

Lihat dokumen InfluxData untuk mengetahui informasi selengkapnya.

Persyaratan port untuk apigee-influxdb

Port 8086 dan 8183 harus terbuka di node data apigee-influxdb untuk akses oleh node yang menjalankan apigee-grafana dan apigee-telegraf.

File konfigurasi untuk menginstal komponen dasbor

Untuk menginstal komponen apigee-telegraf dan apigee-grafana, Anda meneruskan file konfigurasi ke utilitas apigee-service. Simpan file ini di direktori yang dapat diakses oleh pengguna 'apigee', seperti /opt/apigee/customer/application, dan jadikan file tersebut dimiliki oleh pengguna 'apigee'.

Parameter konfigurasi untuk apigee-telegraf

Tetapkan properti ini dalam file teks yang Anda teruskan ke perintah setup apigee-telegraf. Misalnya, tetapkan dalam file teks bernama sa_telegraf.txt:

http://192.168.0.1:8086

Parameter Konfigurasi untuk apigee-grafana

Tetapkan properti ini dalam file teks yang Anda teruskan ke perintah apigee-grafana setup. Misalnya, tetapkan dalam file teks bernama sa_grafana.txt:

192.168.0.1

Petunjuk penginstalan

Ikuti petunjuk di bawah untuk menginstal komponen dasbor dalam urutan ini:

• apigee-influxdb (di node pusat)
• apigee-telegraf (di setiap node)
• apigee-grafana (di server pusat)

Menginstal apigee-influxdb di satu node Edge atau node mandiri

Pada node mandiri, atau node Edge yang menjalankan Server Pengelolaan atau UI Edge:

1. Instal apigee-influxdb:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
2. Konfigurasi database apigee-influxdb:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
3. Mulai apigee-influxdb:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start

Menginstal apigee-telegraf di setiap node Edge

Di setiap node penginstalan Edge Anda:

1. Pada node Edge pertama Anda, instal apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
2. Buat file konfigurasi untuk apigee-telegraf bernama sa_telegraf.txt. Biasanya, Anda menyimpan file ini di direktori yang dapat diakses oleh pengguna 'apigee', seperti /opt/apigee/customer/application, dan menjadikannya milik pengguna 'apigee'.
   
   Tetapkan properti berikut dalam file untuk menentukan URL node apigee-influxdb, termasuk port 8086:
   INFLUXDB_URL=http://influx_IP:8086
3. Ubah pemilik menjadi 'apigee':
   > chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
4. Konfigurasikan apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
5. Mulai ulang apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
6. Ulangi proses ini di semua node Edge.

Menginstal apigee-grafana di satu node Edge

Pada satu node penginstalan Edge Anda, seperti node UI Edge:

1. Pada node Edge pertama Anda, instal apigee-grafana:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
2. Buat file konfigurasi untuk apigee-grafana bernama sa_grafana.txt. Biasanya, Anda menyimpan file ini di direktori yang dapat diakses oleh pengguna 'apigee', seperti /opt/apigee/customer/application, dan menjadikannya milik pengguna 'apigee'.
   
   Tetapkan properti berikut dalam file. Properti ini dijelaskan di atas:
   INFLUXDB_HOST=192.168.56.101
   INFLUXDB_PORT=8086
   GRAFANA_USERNAME=admin
   GRAFANA_PASSWORD=admin
3. Ubah pemilik menjadi 'apigee':
   > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
4. Konfigurasikan apigee-grafana menggunakan file konfigurasi:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
5. Mulai ulang apigee-grafana:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart

Untuk mengakses dasbor, buka URL berikut di browser:

http://grafana_IP_or_DNS:3000

Login menggunakan kredensial yang Anda tentukan dalam file konfigurasi untuk apigee-grafana. Pada contoh yang ditampilkan di atas, nama pengguna/sandinya adalah admin/admin.

Memecahkan masalah penginstalan

Jika Anda tidak melihat data muncul di dasbor, gunakan prosedur berikut untuk memecahkan masalah penginstalan:

1. Untuk memastikan apigee-telegraf mengumpulkan data
   1. Jalankan apigee-service apigee-telegraf setup, yang bersifat idempoten, periksa apakah ada error, dependensi yang tidak ada, dan selesaikan masalah tersebut.
   2. Mulai ulang apigee-telegraf dan periksa /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log untuk menemukan error
2. Untuk memastikan apigee-influxdb menerima data:
   1. Pastikan port TCP berikut terbuka di node data apigee-influxdb: 8086 dan 8183.
   2. Gunakan URL berikut untuk membuka UI influxdb di browser:
      http://influxdb_IP_or_DNS:8183
      1. Di kolom Query, masukkan "show databases".
         Pastikan database berikut telah dibuat: system, application, events, _internal.
      2. Di kolom Query, masukkan "show servers”.
         Pastikan Anda melihat node apigee-influxdb tercantum.
3. Periksa sumber data ke dasbor:
   1. Pilih Sumber Data di menu utama. Anda akan melihat ikon untuk tiga sumber data yang ditampilkan.
   2. Untuk setiap sumber data, pilih ikon.
   3. Di halaman detail untuk sumber data, pilih tombol Save & Test.
   4. Jika sumber data dikonfigurasi dengan benar, Anda akan melihat pesan dalam formulir:
      Berhasil
      Sumber data berfungsi

Memperbarui dasbor pemantauan Beta

Gunakan salah satu dari dua prosedur di bawah berdasarkan versi Edge yang Anda upgrade:

• 4.16.09 dan 4.17.01 menggunakan prosedur yang sama
• 4.16.05 mengharuskan Anda meng-uninstal apigee-collectd sebagai bagian dari update.

Update dari versi 4.16.09 atau 4.17.01

Jika Anda menginstal Dasbor Pemantauan Apigee versi Beta di 4.16.09 atau 4.17.01, Anda dapat mengupdatenya ke versi Beta untuk 4.17.05.

Untuk memperbarui dasbor pemantauan Beta:

1. Update Edge ke 4.17.05 seperti yang dijelaskan di Mengupdate Apigee Edge 4.17.01 ke 4.17.05, Mengupdate Apigee Edge 4.16.09 ke 4.17.05, dan Mengupdate Apigee Edge 4.16.01/4.16.05 ke 4.17.05.
2. Update apigee-influxdb di node Server Pengelolaan:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
   
   dengan configFile adalah file konfigurasi yang Anda gunakan untuk menginstal apigee-influx.
   
   Jika Anda juga menginstal apigee-grafana di node Server Pengelolaan, langkah ini juga akan mengupdate apigee-grafana. Jika tidak, update apigee-granfana seperti yang ditunjukkan pada langkah berikut.
3. Jika Anda tidak menginstal apigee-grafana di node Server Pengelolaan, update apigee-grafana di node tempat Anda menginstalnya:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
4. Perbarui apigee-telegraf di node 1:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf update
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
5. Ulangi langkah 4 untuk setiap node.

Update dari versi 4.16.05

Dasbor versi 4.16.05 menggunakan apigee-collectd, bukan apigee-telegraf. Sebagai bagian dari update ke 4.17.05, Anda meng-uninstal apigee-collectd dan menginstal apigee-telegraf.

Untuk memperbarui dasbor pemantauan Beta:

1. Update Edge ke 4.17.05 seperti yang dijelaskan di Mengupdate Apigee Edge 4.17.01 ke 4.17.05, Mengupdate Apigee Edge 4.16.09 ke 4.17.05, dan Mengupdate Apigee Edge 4.16.01/4.16.05 ke 4.17.05.
2. Update apigee-influxdb di node Server Pengelolaan:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
   
   dengan configFile adalah file konfigurasi yang Anda gunakan untuk menginstal apigee-influx.
   
   Jika Anda juga menginstal apigee-grafana di node Server Pengelolaan, langkah ini juga akan mengupdate apigee-grafana. Jika tidak, update apigee-granfana seperti yang ditunjukkan pada langkah berikut.
3. Jika Anda tidak menginstal apigee-grafana di node Server Pengelolaan, update apigee-grafana di node tempat Anda menginstalnya:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
4. Instal apigee-telegraf di node 1:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd stop
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
   > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd uninstall
5. Ulangi langkah 4 untuk setiap node.