コンテンツにスキップ

このページは英語のページを機械翻訳したものです。内容は英語のページが正です。 英語のページを読む

サーバーを外部から監視する

死活監視サービスをサーバーに向ける方法、監視で運用コストが上がらないようにする方法、メンテナンスモード(メンテナンス)と障害を見分ける方法を説明します。プローブのパスは運用ガイドのヘルスチェックの節にあります。

以下に書いた外部サービスの情報には、確認した日付と出典を添えています。サービスのプランや画面は変わるので、制限に頼る前にリンク先のページを確認してください。

パス 用途 DB へのアクセス メンテナンスモード中
GET /api/v1/instance/health 死活監視、ステータスページ、Web クライアント プロセスごとに 60 秒に最大 1 回 503(Retry-After 付き)と {"status":"maintenance"}
GET /healthz, GET /health/live プラットフォームの liveness プローブ しない 200 {"status":"maintenance"}
GET /readyz, GET /health/ready ロードバランサーや Kubernetes の readiness プローブ リクエストごと(同時のリクエストは 1 回のチェックを共有) 200 {"status":"maintenance"}

外部の監視は /api/v1/instance/health に向けてください。/readyz(/health/ready)には向けないでください。これらはリクエストのたびにデータベースに問い合わせるので、間隔の短い監視はスケールトゥゼロのデータベースを起こし続けます。プローブはプラットフォームのためのものです。 monitoring セクションは、Google Cloud 上では mycroblog-gcp のものが /health/live を、mycroblog-aws のものが /readyz を、それぞれプラットフォーム自身の監視から長い間隔でチェックします。チェックのたびにインスタンスが起きるので、そのコストが uptime_period です。

サーバー自身のメトリクス、トレース、エラーレポートの送り先は、同じモジュールの observability セクションで、monitoring はこれを読みます。既定では、それぞれをプラットフォームに送ります。Google Cloud では、メトリクスを Cloud Monitoring に、リクエストのトレースを Cloud Trace に、エラーレポートを Error Reporting に送ります。この 3 つはすべて Cloud Run が送るものから作られ、各 API は有効になります。AWS では、メトリクスを Embedded Metric Format で CloudWatch に、エラーレポートを CloudWatch Logs に、トレースをすべてのタスクでサーバーの隣で動くコレクター経由で X-Ray に送ります(AWS ECS でのトレース)。monitoring にはそこにメトリクスがあることが必要で、observability.metrics = "settings" は受け付けません。これは metrics_exporter を settings の入力に任せるものです。

/api/v1/instance/health の応答(認証なし、Cache-Control: no-store)は次のとおりです。

状態 HTTP 本文
正常 200 {"status":"ok","checked_at":"<RFC 3339>"}
利用不可(データベースに到達できない、またはスキーマが適用されていない) 503 {"status":"unavailable","checked_at":"<RFC 3339>"}
メンテナンスモード 503(Retry-After 付き) {"status":"maintenance"}

/healthz と /readyz は、正常なときに 200 と {"status":"ok"} を返します。データベースの準備ができていないとき、/readyz は problem document 付きの 503 を返します。/health/live と /health/ready は、別の名前で提供される同じチェックです。

Cloud Run では、末尾が z で終わらないパスを呼び出してください。 Cloud Run は末尾が z で終わる一部のパスを予約していて、リクエストがコンテナーに届く前に、Cloud Run 自身の 404 で応答します。/healthz がその 1 つで、/readyz が今後も応答し続ける保証はありません。Cloud Run のデプロイの外側(死活監視、curl)からは、/health/live、/health/ready、/api/v1/instance/health を使ってください。コンテナー自身のプローブには影響しません。 本文に理由、ホスト名、バージョンが含まれることはありません。原因はサーバーのログにあります。

checked_at は、応答のもとになったチェックの時刻です。サーバーはデータベースのチェックをプロセスごとに 1 分に最大 1 回実行し、その結果を使い回します。そのため 60 秒より短い間隔でポーリングする監視は同じ checked_at を見るだけで、得るものはありません。プロセスが複数あるときは、それぞれが自分のチェックを実行します。

