監視
Speakeasy の監視は Cloudflare の組み込み機能と、Penthouse の管理ダッシュボードで行います。
監視アーキテクチャ
Section titled “監視アーキテクチャ”Cloudflare Dashboard
Section titled “Cloudflare Dashboard”Workers Analytics
Section titled “Workers Analytics”Cloudflare Dashboard の Workers セクションで確認できるメトリクス:
| メトリクス | 説明 | 閾値目安 |
|---|---|---|
| リクエスト数 | 総リクエスト / 成功 / エラー | - |
| CPU 時間 | ワーカーあたりの CPU 使用時間 | p99 < 30ms |
| レスポンス時間 | リクエスト〜レスポンス | p99 < 500ms |
| エラー率 | 4xx/5xx レスポンスの割合 | < 1% |
Workers Logs
Section titled “Workers Logs”全サービスで Observability が有効化されており、構造化ログが記録されます:
- head_sampling_rate: 1 — 全リクエストを記録
- invocation_logs: true — 呼び出しログを記録
- persist: true — ログを永続化
Cloudflare Dashboard の Workers & Pages > Logs からリアルタイムログストリームにアクセスできます。
Penthouse 管理ダッシュボード
Section titled “Penthouse 管理ダッシュボード”/admin — メインダッシュボード
Section titled “/admin — メインダッシュボード”| セクション | データソース | 期間 |
|---|---|---|
| コスト概要 | getAllServicesCost() | 月次 |
| Workers メトリクス | getWorkersMetrics() | 24 時間 |
| DB メトリクス | getDbOperationsMetrics() | 月次 |
/admin/cloudflare — Cloudflare メトリクス
Section titled “/admin/cloudflare — Cloudflare メトリクス”Workers 単位の詳細メトリクス:
| メトリクス | 内容 |
|---|---|
| リクエスト数 | ワーカー別 24h リクエスト |
| CPU 時間 | ワーカー別 CPU 使用量 |
| レスポンス時間 | ワーカー別レイテンシ |
| エラー数 | ワーカー別エラー件数 |
サービス利用ゲージ:
| サービス | 監視項目 |
|---|---|
| Workers | リクエスト数 / 制限 |
| Durable Objects | リクエスト・ストレージ / 制限 |
| Queues | メッセージ数 / 制限 |
| R2 | ストレージ・オペレーション / 制限 |
| KV | 読み取り・書き込み / 制限 |
/admin/database — データベースメトリクス
Section titled “/admin/database — データベースメトリクス”| メトリクス | 内容 |
|---|---|
| オペレーション数 | 月次クエリ実行回数 |
| クエリレイテンシ | p50 / p95 / p99 レスポンスタイム |
| エラー数 | クエリエラー件数 |
| サービス別内訳 | 各サービスのクエリ数 |
| モデル別内訳 | テーブル別クエリ数 |
| 種別内訳 | SELECT / INSERT / UPDATE / DELETE |
/admin/sql — SQL Explorer
Section titled “/admin/sql — SQL Explorer”| タブ | 機能 |
|---|---|
| クエリエディタ | インタラクティブ SQL 実行 |
| 最近のログ | DB ログのリアルタイム表示 |
| スロークエリ | 遅延クエリの特定 |
| 時間帯別統計 | 時間帯ごとのクエリ数推移 |
| エンドポイント別 | API エンドポイント別のクエリ統計 |
Analytics Engine
Section titled “Analytics Engine”DB オペレーションの計測に Analytics Engine を使用:
| バインディング | Dataset | 用途 |
|---|---|---|
ANALYTICS | speakeasy_db_operations | クエリ実行統計 |
Analytics Engine は Tap, Vintage, Penthouse に設定されています。
ヘルスチェック
Section titled “ヘルスチェック”サービス別ヘルスチェック
Section titled “サービス別ヘルスチェック”各サービスのヘルスチェックは Cloudflare Dashboard の Workers 概要で確認できます。Workers は自動的にヘルスモニタリングが行われます。
Cron トリガー
Section titled “Cron トリガー”定期実行タスクの正常動作を監視:
| サービス | スケジュール | タスク |
|---|---|---|
| Fizz | 毎時 (0 * * * *) | 予約配信の Queue 投入 |
| Bell | 毎時 (0 * * * *) | 予約 PUSH 通知の送信 |
Cron 実行の成功/失敗は Workers Analytics のイベントとして記録されます。
アラート設定
Section titled “アラート設定”Cloudflare Notifications
Section titled “Cloudflare Notifications”Cloudflare Dashboard の Notifications で以下のアラートを設定:
| アラート | 条件 | 通知先 |
|---|---|---|
| Workers エラー率 | エラー率 > 5% | メール |
| Workers CPU 時間 | p99 > 50ms | メール |
| Queue DLQ | DLQ にメッセージ到達 | メール |
推奨アラート設定
Section titled “推奨アラート設定”- Workers failing — Worker のエラー検知
- Queue backlog — キューのメッセージ滞留
- Durable Objects errors — DO のエラー検知
Workers Logs（Cloudflare Dashboard）
Section titled “Workers Logs（Cloudflare Dashboard）”- Cloudflare Dashboard → Workers & Pages → 対象 Worker を選択
- Logs タブを開く
- リアルタイムログストリームまたは過去ログを検索
Penthouse SQL Explorer
Section titled “Penthouse SQL Explorer”DB レベルのログは Penthouse の SQL Explorer で検索:
- Penthouse (
penthouse.plfumg.com) にログイン /admin/sqlに移動- 「最近のログ」タブで DB ログを確認
- Penthouse 画面一覧 — 管理ダッシュボードの詳細
- インフラストラクチャ — Cloudflare リソース構成
- トラブルシューティング — 問題対応
- インシデント対応 — 重大障害時の対応