内部監視 (Host Agent)

サーバーやVMのリソース使用率（CPU・メモリ・ディスク・ネットワーク）を Manako CLI から定期的にプッシュして監視します。外部からのポーリングではなく、サーバー側からメトリクスを送信するプッシュ型の監視方式です。

外部監視との違い

	外部監視 (HTTP/TCP/Ping など)	内部監視 (Host Agent)
監視方向	Manako → サーバー	サーバー → Manako
確認できること	死活・レスポンス・ポート疎通	CPU・メモリ・ディスク・ネットワーク
ファイアウォール	インバウンド許可が必要	アウトバウンドのみ必要
実行方法	Manako が定期チェック	サーバーの cron から CLI を実行

スタンドアロン エージェントのインストール

manako-agent はデーモン型スタンドアロンバイナリです。Node.js / npm 不要で動作し、systemd / launchd / Windows Service として常駐させることができます。

Linux / macOS (curl)

# ワンライナーインストール + サービス登録
curl -fsSL https://get.manako.dev/agent | sh -s -- <エージェントトークン>

# システム全体へのインストール (sudo 必要)
curl -fsSL https://get.manako.dev/agent | sh -s -- <エージェントトークン> --system

macOS (Homebrew)

brew tap elchika-inc/manako
brew install manako-agent

# インストール後にサービス登録
manako-agent agent install --token <エージェントトークン>

Windows (PowerShell)

# ワンライナーインストール
$env:MANAKO_TOKEN="<エージェントトークン>"; iwr https://get.manako.dev/agent.ps1 -useb | iex

インストール後は manako-agent agent status で稼働確認ができます。

ヒント

サービス登録せずに手動でインストールする場合は、GitHub Releases からバイナリを直接ダウンロードできます。

---

セットアップ手順

1. ダッシュボードでモニターを作成

   Manako ダッシュボードの「新規モニター」から 内部監視 (Host Agent) を選択してモニターを作成します。または CLI から作成することもできます：

   manako monitors add <サーバー名> -t host_agent -n "prod-web-01"

   作成直後にエージェントトークンが表示されます。このトークンは一度しか表示されないため、必ず安全な場所に保存してください。

   注意

   エージェントトークンを紛失した場合は、CLI または API から再取得できます：manako monitors agent-token <monitor-id> または GET /api/v1/monitors/<id>/agent-token

2. CLI をインストール

   npm

   npm install -g manako

   npx（インストール不要）

   # インストールせずにそのまま実行
   npx manako metrics push --token <token>

3. メトリクス送信のテスト

   manako metrics push --token <エージェントトークン> --dry-run

   --dry-run を付けると実際には送信せず、収集したメトリクスの JSON を確認できます。問題なければ --dry-run を外して実行します：

   manako metrics push --token <エージェントトークン>

4. cron を設定

   サーバーで crontab -e を開き、5 分ごとに実行する設定を追加します：

   5分ごと (推奨)

   */5 * * * * /usr/local/bin/manako metrics push --token <エージェントトークン>

   1分ごと

   * * * * * /usr/local/bin/manako metrics push --token <エージェントトークン>

   systemd timer (Linux)

   /etc/systemd/system/manako-metrics.service

   [Unit]
   Description=Manako Host Metrics Push
   
   [Service]
   Type=oneshot
   ExecStart=/usr/local/bin/manako metrics push --token <エージェントトークン>

   /etc/systemd/system/manako-metrics.timer

   [Unit]
   Description=Manako Metrics Push Timer
   
   [Timer]
   OnBootSec=1min
   OnUnitActiveSec=5min
   
   [Install]
   WantedBy=timers.target

   systemctl enable --now manako-metrics.timer

収集するメトリクス

メトリクス	内容
CPU	全コアの使用率 (%)
メモリ	使用量 / 合計容量
ディスク	マウントポイントごとの使用率 (%)
ネットワーク	インターフェースごとの受信・送信バイト数

ホスト情報（ホスト名・OS・アーキテクチャ・エージェントバージョン）も併せて記録されます。

ダッシュボードでの確認

モニター詳細画面の メトリクスタブ で時系列グラフを確認できます。表示期間は 1 時間・24 時間・7 日間・30 日間から選択できます。

5 分以上データが届いていない場合は「5分以上応答がありません」の警告が表示されます。

トラブルシューティング

メトリクスが届かない場合

エラーログを確認します：

cat /tmp/manako-agent.log

よくある原因：

• トークンが正しくない → manako monitors agent-token <monitor-id> でトークンを再取得
• サーバーからアウトバウンド通信がブロックされている → hb.manako.dev (HTTPS/443) へのアクセスを許可

cron が実行されているか確認

# systemd 環境
journalctl -u cron --since "10 min ago"

# macOS
log show --last 10m | grep -i cron