origin_secret を設定していても、この 3 つのパスはヘッダーなしで応答するので、CDN がヘッダーを失ったことはこれらには表れません。監視を問題の最初の兆候にしているなら、https://<host>/about のような CDN 経由のページも監視してください。

  • スケールトゥゼロのデータベース。 監視の間隔が、データベースが停止するまでの待ち時間より短いと、データベースは停止しません。 Neon は 5 分間アクティビティがないとコンピュートを停止します。Free プランではこれを無効にできません (2026-10-25 確認、Neon: Scale to zero)。 目安として、間隔を 5 分以上にすれば、アイドルのデータベースはチェックの合間に停止でき、各チェックはチェックの時間とアイドル時間のぶんだけデータベースを起こします。 連合するサーバーはほかのサーバーから一日中配送を受けるので、いずれにしてもデータベースは一日の大半起きています。 追加のコストは静かな時間帯に限られます。
  • アイドル時のコストを最も重視するなら、安い組み合わせにします。 /health/live(データベースに一切触れません)を短い間隔で、データベースを使う /api/v1/instance/health を長い間隔(15 分以上)で監視します。/health/live はメンテナンスモード中も 200 を返すので、本文の "status":"ok" で判定してください。
  • リクエストそのものは小さなものです。 5 分ごとに 1 回のチェックは月に約 8,640 リクエスト、1 分ごとなら約 43,200 リクエストです。これは Cloud Run の無料枠 (月に 200 万リクエスト、180,000 vCPU 秒、360,000 GiB 秒。時間は 100 ms 単位で切り上げ。2026-10-23 確認、Cloud Run pricing)に収まります。

メンテナンスモードと障害を見分ける

Section titled “メンテナンスモードと障害を見分ける”

メンテナンスモード中(メンテナンスのガイド)、ヘルスエンドポイントは 503 を返し、ほとんどの監視サービスはこれを障害と同じに扱います。 ステータスコードだけでは区別できないので、本文で判定してください。

  • 本文に "status":"ok" があれば正常、それ以外はダウンとして扱います。キーワード監視や JSON の値の監視でこれができます。
  • 予定したメンテナンス中にアラートを出さないようにするには、サービスにメンテナンスウィンドウがあればそれを設定するか(下の表を参照)、 始める前に監視を手動で一時停止します。
  • UptimeRobot の Free プランにはメンテナンスウィンドウがありません。監視を一時停止するか、アラートを受け入れてください。

どのサービスでも同じことをチェックします。GET https://<your-host>/api/v1/instance/health の応答が 200 で、本文に "status":"ok" が含まれていれば正常です。

サービス 監視の種類 正常の条件 メンテナンスウィンドウ 確認日
UptimeRobot Keyword 本文に "status":"ok" が含まれる Free にはない(Solo 以上) 2026-10-25、料金
Better Stack HTTP status または Keyword 2xx、または本文に "status":"ok" が含まれる 未確認 2026-10-25
Gatus Endpoint conditions [STATUS] == 200 かつ [BODY].status == ok 設定の maintenance 2026-10-25、README
Uptime Kuma HTTP(s) - Keyword または JSON Query 本文に "status":"ok" が含まれる、または status が ok 組み込み 2026-10-23、README
Upptime .upptimerc.yml の sites 200 かつ本文に "status":"ok" が含まれる なし 2026-10-25、Configuration

種類 Keyword の監視を作成します。URL は https://<your-host>/api/v1/instance/health、キーワードは "status":"ok" とし、キーワードが存在しないときにアラートを出すようにします。 Free プランでは 5 分間隔の監視を 50 個まで作成でき、キーワード監視も含まれます。 「Custom headers & statuses」とメンテナンスウィンドウは Solo プラン(有料、60 秒間隔)から使えます (2026-10-25 確認、料金)。チェックは本文で行うので、ここではキーワード監視で十分です。

