はじめに

このガイドでは、Docker Compose を使って 1 台のマシン上に Yagra スタック全体 — core、poller、 WebUI、そして背後のストア — を起動します。読み終えるころには、サインインを済ませ、最初のノードの監視が始まっている状態になります。

前提条件

Docker と Docker Compose プラグイン。
Linux では、ポーラーが raw ソケットの ICMP を使うため NET_RAW ケーパビリティが必要です — 同梱の Compose ファイルがこれを付与します（cap_add: [NET_RAW]）。

リポジトリをクローンします:

git clone https://github.com/horryworks/Yagra.git
cd Yagra

すべてを起動します:
Terminal window
```
docker compose up --build
```
初回のビルドには数分かかりますが、以降の起動は高速です。
初回起動時にコアのログへ出力される、使い捨ての admin パスワードを取得します:
Terminal window
```
docker compose logs core
```
https://localhost:8443 で WebUI を開き、admin とそのパスワードでサインインします。

初回アクセスではブラウザが警告を出します。自分の証明書を取り込むまでは自己署名証明書のままで、しかも Yagra はどのホスト名でアクセスされるかを知りようがないため、名前も一致しないのが普通です。ここではそのまま進んでください。 設定 ▸ TLS 証明書で正式な証明書を取り込むか、正しい名前を指定して自己署名証明書を再生成できます。

このスタックは 2 つの HTTP ポートに加えて、パッシブデータを受け取る UDP リスナーを公開します。リスナーはオプトインの機能で、この構成では最初の 3 つを既定で有効にしています:

ストア（PostgreSQL・Redis・NATS・VictoriaMetrics・VictoriaLogs・ClickHouse）は内部の Docker ネットワークに留まります。ファイアウォールで塞ぐべきものを含む完全な一覧は、ポートリファレンスにあります。

サイドバーの Nodes を開き、Add node を選びます。
名前とデバイスの IP アドレスを入力します。これだけで、Yagra はただちに ICMP 死活監視を開始します。
インターフェースやシステムのメトリクスも収集するには、SNMP credential（v2c コミュニティまたは SNMPv3 ユーザー）を割り当て、デバイスプロファイルを選びます — 組み込みのプロファイルが一般的な機器ファミリーを網羅しており、それ以外には汎用の SNMP プロファイルが使えます。
1 回のポーリング周期のうちに、ノードの状態・応答時間・（SNMP があれば）インターフェース単位のトラフィックが、ノードの詳細ページに表示されます。

機器を 1 台ずつ追加する方法だけではありません。ディスカバリは IP レンジをスキャンして応答したものを見つけ、分類したうえで、その結果をまとめて取り込めるようにします。どちらの方法も、URL・ DNS・Meraki の監視とあわせて監視ガイドで扱っています。

本番運用へ進みますか？ この構成はソースからビルドするもので、評価用です。インストールガイドでは、本番向けのデプロイ — 固定したリリースイメージ、認証情報を暗号化する鍵の永続化、バックアップ — に加えて、ネイティブインストールとリモート拠点のポーラーを扱います。
スタックを調整する — すべての環境変数、既定値、クランプ範囲は設定リファレンスにあります。
機能を見てまわる — アラート、パッシブイベント、トラフィックフロー、ダッシュボードとレポート。
設計を理解する — アーキテクチャ概要では、コア・ポーラー・バス・ストアがどう組み合わさるのかを説明しています。