ragog/checkly-citi-cli

Checkly Monitoring-as-code: Advanced Project

This example project shows how you can use the Checkly CLI in a Monitoring-as-Code (MaC) workflow. We are using the https://checklyhq.com website as a monitoring target.

1. Write API Checks and Playwright-powered Browser Checks!
2. Add alert channels, a run schedule and any global regions.
3. Test -> Deploy: now you have your app monitored around the clock. All from your code base.

npm create @checkly/cli -- --template advanced-project

Project Structure

This project mimics a typical app where you organize code with top-level defaults and per page, service or component checks.

.
|-- _github
|   `-- workflow.yml
|-- checkly.config.ts
|-- package.json
`-- src
    |-- __checks__
    |   |-- 404.spec.ts
    |   |-- group.check.ts
    |   |-- home.check.ts
    |   `-- homepage.spec.ts
    |-- alert-channels.ts
    |-- defaults.ts
    `-- services
        |-- api
        |   `-- api.check.ts
        `-- docs
            `-- __checks__
                `-- docs-search.spec.ts

• Running npx checkly test will look for .check.ts files and .spec.ts in __checks__ directories and execute them in a dry run.

• Running npx check deploy will deploy your checks to Checkly, attach alert channels, and run them on a 10m schedule in the region us-east-1 and eu-west-1

• An example GitHub Actions workflow is in the _github/workflow.yml file. It triggers all the checks in the project and deploys them if they pass.

CLI Commands

Run the core CLI commands with npx checkly <command>

Command	Action
npx checkly test	Dry run all the checks in your project
npx checkly deploy	Deploy your checks to the Checkly cloud
npx checkly login	Log in to your Checkly account
npx checkly --help	Show help for each command.

Questions?

Check our CLI docs, the main Checkly docs or join our Slack community