Uptime Kumaについて
Uptime Kumaは、開発者のLouis Lam氏が始めたオープンソースの監視ツールで、現在はGitHubで最も多くのスターを集めるセルフホスト型プロジェクトのひとつです。HTTP(S)によるウェブサイト、ページ内のキーワード、TCPポート、ping、DNSレコード、データベースなどが応答しているかをチェックします。
チェックに失敗すると、Telegram、Discord、Slack、メール、Webhookなど、数十種類の対応チャネルのいずれかで通知します。応答時間の記録、TLS証明書の期限切れ前の警告、顧客向けの公開ステータスページの作成も可能です。
軽量で無料、数分で設定できるすっきりした画面がセルフホストで選ばれる理由です。重要なのは別のサーバーで動かすこと。サイトと同じマシンで動く監視ツールは、そのマシンが停止したことを知らせられません。
主な使い道
サイトダウン時の通知
ウェブサイトとAPIを毎分チェックし、応答がなくなればすぐにTelegramやメールで通知を受け取れます。
証明書の期限切れ警告
HTTPS証明書が切れる数日前に通知。顧客から指摘されてから気づくことはありません。
公開ステータスページ
ご自身で管理するページで、サービスの現在の状態を顧客に公開できます。
ご注文後の流れ
サーバーの初回起動時にUptime Kumaがインストールされ、ファイアウォールでポート3001が開放されます。監視画面には http://your-server-address:3001/ でアクセスできます。最初のアクセス時に管理者アカウントを作成するため、サーバーの準備ができたらすぐにアドレスを開いてください。その後、最初の監視項目を追加し、通知チャネルを接続します。
どこで動かすか
Uptime Kumaは、動いている場所からチェックを行います。監視対象と同じサーバー上の監視ツールは、対象と一緒に停止して警告を出せません。監視対象とは別のサーバーで動かしてください。
Uptime Kumaに独自ドメインとHTTPSを設定
初期状態のUptime Kumaは、サーバーのIPアドレスに対して暗号化なしのHTTPで応答します。status.example.com のような名前と証明書を付けるには、DNSでその名前のAレコードをサーバーのIPv4アドレスに向け、その前段にCaddyを置きます。CaddyはLet's Encryptの無料証明書を自動で取得し、更新も行います。以下のコマンドは、当社のアプリ用サーバーで使用しているUbuntu 24.04向けです。
パネルで、サーバーのファイアウォールのTCPポート80と443を開放してください。CaddyがLet's Encryptの証明書を取得し、サイトを配信するために必要です。
apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
status.example.com {
reverse_proxy 127.0.0.1:3001
}
EOF
systemctl reload caddyドメインを設定すれば、Uptime Kumaのステータスページを顧客と共有できます。ステータスページを作成し、表示する監視項目を選んで、https://status.example.com/status/your-page を案内してください。ステータスページの設定で、ドメインをそのページ自体に割り当てることもできます。
ドメインが使えるようになれば、ポート3001に直接アクセスする必要はありません。/opt/uptime-kuma/compose.yml で "3001:…" を "127.0.0.1:3001:…" に変更し、docker compose up -d を実行して、ファイアウォールからポート3001を削除してください。これでUptime KumaにはHTTPS経由でのみアクセスできるようになります。
Uptime Kumaのアップデート
/opt/uptime-kuma/compose.yml のイメージは正確なバージョンに固定されているため、docker compose pull を実行するだけでは同じバージョンが再取得されます。アップデートするには、image: 行のバージョンを目的のバージョンに書き換え(事前にリリースノートを確認してください)、pullしてコンテナを再作成します。データはDockerボリュームにあり、そのまま保持されます。
cd /opt/uptime-kuma
nano compose.yml # the new version in the image: line
docker compose pull
docker compose up -dUptime Kumaのバックアップ
パネルでは、サーバー全体の毎日自動バックアップ(プラン料金の+20%、直近7世代を保持)を有効にでき、どの世代からでもサーバーを復元できます。それでも、アプリのデータをファイルとしてコピーしておくと便利です。別のサーバーへ移したり、他の部分を巻き戻さずに復元したりできます。
監視項目、通知設定、チェック履歴は uptime-kuma_uptime_kuma ボリューム(/app/data)にあります。データベースファイルを整合性のある状態でコピーするため、少しの間アプリを停止してください。
cd /opt/uptime-kuma && docker compose stop
docker run --rm -v uptime-kuma_uptime_kuma:/data -v /root:/backup alpine \
tar czf /backup/uptime-kuma-$(date +%F).tgz -C /data .
docker compose start仕組み
- サーバーの注文ページでUptime Kumaを選び、十分なメモリのあるプランを選びます。
- アプリはサーバーの初回起動時にインストールされます。通常は数分で完了します。
- パネルでサーバーを開くと、アドレスとログイン情報が表示されています。