sonar

$ sonar list
PORT   PROCESS                      CONTAINER                    IMAGE             CPORT   URL
1780   proxy (traefik:3.0)          my-app-proxy-1               traefik:3.0       80      http://localhost:1780
3000   next-server (v16.1.6)                                                               http://localhost:3000
5432   db (postgres:17)             my-app-db-1                  postgres:17       5432    http://localhost:5432
6873   frontend (frontend:latest)   my-app-frontend-1            frontend:latest   5173    http://localhost:6873
9700   backend (backend:latest)     my-app-backend-1             backend:latest    8000    http://localhost:9700

5 ports (4 docker, 1 user)

brew install raskrebs/sonar/sonar

curl -sfL https://raw.githubusercontent.com/raskrebs/sonar/main/scripts/install.sh | bash

irm https://raw.githubusercontent.com/raskrebs/sonar/main/scripts/install.ps1 | iex

curl -sfL https://raw.githubusercontent.com/raskrebs/sonar/main/scripts/install.sh | SONAR_INSTALL_DIR=/usr/local/bin bash

curl -sfL https://raw.githubusercontent.com/raskrebs/sonar/main/scripts/install.sh | SONAR_VERSION=vX.Y.Z bash

$env:SONAR_VERSION="vX.Y.Z"; irm https://raw.githubusercontent.com/raskrebs/sonar/main/scripts/install.ps1 | iex

go install github.com/raskrebs/sonar@latest

sonar completion zsh > "${fpath[1]}/_sonar"   # zsh
sonar completion bash > /etc/bash_completion.d/sonar  # bash
sonar completion fish | source                 # fish

sonar list                     # عرض جميع المنافذ
sonar list --stats             # تضمين وحدة المعالجة المركزية، الذاكرة، الحالة، وقت التشغيل
sonar list --filter docker     # منافذ Docker فقط
sonar list --sort name         # الترتيب حسب اسم العملية
sonar list --json              # إخراج JSON
sonar list -a                  # تضمين تطبيقات سطح المكتب
sonar list -c port,cpu,mem,uptime,state  # أعمدة مخصصة
sonar list --health            # تشغيل فحوصات HTTP الصحية
sonar list --host user@server  # فحص جهاز عن بعد عبر SSH

sonar info 3000

sonar kill 3000                            # SIGTERM
sonar kill 3000 -f                         # SIGKILL
sonar kill-all --filter docker             # إيقاف جميع حاويات Docker
sonar kill-all --project my-app            # إيقاف مشروع Compose
sonar kill-all --filter user -y            # تخطي التأكيد

sonar logs 3000

sonar attach 3000                          # دخول shell إلى حاوية Docker، أو اتصال TCP
sonar attach 3000 --shell bash             # shell معين

sonar watch                                # استقصاء كل ثانيتين، عرض الفروقات
sonar watch --stats                        # إحصائيات الموارد الحية (مثل docker stats)
sonar watch -i 500ms                       # استقصاء أسرع
sonar watch --notify                       # إشعارات سطح المكتب عند صعود/نزول المنافذ
sonar watch --host user@server             # مراقبة جهاز عن بعد

sonar graph                                # عرض الخدمات التي تتحدث مع بعضها
sonar graph --json                         # إخراج منظم
sonar graph --dot                          # تنسيق Graphviz DOT

sonar profile create my-app                # التقاط سريع للمنافذ الحالية
sonar profile list                         # عرض الملفات الشخصية المحفوظة
sonar profile show my-app                  # عرض تفاصيل الملف الشخصي
sonar up my-app                            # التحقق من المنافذ المتوقعة العاملة
sonar down my-app                          # إيقاف جميع المنافذ في الملف الشخصي

sonar wait 5432                        # الانتظار حتى يقبل المنفذ الاتصالات
sonar wait 5432 3000 6379              # انتظار منافذ متعددة
sonar wait 5432 --timeout 30s         # الفشل بعد 30 ثانية
sonar wait 5432 --http                # انتظار استجابة HTTP 200، وليس مجرد فتح TCP
sonar wait 5432 --http=/health        # التحقق من نقطة نهاية محددة
sonar wait 5432 -i 500ms              # فترة استقصاء مخصصة
sonar wait 5432 -q                    # بدون إخراج، فقط رمز الخروج (للسكريبتات)

docker compose up -d
sonar wait 5432 3000 --timeout 60s && npm run migrate && npm run test

sonar map 6873 3002

sonar next                                 # أول منفذ حر بعد 3000
sonar next 8000                            # أول منفذ حر بعد 8000
sonar next 3000-3100                       # أول منفذ حر في النطاق
sonar next -n 3                            # 3 منافذ حرة متتالية
sonar next --json                          # إخراج JSON

sonar open 3000                            # فتح في المتصفح
sonar tray                                 # تطبيق شريط القوائم مع إحصائيات حية (macOS)
sonar --no-color                           # تعطيل الألوان (يحترم أيضًا متغير البيئة NO_COLOR)

sonar config init       # كتابة قالب مع التعليقات
sonar config path       # طباعة موقع الملف
sonar config edit       # فتحه في $EDITOR

list:
  columns: [port, process, container, image, containerport, url]
  sort: port            # port | pid | name | type
  filter: ""            # docker | user | system | "" (all)
  all: false            # تضمين تطبيقات سطح المكتب افتراضيًا
color: true             # تعيين false لتعطيل الإخراج الملون
services:               # تسمية المنافذ المخصصة/غير المعروفة
  9000: php-fpm
  5050: my-dashboard

swiftc -O -o sonar-tray tray/SonarTray.swift -target arm64-apple-macos13

sonar tray