什么是 sentry-cli?
sentry-cli 是 Sentry 的命令行工具,它提供了一种简单的方式来与 Sentry 进行交互。因此你可以在你的 CI/CD 或者本地构建过程中使用它来上传你的 sourcemaps 或者其他任何的数据到 Sentry。
安装
你可以通过以下两种方式来安装 sentry-cli。
- 全局安装
npm install -g @sentry/cli
- 项目内安装
npm install @sentry/cli --save-dev
登录 Sentry
在使用 sentry-cli 前,你需要先登录 Sentry:
sentry-cli login
会提示你输入 Sentry 的登录邮箱和密码以及你组织在 Sentry 上的名字。
使用
sentry-cli 支持很多操作,包括上传 sourcemaps、创建 release、上传 dSYM 等。下面以上传 sourcemaps 为例,介绍使用方法。
- 创建新项目
在 Sentry 上创建一个新的项目并记住它的 slug
或者项目的 id
。
- 创建 release
在本地的代码库中使用 sentry-cli 创建一个 release。release 用于标识一个版本的代码发布。release 可以是一个版本号,或者一个 git 的 commit,或者是其他一些你为你的发布流程选择的标识符。
可以指定一个或多个文件或者文件夹作为需要上传的 sourcemaps,上传的 sourcemaps 根据项目中的 sourceMappingURL 注释自动关联到对应的出错文件。
sentry-cli releases new <version> sentry-cli releases files <version> upload-sourcemaps <path>
若要指定项目的 slug
:
sentry-cli releases new -p <slug> <version> sentry-cli releases files <version> upload-sourcemaps <path> --project <slug>
- 错误报告
现在,如果你在你的产品中发现了 bug,那么你可以使用 sentry 客户端库来报告错误。
示例代码:
-- -------------------- ---- ------- -- -- ------ -------- ------ - -- ------ ---- ------------------ ------------- ---- ----------- -------- --------------- --- -- ------ -------- ------------ - ----- --- ------------ ------------ - --- - ------------- - ----- ------- - ------------------------------- -
- 查看上传记录
如果你想查看哪些 sourcemaps 已经被上传并且是成功的,你可以使用如下命令:
sentry-cli releases files <version> list-sourcemaps
结语
本文介绍了如何使用 sentry-cli 工具来上传 sourcemaps 到 Sentry,以及如何使用 Sentry 的客户端库来报告错误。Sentry 是一个非常好用的错误追踪和日志记录工具,它可以帮助我们快速定位和解决问题。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/600559cb81e8991b448d7510