Table of contents
Using git metadata
The CLI can attach git metadata like branch, commit sha, owner and more when executing the test --record and deploy commands. This way you can keep track of
your test sessions and deployed resources in the UI and cross-reference them with any updates to your code.
For example, in the screenshot below we ran a test session from our CI server after the project was deployed to our
Staging environment with the npx checkly test --record command.
After the test succeeds, we deploy this check so it runs as a monitor with npx checkly deploy.
Environment variables
The CLI will attempt to auto-detect and parse git specific information from your local machine or CI environment, but you can also set these data items specifically by using environment variables.
| item | auto | variable | description |
|---|---|---|---|
| Repository | false | repoUrl in checkly.config.ts or CHECKLY_REPO_URL |
The URL of your repo on GitHub, GitLab etc. |
| Commit hash | true | CHECKLY_REPO_SHA |
The SHA of the commit. |
| Branch | true | CHECKLY_REPO_BRANCH |
The branch name. |
| Commit owner | true | CHECKLY_REPO_COMMIT_OWNER |
The committer’s name or email. |
| Commit message | true | CHECKLY_REPO_COMMIT_MESSAGE |
The commit message. |
| Environment | false | CHECKLY_TEST_ENVIRONMENT |
The environment name, e.g. “staging” |
For example, if you want to specifically set the Environment you invoke:
CHECKLY_TEST_ENVIRONMENT=Production npx checkly test --record
Or, if you want to set repo URL you invoke:
CHECKLY_REPO_URL="https://my.git.solution/project/" npx checkly test --record
Dynamic monitor creation
Last updated on November 5, 2024. You can contribute to this documentation by editing this page on Github