Skip to main content

Lighthouse Desktop Audit

Lighthouse Desktop Audit

Plugin: dem.plugin Module: lighthouse

Maintained by Netdata

Overview​

Audit the load performance of a web page on a schedule with Lighthouse and follow how it changes over time.

Each job loads one URL in a fresh desktop Chromium browser and gives you:

  • The Lighthouse performance score, from 0 to 100.
  • Lab timings: First Contentful Paint, Largest Contentful Paint, Total Blocking Time and Speed Index, plus Cumulative Layout Shift.
  • The outcome and duration of every audit, how old the latest result is, and a run history.
  • Optionally, the full Lighthouse HTML report of each audit.

Every check_every seconds (30 minutes by default), the Agent starts a fresh, sandboxed Chromium browser on this host and runs a Lighthouse performance audit of the configured URL with the desktop preset. The browser loads the page like a visitor would, without clicking or submitting anything.

These are lab measurements from one browser on the Agent host, so they depend on that host's network and CPU and differ from what visitors experience. For measurements from real visitors, use Real User Monitoring. The Test action in the job editor checks that the browser runtime is ready, without running an audit.

This collector is only supported on the following platforms:

  • Linux

This collector supports collecting metrics from multiple instances of this integration.

The host must let an unprivileged process create the user namespaces Chromium's sandbox needs. Installing the browser runtime prepares this on hosts that restrict it, such as Ubuntu 24.04 (see Prerequisites). Browser jobs never run as root, and Chromium's sandbox stays enabled.

Lighthouse Desktop Audit can be monitored further using the following other integrations:

Default Behavior​

Auto-Detection​

This integration doesn't support auto-detection.

Limits​

  • All journey and Lighthouse jobs on the Agent share browser.concurrency in dem.conf, which runs one browser at a time by default. A check that comes due while the browser is busy waits; if it is still waiting when the job's next check comes due, it is skipped and counted as coalesced.
  • Audits that run at the same time compete for the host's CPU, which changes their timings and scores.
  • A result is fresh for two check intervals. After that the state chart shows stale and the duration and Lighthouse charts leave a gap until a new audit completes.
  • Run history is shared with RUM and kept for about 30 days, or less once it would exceed 1 GiB, and reports for 7 days, or less once they would exceed 2 GiB (history and artifacts in dem.conf). History files of up to a day expire together, so runs can stay about a day longer. When the size limit is reached, the oldest entries go first.
  • A report larger than 5 MiB is not kept.
  • Run diagnostics keep up to 500 events per audit and 2,000 characters per text, and count what they drop.
  • To be alerted on a low performance score, add your own health alert on dem_synthetic.lighthouse.performance.

Performance Impact​

Each audit starts a new Chromium browser and Node.js process on the Agent host, which use CPU and memory for as long as the audit lasts. The audited website receives one full page load, with all its resources.

  • Raise check_every to audit less often. update_every only refreshes the charts and starts no browser.
  • browser.concurrency in dem.conf limits how many browsers run at once; size it for the host's CPU and memory, and restart the Agent to apply it.

Setup​

Prerequisites​

Install the browser runtime​

Journeys and Lighthouse audits run in a separately installed browser runtime (Node.js, Chromium, Playwright and Lighthouse). Netdata never installs it on its own, and a job waits until it is installed. It needs Linux on amd64 or arm64.

Netdata installationInstall the runtime with
Native DEB or RPM packagesThe optional netdata-dem-runtime package, installed with your package manager. It requires a running systemd host, stops the Agent during installation and restores its previous service state.
Static or source installationkickstart.sh --install-dem-runtime during an install or update, or the installed helper: sudo /opt/netdata/usr/libexec/netdata/netdata-dem-runtime.sh install --agent /opt/netdata/usr/sbin/netdata --allow-download (static paths).
Docker (local, rootful)kickstart.sh --install-dem-runtime --docker-container NAME, run on the Docker host.

Static, source and Docker release builds default to the signed runtime matching the Agent version, channel and architecture. runtime.release_url in dem.conf can override that URL. Setup also prepares the host for Chromium's sandbox (an AppArmor allowance on Ubuntu 24.04). Installation verifies integrity and version compatibility. Local runtime qualify is optional.

The browser runtime host setup guide covers offline installation, Docker requirements, updates and removal.

Restart Netdata to activate the runtime​

