<div align="center">
```
██████ ███ ██████ ██ ██████
██ ██ ██ ██ ██ ██
██ ██ ██ ██ ██ ██ ██ ██
██ ██ ██ ██ ██ ██ ██ ████
██ ██ ██ ██ ██ ██ ██ ██
██████ ███ ██ ██ ██ ██ ██ ██
```
マシン上で何が動いているかを把握できます。
</div>
Sonar は localhost でリッスンしているすべてを表示し、整理します。すべてのポートは **group** に属し — 通常はそれが起動されたリポジトリです — そしてそのグループ内では名前付きの **service** に属します。`sonar start` で開発サーバーを起動すれば、プロジェクト全体が 1 つのものとなり、ツリーとして一覧表示し、待機し、tail し、単一のコマンドで停止できます。Docker コンテナ、Compose プロジェクト、手動で起動したプロセスも、設定なしで検出されます。
```
$ sonar list --tree
my-app (3 ports, running) ~/code/my-app
├─ 5432 db postgres:17 http://localhost:5432
├─ 5173 frontend vite (v5.4) http://localhost:5173
└─ 8000 api uvicorn app:app http://localhost:8000
ungrouped (1 port)
└─ 3000 next-server (v16.1.6) http://localhost:3000
```
## インストール
### Homebrew (macOS / Linux)
```sh
brew install raskrebs/sonar/sonar
```
Homebrew 6 は、一度タップを信頼するまでサードパーティのタップからの formulae を拒否します
(`Error: Refusing to load formula raskrebs/sonar/sonar from untrusted tap`):
```sh
brew trust raskrebs/sonar
```
### インストールスクリプト
```sh
curl -sfL https://raw.githubusercontent.com/raskrebs/sonar/main/scripts/install.sh | bash
```
最新のバイナリを `~/.local/bin` にダウンロードし、必要に応じて PATH に追加します。ターミナルを再起動するか、`source ~/.zshrc` を実行してください。
Windows の場合 (PowerShell):
```powershell
irm https://raw.githubusercontent.com/raskrebs/sonar/main/scripts/install.ps1 | iex
```
カスタムインストール場所:
```sh
curl -sfL https://raw.githubusercontent.com/raskrebs/sonar/main/scripts/install.sh | SONAR_INSTALL_DIR=/usr/local/bin bash
```
特定のバージョンをインストールする:
```sh
curl -sfL https://raw.githubusercontent.com/raskrebs/sonar/main/scripts/install.sh | SONAR_VERSION=vX.Y.Z bash
```
```powershell
$env:SONAR_VERSION="vX.Y.Z"; irm https://raw.githubusercontent.com/raskrebs/sonar/main/scripts/install.ps1 | iex
```
### Go の使用
```sh
go install github.com/raskrebs/sonar@latest
```
シェル補完(ポート番号のタブ補完):
```sh
sonar completion zsh > "${fpath[1]}/_sonar" # zsh
sonar completion bash > /etc/bash_completion.d/sonar # bash
sonar completion fish | source # fish
```
## 60秒
リポジトリのルートに `sonar.yaml` を置いて、`dev.sh` の代わりにプロジェクトの実行方法を記述します:
```yaml
name: my-app
services:
- name: db
cmd: docker compose up db
port: 5432
- name: api
cmd: uv run uvicorn app:app --port ${port}
port: auto
depends_on: [db]
- name: frontend
cmd: npm run dev -- --port ${port} --strictPort
port: auto
depends_on: [api]
env:
VITE_API_URL: ${api.url}
```
Then start it:
```sh
sonar start
```
```
✓ db http://localhost:5432 pid 41022 ~/.config/sonar/logs/my-app/db.log
✓ api http://localhost:21408 pid 41040 ~/.config/sonar/logs/my-app/api.log
✓ frontend http://localhost:21409 pid 41077 ~/.config/sonar/logs/my-app/frontend.log
3 started
following the logs; Ctrl+C stops the 3 services started here
api | INFO: Uvicorn running on http://127.0.0.1:21408
frontend | VITE v5.4 ready in 312 ms
```
Sonar は `port: auto` の各サービスに空きポートを割り当て、各サービスに他のサービスの場所を伝えるため、2 つ目の worktree が最初のものと並行して動作し、ポートが衝突することはありません。`sonar start -d` は同じことをバックグラウンドで実行し、`sonar down` はそれを停止してポートを解放します。別のターミナルで:
```sh
sonar list --tree
```
```
my-app (3 ports, running) ~/code/my-app
├─ 5432 db postgres:17 http://localhost:5432
├─ 21408 api uvicorn app:app http://localhost:21408
└─ 21409 frontend vite (v5.4) http://localhost:21409
```
`sonar.yaml` がない場合、`sonar start -- npm run dev` は1つのコマンドを名前付きサービスとして実行し、`sonar list` と `sonar kill` はリッスンしているものすべてに対して機能します。
以下で `# check` と記された例は、CI 実行のたびに `scripts/readme-check.sh` によって新規ビルドに対して実行されます。
## コマンド
### `sonar list`
```sh
sonar list
sonar list --tree
sonar list --group my-app
sonar list --json
# check
```
```sh
sonar list --stats # CPU, memory, threads, uptime, state
sonar list --health # HTTP health checks
sonar list --filter docker # only Docker ports
sonar list --sort name # port | pid | name | type
sonar list -a # include desktop apps
sonar list -c port,process,group,cpu,mem
sonar list --host user@server # scan a remote machine over SSH
```
デフォルトのカラムは `port`、`process`、`group`、`container`、`image`、
`containerport`、`url` です。ここで `process` はあなたがポートに付けた名前
(`sonar rename`) を表示し、次にサービス名、そして検出された内容を表示します。
利用可能なカラム: `port`、`process`、`pid`、`type`、`url`、`group`、`cpu`、
`mem`、`threads`、`uptime`、`state`、`connections`、`health`、`latency`、
`container`、`image`、`containerport`、`compose`、`project`、`user`、`bind`、
`ip`。
たまたまリッスンしているデスクトップアプリやシステムサービス — Figma、Discord、
Spotify、ControlCenter、macOS の `.app` バンドル、`/System/Library/` のデーモン — は
`-a` を渡さない限り非表示になります。
### `sonar start`
`sonar.yaml` からプロジェクトを開始します:
```sh
sonar start # every service in the nearest sonar.yaml
sonar start api frontend # only these (they still wait for their dependencies)
sonar start ../other-project # the sonar.yaml in or above another directory
sonar start -d # in the background, like `sonar up`
```
フォアグラウンドでは、sonar はデーモンを介してサービスを起動し、各行の先頭にサービス名を付けてログを追跡し、Ctrl+C を押すと起動したサービスを停止します。すでに実行中のサービスはそのままにされ、sonar が起動したすべてのサービスが終了すると、sonar は自動的に終了します。
`--` より前の引数はディレクトリまたはサービスを指定し、`--` より後のすべてはコマンドです。または、グループ内の名前付きサービスとして 1 つのコマンドを実行します:
```sh
sonar start -- npm run dev
sonar start --group my-app --name frontend -- npm run dev
sonar start --port 5173 -- npm run dev # expected port, before it binds
sonar start --detach --name api -- uv run uvicorn app:app
sonar start --list
```
何も渡す必要はない:
- **Group** — `--group`、なければ最も近い `sonar.yaml` の `name`、なければ
git ルートのディレクトリ名(worktree の場合は `repo@worktree` になる)、なければ
カレントディレクトリの名前。
- **Name** — `--name`、なければ `cmd` が一致する `sonar.yaml` のサービス、なければ
コマンドから推測される(`npm run dev` → `dev`、`uv run api` → `api`、
`python -m uvicorn` → `uvicorn`、`./dev.sh` → `dev.sh`)。
- **Port** — `--port` はヒントであり、バインディングではない:ポートが実際に
リッスンするまで実行は `starting` として表示され、デーモンはそれを使って
プロセスをポートに照合する。
子プロセスは stdin、stdout、stderr、cwd、環境を継承し、さらに
`SONAR_GROUP`、`SONAR_NAME`、`SONAR_RUN_ID` も継承する。子プロセスは独自の
プロセスグループを取得するため、`sonar kill` はツリー全体 — ウォッチャーや
ワーカーを伴う開発サーバー — を停止する。Ctrl+C は転送され、sonar は子プロセスの
終了コードで終了する。
`--detach` は即座に戻り、出力を
`~/.config/sonar/logs/<group>/<name>.log` に書き込む。`--list` は sonar が起動した
ものと、その下にその後終了したもの — 終了コード、およびクラッシュしたのか
停止されたのか — を表示する(機械可読形式には `--json`):
```sh
sonar start --list
sonar start --detach --name demo --port 8123 -- sleep 5
sonar start --list --json
# check
```
### `sonar.yaml`
プロジェクトはリポジトリのルートにある `sonar.yaml` で自身とそのサービスに名前を付けます。これは任意です — これがなくても sonar は git ルートでグループ化します — そしてコミットされることを意図しています:
```yaml
name: my-app
services:
- name: db
cmd: docker compose up db
port: 5432
health: /
description: Postgres 17
icon: database
color: "#4f8cc9"
- name: api
cmd: uv run uvicorn app:app --port 8000
cwd: backend
port: 8000
health: /healthz
depends_on: [db]
- name: frontend
cmd: npm run dev
port: 5173
depends_on: [api]
ports: [9229] # ports that belong to this project without a service
```
- `name` — グループ名。スラッシュや空白は使用できません。
- `cmd`、`cwd`、`port` — `sonar start` がサービスを起動する方法。`cwd` は
ファイルからの相対パスで、そのディレクトリの外に出ることはできません。
- `health` — サービスが起動している間、デーモンがポーリングする HTTP パス。
これにより、サービスが*実行中*でもまだ*正常*でない場合があります。`ok`、`fail`、
`unknown` を報告し、失敗の理由も示します。
- `description`、`icon`、`color` — デスクトップアプリ用の自由形式のメタデータ。sonar
がこれらを推測することはありません。
- `depends_on` — 起動順序。ファイルに存在しないサービスを指定したり、
循環を指定するとエラーになります。無効なファイルは一度報告され、スキャンを停止させることはありません。
- `env` — sonar がサービスを起動するときに設定される変数。
#### `port: auto` と参照
サービスはポートを sonar に任せることができ、ハードコードされた `localhost:8080` の代わりに
環境変数を通じて他のサービスを見つけることができます:
```yaml
services:
- name: api
cmd: uv run uvicorn app:app --port ${port}
port: auto
- name: frontend
cmd: npm run dev -- --port ${port} --strictPort
port: auto
depends_on: [api]
env:
VITE_API_URL: ${api.url}
```
`sonar start` は起動するすべての `port: auto` サービスに対して空きポートを確保する。同じチェックアウト内では毎回同じポート、他のチェックアウトではそれぞれ異なるポートになるため、worktree がメインのものと衝突することはない。サービスはそれを `PORT`、`SONAR_PORT`、`${port}` として受け取り、それを使わなければならない — `PORT` を読むか、コマンドラインで `${port}` を渡す。すでに実行中のサービスはそのポートを保持するため、後から起動したサービスでもそれを見つけられる。割り当てられたポートの背後にあるクレームは最後の起動から 1 日間有効で、`claims.ttl` でそれを変更できる(デーモンの項を参照)。
`${port}` と `${url}`(`http://localhost:<port>`)はそのサービス自身のもので、`${<service>.port}` と `${<service>.url}` は別のサービスのものである。これらは `cmd` と `env` で機能する。ファイルに存在しないサービス、またはポートを持たないサービスへの参照は、ファイルの読み込み時にエラーとなる。`${HOME}` のような `${` と `}` の間にあるその他のものは、書かれたとおりにそのまま残される。
`sonar.yml` と綴っていればそれが読み込まれる。`sonar init` は常に `sonar.yaml` を書き出す。ファイルは以前はドットファイル `.sonar.yaml` であり、その名前もまだ機能する。sonar は `sonar.yaml`、`sonar.yml`、`.sonar.yaml`、`.sonar.yml` の順に探し、最初に見つけたものを読み込む。編集は sonar が読み込んだファイルに書き戻されるため、知らないうちに名前が変更されることはない。`sonar doctor` は古い名前のファイルを指摘し、`sonar doctor --fix` はそれをリネームする(ファイルが追跡されている場合は `git mv` を使用)。デーモンは把握しているプロジェクトを監視し、再起動なしでファイルへの編集を拾い上げる。sonar が行うすべての編集 — デスクトップアプリから、`sonar groups add`、`rename`、`remove` から、エージェントから — はデーモンを経由し、デーモンは自身の構文木からファイルを再レンダリングするため、コメント、キーの順序、レイアウトは、メタデータの変更がそうであるように、サービスの追加、リネーム、削除を行う編集でも維持される。唯一の例外は、末尾コメントを揃えるための余分なスペース(`cmd: x # note`)が 1 つに縮まることである。これは YAML ライブラリがコメントを保持してもその列位置は保持しないためである。
#### `sonar env`
ファイルが解決する内容は、何も起動せずに読み取ることができる:
```sh
sonar env # every service: port, url and its expanded env
sonar env frontend # one service, as export lines
sonar env --json # for tools
```
```
SERVICE PORT URL ENV
db 5432 http://localhost:5432
api 21408 http://localhost:21408 DB_URL=postgres://localhost:5432/app
frontend 21409 http://localhost:21409 VITE_API_URL=http://localhost:21408
```
`port: auto` のサービスが起動していない場合、ここで `sonar start` が行うのと同じ要求が与えられるため、`sonar env` が出力する内容が後で start がバインドする内容になります。すでに起動しているサービスは、現在使用しているポートを維持します。名前を指定すると、サービスは `export` 行として出力されるため、シェルはサービスが何を認識するかを確認できます:
```sh
eval "$(sonar env frontend)" && npm test
```
その背後にはデーモン上の `groups.env` があり、サービスが存在する前にワークツリーをセットアップするエディタやエージェントのためにあります。
### `sonar up`
```sh
sonar up # the sonar.yaml at or above this directory
sonar up my-app # a group by name
sonar up --only api,frontend
sonar up --json
```
`sonar up` は `sonar start -d` であり、どこからでもグループに名前を付けて別のホストで起動することもできます。グループの `sonar.yaml` が宣言するすべてのサービスを `depends_on` の順序で起動します。サービスは依存関係が宣言するポートを待ってから起動され、すでにリッスンしているものはスキップされます。各サービスは独自のプロセスグループでデタッチされて実行され、その出力は `~/.config/sonar/logs/<group>/<service>.log` に保存され、`sonar up` を実行したシェルの環境に加えて、ポートを持つサービスには `PORT` が設定されます。
```
✓ db http://localhost:5432 pid 41022 ~/.config/sonar/logs/my-app/db.log
- api already running
✓ frontend http://localhost:5173 pid 41108 ~/.config/sonar/logs/my-app/frontend.log
2 started, 1 already running
```
起動に失敗したサービスはそれ自体の行に報告され、他に何が起きたとしてもコマンドは非ゼロで終了します。`sonar down` でそれらをすべて再度停止します。
`sonar up` はデーモンを必要とし、まだ実行されていない場合は起動します。
### `sonar down`
```sh
sonar down # the project in the nearest sonar.yaml
sonar down my-app # a group by name
sonar down --only api,worker # only these services
```
プロジェクトのすべてのサービスを停止する — それがリッスンしているすべてのポート、および worker のようにポートを保持しない sonar が起動したすべてのサービスを停止し、sonar が `port: auto` サービス用に確保したポートを解放する。`--only` は、`sonar up --only` が一部のみを起動するのと同様に、そのすべてを指定されたサービスに絞り込む。ファイルが宣言していない名前はエラーとなる。`sonar kill -g my-app` はポートを停止し、何も解放しない。
### `sonar groups` と `sonar init`
```sh
sonar init --dry-run
sonar init --service api:8000:/healthz --service web:5173
sonar groups
sonar groups --json
group=$(basename "$PWD") # sonar init names the group after the directory
sonar groups add "$group" worker --port 9000 --cmd 'uv run worker' --depends-on api
sonar groups rename "$group" worker jobs
sonar groups remove "$group" jobs
# check
```
`sonar groups` は sonar が見つけられるすべてのグループと、それぞれの名前の由来を一覧表示します:
`manual`(`sonar assign` で固定したもの)、`start`(`sonar start` の実行)、
`file`(`sonar.yaml`)、または `auto`(git ルートまたは Compose プロジェクト)。
`sonar groups <name>` は 1 つのグループのポートとサービス、および宣言されているが
実行されていないサービスを表示します。
`sonar init` は、把握できる内容から git ルートに `sonar.yaml` を書き出します:
現在プロジェクト内でリッスンしているポート(デスクトップアプリと 1024 未満のポートは除外)、
および compose ファイルや `package.json` が明示的に宣言しているもの — compose サービスごとに
1 サービス、その公開ポートと `depends_on`、そしてロックファイルが指定するパッケージマネージャーに
よって実行される `dev` スクリプトです。
両者が食い違う場合、リッスンしているポートが優先されます:それは証拠であり、宣言ではないからです。
書き出されるファイルには、判別できなかったことが記されます。
それ以外は何も検出されません。Makefile のターゲット、Procfile の行、フレームワークに
埋もれたエントリポイント — それらはあなたのリポジトリに関する推測であり、その一覧が
完成することは決してありません。その部分はエージェントに任せます:
```sh
sonar init --agent # whichever agent is installed
sonar init --agent codex # name one
sonar init --agent claude -- --allow-dangerously-skip-permissions
```
`--agent` は、このターミナルで、すでに持っているコーディングエージェントを開き、プロンプトをすでに送信した状態にします。sonar が知っていること、書き込むはずだったドラフト、フォーマット、そしてファイルを書き込み何も開始しないというルールを含みます。あなたはいつもどおりに、それがリポジトリを読むのを見守り、その編集を承認します — それはあなたのエージェントであり、あなたの権限の下にあります — そして `--` の後に続くものはすべてそれに渡されます。sonar は `claude`、`codex`、`cursor-agent`、`opencode` を認識します。複数インストールされている場合は、1つを指定してください。エージェントが終了すると、sonar はファイルを読み込み、それが宣言するサービス、または読み込まれない理由を出力します。ターミナルがない場合 — パイプや CI — `--agent` は何も起動せずにプロンプトを出力します。
`--force` なしでの上書きを拒否し、`--dry-run` は書き込む代わりにファイルを出力します。`--merge` は、すでに存在するファイルに追記します(拒否する代わりに)。また `--service name:port[:health]` — 繰り返し可能 — は、見つけたサービスではなく、指定したサービスを書き込み、保持したポートに対して推測したコマンドを維持します。`--force` と `--merge` は相互に排他的です。
`sonar groups add <group> <name> --port N` は、そのグループの `sonar.yaml` にサービスを追加します。残りの部分には `--cmd`、`--cwd`、`--health`、`--description`、`--icon`、`--color`、および繰り返し可能な `--depends-on` を使用します。`sonar groups rename <group> <old> <new>` は、ファイル内のすべての箇所で名前を変更し、`depends_on` の参照も含みます。また `sonar groups remove <group> <name>` は、1つを削除し、それを名指ししていたすべての `depends_on` から取り除きます。これら3つはすべて、ファイルを無効にするような編集 — 重複した名前、別のサービスがすでに要求しているポート、存在しないサービス — を拒否し、編集全体が問題ないと確認されるまで1バイトも書き込みません。
書き込みを行うのはデーモンであり、そのため編集が CLI、デスクトップアプリ、エージェントのいずれから来たものでも、ファイルはコメントとキーの順序を保ったまま返ってきます。`sonar groups add`、`rename`、`remove` はデーモンを必要とし、まだ実行されていなければ起動します。これら3つの名前はサブコマンドであるため、実際に `add` という名前のグループは `sonar groups --json` で読み取ります。
### `sonar kill`
```sh
sonar kill 3000 # SIGTERM, then SIGKILL after 5s
sonar kill 3000 5432 -f # SIGKILL both straight away
sonar kill 3000 --tree # the listener and everything below it
sonar kill --pid 12345 --tree # by process id
sonar kill -g my-app # a whole group, confirms unless -y
sonar kill --all --filter docker -y # every container publishing a port
sonar kill --all --project my-app # one Compose project
sonar kill 3000 --ip 127.0.0.1 # one bind address of several
sonar kill --all --dry-run --json # the plan for the whole machine
```
`--dry-run` は任意のセレクタを受け取り、何も変更しません。kill が実行するアクションを子プロセスから順に出力し、すべてを実行中のままにします。自分自身のリスナーに対してエンドツーエンドで:
```sh
sonar start --detach --name plan --port 8231 -- sonar map 3000 8231
sonar wait 8231
sonar kill 8231 --dry-run --json # the plan; the mapping keeps running
sonar kill 8231 -y # and now for real
# check
```
位置引数はポートとして読み取られ、その番号で何もリッスンしていない場合にのみ pid として読み取られます。`-g` は解決されたグループ、レガシーな実行タグまたは id、および Compose プロジェクトに大文字小文字を区別せずにマッチします。
SIGTERM を無視するプロセスは、`--grace` (5s) 経過後もポートがまだリッスンしている場合に SIGKILL が送信されます。`--no-escalate` はそれを無効にします。子は親より先にシグナルを受信するため、ツリーは順番に停止します。Docker コンテナは `docker stop` で停止され、シグナルは送信されません。`sonar start` によって起動されたリスナーは、常にそのプロセスグループとともに停止されます。
`--json` はプロセスごとに 1 行を出力します:
`{port, bind_address, pid, name, method, ok, error}`。ここで `method` は `sigterm`、`sigkill`、`docker_stop`、`map_stop` または `none` です。空のスイープは 0 で終了し、不明なグループは 1 で終了します。
### `sonar map`
```sh
sonar map 6873 3002 # also serve the service on 6873 from port 3002
```
TCP プロキシを停止するまでフォアグラウンドで実行します。`sonar kill` は停止したマッピングを `map_stop` として報告します。
### `sonar rename`、`sonar assign`、`sonar history`
```sh
sonar rename 3000 storefront # a name of your own, survives restarts
sonar rename 3000 --clear
sonar assign 3000 my-app # pin a port to a group by hand
sonar assign 3000 --clear
sonar history # everything that came up, went down, restarted
sonar history 3000 --since 24h --limit 20
```
```sh
sonar history --since 1h
sonar history --json
# check
```
名前とピンはsonarのデータベースに保存され、ポートについて判明している最も具体的なもの、すなわち実行(`run:<group>/<name>`)、コンテナ(`docker:<project>/<service>`)、作業ディレクトリ、そして最後にポート番号をキーとして管理されます。名前を変更した開発サーバーは再起動してもその名前を保持し、ポート3000だけにピン留めされた名前はそこに応答するものすべてに適用されます。これら3つのコマンドはデーモンを必要とし、実行されていない場合は起動します。
### ポートの読み取り
```sh
sonar info 3000 # command, user, bind, stats, health
sonar logs 3000 # tail; docker logs for containers
sonar wait 5432 3000 --timeout 60s # block until ready
sonar wait 5432 --http=/health # wait for HTTP 200-399, not just TCP
sonar next 3000 # first free port from 3000
sonar next 3000-3100 -n 3 # three consecutive free ports
sonar graph # who is connected to whom
sonar graph --dot # Graphviz
sonar open 3000 # open in the browser
sonar attach 3000 # shell into the container, or TCP
sonar watch # live view
sonar watch --stats --notify
```
```sh
sonar next 3000
sonar next 3000-3100 -n 3 --json
sonar graph --json
sonar info --help
# check
```
`sonar wait` は `0`(準備完了)、`1`(タイムアウト)、`2`(中断)で終了するため、
何かを起動してからテストするまでの間に置くのに適しています:
```sh
docker compose up -d
sonar wait 5432 3000 --timeout 60s && npm run migrate && npm run test
```
**デーモンか直接スキャンか。** すべての読み取りコマンドは、デーモンが
実行中かどうかを問い合わせる。デーモンはすでに答えを持っており、`lsof` を fork
する必要がないからだ。実行中のデーモンがなければ直接スキャンし、その旨を stderr に
1 行だけ出力する。`sonar kill` も同じルールに従う。到達可能なデーモンが kill を
実行するため、直ちに再スキャンし、その次の応答 — そしてポート履歴 — はすでに
そのポートが消えたことを把握している。読み取りも kill も、背後で勝手にデーモンを
起動することはない。`--no-daemon` は直接スキャンを強制し、その際は何も出力せず、
どのコマンドでも機能する:
```sh
sonar list --no-daemon --json
# check
```
### `sonar host`
```sh
sonar host # cpu, load, memory and disk of the machine sonar watches
sonar host --json
```
```sh
sonar host
# check
```
デーモンはスキャンの周期で自身のマシンを計測し、スナップショットの `hosts` コレクションの `localhost` 行として公開する。os とカーネル、稼働時間、cpu パーセント、ロードアベレージ、メモリ、そして `/` を保持するディスクである。CPU パーセントは2回のスキャンの間に行われた作業量であるため、デーモンが2回スキャンするまでは null になる。プラットフォームが生成できない数値 — ロードアベレージを持たない Windows でのロードアベレージ — はゼロではなく null である。`sonar remote add` で登録されたすべてのホストは、自身の負荷とともに同じテーブルに加わる。このコマンドには実行中のデーモンが必要である。パーセントの測定基準となる前回のサンプルを保持しているのはデーモンだからである。
GPU はホストの下に使用率とメモリとともに一覧表示される。macOS では `ioreg` から(Apple silicon のメモリは統合されているため、GPU が保持している分だけが表示される)、Linux では `nvidia-smi` または amdgpu の sysfs カウンタから取得する。デーモンはこれらをバックグラウンドで5秒ごとに読み取り、コマンドの経路上では決して読まない。`gpus` はソースがない場合(Windows、Intel のみの Linux)は null であり、GPU のないマシンでは `[]` である。
### `sonar remote install`
```sh
sonar remote install [email protected] # same version as this sonar
sonar remote install hetzner --version v0.6.0 # a Host from ~/.ssh/config
sonar remote install deploy@box --no-service # the binary, no daemon
```
既に ssh 接続できるホストに sonar を配置し、そこでデーモンを起動します。リリースアーカイブは**リモートホスト上で**ダウンロードおよびチェックサム検証され、このマシンからは何もコピーされません。バイナリは `~/.local/bin/sonar` に配置されるため、いずれも root 権限を必要としません。デーモンは、ホストが対応していれば systemd ユーザーユニット (`~/.config/systemd/user/sonar.service`) として実行され、対応していなければデタッチドで実行されます。ユーザーセッションがログアウト時に終了し、デーモンも道連れになる場合は、`loginctl enable-linger` が助言として表示されます。
インストールされるバージョンは、実行元の sonar のバージョンであるため、両端は同じプロトコルで通信します。再度実行するとインプレースでアップグレードされ、デーモンが再起動します。これにより、インストールとアップデートが同じコマンドになります。
---
[Read more](https://github.com/raskrebs/sonar)