エンジニアの皆さん、こんにちは。現場で「またチケットのステータス更新を忘れてた…」と頭を抱えたことはありませんか？
監視ツールとタスク管理ツールが「分断」されている状態は、エンジニアの認知負荷を無駄に高める最大の敵です。今日は、Rollbarでエラーを検知し、それが修正された瞬間にJiraやLinearのチケットを自動クローズする。この「運用自動化の聖杯」を、プロの知見で実装する方法を伝授します。
単なる連携ではありません。「ノイズを遮断し、真に解決すべきエラーのみをチケット化する」ための、現場レベルの極意を詰め込みました。
—
1. なぜ「双方向同期」が最強の武器なのか
Rollbarは「エラーを検知する場所」、Jira/Linearは「作業を管理する場所」です。この二つが同期していないと、以下のような地獄が生まれます。
- 重複作業: 修正済みなのに、別のエンジニアがチケットを掘り起こして調査する。
- 負の連鎖: アラートが鳴り止まず、誰も見なくなる（アラート疲れ）。
これを解決するのがWebhookとAPIを組み合わせた「ステータス同期ワークフロー」です。
—
2. 準備：最も重要な「基礎セットアップ」
まずは、Rollbarが「何をもってエラーを解決とみなすか」を定義します。
Rollbar側の設定
1. Project Access Tokenを発行します（Read/Write権限が必要です）。
2. Notificationsメニューから、Webhooksを選択します。
3. ここで重要なのは、「Resolved」イベントにだけフックすることです。
外部ツール（Jira/Linear）の準備
- APIキーを取得し、チケットのステータス遷移（例: `Done` や `Resolved`）のIDを控えておきます。
—
3. 実装の極意：Webhookハンドラーの構築
直接ツール同士を繋ぐのではなく、間にAWS LambdaやCloud Functions等の軽量なミドルウェア（Webhookハンドラー）を挟むのがプロの定石です。なぜなら、複雑なロジック（特定の環境のみ、特定の重要度のみ等）を柔軟に制御できるからです。
以下は、Node.jsを用いた汎用的なWebhookハンドラーの骨子です。
// Webhookを受け取り、RollbarのResolvedイベントを処理するハンドラー
exports.handler = async (event) => {
const body = JSON.parse(event.body);
// 1. 本物のResolvedイベントか確認（ノイズ除外）
if (body.event_name !== ‘resolved’) return { statusCode: 200 };
const errorOccurrence = body.data.item;
const ticketId = extractTicketId(errorOccurrence.title); // タイトルからチケットIDを抽出
if (!ticketId) return { statusCode: 404, message: “Ticket ID not found” };
// 2. 外部APIを叩いてチケットをクローズ
try {
await closeExternalTicket(ticketId);
console.log(`Successfully closed ticket: ${ticketId}`);
} catch (err) {
console.error(“Sync failed:”, err);
}
return { statusCode: 200 };
};
// チケットIDを正規表現で抽出するヘルパー（地味に重要！）
function extractTicketId(title) {
const match = title.match(/\[([A-Z]+-\d+)\]/); // 例: [PROJ-123] を探す
return match ? match[1] : null;
}
—
4. 精度を高める「現場の知見」：トラブルを未然に防ぐ
この仕組みを導入する際、初心者が必ず陥る罠があります。これを避けるのが「達人」への近道です。
- 無限ループの恐怖:
RollbarがResolvedにした→Webhookが飛ぶ→外部ツールでクローズ→もし外部ツールのWebhookがRollbarを叩く設定になっていたら？……地獄の無限ループです。
鉄則: 外部ツール側の更新イベントは、Rollbarへ送り返さないようにフィルタリングしてください。
- チケットIDの正規化:
Rollbar側のタイトルが頻繁に変わる場合、WebhookがIDを見失います。Rollbarの「Occurrenceタグ」を活用し、そこに固定のチケットIDを埋め込む設計にすると、堅牢性が劇的に向上します。
—
5. 動作確認：HelloWorldのその先へ
1. テスト用エラーの発火: 開発環境でわざと例外を発生させ、Rollbarに送信します。
2. 手動解決: Rollbarのコンソールで「Resolve」ボタンを押します。
3. ログ監視: Lambdaのログを確認し、正しく外部APIが呼ばれたかチェックします。
これが成功すれば、あなたのチームは「エラー対応の追跡」という、最も退屈でミスが起きやすい業務から解放されます。
—
最後に：エンジニアの時間を守るために
オブザーバビリティの本質は、「システムの状態を把握し、即座に手を打てる状態を作ること」です。
今回紹介した双方向同期は、単なる自動化ではありません。システムとチームの間の「意思疎通」を自動化する仕組みです。この基盤を作れば、あなたはもっと創造的で、もっと楽しい開発に集中できるようになります。
もし躓くことがあれば、またいつでも聞いてください。設計図を描くところから一緒に考えましょう。あなたのプロダクトが、より強固なものになることを応援しています！