A running Agent keeps the runtime it found when it started. After the first installation, restart the Agent (sudo systemctl restart netdata) or the container (docker restart NAME). The native package restores the previous service state for you. Later updates replace Agent and runtime as a matching pair. Source/static installers coordinate that transition; Docker deployments must switch the pinned image and runtime selection together. There is no separate daily runtime update.

To check the runtime, run as the Netdata service account:

sudo -u netdata /usr/libexec/netdata/plugins.d/dem.plugin runtime status
sudo -u netdata /usr/libexec/netdata/plugins.d/dem.plugin runtime qualify

qualify runs a test journey and a Lighthouse audit. Static installations keep the plugin under /opt/netdata/usr/libexec/netdata/plugins.d/.

Configuration​

Options​

Each job audits one page. All options apply per job.

Configuration options
GroupOptionDescriptionDefaultRequired
TargetnameJob name. It identifies the audit in charts and run history, so renaming starts a separate history.yes
urlPage to audit, as an absolute http:// or https:// URL without a username or password.yes
Diagnosissave_reportSave the full Lighthouse HTML report of each audit. Reports can contain sensitive URLs and page content.nono
Collectioncheck_everyHow often to audit the page, in seconds.1800no
update_everyHow often to refresh the charts from the latest result, in seconds. Refreshing never starts a browser.10no
timeoutTime limit for one audit, in seconds. Time spent waiting for a free browser does not count.180no
Virtual NodevnodeAssociates this job with a Virtual Node.no
save_report​

Download a report with the synthetics-artifact Function (administrator access) and open it in a browser. Reports larger than 5 MiB are not kept.

check_every​

A new job runs its first audit right away. The second comes one to two intervals later, at a point that depends on the job name, so jobs created together do not all run at once. After that, audits follow every check_every seconds.

timeout​

An audit that exceeds it ends as timeout. After the browser and its processes exit, saving the report and history has up to 10 more seconds, and the audit keeps its browser slot until then.

vnode​

The job's charts and alerts appear under the virtual node instead of this Agent's host, which lets you group the checks of one website under one node. Define the virtual node first, as the dem:vnode dynamic configuration or as a YAML file in the vnodes/ directory of the Netdata configuration directory, then enter its name, not its GUID. Changing it clears the latest-result charts until the next run; earlier runs keep the virtual node they ran under.

via File​

The configuration file name for this integration is dem/lighthouse.conf.

You can edit the configuration file using the edit-config script from the Netdata config directory.

cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata
sudo ./edit-config dem/lighthouse.conf
Examples​
Audit a page​

The minimal audit. It checks the page every 30 minutes.

Config
jobs:
- name: home
url: https://example.org/

Keep the HTML report​

Saves the full Lighthouse report of every audit, for a closer look at a slow result.

Config
jobs:
- name: home
url: https://example.org/
save_report: true

Group audits under a virtual node​

Shows the audit's charts under the shop virtual node, which must be defined first.

Config
jobs:
- name: home
vnode: shop
url: https://shop.example.org/

Alerts​

There are no alerts configured by default for this integration.

Metrics​

Metrics grouped by scope.

The scope defines the instance that the metric belongs to. An instance is uniquely identified by a set of labels.

Each job has its own charts, under its virtual node when vnode is set and under this Agent's host otherwise. The charts show the latest completed run until the next one finishes. When that result is older than two check intervals, the state chart shows stale and the duration, test and Lighthouse charts leave a gap instead of repeating it. Changing a job's vnode clears the latest result until the first run under the new virtual node completes.

Per lighthouse job​

One configured Lighthouse audit.

This scope has no labels.

Metrics:

MetricDescriptionDimensionsUnit
dem_synthetic.execution_stateLatest synthetic observation stateunknown, success, failed, timeout, inconclusive, error, cancelled, stalestate
dem_synthetic.durationLatest synthetic attempt durationdurationmilliseconds
dem_synthetic.observation_ageAge of latest synthetic observationageseconds
dem_synthetic.attemptsCompleted synthetic attemptssuccess, failed, timeout, inconclusive, error, cancelled, unknownattempts/s
dem_synthetic.occurrencesSynthetic scheduled occurrencesscheduled, admitted, coalescedoccurrences/s
dem_synthetic.scheduler_stateSynthetic active and pending attemptsactive, pendingattempts
dem_synthetic.queue_ageOldest synthetic admission waitageseconds
dem_synthetic.scheduling_delayLatest synthetic admission delay from selected due timedelayseconds
dem_synthetic.lighthouse.performanceLatest Lighthouse performance scoreperformancepoints
dem_synthetic.lighthouse.timingsLatest Lighthouse lab timingsfcp, lcp, tbt, speed_indexmilliseconds
dem_synthetic.lighthouse.clsLatest Lighthouse cumulative layout shiftclsratio

