Edge for Private Cloud v4.18.01
Persyaratan sistem
Anda harus menginstal apigee-telegraf
pada semua node Edge untuk
mengumpulkan data
dasbor. Oleh karena itu, persyaratan sistem untuk apigee-telegraf
adalah
sama seperti untuk Edge
{i>node<i} tempat Anda
menginstalnya.
Anda dapat menginstal apigee-grafana
pada node terpisah, atau menggunakan kembali salah satu node Edge yang ada seperti Management Server atau Edge
Node UI.
Untuk apigee-influxdb
, Anda dapat
menginstalnya pada node Edge yang ada, seperti node Management Server atau node UI Edge, dengan
persyaratan sistem tidak berubah.
Jika Anda memutuskan untuk menginstal apigee-influxdb
pada nodenya sendiri untuk
alasan performa, node harus memiliki persyaratan berikut:
- CPU 2 core
- RAM 4 GB
- Kapasitas disk 250 GB (pemantauan data dihapus permanen setelah 1 bulan)
- 1.000 IOPS atau lebih
Lihat Dokumen InfluxData untuk informasi selengkapnya.
Persyaratan port untuk apigee-influxdb
Port 8086 dan 8183 harus terbuka pada node data apigee-influxdb
agar dapat diakses oleh
node yang menjalankan apigee-grafana
dan
apigee-telegraf
.
File konfigurasi untuk menginstal dasbor komponen
Untuk menginstal apigee-telegraf
dan apigee-grafana
komponen,
Anda meneruskan file konfigurasi ke utilitas apigee-service
. Simpan file ini di
direktori yang dapat diakses oleh 'apigee' seperti /opt/apigee/customer/application
,
dan membuatnya dimiliki oleh 'apigee' .
Parameter konfigurasi untuk apigee-telegraf
Tetapkan properti ini dalam file teks yang Anda teruskan ke apigee-telegraf setup
perintah. 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 apigee-grafana setup
perintah. 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
(pada setiap node)apigee-grafana
(di server pusat)
Instal apigee-influxdb pada satu node Edge atau node mandiri
Pada node mandiri, atau node Edge yang menjalankan Management Server atau UI Edge:
- Instal
apigee-influxdb
:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
- Konfigurasi 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 Anda:
- Pada node Edge pertama Anda, instal
apigee-telegraf
:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
- Buat file konfigurasi untuk
apigee-telegraf
bernamasa_telegraf.txt
. Biasanya, Anda menyimpan file ini dalam direktori yang dapat diakses oleh 'apigee' seperti/opt/apigee/customer/application
, dan membuatnya dimiliki oleh 'apigee' .Setel 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 di satu node Edge
Pada satu node penginstalan Edge Anda, 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 untuk
apigee-grafana
bernamasa_grafana.txt
. Biasanya, Anda menyimpan file ini dalam direktori yang dapat diakses oleh 'apigee' sendiri, seperti/opt/apigee/customer/application
, dan membuatnya dimiliki oleh '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
Masuk menggunakan kredensial yang Anda tentukan di file konfigurasi untuk
apigee-grafana
. Pada contoh yang ditampilkan di atas
nama pengguna/sandi adalah
admin/admin.
Memecahkan masalah penginstalan
Jika Anda tidak melihat data muncul di dasbor, gunakan prosedur berikut untuk memecahkan masalah penginstalan Anda:
- Untuk memastikan
apigee-telegraf
adalah mengumpulkan data- Jalankan
apigee-service apigee-telegraf setup
karena ini bersifat idempoten. Periksa {i>error<i}, dependensi yang hilang dan mengatasinya. - Mulai ulang
apigee-telegraf
dan periksa/opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log
untuk error
- Jalankan
- Untuk memastikan
apigee-influxdb
menerima data:- Pastikan port TCP berikut terbuka di 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 {i>database<i} berikut
dibuat:
system, application, events, _internal
. - Di {i>field<i} Query, masukkan "show server". Pastikan Anda melihat
apigee-influxdb
node dicantumkan.
- Di kolom Query, masukkan "show database". Pastikan bahwa {i>database<i} berikut
dibuat:
- Pastikan port TCP berikut terbuka di 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 ikonnya.
- Di halaman detail sumber data, pilih tombol Simpan & Menguji tombol.
- Jika sumber data dikonfigurasi dengan benar, Anda akan melihat pesan dalam formulir:
Berhasil
Sumber data berfungsi
Mengupdate dasbor pemantauan Beta
Gunakan salah satu dari dua prosedur di bawah ini berdasarkan versi Edge tempat Anda meningkatkan versi:
- 4.16.09 dan 4.17.0x 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.0x
Jika Anda menginstal Dasbor Pemantauan Apigee versi Beta di 4.16.09 atau 4.17.0x, Anda dapat memperbaruinya ke versi Beta untuk 4.18.01.
Untuk mengupdate dasbor pemantauan Beta:
- Update Edge ke versi 4.18.01 seperti yang dijelaskan di Mengupdate Apigee Edge 4.17.01/4.17.05 hingga 4.17.09, Update Apigee Edge 4.16.09 ke 4.17.09, dan Mengupdate Apigee Edge 4.16.01/4.16.05 hingga 4.17.09.
- 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 bagian Pengelolaan Node server, lalu langkah ini juga akan memperbaruiapigee-grafana
. Jika tidak, perbaruiapigee-granfana
seperti yang ditunjukkan pada langkah berikut. - Jika Anda tidak menginstal
apigee-grafana
di Node Server Pengelolaan, perbaruiapigee-grafana
di node tempat Anda menginstalnya:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- Update
apigee-telegraf
di simpul 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 pembaruan ke 4.18.01 Anda menghapus
apigee-collectd
dan menginstal apigee-telegraf
.
Untuk mengupdate dasbor pemantauan Beta:
- Perbarui Edge ke 4.18.01 seperti yang dijelaskan di Mengupdate Apigee Edge 4.16.01/4.16.05 hingga 4.17.01 dan Update Apigee Edge 4.16.09 ke 4.17.01.
- 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 bagian Pengelolaan Node server, lalu langkah ini juga akan memperbaruiapigee-grafana
. Jika tidak, perbaruiapigee-granfana
seperti yang ditunjukkan pada langkah berikut. - Jika Anda tidak menginstal
apigee-grafana
di Node Server Pengelolaan, perbaruiapigee-grafana
di node tempat Anda menginstalnya:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- 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
- Ulangi langkah 4 untuk setiap node.