Checkly CLI 监控即代码
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/checkly-cli-monitoring-as-code-for-api-and-browser-checks。
技能介绍
当合成监控被困在 UI 里
API 和浏览器检查是发现线上故障的好手段,但很多团队的监控配置仍散落在 Web 控制台的点击操作中。结果是:配置难以版本化、代码评审缺失、CI 里跑的 Playwright 测试和线上监控逻辑逐渐分叉。等到需要为多环境批量复制检查、或把监控变更纳入 review 流程时,手工配置就成了明显的瓶颈。
这个技能做了什么
Checkly CLI 把合成监控的定义、测试和部署都拉回代码仓库,核心能力包括:
- 从 JavaScript 或 TypeScript 代码库中以代码方式声明 API 检查和浏览器(Playwright)检查
- 使用
npx checkly test在本地机器或 CI 流水线中先跑一遍检查,验证行为是否符合预期 - 通过
npx checkly deploy将检查部署到 Checkly 云端,也可以借助 Private Locations 在自有网络内执行 - 支持
npx checkly login登录和npm create checkly@latest快速初始化项目
典型工作流是:在代码库中定义检查 → CI 中执行 npx checkly test 做验证 → 通过后部署上线。监控配置因此与 Playwright 测试、API 检查和 CI 工作流放在同一个版本控制之下,而不是游离于 UI 之外。
适用边界与注意点
- 使用前需要准备
npm环境,如果涉及多语言技术栈,还需按需准备pip、go、java等运行时 test和deploy是两个独立步骤,建议在 CI 中先 test 再 deploy,避免未经验证的检查直接上线- 部署目标可以是 Checkly 云,也可以是自有网络内的 Private Locations,选型时需要考虑网络可达性
- 该技能适合「监控即代码」的场景:如果你的检查逻辑需要与代码评审、分支策略和 CI 深度绑定,CLI 方式更合适;如果只是少量临时探测,UI 操作依然够用
更多细节见 Checkly CLI 文档。
使用场景
- 代码评审需要审查 API 检查逻辑时,从代码库运行 npx checkly test 验证行为
- CI 流水线合并前用 npx checkly test 验证浏览器与 API 检查是否符合预期
- 需要把检查部署到 Checkly 云端时执行 npx checkly deploy
- 在自有网络用 Private Locations 运行浏览器检查时配置执行位置
适合人员
- 维护合成监控的 DevOps 工程师,希望检查配置随代码仓库版本化
- 编写 Playwright 测试的 QA 工程师,希望浏览器检查与测试共享同一套定义
- 把 API 监控接入 CI 的后端工程师,希望合并前自动运行检查
- 管理 Private Locations 的运维工程师,希望在自有网络内部署执行环境