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 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 mengetahui 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, Anda meneruskan file konfigurasi ke utilitas apigee-service. Simpan file ini di direktori yang dapat diakses oleh 'apigee' pengguna, 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 perintah apigee-telegraf setup. Misalnya, atur dalam file teks bernama sa_telegraf.txt:
Properti |
Deskripsi |
---|---|
INFLUXDB_URL |
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 |
---|---|
INFLUXDB_HOST |
Tentukan alamat IP atau nama DNS node InfluxDB. Misalnya: 192.168.0.1 |
INFLUXDB_PORT |
Port InfluxDB API yang digunakan oleh sumber data Grafana. Tentukan 8086. |
GRAFANA_USERNAME |
Nama pengguna Grafana untuk login ke UI dasbor. |
GRAFANA_PASSWORD |
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 {i>node<i})
- 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 penginstalan - Konfigurasi database apigee-influxdb:
> Penyiapan /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb - 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 instal - Buat file konfigurasi untuk apigee-telegraf bernama sa_telegraf.txt.
Biasanya, Anda menyimpan file ini dalam direktori yang dapat diakses oleh 'apigee' pengguna, seperti
sebagai /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':
> {i>chown apigee:apigee<i} /opt/apigee/customer/application/sa_telegraf.txt - Mengonfigurasi 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 mulai ulang - 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 penginstalan - Buat file konfigurasi untuk apigee-grafana bernama sa_grafana.txt. Biasanya,
Anda menyimpan file ini pada direktori yang dapat diakses oleh 'apigee' pengguna, 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':
> {i>chown apigee:apigee<i} /opt/apigee/customer/application/sa_grafana.txt - Mengonfigurasi 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 mulai ulang
Untuk mengakses dasbor, buka URL berikut di browser:
http://grafana_IP_or_DNS:3000
Login 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
- Menjalankan apigee-service penyiapan apigee-telegraf, bersifat idempoten, memeriksa error, dependensi yang tidak ada dan menyelesaikannya.
- Memulai ulang apigee-telegraf lalu periksa /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log untuk setiap error
- 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 database berikut telah dibuat: sistem, aplikasi, peristiwa, _internal. - Di {i>field<i} Query, masukkan "{i>show server<i}".
Pastikan Anda melihat node apigee-influxdb sedang terdaftar.
- Di kolom Query, masukkan "show database".
- 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.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 memperbaruinya ke versi Beta untuk 4.17.05.
Untuk mengupdate dasbor pemantauan Beta:
- Perbarui Edge ke 4.17.05 seperti yang dijelaskan di Pembaruan Apigee Edge 4.17.01 hingga 4.17.05, Update Apigee Edge 4.16.09 hingga 4.17.05, dan Update Apigee Edge 4.16.01/4.16.05 hingga 4.17.05.
- Mengupdate 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 halaman Pengelolaan node server, kemudian langkah ini juga akan memperbarui apigee-grafana. Jika tidak, perbarui apigee-granfana seperti ditunjukkan dalam langkah selanjutnya. - Jika Anda tidak menginstal apigee-grafana pada
Node Server Pengelolaan, perbarui apigee-grafana di node tempat Anda
menginstalnya:
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f file konfigurasi - Mengupdate 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 mulai ulang - 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 pembaruan ke 4.17.05 Anda meng-uninstal apigee-collectd dan menginstal apigee-telegraf.
Untuk mengupdate dasbor pemantauan Beta:
- Perbarui Edge ke 4.17.05 seperti yang dijelaskan di Pembaruan Apigee Edge 4.17.01 hingga 4.17.05, Update Apigee Edge 4.16.09 hingga 4.17.05, dan Update Apigee Edge 4.16.01/4.16.05 hingga 4.17.05.
- Mengupdate 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 halaman Pengelolaan node server, kemudian langkah ini juga akan memperbarui apigee-grafana. Jika tidak, perbarui apigee-granfana seperti ditunjukkan dalam langkah selanjutnya. - Jika Anda tidak menginstal apigee-grafana pada
Node Server Pengelolaan, perbarui apigee-grafana di node tempat Anda
menginstalnya:
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f file konfigurasi - 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 instal
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf mulai ulang
> /opt/apigee/apigee-service/bin/apigee-service apigee-collectd uninstall - Ulangi langkah 4 untuk setiap node.