> ## Documentation Index
> Fetch the complete documentation index at: https://checklyhq.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Checkly Agent Changelog

> Release history for the Checkly Agent

For major release announcements and summaries, see Checkly's [product changelog](https://feedback.checklyhq.com/changelog?c=Checkly+Agent), filtered by `Checkly Agent`.

Learn more about:

* updating to the latest version in
  [updating the agent container](/platform/private-locations/agent-configuration#updating-the-agent-container)
* supported runtimes for each agent version in
  [agent version and runtimes](/platform/private-locations/agent-configuration#agent-version-and-runtimes)

## Full release history

<Update label="v8.3.2" tags={["June 2026"]}>
  * Update vm2 dependency: 3.11.3 → 3.11.5
</Update>

<Update label="v8.3.1" tags={["May 2026"]}>
  * Fix a bug that prevented users of pnpm workspaces to run their PWCS on private locations in certain scenarios.
  * Test failures and setup errors are now surfaced in the user-visible log alongside the existing report.
</Update>

<Update label="v8.3.0" tags={["May 2026"]}>
  * Added support for cancelling running Playwright check suites
  * Playwright check suites can run in different NodeJs or Bun versions (22, 24, 26 or Bun 1.3)
</Update>

<Update label="v8.2.0" tags={["May 2026"]}>
  * Improved Playwright browsers installation
  * Playwright Check Suites now cache Playwright browsers across runs in the same Private Location Agent
  * Upgraded dependencies such as `vm2` 3.10.5 → 3.11.3 and `axios` 1.15.0 → 1.16.1
  * Patched Checkly's `markCheckAsDegraded` helper when used with soft assertions
</Update>

<Update label="v8.1.0" tags={["May 2026"]}>
  * [Global timeouts](https://playwright.dev/docs/test-timeouts#global-timeout) now apply and surface correctly in Playwright Check Suites
  * Improved scheduling for long-running Playwright Check Suites
</Update>

<Update label="v8.0.1" tags={["May 2026"]}>
  * Resolved several dependency vulnerabilities in the private location image
</Update>

<Update label="v8.0.0" tags={["April 2026"]}>
  Latest agent image with [runtime 2026.04](/platform/runtimes/runtime-specification/#2026-04) only.

  * Previous versions bundled two runtimes to support gradual upgrades
  * This could surface vulnerabilities from the older runtime in security scans
  * From v8 onward, only the latest runtime is included

  **Upgrade path**

  * Already on `2026-04`: upgrade directly
  * On older runtimes: use the [migration image](#v7-0-2) (`7.0.2-migrate-202409-202604`) to move to `2026-04`, then upgrade to v8
</Update>

<Update label="v7.0.3" tags={["April 2026"]}>
  Patches vulnerabilities in dependencies bundled with the [2026.04 runtime](/platform/runtimes/runtime-specification/#2026-04). Fix-forward updates only.

  Updated packages:

  * `@azure/identity` 4.13.0 → 4.13.1
  * `@clerk/testing` 1.14.2 → 1.14.3
  * `@opentelemetry/exporter-metrics-otlp-grpc` 0.212.0 → 0.215.0
  * `@xmldom/xmldom` 0.9.8 → 0.9.10
  * `axios` 1.13.5 → 1.15.0
  * `imapflow` 1.2.10 → 1.3.1
  * `lodash` 4.17.23 → 4.18.1
  * `prisma` 7.4.1 → 7.8.0
  * `protobufjs` 8.0.0 → 8.0.1
</Update>

<Update label="v7.0.2" tags={["April 2026"]}>
  * Includes security patches for runtime `2026-04`
  * Migration image (`7.0.2-migrate-202409-202604`) available: Bundles runtimes `2024-09`, `2025-04`, and `2026-04`, allowing you to upgrade from older runtimes to `2026-04`
</Update>

<Update label="v7.0.1" tags={["April 2026"]}>
  * [ICMP monitors](/detect/uptime-monitoring/icmp-monitors/overview) no longer require full root privileges to run
  * Fixed broken runtime dependencies in agent containers. Incorrect symlinks for the `2025-04` and `2026-04` runtimes caused dependency resolution failures (affecting agent v6.3.2 and v7.0.0)
  * Fixed connectivity issues when IPv6 is disabled. The agent now falls back to IPv4 automatically
  * API checks and URL monitors now capture [packets and traceroutes](/platform/network-diagnostic-tools/) on network failures
  * Bun is now supported as a package manager in [Playwright Check Suites](/detect/synthetic-monitoring/playwright-checks/overview/)
  * Degraded status now correctly appears in the [test reporter](/detect/testing/playwright-reporter/) header
</Update>

<Update label="v7.0.0" tags={["March 2026"]}>
  * Added support for running [ICMP](/detect/uptime-monitoring/icmp-monitors/overview) and [DNS monitors](/detect/uptime-monitoring/dns-monitors/overview) on Private Locations
  * Introduced the [uptime agent image](/platform/private-locations/agent-images#uptime-image), a lightweight version of the agent for running uptime monitors (URL, DNS, TCP, ICMP) only
  * Added [external observability](/platform/private-locations/agent-configuration#external-observability) for Private Location agents to capture runtime errors
    * Error-level events can be reported to Checkly to help detect crashes, bugs, and environment-related issues
    * Only limited technical metadata is collected (error message, stack trace, agent version, platform, Go runtime)
    * Sensitive data such as API keys, environment variables, check configuration, URLs, headers, and response bodies is never sent
    * Enabled by default, can be disabled with `EXTERNAL_OBSERVABILITY=off`
  * Support for runtimes `2026.04` and `2025.04`
</Update>

<Update label="v6.3.2" tags={["March 2026"]}>
  * Improved error logging for failed Playwright test report uploads, including the report file size
  * Increased the maximum artifact upload size from 75 MB to 150 MB
</Update>

<Update label="v6.3.1" tags={["February 2026"]}>
  The agent now exposes HTTP health probe endpoints:

  * **GET /-/readiness**: Returns `200 OK` when the agent is ready, `503 Service Unavailable` during shutdown
  * **GET /-/liveness**: Returns `200 OK`
  * **GET /health**: Returns `200 OK`
    Health endpoints run on port 8081 by default, configurable via the `AGENT_HEALTH_PORT` environment variable
</Update>

<Update label="v6.3.0" tags={["December 2025"]}>
  * Added [agent-dev image](https://www.checklyhq.com/docs/platform/private-locations/agent-images/) including build tools to support building native npm packages. Going forward, the dev variant is published as a separate image rather than a tag on the main agent image
  * Improved secret scrubbing speed
  * Improved error logging for hanging or long running Playwright Check Suite jobs
</Update>

<Update label="v6.2.0" tags={["December 2025"]}>
  Ensured `devDependencies` are not installed in the agent image
</Update>

<Update label="v6.1.7" tags={["December 2025"]}>
  * Added support for a [dev image](https://www.checklyhq.com/docs/platform/private-locations/agent-images/) including build tools to support building native npm packages
  * Improved internal logging and metrics for [Playwright Check Suites](/detect/synthetic-monitoring/playwright-checks/overview)
  * Browser and Multistep checks using runtime 2025.04 now automatically scrub the `Authorization` header from requests
</Update>

<Update label="v6.1.6" tags={["November 2025"]}>
  Added Checkly environment variables and configuration to [Playwright Check Suites](/detect/synthetic-monitoring/playwright-checks/overview). See the docs on [Playwright Check Suites environment variables](/detect/synthetic-monitoring/playwright-checks/environment-variables):

  * Adds support for `CHECKLY` to all checkly triggered runs: scheduled checks and test sessions triggered through either `npx checkly test`, `npx checkly trigger` or `npx checkly pw-test`
  * Includes the environment variable `CI` as true only for test session triggered runs
</Update>

<Update label="v6.1.5" tags={["November 2025"]}>
  Added Playwright test metrics to the check overview page, including **Test performance** and **Test statuses** graphs
</Update>

<Update label="v6.1.4" tags={["October 2025"]}>
  Minor patches on reporting
</Update>

<Update label="v6.1.3" tags={["August 2025"]}>
  Improved and centralized secret scrubbing for more reliable removal of sensitive data
</Update>

<Update label="v6.1.2" tags={["August 2025"]}>
  Added support for `CHECKLY_SECRET_*` environment variables. Secrets containing special characters (e.g. `@`, `%`, `!`, `+`) are now reliably scrubbed from traces, including when they appear in encoded form in URLs or request payloads. Learn more in our documentation on [Dynamic Secret Scrubbing](/platform/dynamic-secret-scrubbing/)
</Update>

<Update label="v6.1.1" tags={["July 2025"]}>
  Fixed an issue where checks could fail behind proxies during dependency installation because proxy-related environment variables were not consistently available
</Update>

<Update label="v6.1.0" tags={["July 2025"]}>
  * Added runtime secret detection for Browser and Multistep checks (enabled for selected accounts)

  * See the [product changelog](https://feedback.checklyhq.com/changelog/checkly-agent-610-playwright-check-suites-and-more) for details on changes from version 6.0.1 to 6.1.0
</Update>

<Update label="v6.0.7" tags={["June 2025"]}>
  Internal improvements and fixes related to networking and request handling
</Update>