Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions platform/private-locations/agent-configuration.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ Variable|Description
`USE_OS_DNS_RESOLVER`|When set to true, TCP monitors will resolve DNS using `getaddrinfo` C function, instead of using the network. This enables easier DNS resolution for internal services e.g. services running in the same Kubernetes cluster.
`DEPENDENCY_CACHE`|(Default: `OFF`) Set to `CHECKLY_S3` to enable dependency caching for [Playwright Check Suites](/detect/synthetic-monitoring/playwright-checks/overview). Caches installed dependencies between runs to speed up check execution. Learn more about [dependency caching](/detect/synthetic-monitoring/playwright-checks/custom-dependencies#dependency-caching).
`AGENT_HEALTH_PORT`|(Default: `8081`) Port for the HTTP [health probe endpoints](#health-probe-endpoints).
`EXTERNAL_OBSERVABILITY`|(Default: `ON`) Set to `OFF` to disable [external observability](#external-observability) reporting of agent runtime errors to Checkly.

For example, you can add these variables to the standard docker run command like this:

Expand Down Expand Up @@ -164,6 +165,18 @@ Endpoint|Description

These endpoints are useful for configuring [Kubernetes readiness and liveness probes](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/) or any other container orchestration health checks.

## External Observability

The Checkly Agent reports error-level events to Checkly to help detect crashes, bugs, and environment-related issues. This is enabled by default starting with agent v7.0.0.

Only limited technical metadata is collected (e.g. error messages, stack traces, agent version, platform, go runtime information). Sensitive data such as API keys, environment variables, check configuration, URLs, headers, and response bodies is **never** sent.

To disable external observability, set the `EXTERNAL_OBSERVABILITY` environment variable to `OFF`:

```bash Terminal
-e EXTERNAL_OBSERVABILITY=OFF
```

## Agent Version and Runtimes

Each Checkly Agent only supports specific [runtimes](/platform/runtimes/overview/). This is to keep the container image at an acceptable size. When you change the runtime a check uses, you may also need to change to the corresponding agent version. Similarly, if you update the agent version to one using a different runtime you also need to update your checks to use the same runtime.
Expand Down
8 changes: 8 additions & 0 deletions platform/private-locations/change-log.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,14 @@ Learn more about:

## Full release history

<Update label="v7.0.0" tags={["March 2026"]}>
Added 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`
</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
Expand Down