mcpField
S
sentry-automation

sentry-automation

github.com/composiohq開発78.3k68 回インストール14 週間前に更新
リポジトリ

sentry-automation について

sentry-automationは、Rube MCP上のComposio SentryツールキットでSentryのエラー追跡と監視のワークフローを自動化するスキルです。問題調査、アラート、リリース、組織データ、Cron監視を扱います。

主な機能

  1. 01問題とイベントの検索・確認
  2. 02プロジェクトの問題一覧と詳細確認
  3. 03アラートルールの作成と更新
  4. 04リリースの作成とデプロイ記録
  5. 05組織、チーム、メンバー情報の確認
  6. 06Cron監視設定の更新

活用シーン

  1. 01未解決エラーとイベントのスタックトレース調査
  2. 02プロジェクトまたは組織のアラート設定
  3. 03リリースとデプロイの追跡
  4. 04Cron監視のスケジュールと実行時間上限の調整

MCP 対応

Rube MCPとComposioのSentryツールキットを介して、MCPクライアントにSentry操作を提供します。Sentryの有効な接続が必要です。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/composiohq/awesome-claude-skills --skill sentry-automation

インストール後、Claude Code で/sentry-automationを入力して読み込まれたか確認します。

詳細

Rube MCP による Sentry の自動化

Rube MCP 経由で Composio の Sentry ツールキットを利用して、Sentry のエラー追跡と監視の操作を自動化します。

ツールキットのドキュメント：composio.dev/toolkits/sentry

前提条件

  • Rube MCP が接続されていること（RUBE_SEARCH_TOOLS が利用可能であること）
  • ツールキット sentry を指定して RUBE_MANAGE_CONNECTIONS 経由で有効な Sentry 接続があること
  • 最新のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

Rube MCP の取得：クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要です。エンドポイントを追加するだけで動作します。

  1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを確かめます
  2. ツールキット sentry を指定して RUBE_MANAGE_CONNECTIONS を呼び出します
  3. 接続が ACTIVE でない場合は、返された認証リンクに従って Sentry OAuth を完了します
  4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

主なワークフロー

1. イシューの調査

使用する場面：エラーイシューを検索、調査、またはトリアージしたい場合

ツールの順序：

  1. SENTRY_LIST_AN_ORGANIZATIONS_ISSUES - 組織全体のイシューを一覧表示します［必須］
  2. SENTRY_GET_ORGANIZATION_ISSUE_DETAILS - 特定のイシューの詳細情報を取得します［任意］
  3. SENTRY_LIST_AN_ISSUES_EVENTS - イシューの個々のエラーイベントを表示します［任意］
  4. SENTRY_RETRIEVE_AN_ISSUE_EVENT - スタックトレースを含むイベントの詳細を取得します［任意］
  5. SENTRY_RETRIEVE_ISSUE_TAG_DETAILS - イシューのタグの分布を調べます［任意］

主なパラメーター：

  • organization_id_or_slug：組織の識別子
  • issue_id：数値のイシュー ID
  • query：検索クエリ（例：is:unresolved、assigned:me、browser:Chrome）
  • sort：並べ替え順（date、new、freq、priority）
  • statsPeriod：統計の対象期間（24h、14d など）

注意点：

  • organization_id_or_slug は組織のスラッグです（例：'my-org'）。表示名ではありません
  • イシュー ID は数値です。UUID であるイベント ID と混同しないでください
  • クエリ構文には Sentry の検索形式を使います：is:unresolved、assigned:me、!has:release
  • イシュー内のイベントごとにスタックトレースが異なる場合があります。詳細を確認するには個々のイベントを調べてください
2. プロジェクトのイシューを管理する

使用する場面：特定のプロジェクトに絞ったイシューを表示したい場合

ツールの順序：

  1. SENTRY_RETRIEVE_ORGANIZATION_PROJECTS - プロジェクトを一覧表示し、プロジェクトのスラッグを確認します［前提条件］
  2. SENTRY_RETRIEVE_PROJECT_ISSUES_LIST - 特定のプロジェクトのイシューを一覧表示します［必須］
  3. SENTRY_RETRIEVE_ISSUE_EVENTS_BY_ID - 特定のイシューのイベントを取得します［任意］

主なパラメーター：

  • organization_id_or_slug：組織の識別子
  • project_id_or_slug：プロジェクトの識別子
  • query：検索フィルター文字列
  • statsPeriod：統計の対象期間

注意点：

  • プロジェクトのスラッグはプロジェクトの表示名とは異なります
  • RETRIEVE_ORGANIZATION_PROJECTS を使って、必ず先にプロジェクト名をスラッグに解決してください
  • プロジェクト単位のイシュー一覧では、組織単位の一覧とページネーションが異なる場合があります
