Rollbarが沈黙する時：オブザーバビリティのプロが教える「エラー検知」復旧の極意
「本番でエラーが起きているはずなのに、Rollbarに何も届かない」。
この瞬間、エンジニアの胃には冷たい穴が開く。監視ツールが盲目になることは、航海中にコンパスを失うことと同義だ。
私はこれまで数多のシステムトラブルを鎮火してきたが、Rollbarが「沈黙」する原因は、実は驚くほどパターン化されている。今回は、単なるマニュアルの焼き直しではない。「なぜ届かないのか」という不可視領域を解剖し、二度と迷わせないためのプロの設計術を伝授する。
—
1. 接続の死角を突く：Rollbar「届かない」チェックリスト
Rollbarにデータが到達しない場合、原因は「認証」「ネットワーク」「順序」のいずれかにある。まずはこの順で切り分けろ。
① アクセストークンのスコープミス
`post_client_item` の権限を持つトークンを使っているか？ 読み取り専用トークンで書き込みを試みていないか。
- 確認方法: ダッシュボードから「Project Access Tokens」を再生成し、その場で `curl` を叩いて疎通確認する。
② SDK初期化の「先走り」
フロントエンド（SPA）において、メインロジックの実行前にRollbarが初期化されていないケースが多発する。
- 対策: `window.onerror` や `unhandledrejection` がフックされる前に読み込まれているか、バンドラーの読み込み順序を再確認せよ。
③ ネットワークフィルタリングとCORS
社内プロキシやWAFが、RollbarのAPIエンドポイント（`api.rollbar.com`）をブロックしていないか？
- プロの診断: ブラウザのコンソールではなく、ネットワークタブで「Failed」になっているリクエストを探せ。`CORS` エラーなら、Rollbar側の許可ドメイン設定と一致しているか確認が必要だ。
—
2. 開発スピードを加速させる「プロの隠し味」
ただエラーを眺めるだけでは、オブザーバビリティとは呼べない。生産性を底上げするための秘伝テクニックを公開する。
隠れたキーボードショートカット
- `Shift + /` (ダッシュボード画面): キーボードショートカット一覧を表示。これを暗記するだけで、マウス操作の9割が不要になる。
- `Enter` (エラー詳細画面): エラーのステータスを即座に「Resolved」に遷移させる。トリアージ時間を極限まで短縮せよ。
推奨：絶対に入れるべき神プラグイン・連携
- GitHub/GitLab連携: エラー発生箇所から「コミットログ」と「修正者」にワンクリックで飛べるようにせよ。調査時間を5分から10秒に短縮する魔法だ。
- Slackの「Actionable Notifications」: 通知を受け取った瞬間、Slack上で「Resolve」「Assign」「Ignore」ができる設定を入れろ。コンテキストスイッチを最小化するのが一流の条件だ。
—
3. 実践：ベストプラクティスな設定構成（JavaScript/TS例）
場当たり的な設定はノイズの温床になる。以下の構成で「構造化された監視」を実現せよ。
// rollbar.config.ts
import Rollbar from ‘rollbar’;
const rollbar = new Rollbar({
accessToken: process.env.ROLLBAR_ACCESS_TOKEN,
captureUncaught: true,
captureUnhandledRejections: true,
payload: {
environment: process.env.NODE_ENV || ‘production’,
// チーム共通のコンテキストを付与：誰の、どのビルドか即座に特定する
client: {
javascript: {
source_map_enabled: true,
code_version: process.env.GIT_SHA, // デプロイハッシュを必ず埋め込む
}
}
},
// ノイズ除去：無限ループエラーなどを無視する設定
checkIgnore: (isUncaught, args, payload) => {
const message = args[0] || ”;
return message.includes(‘ResizeObserver loop limit exceeded’);
}
});
export default rollbar;
—
4. チームで共有すべき「運用哲学」
ツールは入れれば終わりではない。以下の3つのルールをチームの憲法にせよ。
1. 「環境変数は正義」: トークンをコードに埋め込むな。環境ごとにプロジェクトを分け、ビルド時に環境変数を注入するパイプラインを構築せよ。
2. 「ノイズは即時撲滅」: 意味のないアラートが一つでも放置されると、チームは「Rollbarの通知」を無視するようになる。無視される監視ほど無価値なものはない。
3. 「ソースマップの自動アップロード」: Minifyされたコードでデバッグするのは、目隠しで爆弾処理をするようなものだ。CI/CDパイプラインにソースマップのアップロードを組み込むのは、現代のエンジニアとして最低限の義務である。
—
最後に：オブザーバビリティは「文化」である
Rollbarが届かないという事態は、システムが助けを求めているのに無視している状態だ。
エラーを「バグ」ではなく「システムの挙動を知るためのシグナル」と捉えよ。
もし次にRollbarが沈黙したら、焦らずこの記事の「チェックリスト」に戻ってこい。そして、監視が復旧したその瞬間、君たちのチームはまた一歩、真のオブザーバビリティに近づいているはずだ。
さあ、コードに戻ろう。解決すべき問題は、まだそこにある。