hmci

IBM Power HMC Kinerja Data Exportir

HMCI adalah utilitas yang mengumpulkan metrik dari satu atau lebih IBM Power Hardware Management Consoles (HMC) , tanpa perlu menginstal agen pada partisi logis / mesin virtual yang berjalan pada sistem daya IBM. Data metrik diproses dan disimpan ke dalam database seri-time-seri, dan/atau tersedia untuk prometheus untuk mengikis. Grafana digunakan untuk memvisualisasikan data metrik melalui dasbor yang disediakan, atau dasbor Anda yang disesuaikan dan ditingkatkan.

Perangkat lunak ini bebas digunakan dan dilisensikan di bawah lisensi Apache 2.0, tetapi tidak didukung atau didukung oleh International Business Machines (IBM).

Metrik meliputi:

• Sistem terkelola - Server Daya Fisik
• Partisi logis - server tervirtualisasi yang menjalankan AIX, Linux atau IBM -I (AS/400)
• Server I/O Virtual - Partisi I/O Virtualisasi Jaringan dan Penyimpanan
• Energi - watt dan suhu (harus diaktifkan dan tidak tersedia di semua sistem)

Beberapa proyek terkait saya yang lain adalah:

• SVCI untuk memantau IBM Spectrum Virtualize (FlashSystems / Storwize / SVC)
• Sysmon untuk memantau semua jenis server dengan agen java kecil
• Syslogd untuk mengarahkan Syslog dan Gelf ke Destinasi Penebangan Jarak Jauh

Tangkapan layar

Tangkapan layar dasbor lain tersedia di folder tangkapan layar.

Instalasi dan Pengaturan

Ada beberapa langkah dalam instalasi.

1. Persiapan Konsol Manajemen Perangkat Keras (HMC)
2. Instalasi InfluxDB atau Prometheus, Grafana dan perangkat lunak HMCI (ini)
3. Konfigurasikan grafana dan impor contoh dasbor

1 - Persiapan Konsol Manajemen Perangkat Keras (HMC)

Pada HMC kami membuat pengguna penampil yang digunakan untuk mengambil data melalui REST API dan mengaktifkan kumpulan metrik kinerja.

Baca file readme-hmc.md untuk instruksi dan bantuan.

2 - Pemasangan InfluxDB atau Prometheus, Grafana dan Perangkat Lunak HMCI

Perangkat lunak yang diperlukan dapat diinstal bersama pada LPAR / VM yang sama atau secara terpisah, selama mungkin untuk memastikan konektivitas jaringan.

Bergantung pada sistem operasi Anda, buka salah satu dokumen:

• README-AIX.MD untuk AIX.
• ReadMe-SUSE.MD untuk SUSE Enterprise Linux dan OpenSUSE Linux.
• README-REDHAT.MD untuk Redhat Enterprise Linux, Almalinux dan Rockylinux.
• readme-debian.md untuk debian gnu/linux dan turunan seperti ubuntu.

Paket HMCI untuk Debian/Ubuntu & Redhat/SUSE tersedia dari halaman rilis.

3. Konfigurasikan Grafana dan Impor contoh dasbor

Baca file readme-grafana.md untuk instruksi dan bantuan.

---

Catatan & Pemecahan Masalah

Catatan

Tidak ada data (atau data masa lalu/masa depan) yang ditampilkan di Grafana

Ini kemungkinan besar karena zona waktu, tanggal dan/atau NTP tidak dikonfigurasi dengan benar pada HMC dan/atau host yang menjalankan HMCI.

Anda dapat memeriksa cap waktu dari data terbaru dengan menanyakan influxdb dengan klien CLI influx , dan mencatat zona waktu saat membandingkan:

use hmci;
precision rfc3339;
SELECT * FROM server_details GROUP BY * ORDER BY DESC LIMIT 1 ;

Pengaturan memori JVM