Live Data​

These Functions show the state of every journey and Lighthouse job on the Agent, their run history and their saved screenshots, traces and reports. They are available while the Agent has at least one active job, saved run or saved capture, so history stays readable after a job is removed. Run history has one Function per kind; the others serve both kinds.

Viewing them requires a signed-in member of the node's Netdata Cloud Space with permission to view sensitive data, on a paid plan or an active trial. Jobs run and their history is kept on every plan.

To narrow the results to one virtual node, pass vnode with its configured name, or vnode_guid with its GUID for a virtual node that was renamed or removed. Without either, every job is included, with or without a virtual node.

The plugin-wide dem-history-status Function covers the history that RUM and synthetic monitoring share. It is available whenever the plugin runs, needs the same access and takes no parameters. It shows the retention in effect (history in dem.conf), how much disk the history files use, and the latest cleanup, write or configuration reload error.

Synthetic monitors​

The current status of every active journey and Lighthouse job - its latest result and whether it is still fresh, when it last succeeded and failed, and whether its checks are waiting for a free browser. Disabled jobs and jobs that failed to start are not listed; their status is in the job configuration.

AspectDescription
NameSynthetics-checks
Require Cloudyes
PerformanceReads the jobs' current state in memory. Starts no browser and contacts no website.
SecurityShows job names, audited URLs and error messages, which can contain sensitive text.
AvailabilityWhile the Agent has at least one active synthetic job, saved run or saved capture.

Prerequisites​

No additional configuration is required.

Parameters​

ParameterTypeDescriptionRequiredDefaultOptions
Virtual node name (vnode)stringOnly jobs of the configured virtual node with this name. An empty or unknown name is an error. Do not combine with vnode_guid.no
Virtual node GUID (vnode_guid)stringOnly jobs recorded under the virtual node with this GUID. Do not combine with vnode.no
Job (job_id)stringOnly this job, written as module and job name, such as journey:checkout or lighthouse:home.no
Kind (kind)stringOnly journey or only lighthouse jobs.no
Maximum rows (limit)stringThe maximum number of rows to return, from 1 to 2000. The response sets truncated when more rows match.no2000

Returns​

One row per active job.

ColumnTypeUnitVisibilityDescription
job_idstringModule and job name, such as journey:checkout.
kindstringjourney or lighthouse.
namestringJob name.
targetstringAudited URL of a Lighthouse job, without credentials. Empty for journeys.
statestringThe latest outcome; waiting or running while a check is in progress; stale when the latest result is older than two check intervals; unknown before the first result.
freshbooleanWhether the latest result is less than two check intervals old.
run_idstringID of the latest run.
outcomestringOutcome of the latest run.
completed_ustimestampWhen the latest run finished.
duration_msfloatmsHow long the latest run took.
last_success_ustimestampWhen a run last succeeded, since the job started or moved to another virtual node.
last_failure_ustimestampWhen a run last failed or timed out, since the job started or moved to another virtual node.
errorstringError message of the latest run.
history_errorstringProblem saving the latest run to the run history.
vnode_guidstringGUID of the job's virtual node. Empty when it has none.
check_everyintegersConfigured check interval.
scheduledintegerChecks that came due since the job started.
admittedintegerChecks that got a browser and ran.
coalescedintegerChecks skipped because the job's previous check was still waiting for a browser.
pendingbooleanWhether a check is waiting for a browser.
queue_agefloatsHow long the waiting check has waited.
scheduling_delayfloatsHow long after its due time the latest check got a browser.

Lighthouse runs​

The history of Lighthouse audits, newest first, with the performance score and lab timings of each. Use it to see when a page got slower. Audits are selected by start time.

AspectDescription
NameSynthetics-lighthouse-runs
Require Cloudyes
PerformanceReads the run history from disk, up to 2000 rows per request. Starts no browser and contacts no website.
SecurityRows can contain URLs and error messages, which can include sensitive text.
AvailabilityWhile the Agent has at least one active synthetic job, saved run or saved capture.

Prerequisites​

No additional configuration is required.

Parameters​

