Files
sim/apps/docs/content/docs/ja/tools/sentry.mdx
Waleed 93e1c513b2 feat(i18n): update translations (#2120)
* feat(i18n): update translations

* fix build

---------

Co-authored-by: waleedlatif1 <waleedlatif1@users.noreply.github.com>
2025-11-25 21:35:15 -08:00

306 lines
18 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: Sentry
description: Sentryの問題、プロジェクト、イベント、リリースを管理
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="sentry"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}
[Sentry](https://sentry.io/)でエラー監視とアプリケーションの信頼性を強化しましょう — リアルタイムエラー追跡、パフォーマンス監視、リリース管理のための業界をリードするプラットフォームです。Sentryを自動化エージェントワークフローにシームレスに統合して、問題の監視、重要なイベントの追跡、プロジェクトの管理、およびすべてのアプリケーションとサービス全体でのリリースの調整を簡単に行うことができます。
Sentryツールを使用すると、以下のことが可能です
- **問題の監視とトリアージ**: `sentry_issues_list` 操作を使用して問題の包括的なリストを取得し、`sentry_issues_get` を通じて個々のエラーやバグに関する詳細情報を取得できます。メタデータ、タグ、スタックトレース、統計情報に即座にアクセスして、解決までの平均時間を短縮します。
- **イベントデータの追跡**: `sentry_events_list` と `sentry_events_get` を使用して特定のエラーとイベントインスタンスを分析し、エラーの発生とユーザーへの影響に関する深い洞察を提供します。
- **プロジェクトとチームの管理**: `sentry_projects_list` と `sentry_project_get` を使用してすべてのSentryプロジェクトを列挙・確認し、チームのコラボレーションと一元化された構成を確保します。
- **リリースの調整**: `sentry_releases_list`、`sentry_release_get` などの操作を使用して、コードベース全体でのバージョン追跡、デプロイメントの健全性、変更管理を自動化します。
- **強力なアプリケーションインサイトの獲得**: 高度なフィルターとクエリを活用して、未解決または優先度の高い問題を見つけ、時間の経過に伴うイベント統計を集計し、コードベースの進化に伴う回帰を追跡します。
Sentryの統合により、エンジニアリングチームとDevOpsチームは早期に問題を検出し、最も影響の大きいバグに優先順位を付け、開発スタック全体でアプリケーションの健全性を継続的に改善することができます。最新の可観測性、インシデント対応、リリースライフサイクル管理のためのワークフロー自動化をプログラムで調整し、ダウンタイムを削減してユーザー満足度を向上させます。
**利用可能な主要なSentry操作**:
- `sentry_issues_list`: 組織やプロジェクトのSentry課題を一覧表示し、強力な検索とフィルタリング機能を提供します。
- `sentry_issues_get`: 特定のSentry課題に関する詳細情報を取得します。
- `sentry_events_list`: 根本原因分析のために特定の課題に関連するイベントを列挙します。
- `sentry_events_get`: スタックトレース、コンテキスト、メタデータを含む個別イベントの詳細情報を取得します。
- `sentry_projects_list`: 組織内のすべてのSentryプロジェクトを一覧表示します。
- `sentry_project_get`: 特定のプロジェクトの設定と詳細を取得します。
- `sentry_releases_list`: 最近のリリースとそのデプロイメント状況を一覧表示します。
- `sentry_release_get`: 関連するコミットと課題を含む詳細なリリース情報を取得します。
アプリの健全性を積極的に管理する場合でも、本番環境のエラーをトラブルシューティングする場合でも、リリースワークフローを自動化する場合でも、Sentryは世界クラスの監視、実用的なアラート、シームレスなDevOps統合を提供します。エージェントワークフローから、エラー追跡、可観測性、リリース管理にSentryを活用することで、ソフトウェアの品質と検索の可視性を向上させましょう。
{/* MANUAL-CONTENT-END */}
## 使用方法
Sentryをワークフローに統合します。アプリケーション全体で課題の監視、プロジェクト管理、イベント追跡、リリース調整を行います。
## ツール
### `sentry_issues_list`
特定の組織、およびオプションで特定のプロジェクトのSentryから課題を一覧表示します。ステータス、エラー数、最終確認タイムスタンプなどの課題の詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラグ |
| `projectSlug` | string | いいえ | 特定のプロジェクトスラグで課題をフィルタリング(オプション) |
| `query` | string | いいえ | 課題をフィルタリングする検索クエリ。Sentryの検索構文をサポート「is:unresolved」、「level:error」 |
| `statsPeriod` | string | いいえ | 統計の期間「24h」、「7d」、「30d」。指定されない場合は24hがデフォルト |
| `cursor` | string | いいえ | 次のページの結果を取得するためのページネーションカーソル |
| `limit` | number | いいえ | ページごとに返す課題の数デフォルト25、最大100 |
| `status` | string | いいえ | 課題のステータスでフィルタリングunresolved、resolved、ignored、またはmuted |
| `sort` | string | いいえ | ソート順date、new、freq、priority、またはuserデフォルトdate |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `issues` | array | Sentryの問題一覧 |
### `sentry_issues_get`
IDによって特定のSentry問題に関する詳細情報を取得します。メタデータ、タグ、統計情報を含む問題の完全な詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラグ |
| `issueId` | string | はい | 取得する問題の一意のID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `issue` | object | Sentryの問題に関する詳細情報 |
### `sentry_issues_update`
ステータス、割り当て、ブックマーク状態、またはその他のプロパティを変更することでSentryの問題を更新します。更新された問題の詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラグ |
| `issueId` | string | はい | 更新する問題の一意のID |
| `status` | string | いいえ | 問題の新しいステータスresolved、unresolved、ignored、またはresolvedInNextRelease |
| `assignedTo` | string | いいえ | 問題を割り当てるユーザーIDまたはメール。割り当てを解除するには空の文字列を使用します。 |
| `isBookmarked` | boolean | いいえ | 問題をブックマークするかどうか |
| `isSubscribed` | boolean | いいえ | 問題の更新を購読するかどうか |
| `isPublic` | boolean | いいえ | 問題を公開表示するかどうか |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `issue` | object | 更新されたSentryの課題 |
### `sentry_projects_list`
Sentryの組織内のすべてのプロジェクトを一覧表示します。名前、プラットフォーム、チーム、設定などのプロジェクト詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラグ |
| `cursor` | string | いいえ | 次のページの結果を取得するためのページネーションカーソル |
| `limit` | number | いいえ | ページごとに返すプロジェクト数デフォルト25、最大100 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `projects` | array | Sentryプロジェクトのリスト |
### `sentry_projects_get`
スラグによって特定のSentryプロジェクトに関する詳細情報を取得します。チーム、機能、設定を含むプロジェクトの完全な詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラグ |
| `projectSlug` | string | はい | 取得するプロジェクトのIDまたはスラグ |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `project` | object | Sentryプロジェクトに関する詳細情報 |
### `sentry_projects_create`
組織内に新しいSentryプロジェクトを作成します。プロジェクトを関連付けるチームが必要です。作成されたプロジェクトの詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラッグ |
| `name` | string | はい | プロジェクトの名前 |
| `teamSlug` | string | はい | このプロジェクトを所有するチームのスラッグ |
| `slug` | string | いいえ | URL用のプロジェクト識別子提供されない場合は名前から自動生成されます |
| `platform` | string | いいえ | プロジェクトのプラットフォーム/言語javascript、python、node、react-native。指定されない場合、デフォルトは"other"になります |
| `defaultRules` | boolean | いいえ | デフォルトのアラートルールを作成するかどうかデフォルトtrue |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `project` | object | 新しく作成されたSentryプロジェクト |
### `sentry_projects_update`
名前、スラッグ、プラットフォームなどの設定を変更して、Sentryプロジェクトを更新します。更新されたプロジェクトの詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラッグ |
| `projectSlug` | string | はい | 更新するプロジェクトのスラッグ |
| `name` | string | いいえ | プロジェクトの新しい名前 |
| `slug` | string | いいえ | 新しいURL用のプロジェクト識別子 |
| `platform` | string | いいえ | プロジェクトの新しいプラットフォーム/言語javascript、python、node |
| `isBookmarked` | boolean | いいえ | プロジェクトをブックマークするかどうか |
| `digestsMinDelay` | number | いいえ | ダイジェスト通知の最小遅延(秒単位) |
| `digestsMaxDelay` | number | いいえ | ダイジェスト通知の最大遅延(秒単位) |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `project` | object | 更新されたSentryプロジェクト |
### `sentry_events_list`
Sentryプロジェクトからイベントを一覧表示します。課題ID、クエリ、または期間でフィルタリングできます。コンテキスト、タグ、ユーザー情報などのイベント詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラグ |
| `projectSlug` | string | はい | イベントを一覧表示するプロジェクトのスラグ |
| `issueId` | string | いいえ | 特定の課題IDでイベントをフィルタリング |
| `query` | string | いいえ | イベントをフィルタリングする検索クエリ。Sentryの検索構文をサポート"user.email:*@example.com" |
| `cursor` | string | いいえ | 次のページの結果を取得するためのページネーションカーソル |
| `limit` | number | いいえ | ページごとに返すイベントの数デフォルト50、最大100 |
| `statsPeriod` | string | いいえ | クエリの期間(例:"24h"、"7d"、"30d"。指定されない場合、デフォルトは90d |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `events` | array | Sentryイベントのリスト |
### `sentry_events_get`
IDによって特定のSentryイベントの詳細情報を取得します。スタックトレース、パンくずリスト、コンテキスト、ユーザー情報などの完全なイベント詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラグ |
| `projectSlug` | string | はい | プロジェクトのスラグ |
| `eventId` | string | はい | 取得するイベントの一意のID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `event` | object | Sentryイベントに関する詳細情報 |
### `sentry_releases_list`
Sentryの組織またはプロジェクトのリリース一覧を取得します。バージョン、コミット、デプロイ情報、関連プロジェクトなどのリリース詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラグ |
| `projectSlug` | string | いいえ | 特定のプロジェクトスラグでリリースをフィルタリング(オプション) |
| `query` | string | いいえ | リリースをフィルタリングする検索クエリ(例:バージョン名パターン) |
| `cursor` | string | いいえ | 次のページの結果を取得するためのページネーションカーソル |
| `limit` | number | いいえ | ページごとに返すリリース数デフォルト25、最大100 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `releases` | array | Sentryリリースのリスト |
### `sentry_releases_create`
Sentryで新しいリリースを作成します。リリースとは、環境にデプロイされたコードのバージョンです。コミット情報や関連プロジェクトを含めることができます。作成されたリリースの詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラッグ |
| `version` | string | はい | リリースのバージョン識別子(例:"2.0.0"、"my-app@1.0.0"、またはgitコミットSHA |
| `projects` | string | はい | このリリースに関連付けるプロジェクトスラッグのカンマ区切りリスト |
| `ref` | string | いいえ | このリリースのGitリファレンスコミットSHA、タグ、またはブランチ |
| `url` | string | いいえ | リリースを指すURLGitHubリリースページ |
| `dateReleased` | string | いいえ | リリースがデプロイされた日時のISO 8601タイムスタンプデフォルトは現在時刻 |
| `commits` | string | いいえ | id、repositoryオプション、messageオプションを持つコミットオブジェクトのJSON配列。例\[\{"id":"abc123","message":"Fix bug"\}\] |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `release` | object | 新しく作成されたSentryリリース |
### `sentry_releases_deploy`
特定の環境でSentryリリースのデプロイ記録を作成します。デプロイは、リリースがいつどこにデプロイされたかを追跡します。作成されたデプロイの詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラグ |
| `version` | string | はい | デプロイされるリリースのバージョン識別子 |
| `environment` | string | はい | リリースがデプロイされる環境名(例:"production"、"staging" |
| `name` | string | いいえ | このデプロイのオプション名(例:"Deploy v2.0 to Production" |
| `url` | string | いいえ | デプロイを指すURLCI/CDパイプラインURL |
| `dateStarted` | string | いいえ | デプロイが開始された時刻のISO 8601タイムスタンプデフォルトは現在時刻 |
| `dateFinished` | string | いいえ | デプロイが完了した時刻のISO 8601タイムスタンプ |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `deploy` | object | 新しく作成されたデプロイレコード |
## 注意事項
- カテゴリー: `tools`
- タイプ: `sentry`