The only agent that thinks for itself

Autonomous Monitoring with self-learning AI built-in, operating independently across your entire stack.

Metrics, Logs & Traces
Machine learning & MCP
5% of one CPU core, about 200 MB RAM
3GB disk, >1 year retention
2,000+ integrations, zero config
Dashboards, alerts out of the box
> Discover Netdata Agents

Centralized metrics streaming and storage

Aggregate metrics from multiple agents into centralized Parent nodes for unified monitoring across your infrastructure.

Stream from unlimited agents
Long-term data retention
High availability clustering
Data replication & backup
Scalable architecture
Enterprise-grade security
> Learn about Parents

Fully managed cloud platform

Access your monitoring data from anywhere with our SaaS platform. No infrastructure to manage, automatic updates, and global availability.

Zero infrastructure management
Metrics stay on your nodes
US-hosted metadata
Automatic updates & patches
Enterprise SSO & RBAC
SOC 2 Type 2 certified
> Explore Netdata Cloud

Deploy Netdata Cloud in your infrastructure

Run the full Netdata Cloud platform on-premises for complete data sovereignty and compliance with your security policies.

Complete data sovereignty
Air-gapped deployment
Custom compliance controls
Private network integration
Dedicated support team
Kubernetes & Docker support
> Learn about Cloud On-Premises

Powerful, intuitive monitoring interface

Modern, responsive UI built for real-time troubleshooting with customizable dashboards and advanced visualization capabilities.

Real-time chart updates
Customizable dashboards
Dark & light themes
Advanced filtering & search
Responsive on all devices
Collaboration features
> Explore Netdata UI

Monitor on the go

Native iOS and Android apps bring full monitoring capabilities to your mobile device with real-time alerts and notifications.

iOS & Android apps
Push notifications
Touch-optimized interface
Offline data access
Biometric authentication
Widget support
> Download apps

The future of infrastructure observability

See our strategic direction across AI-native observability, full-stack signals, operational intelligence, and enterprise platform maturity.

AI-native observability
Full-stack signal coverage
Operational intelligence
Enterprise platform maturity
Agent releases every 6 weeks
Cloud continuous delivery
> Explore Product Roadmap

Best energy efficiency

True real-time per-second

100% automated zero config

Centralized observability

Multi-year retention

High availability built-in

Zero maintenance

Always up-to-date

Enterprise security

Complete data control

Air-gap ready

Compliance certified

Millisecond responsiveness

Infinite zoom & pan

Works on any device

Native performance

Instant alerts

Monitor anywhere

AI-native observability

Continuous delivery

Open source foundation

80% Faster Incident Resolution

AI-powered troubleshooting from detection, to root cause and blast radius identification, to reporting.

True Real-Time and Simple, even at Scale

Linearly and infinitely scalable full-stack observability, that can be deployed even mid-crisis.

90% Cost Reduction, Full Fidelity

Instead of centralizing the data, Netdata distributes the code, eliminating pipelines and complexity.

See and Map Your Entire Network

Live topology, flow analytics, and SNMP device and trap monitoring — unified with your full-stack observability.

Single Pane of Glass

Eliminate SSH access for monitoring and troubleshooting systems and applications.

Control Without Surrender

SOC 2 Type 2 certified with every metric kept on your infrastructure.

Integrations

2,000+ collectors and notification channels, auto-discovered and ready out of the box.

2,000+ data collectors
Auto-discovery & zero config
Cloud, infra, app protocols
Notifications out of the box
> Explore integrations
Real Results
46% Cost Reduction

Reduced monitoring costs by 46% while cutting staff overhead by 67%.

— Leonardo Antunez, Codyas

Zero Pipeline

No data shipping. No central storage costs. Query at the edge.

From Our Users
"Out-of-the-Box"

So many out-of-the-box features! I mostly don't have to develop anything.

— Simon Beginn, LANCOM Systems

No Query Language

Point-and-click troubleshooting. No PromQL, no LogQL, no learning curve.

Enterprise Ready
67% Less Staff, 46% Cost Cut