ParameterTypeDescriptionRequiredDefaultOptions
Virtual node name (vnode)stringOnly jobs of the configured virtual node with this name. An empty or unknown name is an error. Do not combine with vnode_guid.no
Virtual node GUID (vnode_guid)stringOnly jobs recorded under the virtual node with this GUID. Do not combine with vnode.no
Job (job_id)stringOnly audits of this job, such as lighthouse:home.no
Outcome (outcome)stringOnly runs with this outcome - success, failed, timeout, inconclusive, error, cancelled or unknown.no
Started after (after)stringOnly runs started at or after this time, in Unix seconds, or seconds before now when negative (-3600 for the last hour). Empty includes the whole history.no
Started before (before)stringOnly runs started at or before this time, in Unix seconds, or seconds before now when negative. Empty means now.no
Maximum rows (limit)stringThe maximum number of rows to return, from 1 to 2000. The response sets truncated when more rows match.no2000

Returns​

One row per audit. The response reports the time range it used and sets truncated when more audits match than limit. Measurements an audit did not report are null.

ColumnTypeUnitVisibilityDescription
run_idstringRun ID.
job_idstringModule and job name.
namestringJob name.
targetstringAudited URL, without credentials. Empty for journeys.
started_ustimestampWhen the run started.
completed_ustimestampWhen the run finished. Null when it did not finish, for example because the Agent stopped.
outcomestringOutcome of the run.
duration_msfloatmsHow long the run took, excluding the wait for a browser.
capture_statestringWhether captures were saved - available, not_needed, unavailable or disabled.
errorstringFirst error reported by the run.
history_errorstringProblem saving the run to the history.
vnode_guidstringGUID of the virtual node the run belonged to. Empty when it had none.
scheduled_ustimestampWhen the check was due.
queued_ustimestampWhen the check started waiting for a browser.
termination_reasonstringWhy the run stopped early, such as test_timeout, suite_timeout, execution_budget or cancelled. Empty when it ran to the end.
performancefloatpointsLighthouse performance score, from 0 to 100.
fcp_msfloatmsFirst Contentful Paint.
lcp_msfloatmsLargest Contentful Paint.
tbt_msfloatmsTotal Blocking Time.
si_msfloatmsSpeed Index.
clsfloatCumulative Layout Shift, a unitless score.

Synthetic run detail​

Everything recorded about one run, journey or Lighthouse, including a run that is still in progress - its outcome, error, test counts or Lighthouse measurements, failure details, captures and the timeline of test and step events. Open it from the monitor overview or the run history.

AspectDescription
NameSynthetics-run
Require Cloudyes
PerformanceReads one run from memory or disk. Starts no browser and contacts no website.
SecurityShows URLs, titles and error messages from the website, which can contain sensitive text.
AvailabilityWhile the Agent has at least one active synthetic job, saved run or saved capture.

Prerequisites​

No additional configuration is required.

Parameters​

ParameterTypeDescriptionRequiredDefaultOptions
Job (job_id)stringModule and job name of the run, such as journey:checkout.yes
Run (run_id)stringRun ID, from the monitor overview or the run history.yes

Returns​

One row per recorded test, step or audit event. The response also carries the full run record, including what was captured; a missing completion time means the run has not finished or its end was not recorded. For a journey, the record's failure_evidence holds the first failure's test and step path, source locations and error excerpts, plus what was still pending when a timed-out test was stopped, and browser_summary holds the browser error counts and samples when browser_error_summary is on.

