ドキュメントと使用例
何を、どう監視するか。
Holterは2つの方法で監視します。 インバウンドheartbeat — ジョブが完了時にこちらへpingを送り、pingが届かなくなればアラートします。 アウトバウンドチェック — スケジュールに沿って、外部からURL、証明書、ポート、DNSをこちらからリクエストします。サーバーエージェントも、サーバーへのアクセスも不要です。そしてBusinessでは、 依存監視 — 依存しているベンダーのステータスページを監視するので、障害が起きたときに真っ先に知ることができます。
インバウンドheartbeat
デッドマンスイッチです:成功時にこちらへpingし、途絶えたらアラートします。 バックアップ、キューワーカー、cron、パイプライン、webhookに最適。
1 · インバウンドheartbeatを作成
Holterの監視方法
名前
pingが届かなければアラート
あなたのping URL
Holterが自動生成します — ダッシュボードからコピーしてください。
2 · あとはジョブからcurlするだけ
# success — at the end of the job
pg_dump … | gzip | aws s3 cp - s3://… \
&& curl -fsS "$HOLTER_URL"
# failure — alert right away
curl -fsS "$HOLTER_URL/fail"
ウィンドウ内にpingが届かないと、Holterがインシデントを開始しチャンネルへアラートします。キューワーカー(数分おきにping)やcron(行末にcurlを追記)も同じパターンです。
メールの方がよければ? heartbeatを専用アドレス(…@in.holter.sh)に切り替え、アプリからスケジュールに沿って送信させてください。メール送信が止まればHolterが知らせます — コードだけでなく、送信パイプライン全体を監視します。
アウトバウンドチェック
スケジュールに沿って、公開インターネットからあなたのサービスにアクセスします — インストール不要です。 アップタイム、APIヘルス、SSL、ドメイン、DNS、TCPに最適。
アウトバウンドチェックを作成
Holterの監視方法
何をチェックするか
エンドポイント
正常時のステータス
応答がこれより遅ければアラート
検知できること
- ● ダウン、または想定外のステータスコード
- ● 稼働中だがレイテンシ許容値を超えて遅い(低下)
- ● 復旧 — 障害時間つきで通知
切り替え 何をチェックするか 先は SSL、ドメイン、DNS、リダイレクト — 同じ画面で、URLひとつだけ、追加項目もなし。証明書・ドメインチェックは失効の数日前から警告します。
ヒント:Holter内の「What to watch」を使えば、ワンクリックでこれらをまとめてセットアップできます。
依存先を監視する Business
すべての障害があなた自身の責任とは限りません。 Stripe、AWS、認証プロバイダー、データベースのホスト にインシデントが起きれば、あなたのアプリにも影響が及び、顧客からはあなたのせいだと思われます。それらのベンダーを 依存先 として追加すれば、Holterが公開ステータスページを監視し、真っ先にアラートで気づけます。
依存先を追加
ベンダー
ステータスページURL
または、対応済みの主要ベンダー24社から選択。
何がこれに依存していますか?
アラートする条件
検知できること
- ● ベンダー(またはそのコンポーネント)がサービス低下を報告
- ● ベンダーが全面障害を報告 — チャンネルへアラート
- ● 復旧 — 上流のインシデントが解消
Holterは各ベンダーが 公開しているステータスページ を数分おきに読み取ります — システムへ直接アクセスすることはありません。公開ステータスフィードを持つほとんどのSaaSに対応し、AWS、Google Cloud、Azureは標準サポートしています。
選択した依存先を、自社のステータスページに 「外部依存サービス」として表示することも任意で可能です。
ステータスバッジ
すべての公開ステータスページには埋め込み可能な SVG バッジが用意されています。ステータスや稼働率のライブスナップショットを README、Wiki、自分のサイトに配置できます。API キーは不要で、自動的に更新されます。
スニペットを取得
バッジ URL
Markdown
稼働率バージョン
ライブの例
- ✓ 自動更新 — 実際のステータスを1分以内に反映
- ✓ 公開かつ自己完結 — 画像が表示できる場所ならどこでも表示
コーディングエージェント(MCP)でセットアップ
上のフォームを手作業で埋める代わりに、まずはエージェントに任せましょう。Holterは MCPサーバー を提供しています — Claude Code、Cursor、その他MCP対応エージェントをチームスコープのトークンで接続すれば、リポジトリを ローカルで読み取り、見つけたモニター(cron、キュー、ヘルスチェック、ドメイン)を提案し、レビュー用のheartbeatコードを書いてくれます。
1 · MCPサーバーを追加
{
"mcpServers": {
"holter": {
"type": "http",
"url": "https://app.holter.sh/api/mcp",
"headers": { "Authorization": "Bearer ${HOLTER_TOKEN}" }
}
}
}
チームスコープのトークンを 設定 → MCP から取得し、 HOLTER_TOKENとして設定してください。エージェントに必要なのはこのトークンだけです — Holterチームにスコープされており、コード、サーバー、クラウドへのアクセス権はありません。
2 · あとは聞くだけ
"Set up Holter monitoring for this repo —
read holter.sh/use and follow it."
- ✓ コードベースをローカルで読み取ります — Holterがソースコードを見ることはありません
- ✓ モニターとheartbeatコードを提案 — すべての変更をあなたがレビューして適用
- ✓ トークン経由で動作し、鍵情報は不要 — あなたのシステムには触れません
本番監視チェックリスト
どの項目も3分でセットアップ可能 — またはアプリ内の「What to watch」からワンタップで。
-
ホームページ / メインアプリが応答する
アウトバウンドHTTPチェック、200を期待
-
APIまたはヘルスエンドポイントが応答する
/healthへのアウトバウンドHTTPチェック、任意でレスポンス内容の文字列も照合
-
応答時間が許容範囲内
「これより遅ければアラート」のレイテンシ許容値を追加
-
HTTPがHTTPSへリダイレクトされる
アウトバウンドリダイレクトチェック
-
TLS証明書の期限に余裕がある
アウトバウンドSSLチェック
-
ドメインが失効間近でない
アウトバウンドドメインチェック(RDAP)
-
DNSが正しく名前解決される
アウトバウンドDNSチェック
-
夜間バックアップが完了した
バックアップスクリプトからのインバウンドheartbeat
-
キューワーカーが生きていて処理が滞留していない
スケジュール実行されるワーカーpingからのインバウンドheartbeat
-
スケジュールジョブ / cronが実行された
各cronの完了時のインバウンドheartbeat
-
重要なパイプライン(ETL、請求バッチなど)
成功時にインバウンドheartbeat、エラー時は/fail
-
トランザクションメールが送信され続けている
インバウンドメール監視 — アプリからスケジュールに沿って専用アドレスへ送信
-
データベース / キャッシュのポートに到達できる
アウトバウンドTCPチェック(公開host:port)
-
サードパーティのwebhookが動き続けている
webhookハンドラーからのインバウンドheartbeat
-
ステータスページを公開済み
障害時に顧客が自己解決できるよう公開しておく
-
決済プロバイダーのステータス
Stripe(または利用中の決済代行)を依存先として追加
-
クラウド / ホスティングプロバイダーのステータス
AWS、GCP、Azure、Vercelなどを依存先として追加
-
重要なサードパーティAPI
OpenAI、Twilio、SendGridなど、コア機能に必要なものを追加