github/sim
1
0
Fork 0
mirror of https://github.com/simstudioai/sim.git synced 2026-02-12 15:34:58 -05:00
Code Issues Packages Projects Releases Wiki Activity
Files
cb3618a104087fa62b7e6ecc7b98ed313dbffbd8
sim/apps/docs/content/docs/zh/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
14 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 | 是 | 组织的 slug |
| `projectSlug` | string | 否 | 按特定项目 slug 过滤问题（可选） |
| `query` | string | 否 | 用于过滤问题的搜索查询。支持 Sentry 搜索语法（例如，"is:unresolved"，"level:error"） |
| `statsPeriod` | string | 否 | 统计的时间范围（例如，"24h"，"7d"，"30d"）。如果未指定，默认为 24h。 |
| `cursor` | string | 否 | 用于检索下一页结果的分页游标 |
| `limit` | number | 否 | 每页返回的问题数量（默认：25，最大：100） |
| `status` | string | 否 | 按问题状态过滤：未解决、已解决、已忽略或已静音 |
| `sort` | string | 否 | 排序顺序：日期、新、频率、优先级或用户（默认：日期） |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `issues` | array | Sentry 问题列表 |
### `sentry_issues_get`
通过问题的 ID 检索特定 Sentry 问题的详细信息。返回完整的问题详情，包括元数据、标签和统计信息。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Sentry API 身份验证令牌 |
| `organizationSlug` | string | 是 | 组织的 slug |
| `issueId` | string | 是 | 要检索的问题的唯一 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `issue` | object | Sentry 问题的详细信息 |
### `sentry_issues_update`
通过更改状态、分配、书签状态或其他属性来更新 Sentry 问题。返回更新后的问题详情。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Sentry API 身份验证令牌 |
| `organizationSlug` | string | 是 | 组织的 slug |
| `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 | 是 | 组织的 slug |
| `cursor` | string | 否 | 用于获取下一页结果的分页游标 |
| `limit` | number | 否 | 每页返回的项目数量 \(默认: 25, 最大: 100\) |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `projects` | array | Sentry 项目列表 |
### `sentry_projects_get`
通过项目的 slug 检索特定 Sentry 项目的详细信息。返回完整的项目详情，包括团队、功能和配置。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Sentry API 身份验证令牌 |
| `organizationSlug` | string | 是 | 组织的 slug |
| `projectSlug` | string | 是 | 要检索的项目的 ID 或 slug |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `project` | object | 关于 Sentry 项目的详细信息 |
### `sentry_projects_create`
在组织中创建一个新的 Sentry 项目。需要一个团队来关联该项目。返回创建的项目详细信息。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Sentry API 身份验证令牌 |
| `organizationSlug` | string | 是 | 组织的 slug |
| `name` | string | 是 | 项目的名称 |
| `teamSlug` | string | 是 | 将拥有此项目的团队的 slug |
| `slug` | string | 否 | URL 友好的项目标识符（如果未提供，则根据名称自动生成） |
| `platform` | string | 否 | 项目的平台/语言（例如，javascript、python、node、react-native）。如果未指定，默认为 "other" |
| `defaultRules` | boolean | 否 | 是否创建默认的警报规则（默认值：true） |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `project` | object | 新创建的 Sentry 项目 |
### `sentry_projects_update`
通过更改名称、slug、平台或其他设置来更新 Sentry 项目。返回更新后的项目详细信息。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Sentry API 身份验证令牌 |
| `organizationSlug` | string | 是 | 组织的 slug |
| `projectSlug` | string | 是 | 要更新的项目的 slug |
| `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 | 是 | 组织的 slug |
| `projectSlug` | string | 是 | 要列出事件的项目的 slug |
| `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 | 是 | 组织的 slug |
| `projectSlug` | string | 是 | 项目的 slug |
| `eventId` | string | 是 | 要检索的事件的唯一 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `event` | object | 有关 Sentry 事件的详细信息 |
### `sentry_releases_list`
列出 Sentry 组织或项目的发布版本。返回包括版本、提交、部署信息和相关项目的发布详细信息。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Sentry API 身份验证令牌 |
| `organizationSlug` | string | 是 | 组织的 slug |
| `projectSlug` | string | 否 | 按特定项目 slug 筛选发布版本（可选） |
| `query` | string | 否 | 用于筛选发布版本的搜索查询（例如，版本名称模式） |
| `cursor` | string | 否 | 用于检索下一页结果的分页游标 |
| `limit` | number | 否 | 每页返回的发布版本数量（默认：25，最大：100） |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `releases` | array | Sentry 发布版本列表 |
### `sentry_releases_create`
在 Sentry 中创建一个新版本。版本是部署到环境中的代码版本。可以包含提交信息和相关项目。返回创建的版本详细信息。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Sentry API 身份验证令牌 |
| `organizationSlug` | string | 是 | 组织的 slug |
| `version` | string | 是 | 版本标识符 \(例如，"2.0.0"、"my-app@1.0.0" 或 git 提交 SHA\) |
| `projects` | string | 是 | 与此版本关联的项目 slug 的逗号分隔列表 |
| `ref` | string | 否 | 此版本的 Git 引用 \(提交 SHA、标签或分支\) |
| `url` | string | 否 | 指向版本的 URL \(例如，GitHub 版本页面\) |
| `dateReleased` | string | 否 | 部署版本时的 ISO 8601 时间戳 \(默认为当前时间\) |
| `commits` | string | 否 | 包含 id、repository \(可选\) 和 message \(可选\) 的提交对象 JSON 数组。例如：\[\{"id":"abc123","message":"修复错误"\}\] |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `release` | object | 新创建的 Sentry 版本 |
### `sentry_releases_deploy`
为特定环境中的 Sentry 版本创建一个部署记录。部署记录跟踪版本的部署时间和位置。返回创建的部署详细信息。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Sentry API 身份验证令牌 |
| `organizationSlug` | string | 是 | 组织的 slug |
| `version` | string | 是 | 部署的版本标识符 |
| `environment` | string | 是 | 部署版本的环境名称（例如，"production"，"staging"） |
| `name` | string | 否 | 此次部署的可选名称（例如，"Deploy v2.0 to Production"） |
| `url` | string | 否 | 指向部署的 URL（例如，CI/CD 管道 URL） |
| `dateStarted` | string | 否 | 部署开始时间的 ISO 8601 时间戳（默认为当前时间） |
| `dateFinished` | string | 否 | 部署完成时间的 ISO 8601 时间戳 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `deploy` | object | 新创建的部署记录 |
## 注意
- 类别: `tools`
- 类型: `sentry`
Reference in New Issue View Git Blame Copy Permalink