A capture the run reported but Netdata did not save is listed in the record's captures.unpublished with a reason: too_large (over the 5 MiB download limit), publication_failed (saving failed; the run's error says why), not_eligible (taken while the run was being stopped; such captures are kept only when it stopped with execution_budget) or not_in_final_report (listed in captures.associations but missing from the run's final report).

ColumnTypeUnitVisibilityDescription
at_mstimestampWhen the event happened.
kindstringEvent type, such as a test, step or error.
test_idstringTest the event belongs to.
titlestringTest or step title.
phasestringPhase of the run, such as start or end.
statusstringStatus the test or step ended with.
expected_statusstringStatus the test was expected to end with.
duration_msfloatmsHow long the test or step took.
messagestringError or status message.

Retained synthetic captures​

The saved failure screenshots, traces and Lighthouse reports, one set per run, newest first. Captures are kept separately from the run history (7 days or 2 GiB by default), so they can remain after their run's history or their job is gone, until they expire. The response also shows how much disk the captures use and the retention policy.

AspectDescription
NameSynthetics-artifacts
Require Cloudyes
PerformanceReads capture file sizes and metadata from disk, not their contents. Starts no browser.
SecurityShows job names and capture metadata, not capture contents.
AvailabilityWhile the Agent has at least one active synthetic job, saved run or saved capture.

Prerequisites​

No additional configuration is required.

Parameters​

ParameterTypeDescriptionRequiredDefaultOptions
Virtual node name (vnode)stringOnly jobs of the configured virtual node with this name. An empty or unknown name is an error. Do not combine with vnode_guid.no
Virtual node GUID (vnode_guid)stringOnly jobs recorded under the virtual node with this GUID. Do not combine with vnode.no
Job (job_id)stringOnly captures of this job, such as journey:checkout. The storage totals always cover all jobs.no
Page cursor (cursor)stringThe next value of the previous response, to read the next page. Empty starts from the newest captures.no
Maximum rows (limit)stringThe maximum number of capture sets to return, from 1 to 2000. When truncated is true, pass next as cursor for more.no2000

Returns​

One row per saved capture set. The storage object reports the retention policy, the disk space used and any cleanup error.

ColumnTypeUnitVisibilityDescription
run_idstringRun the captures belong to.
job_idstringModule and job name.
published_ustimestampWhen the captures were saved.
bytesintegerbytesSize of the capture set.
artifact_countintegerNumber of files in the set.
vnode_guidstringGUID of the run's virtual node. Empty when it had none.

Synthetic capture detail​

The captures of one run, and the download of one of them - a screenshot, a Playwright trace ZIP or a Lighthouse HTML report. Downloading requires administrator access to the node.

AspectDescription
NameSynthetics-artifact
Require Cloudyes
PerformanceReads metadata from disk, and one file of up to 5 MiB when downloading. Starts no browser.
SecurityListing requires member access; downloading requires administrator access. Screenshots, traces and reports can contain passwords, cookies, personal data and other page content.
AvailabilityWhile the Agent has at least one active synthetic job, saved run or saved capture.

Prerequisites​

No additional configuration is required.

Parameters​

ParameterTypeDescriptionRequiredDefaultOptions
Job (job_id)stringModule and job name of the run, such as journey:checkout.yes
Run (run_id)stringRun ID, from the capture list, the monitor overview or the run history.yes
Capture (artifact_id)stringCapture to download. The response returns its content base64-encoded. Empty lists the run's captures.no

Returns​

One row per capture of the run. A capture that has expired is reported as expired_or_unavailable. A downloaded file is checked against its recorded SHA-256 and returned as base64 in data_base64, up to 5 MiB.

ColumnTypeUnitVisibilityDescription
artifact_idstringCapture ID, for download.
kindstringCapture type.
mimestringContent type.
bytesintegerbytesFile size.
sha256stringSHA-256 of the file.
availabilitystringWhether the file is still kept.
teststringTitle of the test a screenshot or trace belongs to, or Test not recorded when the run did not report it. Empty for Lighthouse reports.
labelstringScreenshot, Trace or Lighthouse report.

Troubleshooting​

Known Errors​

opening DEM history: load journal identity: journalhost: machine id: no machine id found​

When

The Agent's log shows this when dem.plugin starts on Linux. The plugin then exits, so no DEM job runs, whichever modules are enabled.

Cause

DEM keeps its history in journal files, which need the host's machine ID, and none was found. Neither /etc/machine-id nor /var/lib/dbus/machine-id holds a valid ID, and neither file exists under the Netdata host prefix (/host in the official Docker image). This is common in minimal containers.

Fix

On a host, create the machine ID with sudo systemd-machine-id-setup (or sudo dbus-uuidgen --ensure=/etc/machine-id without systemd), then restart the Agent.

In the official Docker image, mount the host's machine ID under the Netdata host prefix: add -v /etc/machine-id:/host/etc/machine-id:ro to docker run, or the same mount under volumes: in Docker Compose, then recreate the container. Check first that the host has /etc/machine-id: Docker creates a missing source path as an empty directory, which DEM rejects.

install a browser runtime and restart dem.plugin: matching browser runtime is not prepared​

When

Static, source or Docker installation. The job stays waiting and never runs.

Cause

No browser runtime is installed, or it was installed after the Agent started.

Fix

Install the runtime (see Prerequisites), then restart the Agent or the container.

install the optional netdata-dem-runtime package and restart dem.plugin: matching browser runtime is not prepared​

When

Native DEB or RPM installation. The job stays waiting and never runs.

Cause

The netdata-dem-runtime package is not installed.

Fix

Install netdata-dem-runtime with the package manager. The package restarts the Agent when it finishes.

DEM browser execution requires the plugin to run as an unprivileged user; root RUM operation does not enable browser jobs​

Cause

The Netdata service runs as root. Browser jobs refuse to start Chromium as root.

Fix

Run the Netdata service as its unprivileged service account (netdata by default). RUM keeps working either way.

DEM browser execution requires prepared Linux amd64 or arm64 runtime​

Cause

The host is not Linux on amd64 or arm64, where the browser runtime is not available.

Fix

Run browser jobs from an Agent on an amd64 or arm64 Linux host. RUM does not need the runtime.

online runtime preparation requires runtime.release_url​

When

Installing the runtime online, with kickstart, the helper or --allow-download.

Cause

The build has no release identity, or runtime.release_url in dem.conf explicitly disables the default URL.

Fix

Use a release build's default URL, configure an exact matching signed release URL, or provide signed offline inputs (see the browser runtime host setup guide).

offline preparation requires runtime.offline_keyring; no runtime release verification key is configured​

When

Installing the runtime from a release file and archive with --release and --archive.

Cause

There is no public key to verify the release signature.

Fix

Set runtime.offline_keyring in dem.conf to the absolute path of the Netdata release signing keyring, readable by the Netdata service account.

Runtime installation or qualification fails with a Chromium sandbox error​

Cause

The host does not let an unprivileged process create the user namespaces Chromium's sandbox needs, usually because of an AppArmor restriction (Ubuntu 24.04) or a container's seccomp or namespace settings.

Fix

Install the runtime with kickstart or the netdata-dem-runtime.sh helper, which prepare the AppArmor allowance; for Docker, use the documented container settings, including apparmor=unconfined on AppArmor hosts. Look for denials in the kernel log:

sudo journalctl -k --since '10 minutes ago'

Do not disable Chromium's sandbox or the host's restrictions.

Checks are coalesced, or the state chart shows stale​

Cause

The browser is busy with other jobs for longer than this job's check interval, so its checks wait and newer ones replace them. The scheduling charts show growing queue age and coalesced occurrences.

Fix

Raise check_every or lower timeout on busy jobs, or raise browser.concurrency in dem.conf if the host has CPU and memory to spare, then restart the Agent.

plugin exiting with retained unverified synthetic work: ERROR​

When

A journey or Lighthouse run, or a runtime check, ends without proof that its browser processes exited, and the whole plugin, RUM included, exits.

Cause

DEM could not confirm that every browser and Node.js process of the run exited, for example because one is stuck in uninterruptible disk I/O or Netdata lost track of it. It keeps the run's files and its runtime release protected instead of deleting something that may still be in use.

Fix

Look for leftover processes of the Netdata service account (for example ps -u netdata -f) and resolve what keeps them running, then restart the Agent. A process stuck in uninterruptible disk I/O can need a host reboot, which also lets DEM release the protected runtime files.

Leave the files in the dem directory under the Agent's state directory (usually /var/lib/netdata/dem/) in place: DEM never removes protected work based on age or a missing process ID.

unverified synthetic completion: ERROR​

When

The plugin was shutting down when a run or runtime check ended without proof that its browser processes exited.

Cause

DEM could not confirm that every browser and Node.js process of the run exited, for example because one is stuck in uninterruptible disk I/O or Netdata lost track of it. It keeps the run's files and its runtime release protected instead of deleting something that may still be in use.

Fix

Look for leftover processes of the Netdata service account (for example ps -u netdata -f) and resolve what keeps them running, then restart the Agent. A process stuck in uninterruptible disk I/O can need a host reboot, which also lets DEM release the protected runtime files.

Leave the files in the dem directory under the Agent's state directory (usually /var/lib/netdata/dem/) in place: DEM never removes protected work based on age or a missing process ID.

audit URL must be absolute HTTP(S) without credentials​

Cause

url is not an absolute http:// or https:// URL, or it contains a username or password.

Fix

Use a full URL such as https://example.org/. Pages behind a login cannot be audited this way; check them with a journey instead.

Audits end as error​

Cause

Lighthouse could not audit the page, for example because it did not load, the name did not resolve or the TLS certificate was not trusted.

Fix

Open the audit in the Lighthouse run history; its error column has Lighthouse's message. Check that the Agent host can reach the URL.


Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.