3. アラートルールを設定する

使用するタイミング：ユーザーがプロジェクトのアラートルールを作成または管理したい場合

ツールの手順：

  1. SENTRY_RETRIEVE_ORGANIZATION_PROJECTS - アラート対象のプロジェクトを探します［前提条件］
  2. SENTRY_RETRIEVE_PROJECT_RULES_BY_ORG_AND_PROJECT_ID - 既存のルールを一覧表示します［任意］
  3. SENTRY_CREATE_PROJECT_RULE_FOR_ALERTS - 新しいアラートルールを作成します［必須］
  4. SENTRY_CREATE_ORGANIZATION_ALERT_RULE - 組織レベルのメトリクスアラートを作成します［代替手段］
  5. SENTRY_UPDATE_ORGANIZATION_ALERT_RULES - 既存のアラートルールを更新します［任意］
  6. SENTRY_RETRIEVE_ALERT_RULE_DETAILS - 特定のアラートルールを確認します［任意］
  7. SENTRY_GET_PROJECT_RULE_DETAILS - プロジェクトレベルのルールの詳細を取得します［任意］

主なパラメーター：

  • name：アラートルール名
  • conditions：トリガー条件の配列
  • actions：トリガー時に実行するアクションの配列
  • filters：イベントフィルターの配列
  • frequency：トリガーの頻度（分単位）
  • actionMatch：条件の照合方法を指定する 'all'、'any'、または 'none'

注意点：

  • プロジェクトレベルのルール（CREATE_PROJECT_RULE）と組織レベルのメトリクスアラート（CREATE_ORGANIZATION_ALERT_RULE）は別のものです
  • 条件、アクション、フィルターでは特定の JSON スキーマを使用します。有効な型については Sentry のドキュメントを確認してください
  • frequency は分単位です。値を低くしすぎるとアラート疲れの原因になります
  • actionMatch のデフォルト値は異なる場合があります。予期しない動作を避けるため、明示的に設定してください
4. リリースを管理する

使用するタイミング：ユーザーがリリースバージョンを作成、追跡、または管理したい場合

ツールの手順：

  1. SENTRY_LIST_ORGANIZATION_RELEASES - 既存のリリースを一覧表示します［任意］
  2. SENTRY_CREATE_RELEASE_FOR_ORGANIZATION - 新しいリリースを作成します［必須］
  3. SENTRY_UPDATE_RELEASE_DETAILS_FOR_ORGANIZATION - リリースのメタデータを更新します［任意］
  4. SENTRY_CREATE_RELEASE_DEPLOY_FOR_ORG - リリースのデプロイを記録します［任意］
  5. SENTRY_UPLOAD_RELEASE_FILE_TO_ORGANIZATION - ソースマップまたはファイルをアップロードします［任意］

主なパラメーター：

  • version：リリースのバージョン文字列（例：'1.0.0'、コミット SHA）
  • projects：このリリースに属するプロジェクトのスラッグの配列
  • dateReleased：リリースのタイムスタンプ（ISO 8601）
  • environment：デプロイ環境名（例：'production'、'staging'）

注意点：

  • リリースバージョンは組織内で一意である必要があります
  • リリースは複数のプロジェクトにまたがる場合があります。projects 配列を使用してください
  • リリースのデプロイは作成とは別の操作です。CREATE_RELEASE_DEPLOY を使用してください
  • ソースマップをアップロードするには、先にリリースが存在している必要があります
5. 組織とチームを監視する

使用するタイミング：ユーザーが組織の構成、チーム、またはメンバー一覧を確認したい場合

ツールの手順：

  1. SENTRY_GET_ORGANIZATION_DETAILS または SENTRY_GET_ORGANIZATION_BY_ID_OR_SLUG - 組織の情報を取得します［必須］
  2. SENTRY_LIST_TEAMS_IN_ORGANIZATION - すべてのチームを一覧表示します［任意］
  3. SENTRY_LIST_ORGANIZATION_MEMBERS - 組織のメンバーを一覧表示します［任意］
  4. SENTRY_GET_PROJECT_LIST - アクセス可能なすべてのプロジェクトを一覧表示します［任意］

主なパラメーター：

  • organization_id_or_slug：組織の識別子
  • cursor：大量の結果を取得する際のページネーションカーソル

注意点：

  • 組織のスラッグは URL で安全に使用できる識別子であり、表示名ではありません
  • メンバー一覧はページ分割される場合があります。カーソルによるページネーションに従ってください
  • チームとメンバーの表示可否は、認証されたユーザーの権限によって異なります