次の 2 つの形が使えます(2026-10-25 確認、Uptime monitor、Keyword monitor)。

  • HTTP status 監視: 2xx の応答を稼働中として扱うので、200 は稼働中、503(利用不可またはメンテナンス)はインシデントを開きます。
  • Keyword 監視: 「Alert us when」を「URL doesn’t contain keyword」にし、キーワードを "status":"ok" にします。照合では大文字と小文字を区別しません。

Free プランのチェック頻度とメンテナンスウィンドウは未確認です。公式のページには Free プランについての記載がありません。無料枠の数(監視とハートビートを合わせて 10 個、ステータスページ 1 つ)は 料金のページ によるもので、2026-10-23 に確認しました。

config.yaml に次のように書きます(既定の間隔は 60s。2026-10-25 確認、README)。

endpoints:
- name: my
url: "https://<your-host>/api/v1/instance/health"
interval: 5m
conditions:
- "[STATUS] == 200"
- "[BODY].status == ok"

Gatus には、予定した作業のためのトップレベルの maintenance セクションがあります(start は hh:mm、duration、timezone は既定で UTC、every は曜日のリストで、空なら毎日)。 README にはメンテナンスウィンドウ中のアラートを避けるためのものとしか書かれていないので、お使いのバージョンでの動作を確認してください。

種類 HTTP(s) - Keyword の監視をキーワード "status":"ok" で追加するか、HTTP(s) - Json Query の監視をクエリ status、期待値 ok で追加します。 受け付けるステータスコードは既定で 200-299 なので、メンテナンスの 503 も障害の 503 もダウンになります。Uptime Kuma には監視のウィンドウのためのメンテナンス機能があります (wiki に記載がありますが、詳細は未確認です)。 監視の種類は 2026-10-23 にソースで確認しました(monitor.js、 EditMonitor.vue)。

.upptimerc.yml に次のように書きます(2026-10-25 確認、Configuration)。

sites:
- name: My server
url: https://<your-host>/api/v1/instance/health
__dangerous__body_down_if_text_missing: '"status":"ok"'

既定では 20x と 30x が稼働中として数えられます。200 だけを受け付けるには expectedStatusCodes: [200] を設定します。チェックは、すべてのサイトに共通のスケジュールで GitHub Actions から実行されます (workflowSchedule.uptime。既定は 5 分ごとで、これは GitHub Actions で許される最短の間隔でもあります)。オプション名は推奨されないことを示していますが、 本文を調べるにはこの方法を使います。

status_page_url(MY_STATUS_PAGE_URL、https: の URL。設定リファレンスを参照)に、 監視サービスの公開ページを設定します。サーバーはこのリンクを、GET /api/v1/instance、サーバーが表示するサインインのページとエラーページ、Web クライアント (サーバーが応答しないときも含む)、メンテナンスのページに表示します。これで、サーバーにアクセスできない利用者も理由を知ることができます。 この値はデータベースではなく設定から読まれるので、データベースが落ちていても機能します。変更は再起動の後に反映されます。

ページそのものの選択肢は次のとおりです(このサーバーはステータスページの状態を取り込まないので、お知らせはサーバー全体のお知らせとしても投稿してください)。

  • 選んだ監視サービスがホストするステータスページ(UptimeRobot の Free プランにはカスタマイズできないステータスページが 1 つ、Better Stack の無料枠には 1 つあります)、 Gatus と Uptime Kuma が自分で提供するページ、または GitHub Pages 上の Upptime の静的サイト。
  • Atlassian Statuspage。これは公開のための場所で、監視ではありません。コンポーネントは Operational、Under maintenance、Degraded performance、 Partial outage、Major outage の 5 つの状態のいずれかを持ちます(API の値は operational、under_maintenance、degraded_performance、partial_outage、major_outage。 2026-10-23 確認、What is a component?、Statuspage API)。 監視のアラートからコンポーネントの状態を自動で変える方法は未確認です(実際のアカウントでサービスごとの連携を設定する必要があります)。

LLM とコーディングエージェント向け:llms.txt,llms-full.txt, llms-small.txt

このサイトのアクセス解析