メインコンテンツへスキップ
Rollbar プロジェクトを接続することで、CloudThinker エージェントが 1 つまたは複数のプロジェクトにわたってエラーのトリアージ、上位の問題のランク付け、デプロイのレビュー、セッションリプレイコンテキストの取得、アイテムの更新を行えるようになります。Rollbar はプロジェクトアクセストークンで認証します。調査には読み取りスコープのトークンで十分です。承認ゲートが必要なアイテム更新には書き込みスコープのトークンが追加で必要です。

前提条件

  • CloudThinker に参照させたいプロジェクトへのアクセスがある Rollbar アカウント
  • 各プロジェクトのプロジェクトアクセストークン(調査には読み取りスコープで十分)。
  • アイテム状態の更新をエージェントに行わせたい場合のみ、書き込みスコープのトークン(承認ゲート)。
Rollbar のトークンはプロジェクトごとにスコープされます。CloudThinker は 1 つの接続で複数のプロジェクトをサポートします。含めたいプロジェクトごとに 1 つのトークンを入力してください。

セットアップ

1

プロジェクトアクセストークンを作成する

Rollbar でプロジェクトを開き、read スコープのプロジェクトアクセストークンを作成(またはコピー)します。アイテムを更新させたい場合は write スコープのトークンも追加してください。トークンと設定の詳細については Rollbar の MCP Server Setup を参照してください。
2

CloudThinker で接続を追加する

Connections → Rollbar に移動して以下を入力します。
  • Project config (JSON): projects 配列。各 Rollbar プロジェクトのエントリに nametoken を記載する
Connect をクリックします。CloudThinker が認証情報を検証し、Connected ステータスを表示します。

接続の詳細

フィールド説明
ROLLBAR_CONFIG_JSON各 Rollbar プロジェクトをアクセストークンにマッピングする projects 配列。各エントリに nametoken が含まれる以下参照
{
  "projects": [
    { "name": "backend",  "token": "tok_abc123" },
    { "name": "frontend", "token": "tok_xyz789" }
  ]
}
トークンフィールドは tokenaccess_token ではない)で、projects は配列です。フォーマットは Rollbar の MCP マルチプロジェクト設定に準拠しています。

必要な権限

読み取り操作(プロジェクト一覧、アイテム、上位エラー、デプロイ、バージョン、リプレイ)はread スコープのプロジェクトアクセストークンで機能します。アイテム更新にはwrite スコープのトークン および CloudThinker での明示的な承認が必要です。
最小権限の原則に従ってください。調査には読み取りスコープのトークンを使用し、エージェントがアイテム状態を更新する必要があるプロジェクトにのみ書き込みスコープのトークンを追加してください。

エージェントの機能

接続後、エージェントは設定されたプロジェクト全体でエラーの調査と対応を行えます。

読み取り機能

カテゴリエージェントができること
プロジェクト設定済みの Rollbar プロジェクトを一覧表示し、単一プロジェクトに自動スコープする
エラーアイテム現在のアクティブアイテムを一覧表示し、アイテムの詳細と発生シグナルを調査する
上位エラー最も影響の大きいエラーと現在の本番エラーの状態を表示する
デプロイプロジェクトごとの最近のデプロイをレビューする
リリースとバージョンバージョンコンテキストを取得し、リリースとエラーアクティビティを相関付ける
セッションリプレイ記録済みリプレイを持つアイテムのリプレイコンテキストを取得する

書き込み機能

カテゴリエージェントができること
アイテム更新アイテムの状態を変更する(例: 解決、ミュート)— 承認が必要
アイテム更新は実行前に明示的なユーザー承認が必要であり、プロジェクト、アイテム、希望する変更を指定する必要があります。

接続の確認

@alex list my Rollbar projects and show the current top errors

プロンプト例

@alex triage current Rollbar items and rank them by impact #recommend
@alex show the top errors that appeared after the latest deployment
@alex review recent deployments and correlate them with new error activity

トラブルシューティング

貼り付けたプロジェクト設定が無効な JSON か、リクエストされたプロジェクト名が含まれていないか、プロジェクトが期限切れのトークンにマッピングされています。アイテムやデプロイが「データなし」として扱う前に、まず設定済みプロジェクトを一覧表示してください。
複数のプロジェクトが設定されている場合に発生します。エージェントがクエリをスコープできるよう、プロンプトにプロジェクト名を指定してください(例: 「my-app の場合」)。
セッションリプレイコンテキストは記録済みリプレイを持つアイテムにのみ存在します。リプレイのないアイテムはリプレイデータを返しません。これは予期された動作であり、エラーではありません。
更新は承認ゲートであり、write スコープのトークンが必要です。そのプロジェクトのトークンに書き込みスコープがあることを確認し、プロンプトが表示されたらアクションを承認してください。

セキュリティ

  • 最小権限 — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
  • デフォルトで読み取り専用 — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
  • 認証情報のローテーション — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
  • オフボーディング時に失効 — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。
  • 最小権限のトークン — 調査には読み取りスコープのプロジェクトトークンを使用し、エージェントがアイテム状態を更新する必要があるプロジェクトにのみ書き込みスコープを追加してください。
  • ローテーション — プロジェクトアクセストークンを定期的にローテーションし、CloudThinker で更新してください。

関連情報

https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/datadog.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=e8382167f2a1eb1e00971b5f4d703d48

Datadog 接続

ログ、メトリクス、インシデント調査

承認

承認ゲートアクションの仕組み