6. モニターを管理する（Cron 監視）

使用するタイミング：ユーザーが cron ジョブの監視設定を更新したい場合

ツールの手順：

  1. SENTRY_UPDATE_A_MONITOR - モニターの設定を更新します［必須］

主なパラメーター：

  • organization_id_or_slug：組織の識別子
  • monitor_id_or_slug：モニターの識別子
  • name：モニターの表示名
  • schedule：Cron スケジュール式または間隔
  • checkin_margin：チェックインが遅れた場合の猶予時間（分）
  • max_runtime：想定される最大実行時間（分）

注意点：

  • モニターのスラッグは名前から自動生成されます。API 呼び出しにはスラッグを使用してください
  • スケジュールの変更は直ちに反映されます
  • チェックインがない場合、猶予時間の経過後にアラートがトリガーされます

よくあるパターン

ID の解決

組織名 -> スラッグ：

1. Call SENTRY_GET_ORGANIZATION_DETAILS
2. Extract slug field from response

プロジェクト名 -> スラッグ：

1. Call SENTRY_RETRIEVE_ORGANIZATION_PROJECTS
2. Find project by name, extract slug
ページネーション
  • Sentry は Link ヘッダーを使用したカーソルベースのページネーションを採用しています
  • カーソル値をレスポンスで確認します
  • 次のページがなくなるまで、次のリクエストにカーソルを渡します
検索クエリの構文
  • is:unresolved - 未解決の課題
  • is:resolved - 解決済みの課題
  • assigned:me - 現在のユーザーに割り当てられた課題
  • assigned:team-slug - チームに割り当てられた課題
  • !has:release - リリースがない課題
  • first-release:1.0.0 - リリースで初めて検出された課題
  • times-seen:>100 - 100 回を超えて検出された課題
  • browser:Chrome - ブラウザータグで絞り込み

既知の注意点

ID の形式：

  • 組織：表示名ではなく、スラッグ（例：'my-org'）を使用します
  • プロジェクト：表示名ではなく、スラッグ（例：'my-project'）を使用します
  • 課題 ID：数値の整数
  • イベント ID：UUID（32 文字の 16 進数文字列）

権限：

  • API トークンのスコープは、実行する操作に適合している必要があります
  • 組織レベルの操作には、組織レベルの権限が必要です
  • プロジェクトレベルの操作には、プロジェクトへのアクセス権が必要です

レート制限：

  • Sentry は組織ごとのレート制限を適用します
  • 429 レスポンスを受け取った場合は、バックオフを実装します
  • 一括操作は時間をずらして実行してください

クイックリファレンス

タスクツールのスラッグ主なパラメーター
組織の課題を一覧表示SENTRY_LIST_AN_ORGANIZATIONS_ISSUESorganization_id_or_slug, query
課題の詳細を取得SENTRY_GET_ORGANIZATION_ISSUE_DETAILSorganization_id_or_slug, issue_id
課題のイベントを一覧表示SENTRY_LIST_AN_ISSUES_EVENTSissue_id
イベントの詳細を取得SENTRY_RETRIEVE_AN_ISSUE_EVENTorganization_id_or_slug, event_id
プロジェクトの課題を一覧表示SENTRY_RETRIEVE_PROJECT_ISSUES_LISTorganization_id_or_slug, project_id_or_slug
プロジェクトを一覧表示SENTRY_RETRIEVE_ORGANIZATION_PROJECTSorganization_id_or_slug
組織の詳細を取得SENTRY_GET_ORGANIZATION_DETAILSorganization_id_or_slug
チームを一覧表示SENTRY_LIST_TEAMS_IN_ORGANIZATIONorganization_id_or_slug
メンバーを一覧表示SENTRY_LIST_ORGANIZATION_MEMBERSorganization_id_or_slug
アラートルールを作成SENTRY_CREATE_PROJECT_RULE_FOR_ALERTSorganization_id_or_slug, project_id_or_slug
メトリクスアラートを作成SENTRY_CREATE_ORGANIZATION_ALERT_RULEorganization_id_or_slug
リリースを作成SENTRY_CREATE_RELEASE_FOR_ORGANIZATIONorganization_id_or_slug, version
リリースをデプロイSENTRY_CREATE_RELEASE_DEPLOY_FOR_ORGorganization_id_or_slug, version
リリースを一覧表示SENTRY_LIST_ORGANIZATION_RELEASESorganization_id_or_slug
モニターを更新SENTRY_UPDATE_A_MONITORorganization_id_or_slug, monitor_id_or_slug

Composio によって提供されています

コメント

Markdown 対応