Edge untuk Private Cloud v4.18.01
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 node Edge
tempat Anda menginstalnya.
Anda dapat menginstal apigee-grafana
di node terpisah, atau menggunakan kembali salah satu node Edge yang ada, seperti server Pengelolaan Server atau node UI
Edge.
Untuk apigee-influxdb
, Anda dapat
menginstalnya pada node Edge yang ada, seperti node Server Pengelolaan atau node UI Edge, tanpa
mengubah persyaratan sistem.
Jika Anda memutuskan untuk menginstal apigee-influxdb
pada node-nya sendiri karena alasan performa, node tersebut harus memiliki persyaratan berikut:
- CPU 2 core
- RAM 4 GB
- Kapasitas disk 250 GB (pemantauan data yang dihapus permanen setelah 1 bulan)
- 1.000 IOPS atau lebih
Lihat dokumen InfluxData untuk mengetahui informasi selengkapnya.
Persyaratan port untuk apigee-influxdb
Port 8086 dan 8183 harus terbuka pada node data apigee-influxdb
untuk diakses 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', misalnya /opt/apigee/customer/application
,
dan buat file tersebut dimiliki oleh pengguna 'apigee'.
Parameter konfigurasi untuk apigee-telegraf
Tetapkan properti ini dalam file teks yang Anda teruskan ke perintah apigee-telegraf setup
. Misalnya, tetapkan dalam file teks bernama sa_telegraf.txt
:
Properti |
Deskripsi |
---|---|
|
Tentukan URL node apigee-influxdb, termasuk port 8086. Contoh: 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
:
Properti |
Deskripsi |
---|---|
|
Tentukan alamat IP atau nama DNS node InfluxDB. Misalnya: 192.168.0.1 |
|
Port InfluxDB API yang digunakan oleh sumber data Grafana. Tentukan 8086. |
|
Nama pengguna Grafana untuk login ke UI dasbor. |
|
Sandi grafana untuk login ke UI dasbor. |
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 pada satu node Edge atau node mandiri
Pada node mandiri, atau node Edge yang menjalankan Server Pengelolaan atau UI Edge:
- Instal
apigee-influxdb
:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
- Konfigurasikan database
apigee-influxdb
:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
- Mulai
apigee-influxdb
:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start
Instal apigee-telegraf di setiap node Edge
Di setiap node penginstalan Edge:
- Pada node Edge pertama Anda, instal
apigee-telegraf
:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
- Buat file konfigurasi bernama
sa_telegraf.txt
untukapigee-telegraf
. Biasanya, Anda menyimpan file ini di direktori yang dapat diakses oleh pengguna 'apigee', seperti/opt/apigee/customer/application
, dan membuatnya dimiliki oleh pengguna 'apigee'.Tetapkan properti berikut dalam file untuk menentukan URL node apigee-influxdb, termasuk port 8086:
INFLUXDB_URL=http://influx_IP:8086
- Ubah pemilik menjadi 'apigee':
> chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
- Konfigurasi
apigee-telegraf
:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
- Mulai ulang
apigee-telegraf
:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
- Ulangi proses ini pada semua node Edge.
Menginstal apigee-grafana pada satu node Edge
Pada satu node penginstalan Edge, seperti node UI Edge:
- Pada node Edge pertama Anda, instal
apigee-grafana
:> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
- Buat file konfigurasi bernama
sa_grafana.txt
untukapigee-grafana
. Biasanya, Anda menyimpan file ini di direktori yang dapat diakses oleh pengguna 'apigee', seperti/opt/apigee/customer/application
, dan membuatnya dimiliki oleh 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
- Ubah pemilik menjadi 'apigee':
> chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
- Konfigurasi
apigee-grafana
menggunakan file konfigurasi:> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
- 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 dengan menggunakan kredensial yang Anda tentukan dalam file konfigurasi untuk
apigee-grafana
. Pada contoh yang ditampilkan di atas,
nama pengguna/sandi adalah admin/admin.
Pemecahan masalah penginstalan
Jika data tidak muncul di dasbor, gunakan prosedur berikut untuk memecahkan masalah penginstalan Anda:
- Untuk memastikan
apigee-telegraf
mengumpulkan data- Jalankan
apigee-service apigee-telegraf setup
karena bersifat idempoten, periksa error, tidak ada dependensi, dan selesaikan. - Mulai ulang
apigee-telegraf
dan periksa/opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log
untuk menemukan error
- Jalankan
- Untuk memastikan
apigee-influxdb
menerima data:- Pastikan port TCP berikut terbuka pada node data
apigee-influxdb
: 8086 dan 8183. - Gunakan URL berikut untuk membuka UI influxdb di browser:
http://influxdb_IP_or_DNS:8183
- Di kolom Query, masukkan "show database". Pastikan bahwa database berikut
telah dibuat:
system, application, events, _internal
. - Di kolom Kueri, masukkan "tampilkan server". Pastikan Anda melihat node
apigee-influxdb
tercantum.
- Di kolom Query, masukkan "show database". Pastikan bahwa database berikut
telah dibuat:
- Pastikan port TCP berikut terbuka pada node data
- Periksa sumber data ke dasbor:
- Pilih Sumber Data di menu utama. Anda akan melihat ikon untuk tiga sumber data ditampilkan.
- Untuk setiap sumber data, pilih ikon.
- Pada halaman detail sumber data, pilih tombol Save & Test.
- 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 tempat Anda melakukan upgrade:
- 4.16.09 dan 4.17.0x menggunakan prosedur yang sama
- 4.16.05 mengharuskan Anda untuk meng-uninstal
apigee-collectd
sebagai bagian dari update.
Update dari versi 4.16.09 atau 4.17.0x
Jika menginstal Dasbor Pemantauan Apigee versi Beta pada 4.16.09 atau 4.17.0x, Anda dapat mengupdatenya ke versi Beta untuk 4.18.01.
Untuk memperbarui dasbor pemantauan Beta:
- Update Edge ke 4.18.01 seperti yang dijelaskan di Update Apigee Edge 4.17.01/4.17.05 ke 4.17.09, Update Apigee Edge 4.16.09 ke 4.17.09, dan Update Apigee Edge 4.16.01/4.16.
- Update
apigee-influxdb
pada 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
pada node Server Pengelolaan, langkah ini juga akan mengupdateapigee-grafana
. Jika tidak, updateapigee-granfana
seperti yang ditunjukkan pada langkah berikut. - Jika Anda tidak menginstal
apigee-grafana
pada node Server Pengelolaan, updateapigee-grafana
pada node tempat Anda menginstalnya:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- Update
apigee-telegraf
pada 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
- Ulangi langkah 4 untuk setiap node.
Update dari versi 4.16.05
Versi dasbor 4.16.05 menggunakan apigee-collectd
, bukan
apigee-telegraf
. Sebagai bagian dari update ke 4.18.01, Anda meng-uninstal
apigee-collectd
dan menginstal apigee-telegraf
.
Untuk memperbarui dasbor pemantauan Beta:
- Update Edge ke 4.18.01 seperti yang dijelaskan di Mengupdate Apigee Edge 4.16.01/4.16.05 ke 4.17.01 dan Mengupdate Apigee Edge 4.16.09 ke 4.17.01.
- Update
apigee-influxdb
pada 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
pada node Server Pengelolaan, langkah ini juga akan mengupdateapigee-grafana
. Jika tidak, updateapigee-granfana
seperti yang ditunjukkan pada langkah berikut. - Jika Anda tidak menginstal
apigee-grafana
pada node Server Pengelolaan, updateapigee-grafana
pada node tempat Anda menginstalnya:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- Instal
apigee-telegraf
pada 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
- Ulangi langkah 4 untuk setiap node.