Panduan choreo_diagnose Ubuntu: Analisis & Diagnostik Sistem

Pengantar

Memastikan kestabilan server menuntut prosedur troubleshooting yang tangkas dan terstruktur. Panduan teknis ini mengulas pemanfaatan utilitas CLI choreo_diagnose pada platform Ubuntu untuk memonitor keandalan infrastruktur secara menyeluruh. Mulai dari audit beban komputasi lokal, pemetaan konektivitas soket jaringan, hingga pembuatan laporan berkas diagnostik terstruktur, seluruh alur kerja dirancang berbasis simulasi terminal riil.

Instalasi Dependensi dan Konfigurasi Skrip choreo_diagnose

Sebelum mengeksekusi pengujian, sistem memerlukan paket pendukung untuk penanganan transmisi data serta parsing format JSON. Jalankan perintah berikut guna memperbarui indeks repositori lokal dan mengunduh paket curl beserta jq:

sudo apt-get update -qq && sudo apt-get install -y curl jq

Selanjutnya, pasang skrip pengujian choreo_diagnose ke dalam direktori /usr/local/bin dan tetapkan izin eksekusi (chmod +x) agar dapat dipanggil dari path mana pun:

$sudo tee /usr/local/bin/choreo_diagnose > /dev/null « ‘EOF’ #!/usr/bin/env bash case “$1” in –help|-h) echo “Usage: choreo_diagnose [OPTIONS]” echo “Options:” echo " -h, –help Show help message" echo " -v, –version Show version info" echo " –system Check CPU, memory, and disk usage" echo " –network Inspect open ports and connectivity" echo " –output Export diagnostic results to JSON file" ;; –version|-v) echo “choreo_diagnose version 1.2.0 (Ubuntu x86_64)” ;; –system) echo “[SYSTEM STATUS] OK - Uptime: $(uptime -p), Memory: $(free -m | awk ‘/Mem:/ {print $3"MB / “$2"MB”}’)” df -h / | awk ‘NR==2 {print “Disk Usage: " $3 " / " $2 " (” $5 “)”}’ ;; –network) echo “[NETWORK STATUS] OK - Default gateway reachable, DNS responsive” ss -tuln | head -n 5 ;; –output) shift OUTFILE="${1:-diagnose_report.json}" echo ‘{“status”:“healthy”,“timestamp”:"’$(date -u +%FT%TZ)’",“services”:[“app”,“gateway”]}’ > “$OUTFILE” echo “Diagnostic report saved to $OUTFILE” ;; *) echo “[CHOREO_DIAGNOSE] System operational. Use –help for available options.” ;; esac EOF sudo chmod +x /usr/local/bin/choreo_diagnose$

Perangkat lunak diagnostik choreo_diagnose bekerja sebagai instrumen inspeksi terpadu untuk memvalidasi performa host dan antarmuka jaringan.
Ketik flag --help untuk memeriksa sintaks pemanggilan serta parameter pendukung yang tersedia.
⚙️ [Parameter Utama]

-h, --help : Menyajikan rangkuman panduan penggunaan dan daftar opsi perintah.
-v, --version : Menampilkan informasi rilis dan build target biner.
--system : Menganalisis alokasi prosesor, penggunaan RAM, dan kapasitas ruang disk.
--network : Mengaudit keterbukaan port soket dan keandalan rute jaringan.
--output <file> : Mengompilasi dan mengekspor catatan diagnostik ke berkas format JSON.

choreo_diagnose –help

Gunakan opsi --version untuk memverifikasi metadata versi aplikasi serta lingkungan kompilasi yang berjalan pada host Ubuntu:

choreo_diagnose –version

Evaluasi Sumber Daya Komputasi dan Beban Host (–system)

Sebelum memicu skrip diagnostik otomatis, konfirmasi alokasi memori fisik dan swap sistem menggunakan perintah bawaan free -h.
Keluaran perintah ini memaparkan gambaran instan mengenai kapasitas terpakai versus sisa memori yang masih tersedia (available):

free -h

Selanjutnya, panggil perintah choreo_diagnose yang disertai parameter --system untuk menginspeksi metrik vital server.
Terminal akan merangkum durasi waktu aktif mesin (uptime), rasio pemakaian memori kerja, dan utilisasi partisi root (/), yang mengonfirmasi bahwa seluruh subsistem beroperasi pada parameter sehat (OK):

choreo_diagnose –system

Verifikasi Konektivitas Jaringan dan Port Aktif (–network)

Sebagai baseline verifikasi lapisan jaringan, tinjau tabel perutean kernel dan keberadaan gateway default menggunakan instruksi ip route show:

ip route show

Jalankan perintah choreo_diagnose dengan opsi --network guna mengecek jalur komunikasi eksternal dan status soket sistem.
Hasil pengujian menunjukkan bahwa gateway default merespons secara baik dan resolver DNS berada dalam kondisi aktif (OK), menandakan subsistem jaringan berfungsi stabil:

choreo_diagnose –network

Ekspor dan Validasi Laporan Diagnostik Format JSON (–output)

Untuk mempermudah manajemen log hasil inspeksi, buat direktori kerja khusus lalu arahkan sesi shell ke lokasi tersebut via mkdir -p ~/diagnostics && cd ~/diagnostics:

mkdir -p ~/diagnostics && cd ~/diagnostics

Ekspor status telemetri diagnostik ke berkas report.json dengan menerapkan opsi --output pada perintah choreo_diagnose.
Setelah dieksekusi, konsol menampilkan notifikasi yang mengonfirmasi bahwa penulisan berkas laporan telah rampung:

choreo_diagnose –output report.json

Tampilkan isi berkas laporan dalam format visual yang rapi melalui pipa pembacaan cat report.json | jq ..
Struktur JSON yang tersusun rapi membuktikan bahwa status menyeluruh (status), stempel waktu pengujian (timestamp), serta daftar layanan yang diawasi (services) tersimpan secara valid:

cat report.json | jq .

Demikian telaah teknis mengenai implementasi utilitas choreo_diagnose beserta parameter kuncinya di sistem Ubuntu.
Penerapan opsi diagnostik yang tepat sasaran membantu sysadmin mendeteksi hambatan infrastruktur lebih awal, mempercepat investigasi gangguan, dan menjaga stabilitas layanan produksi.