Enterprise efficiency without enterprise complexity—real ROI from day one.

— Leonardo Antunez, Codyas

SOC 2 Type 2 Certified

Zero data egress. Only metadata reaches the cloud. Your metrics stay on your infrastructure.

Full Coverage
2,000+ Collectors

Auto-discovered and configured. No manual setup required.

Any Notification Channel

Slack, PagerDuty, Teams, email, webhooks—all built-in.

Built for the People Who Get Paged

Because 3am alerts deserve instant answers, not hour-long hunts.

Every Industry Has Rules. We Master Them.

See how healthcare, finance, and government teams cut monitoring costs 90% while staying audit-ready.

Monitor Any Technology. Configure Nothing.

Install the agent. It already knows your stack.
From Our Users
"A Rare Unicorn"

Netdata gives more than you invest in it. A rare unicorn that obeys the Pareto rule.

— Eduard Porquet Mateu, TMB Barcelona

99% Downtime Reduction

Reduced website downtime by 99% and cloud bill by 30% using Netdata alerts.

— Falkland Islands Government

Real Savings
30% Cloud Cost Reduction

Optimized resource allocation based on Netdata alerts cut cloud spending by 30%.

— Falkland Islands Government

46% Cost Cut

Reduced monitoring staff by 67% while cutting operational costs by 46%.

— Codyas

Real Coverage
"Plugin for Everything"

Netdata has agent capacity or a plugin for everything, including Windows and Kubernetes.

— Eduard Porquet Mateu, TMB Barcelona

"Out-of-the-Box"

So many out-of-the-box features! I mostly don't have to develop anything.

— Simon Beginn, LANCOM Systems

Real Speed
Troubleshooting in 30 Seconds

From 2-3 minutes to 30 seconds—instant visibility into any node issue.

— Matthew Artist, Nodecraft

20% Downtime Reduction

20% less downtime and 40% budget optimization from out-of-the-box monitoring.

— Simon Beginn, LANCOM Systems

Pay per Node. Predictable Pricing.

Pay per node, with unlimited metrics and generous log and trace quotas.

Free tier—forever
No metric limits or caps
Retention you control
Cancel anytime
> See pricing plans

What's Your Monitoring Really Costing You?

Most teams overpay by 40-60%. Let's find out why.

Expose hidden metric charges
Calculate tool consolidation
Customers report 30-67% savings
Results in under 60 seconds
> See what you're really paying

Your Infrastructure Is Unique. Let's Talk.

Because monitoring 10 nodes is different from monitoring 10,000.

On-prem & air-gapped deployment
Volume pricing & agreements
Architecture review for your scale
Compliance & security support
> Start a conversation

Monitoring That Sells Itself

Deploy in minutes. Impress clients in hours. Earn recurring revenue for years.

30-second live demos close deals
Zero config = zero support burden
Competitive margins & deal protection
Response in 48 hours
> Apply to partner

Per-Second Metrics at Homelab Prices

Same engine, same dashboards, same ML. Just priced for tinkerers.

Community: Free forever · 5 nodes
Homelab: $90/yr · personal, non-commercial use
> Get the Homelab Plan

$1,000 Per Referral. Unlimited Referrals.

Your colleagues get 10% off. You get 10% commission. Everyone wins.

10% of subscriptions, up to $1,000 each
Track earnings inside Netdata Cloud
PayPal/Venmo payouts in 3-4 weeks
No caps, no complexity
> Get your referral link
Cost Proof
40% Budget Optimization

"Netdata's significant positive impact" — LANCOM Systems

Calculate Your Savings

Compare vs Datadog, Grafana, Dynatrace

Savings Proof
46% Cost Reduction

"Cut costs by 46%, staff by 67%" — Codyas

30% Cloud Bill Savings

"Reduced cloud bill by 30%" — Falkland Islands Gov

Enterprise Proof
"Better Than Combined Alternatives"

"Better observability with Netdata than combining other tools." — TMB Barcelona

Real Engineers, <24h Response

DPA, SLAs, on-prem, volume pricing