Edit /opt/hmci/bin/hmci jika Anda perlu memodifikasi pengaturan memori heap JVM default.

Contoh - Persentase memori availabe

 -XX:InitialRAMPercentage=25.0 -XX:MaxRAMPercentage=50.0

Contoh - batas Min / Max

 -Xms64m -Xmx128m

Kebijakan Retensi InfluxDB

Contoh untuk mengubah kebijakan retensi influxdb default untuk database HMCI:

 ALTER RETENTION POLICY "autogen" ON "hmci" DURATION 156w
ALTER RETENTION POLICY "autogen" ON "hmci" DURATION 90d

Meningkatkan HMCI

Pada sistem berbasis RPM (redhat, suse, centos), unduh file dan peningkatan hmci-xyz-n.noarch.rpm terbaru:

rpm -Uvh hmci-x.y.z-n.noarch.rpm

Di Sistem Berbasis Deb (Debian, Ubuntu dan Derivatif), unduh file dan peningkatan hmci_x.yz-n_all.deb terbaru:

dpkg -i hmci_x.y.z-n_all.deb

Mulai ulang layanan HMCI pada sistem Linux berbasis SystemD :

systemctl restart hmci
journalctl -f -u hmci  # to check log output

Di AIX Anda harus meneruskan bendera --ignoreos ke perintah rpm :

rpm -Uvh --ignoreos hmci-x.y.z-n.noarch.rpm

Kemungkinan masalah

Set metrik yang tidak lengkap

Saya belum dapat menguji dan memverifikasi semua jenis data metrik. Jika Anda menemukan data yang hilang atau salah, silakan hubungi saya dan saya akan mencoba memperbaikinya.

Penamaan tabrakan

Anda tidak dapat memiliki partisi (atau server I/O virtual) pada sistem yang berbeda dengan nama yang sama, karena ini tidak dapat dibedakan ketika metrik ditulis untuk influxdb (yang menggunakan nama sebagai kunci).

Mengganti nama partisi

Jika Anda mengganti nama partisi, metrik dalam influxdb masih akan tersedia dengan nama lama, dan metrik baru akan tersedia dengan nama baru partisi. Tidak ada cara mudah untuk memigrasi data lama, tetapi Anda dapat menghapusnya dengan mudah:

 DELETE WHERE lparname = 'name';

---

Pengembangan dan pengujian lokal

Informasi pengembangan

Anda membutuhkan Java (JDK) versi 8 atau lebih baru untuk membangun HMCI.

Bangun & Tes

Gunakan alat Build Gradle, yang akan mengunduh semua dependensi yang diperlukan:

./gradlew clean build

Pengujian lokal

Influxdb v1.x

Mulai wadah influxdb:

docker run --name=influxdb --rm -d -p 8086:8086 influxdb:1.8

Buat database HMCI :

docker exec -i influxdb influx -execute " CREATE DATABASE hmci " 

Influxdb v2.x

Mulai wadah influxdb:

docker pull docker.io/influxdb:latest
docker run --name=influxdb --rm -d -p 8086:8086 docker.io/influxdb:latest

• Kemudian gunakan Web UI untuk membuat pengguna awal (untuk Web UI), organisasi dan ember: http: // localhost: 8086/
• Kemudian buat token API dengan akses RW ke ember Anda.

Grafana

Mulai wadah grafana, menghubungkannya ke wadah influxdb:

docker run --name grafana --link influxdb:influxdb --rm -d -p 3000:3000 grafana/grafana

Pengaturan Grafana untuk terhubung ke wadah influxdb dengan mendefinisikan sumber data baru di url http: // influxdb: 8086 bernama hmci .

Jika Anda menghubungkan ke InfluxDB v2.x, maka tambahkan header HTTP khusus, masukkan bucket sebagai database dan nonaktifkan otorisasi.

• Otorisasi = token abcdef_random_token_from_nfluxdb ==

Impor dasbor dari DOC/ Dashboard/ Folder.