複数プロジェクトのコンテナログを、Dozzle Agent 機能を用いて集約し、Cloudflare Accessでセキュアに一元管理するためのサーバー基盤リポジトリです。
NUTFesのシステムインフラは、複数のProxmox（PVE）ノード上のLXCに分散して各プロジェクトが稼働しています。この構成において、以下の課題がありました。
- アクセス権限の制約: PVE環境へアクセスし操作できるのはインフラチームと一部の権限を持つメンバーのみに限られており、各プロジェクトの開発者が直接コンテナログを確認することが困難でした。
- ログ確認の煩雑さ: 複数のサーバー（ノードやLXC）にログが分散しているため、障害調査やデバッグ時に各環境へ個別にアクセスしてログを探す作業が非常に煩雑でした。
- エラーの早期発見: サービスでエラーが発生した際、即座に気づいて対応できる監視・通知の仕組み（Slack通知など）が必要でした。
これらの課題を解決するため、Dozzleを用いて分散したログを一元管理し、開発者がPVEに直接アクセスせずともセキュアにログを閲覧・検索できる基盤を構築しました。さらに、Dozzleのアラート機能（v10以降）を活用し、特定のエラーログを検知してSlackへ即座に通知（Incoming Webhooks連携）する監視体制を実現しています。
各種プロダクトのデプロイ先は3台のProxmoxノード上のLXCを想定しています。本サーバー（ダッシュボード）は pve01 ノードに専用のLXCを立てて稼働させています。
- Dozzle Server（本リポジトリ）稼働先:
pve01ノード内の LXC Container 100 (dozzle) - 連携対象のProxmoxノード一覧:
各プロジェクトのLXC内にDozzle Agentを配置し、pve01 (CT 100) のDozzle Serverから各Agentのポート(7007)へ接続してログを収集するアーキテクチャとなります。
自分の担当しているプロジェクトのログをこの中央ダッシュボードへ出力するには、プロジェクトの compose.yml に Agent コンテナの定義を追記するだけです。
既存の compose.yml に以下を そのままコピペして追加 してください。
[YOUR_PROJECT_NAME] の部分だけ、ご自身のプロジェクトやコンテナ名に合わせて変更してください。
services:
# --- ここから下を追記 ---
dozzle-agent:
image: amir20/dozzle:latest
command: agent
container_name: dozzle-agent-[YOUR_PROJECT_NAME]
volumes:
- /var/run/docker.sock:/var/run/docker.sock:ro
ports:
- "7007:7007"
environment:
- DOZZLE_HOSTNAME=[YOUR_PROJECT_NAME]
restart: always
healthcheck:
test: ["CMD", "/dozzle", "healthcheck"]
interval: 3s
timeout: 3s
retries: 5
# --- 追記ここまで ---flowchart LR
subgraph PVE01 [pve01 Node]
subgraph LXC100 [LXC Container 100 - This Repo]
C[Cloudflared Tunnel] -->|http| D[Dozzle API Server]
end
end
subgraph Nodes [Proxmox Nodes - pve01, pve02, pve03]
subgraph Apps [App LXCs]
A1["Project A Agent<br>port:7007"]
A2["Project B Agent<br>port:7007"]
A3["Project C Agent<br>port:7007"]
end
end
User -->|Cloudflare Access Auth| C
D -->|Connect to Agent| A1
D -->|Connect to Agent| A2
D -->|Connect to Agent| A3
Proxmox pve01 上のコンテナID 100 (dozzle) へアクセスし、本リポジトリをcloneします。
git clone https://github.com/NUTFes/dozzle-agent-server.git
cd dozzle-agent-server
cp .env.example .env.env ファイルを開き、環境変数を設定します。
DOZZLE_REMOTE_AGENT: ログを収集したい各プロジェクト(Agent)のエンドポイントをカンマ区切りで列挙します。各LXCのIPアドレスを指定します。- フォーマット:
[ホストIPアドレス]:7007 - 例:
192.168.10.2:7007,192.168.10.3:7007,192.168.10.4:7007
- フォーマット:
TUNNEL_TOKEN: Cloudflare Zero Trust ダッシュボードで払い出された Cloudflared Tunnel のトークン
以下のコマンドでDozzle ServerとCloudflaredトンネルのコンテナを起動します。
docker compose up -d設定したCloudflare TunnelのPublic Hostnameにアクセスすると、認証通過後にすべてのプロジェクト(Agent)のログが一元化されたダッシュボードで閲覧可能になります。
新しくAgentが追加された場合は、.envの DOZZLE_REMOTE_AGENT にIPを追記し、このサーバーの docker compose up -d を再実行して反映させます。
Dozzleの機能を利用して、特定のログ（エラーなど）が出力された際にSlackへアラートを送信することができます。 設定には、まずSlack側でWebhook URLを発行し、それをDozzle側に登録します。
- Slack API - Your Apps にアクセスします。
- または画面右上の「Create New App」ボタンをクリックします。
- 「From scratch」を選択します。
- App Name（例:
Dozzle）を入力し、追加先のワークスペースを選択して「Create App」をクリックします。 - Appの設定画面が開いたら、左側のメニューから「Incoming Webhooks」を選択します。
- 「Activate Incoming Webhooks」のトグルを「On」にします。
- 画面下部にある「Add New Webhook to Workspace」ボタンをクリックします。
- 通知を送信したいチャンネルを選択し、許可します。
- チャンネル用の Webhook URL（
https://hooks.slack.com/services/...から始まるURL）が発行されるので、コピーして控えておきます。
Dozzleダッシュボードの画面右上のベルマーク（Notifications）をクリックして設定画面を開きます。
「Add destination」をクリックし、SlackへのWebhook先を登録します。
- Type:
HTTP Webhookを選択 - Name: 任意のわかりやすい名前（例:
Production Slack）を入力 - Webhook URL: 先ほどSlackで発行した Incoming Webhook のURL を入力
- Payload Format:
Slackを選択 - 「Add Destination」を押して保存します。
次に、どのようなログが発生した際に通知を飛ばすか（アラート）を作成します。「+ Add」をクリックして設定を行います。
- Alert Name: アラートの名称（例:
Test API Errors）を入力 - Alert Type:
Log Alertを選択 - Container Filter: 監視対象のコンテナの絞り込み条件（例:
name contains "api"） - Log Filter: 通知させたいログの条件（例:
level == "error" && message contains "timeout"） - Destination: 手順3で追加した送信先（Destination）を選択
- 「Create Alert」を押して保存します。