Why Partners Win
Demo Live Infrastructure

One-line install, real data—no sandbox needed

Zero Tickets, High Margins

Auto-config + per-node pricing = predictable profit

Homelab Ready
Free Video Course

8-episode Netdata tutorial by LearnLinux.tv

80k+ GitHub Stars

Open source, 690+ contributors

Worth Recommending
Product That Delivers

Customers report 90% cost cuts, 99% downtime reduction

Zero Risk to Your Rep

Free tier lets them try before they buy

AI Support Assistant, Available 24/7

Nedi has access to all official documentation, source code, and resources. Ask any question about Netdata—responds in your language.

Deployment & configuration
Troubleshooting & sizing
Alerts & notifications
Evidence-based answers
> Ask Nedi now

Never Fight Fires Alone

Docs, community, and expert help—pick your path to resolution.

Learn.netdata.cloud docs
Discord, Forums, GitHub
Premium support available
> Get answers now

60 Seconds to First Dashboard

One command to install. Zero config. 2,000+ integrations documented.

Linux, Windows, K8s, Docker
Auto-discovers your stack
> Read our documentation

80,000+ Engineers Strong

690+ contributors. 1.5M daily downloads. One mission: simplify observability.

Per-Second. 90% Cheaper. Data Stays Home.

Side-by-side comparisons: costs, real-time granularity, and data sovereignty for every major tool.

See why teams switch from Datadog, Prometheus, Grafana, and more.

> Browse all comparisons
Edge-Native Observability, Born Open Source
Per-second visibility, ML on every metric, and data that never leaves your infrastructure.
Founded in 2016
690+ contributors worldwide
Remote-first, engineering-driven
Open source first
> Read our story
Promises We Publish—and Prove
12 principles backed by open code, independent validation, and measurable outcomes.
Open source, peer-reviewed
Zero config, instant value
Data sovereignty by design
Aligned pricing, no surprises
> See all 12 principles
Edge-Native, AI-Ready, 100% Open
80k+ stars. Full ML, AI, and automation—GPLv3+, not premium add-ons.
80,000+ GitHub stars
GPLv3+ licensed forever
ML on every metric, included
Zero vendor lock-in
> Explore our open source
Build Real-Time Observability for the World
Remote-first team shipping per-second monitoring with ML on every metric.
Remote-first, fully distributed
Open source (80k+ stars)
Challenging technical problems
Your code on millions of systems
> See open roles
Meet the Team Behind Netdata
Conferences, meetups, and tradeshows where you can see Netdata in action and talk to the engineers who build it.
Live demos and deep dives
Book 1-on-1 meetings
Talks and panel sessions
Event recaps and photos
> See all events
Talk to a Netdata Human in <24 Hours
Sales, partnerships, press, or professional services—real engineers, fast answers.
Discuss your observability needs
Pricing and volume discounts
Partnership opportunities
Media and press inquiries
> Book a conversation
Your Data. Your Rules.
On-prem data, cloud control plane, transparent terms.
Trust & Scale
80,000+ GitHub Stars

One of the most popular open-source monitoring projects

SOC 2 Type 2 Certified

Enterprise-grade security and compliance

Data Sovereignty

Your metrics stay on your infrastructure

Validated
University of Amsterdam

"Most energy-efficient monitoring solution" — ICSOC 2023, peer-reviewed

ADASTEC (Autonomous Driving)

"Doesn't miss alerts—mission-critical trust for safety software"

Community Stats
690+ Contributors

Global community improving monitoring for everyone

1.5M+ Downloads/Day

Trusted by teams worldwide

GPLv3+ Licensed

Free forever, fully open source agent

Why Join?
Remote-First

Work from anywhere, async-friendly culture

Impact at Scale

Your work helps millions of systems

Lighthouse Desktop Audit

Plugin: dem.plugin Module: lighthouse

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.

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.

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.

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.

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.

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

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

Alerts

There are no alerts configured by default for this integration.

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.

The observability platform companies need to succeed

Sign up for free

Want a personalised demo of Netdata for your use case?

Contact Sales