Changelog
Stay up to date with new features, improvements, and fixes.
Get this delivered straight to your inbox. Prefer a feed? Subscribe via RSS
Detailed release notes
The new checkly-action runs checkly test or checkly trigger straight from your workflow, with detached test sessions and results reported through GitHub Checks. Gate pull requests on Checkly results without burning Actions minutes waiting for runs to finish.
- uses: checkly/checkly-action@v1
with:
command: test
✓ 12 checks passed · reported via GitHub ChecksThree new monitor types, now available to everyone: check gRPC endpoints, catch expiring certificates, and trace network paths. Create and manage them from the web app, API, CLI, or your Monitoring as Code setup, with detailed assertions and diagnostics.
Playwright Check Suites now collect six Web Vitals for every page your tests visit — LCP, CLS, INP, FCP, TTFB, and TBT, scored against the web.dev thresholds. No changes to your tests needed: metrics show up per page visit in the same result view you already use for functional failures, and each LCP and INP score expands into a breakdown of where the time went.
Every status page now exposes RSS and Atom feeds, and incident updates can flow straight into a Slack channel. Subscribers get incidents where they already work instead of refreshing a status page.
granularity and timezone options.--preserve-resources; destructive deletions now ask for confirmation.checkly checks run, with table, Markdown, or JSON output.The first version of the Checkly MCP Server is live. Point your AI client at the server URL and manage your monitoring from any MCP-capable agent — setup instructions per client are in the docs.
https://api.checklyhq.com/mcpNo more digging through nested check-result JSON. checkly assets list and checkly assets download pull the artifacts of any check run or test session — logs, Playwright traces, videos, screenshots, reports — into your local folder.
Rename tags everywhere they are used, delete unused or misspelled ones, and add tag descriptions that give Rocky AI extra context for root cause analyses. Available in the UI under Configuration.
Install the Checkly Slack app to receive alerts and rerun checks or AI analyses directly from Slack. It replaces webhook-based Slack alerts and comes with a new CLI construct.
--cancel-in-progress-deployment to take over a running deploy.checkly test-sessions get <id> --result <result-id>.checkly checks delete, and manage account members with checkly account members update / delete.Rocky AI's root cause analysis now takes in two extra artifacts to determine why a check failed. It pulls in the last passing result for a failing check and diffs it against the failure to spot obvious regressions, and if you have Checkly Traces enabled, it pulls in relevant OpenTelemetry traces to correlate downstream errors with the failing check result.
CLI 8 ships three major changes: it is ESM-only (Node.js ^20.19.0 or >=22.12.0), CTRL+C now cancels test, pw-test, and trigger runs instead of burning quota in the background, and runs record by default unless you pass --no-record. Use -d for detached mode when you want a run to keep going.
npm i -D checkly@latestA batch of reliability work: cancellable queued and in-progress runs, custom runtime engines (Bun 1.7, Node.js 22/24/26), automatic retries for setup steps hit by transient network issues, browser caching in Private Locations, and full Playwright globalTimeout support.
See queue duration, agent count, and scheduled check runs for your Private Locations right in the UI — and spot over- or underprovisioned agents at a glance. The same metrics are available via Prometheus, so you can autoscale agents on Kubernetes with KEDA.
Use {{MY_SECRET_VAR}} syntax in alert channel configs, so API keys and other sensitive values no longer live in plain text in the UI or API responses. Convert existing values with the new lock icon.
swagger.json is deprecated and frozen — use the OpenAPI spec at api.checklyhq.com/openapi.json instead.Playwright Check Suite runs are now cancellable. You can stop queued or in-progress runs from the Playwright Check Suite Runs or Test Session Run pages, or press CTRL+C on Checkly CLI 8.0.0 and later. This works for runs started from Schedule now and for test sessions triggered via npx checkly test, npx checkly pw-test, and npx checkly trigger; cancelled runs show a Cancelled status in your run history.
Playwright Check Suites now support multiple Node.js and Bun engines, configurable from the UI or in code. Starting with Checkly CLI 8.1.0, the CLI reads your project's version files (.nvmrc, .node-version, .bun-version) and selects a compatible runtime automatically, with Node.js 22 (default), 24, and 26 and Bun 1.3 supported. You can override detection by setting the engine property on your PlaywrightCheck, for example engine: Engine.node('24').
Check Suites now cache Playwright browsers across runs on the same Private Location agent, so the installation step is skipped entirely when a cached version exists. That means faster startup, no repeated downloads, and lower bandwidth usage, with zero configuration required. Caching is scoped per agent and available since Private Location agent version 8.2.0.
globalTimeout is now fully supported: set it in playwright.config.ts or via --global-timeout in your testCommand, and timeout errors now appear in logs and the Failures tab.pnpm install, Corepack, dependency cache downloads) now retry automatically with backoff, no configuration needed.The Checkly CLI is now distributed as ESM only instead of CommonJS, and CLI 8 requires Node.js ^20.19.0 || >=22.12.0. Make sure your local development, CI, and deployment environments run a compatible Node.js version before upgrading; your own projects can still use CommonJS. The CLI also switches its TypeScript loader from ts-node to jiti, which is now bundled as a direct dependency.
npm install checkly@latestPressing CTRL+C during test, pw-test, or trigger now cancels in-flight test sessions instead of leaving them running in the background. If you want the previous keep-running-in-the-cloud behavior, run in detached mode with --detach or -d.
The test and trigger commands now record results by default. To disable recording, pass --no-record; if your scripts relied on recording being off by default, update them before upgrading.
engine property to override detection..env file when present; set CHECKLY_NO_DOTENV=1 to disable it.include patterns now resolve relative to your Playwright config file's directory instead of the project root, matching Playwright's own behavior.checkly rca run now supports --test-session-error-group (-te) to trigger a Root Cause Analysis on Test Session Error Groups.The old API spec at api.checklyhq.com/swagger.json is deprecated and frozen. Use the newer OpenAPI spec at api.checklyhq.com/openapi.json instead. The old file remains available for compatibility, but now carries a deprecation notice in its description and response headers.
Failing assertions on API, URL, DNS, ICMP, and TCP checks now produce individual error messages in Error Groups, instead of being consolidated under a generic "1 of 3 assertions failed". This means Rocky AI root cause analysis triggers when a genuinely new assertion failure surfaces, rather than staying silent because the failures looked alike. Live for all users on all plans.
The new checkly init command sets up Checkly Skills, provides a prompt tailored to your project, and one-shots your monitoring suite with Claude Code, Codex, Cursor, or any other agent of your choosing.
# From ~/path/to/my-unmonitored-project/
npx checkly initThe new runtime is available for Browser and Multistep checks, with upgraded Node.js and Playwright versions and updated built-in dependencies. Upgrade from your account settings; Private Location support starts with agent v7.
Run suites on Bun from CLI 7.11.0 onwards. Custom package manager versions are respected down to the patch version, dependency caches upload only on successful runs and invalidate automatically when your lockfile changes, and all four package managers show detailed install logs.
checkly rca run and checkly rca get.--preserve-resources for destroy, and force fresh dependency installs with --refresh-cache.npx playwright test runs (Reporter 1.10+).Runtime 2026.04 brings Playwright v1.58.2 and Node.js v24.13.1 to Browser and MultiStep Checks. Head to Account settings > Runtimes to select it or make it your default; the runtime documentation lists the full spec with all 67 included packages.
We added axios-cookiejar-support, csv-parse, imapflow, mysql2, pdf-parse, tough-cookie, and winston to the runtime, covering persistent cookie handling, CSV parsing, IMAP inbox monitoring, a modern MySQL client, PDF text extraction, and structured logging. We also removed jsdom; for DOM interactions, use Playwright's built-in Page APIs instead.
Checkly now supports ICMP monitors on all plans, letting you continuously ping hosts to measure reachability, latency, and packet loss across regions. This helps teams detect connectivity issues early and understand network performance before it impacts their applications.
Rocky AI, Checkly's AI agent, is now generally available on all plans. Its automated Root Cause Analysis analyzes failing checks and tests, investigates artifacts like traces and PCAP files, and summarizes the likely root cause so teams can debug issues faster.
The Checkly Playwright Reporter got a major overhaul. It now captures richer debugging data from Playwright runs, including traces, logs, network activity, and performance metrics, making it easier to debug CI failures without digging through artifacts.
The Checkly CLI is now built for AI agents. Across v7.3.0 to v7.7.0 we shipped a skills-based self-discovery system via npx checkly skills, read-only commands to list and inspect checks, full incident lifecycle management from the terminal, and a confirmation protocol for safe agent-driven write operations. Recent additions include analytics stats from the terminal, a built-in checkly skills install command, and checkly account plan to let agents understand your plan's features.
checkly_check_group_v2 resource./-/liveness, /-/readiness, /health) for liveness and readiness probes, and the UI now shows connected agents with their image version.We added a Copy prompt button to the Playwright Check Suites onboarding. Paste the prompt into your AI coding tool (Claude Code, Cursor, Copilot) in the context of your repo: it reads your Playwright setup (projects, test files, base URLs, dependencies), generates check suite definitions grouped by project and tags, iterates until the config looks right, and deploys once you are ready. You get a working checkly.config.ts without writing one from scratch.
The same copy-paste flow works for Test Sessions and Playwright Reporter setup, with a different prompt for each.
The Checkly Playwright Reporter runs alongside your Playwright tests, captures execution data (logs, traces, network activity, console output, performance metrics), and uploads it to Checkly so your team can debug runs without digging through CI artifacts or trace files. It works locally and in CI, and now automatically scrubs sensitive values from reports and trace files, with full control via scrubbing options like envVars, autoDetect, and replacement.
Install the reporter, export CHECKLY_API_KEY and CHECKLY_ACCOUNT_ID, add createChecklyReporter() to the reporter list in your playwright.config.ts, and run npx playwright test. Then open the run in Checkly to explore traces, logs, network requests, console output, and performance data.
npm install --save-dev @checkly/playwright-reporter[project] indicators while tests run, plus a per-project breakdown in your terminal with deep links to traces and full results in Checkly.ICMP monitors are now available on all plans. They continuously ping your hosts with ICMP Echo Requests to measure reachability, latency, and packet loss across regions, so you can verify that hosts not exposed to the public internet stay reachable, catch network-level outages early, and compare latency geographically. Set your ping count and packet loss thresholds, and optionally add assertions on latency or packet loss.
ICMP monitors work in Checkly's Monitoring as Code workflows via the IcmpMonitor construct, available in the CLI from v7.1.0. Terraform support ships in provider v1.18.0 with the checkly_icmp_monitor resource; Pulumi (v2.8.0) is not yet supported.
Rocky AI, Checkly's AI agent, automatically analyzes, categorizes, and summarizes failures from your monitors and synthetic checks. You can now receive a root cause analysis directly in your inbox, Slack, Teams, or any other alert channel the moment a check fails. This is live for all plans; enable it in the Rocky AI settings.
Playwright Check Suites now detect pnpm and npm workspace structures and install the correct dependencies automatically, resolve package.json exports during bundling, and support .tsx and .jsx files. npx checkly pw-test is now GA with new --installCommand and --include flags, checks install all dependencies from your package.json (not just devDependencies), and the dependency cache refreshes automatically when your install command or working directory changes.
Dashboard charts now display data based on the selected time range, so all checks on a dashboard share the same timeline, making it easier to compare results across services. Group names now appear next to check names where applicable, and you can save dashboard views based on your filters and search; saved views are personal and shareable via URL.
The Checkly Agent now exposes /-/readiness, /-/liveness, and /health endpoints on port 8080 for Kubernetes readiness and liveness probes. The agent also sends a heartbeat to the Checkly platform every 2 minutes with built-in retry logic, so Checkly can detect when a private location has no connected agents and notify your team via email, and a /metrics endpoint exposes agent-level Prometheus metrics like check slot utilization and job processing duration.
Playwright Check Suites now work with monorepos. If your project uses pnpm or npm workspaces, Checkly detects your workspace structure, uploads the relevant files, and installs the correct dependencies automatically, with no extra configuration. Shared utility packages are detected and included, workspace:* dependencies resolve correctly, and only the files and workspace packages your check suite needs are uploaded, not your entire repo.
Workspace support is available starting with Checkly CLI v7.1. Update to the latest version, or run npm create checkly@latest if you are new to Checkly and prefer a guided setup.
npm install checkly@latestRocky, Checkly's AI agent, can now analyze and triage failures for all uptime monitors and synthetic check types, including trace routes, packet captures, and other artifacts generated during a check run. You get error classification (code typo or infrastructure error), user impact (which user groups or features are affected), and root cause with supporting evidence and, where possible, a simple code fix.
A new dev variant of the Private Location agent image is designed for checks that rely on npm packages with native dependencies requiring compilation. It works the same way as the standard agent but includes the build tools needed to compile native modules, and is available starting with version 6.3.0.
checkly/agent-dev:X.Y.ZRead & Run is a new role for users who need to run checks and tests without being able to change configuration. Members with this role can view all resources and manually trigger checks via the UI, API, or CLI, while deployments and config changes stay locked down.
pcapDataUrl for packet captures on network errors (API checks only).Older editions and release posts, in full on their own pages.
DNS monitors are here · Error Groups for Test Sessions · Playwright Reporter (Beta) · Playwright Check Suites updates
Fresh Check Overview with Error Groups · TCP dumps and traceroute reports · Meet pw-test: Playwright tests, now in Checkly · Check session trigger API
Checkly Uptime Monitoring is live · Deploy the Checkly Agent on Kubernetes with Helm · Network retries for API checks and URL monitors
Move your setup to code with checkly import · Checkly AI: root cause, domain knowledge, and bring your own model · Group overrides are now optional
Checkly AI: Playwright Impact Analysis and Error Explainer in beta · Playwright Check Suites alpha · 1-second API check frequency · A sidebar that scales
Checkly Status Pages are here · Vercel Observability Marketplace launch · Dark Mode is now available · Multi-Factor Authentication
TCP checks generally available · Checkly CLI 5.0.1 · Pulumi provider update
Checkly Traces are GA · TCP checks in open beta · Improved code imports
Searchable tags in the dashboard · Public API: check results endpoint v2 · No more "reload this app to get updates"