Buy

Monitor

Free & Premium

The Monitor keeps an eye on your customers' websites: whether they are reachable, how fast they respond, when the TLS certificate and the domain expire, whether the structured data can be read and how Lighthouse rates the pages. Every check runs on your Mac while WebDonkey is open. You do not need an account with a monitoring service.

The Monitor has two levels: one project per customer, and any number of targets under it. A target is an address that gets checked, for example the home page of a shop or a health URL. The SEO audits belong to the same projects but have their own page: SEO & Accessibility.

What you do here

Page layout

You find the Monitor in the sidebar in the Monitoring group. At the top are the Check automatically switch, the number of problems (or all ok), New project and Check all. Below, each project has a block with its targets. Projects with a problem come first, and within a project the targets with a problem. Clicking a project name collapses and expands its block.

Free and Premium

Free includes one project with up to three targets and every feature: Lighthouse, structured data, history and notifications. Premium removes the limit. With the SEO package, the project's SEO audits count towards the three entries on Free. If you go back from Premium to Free, everything stays visible. Only the oldest project and its three oldest entries are checked, everything else is locked until Premium is active again. Prices are on webdonkey.io/pricing.

Overview Free & Premium

The overview is the Monitor's start view. It lists every project with its targets and shows at a glance, per target, whether the site responds, how fast, how long the certificate is still valid and what Lighthouse and the structured data check found last. That answers "is anything red?" without opening a single target.

Where to find it

Sidebar › Monitoring › Monitor. In the search (⌘K), the command Check all checks every target and opens the Monitor.

The page header

Element Meaning
Check automatically Turns automatic checks on or off for all projects and targets, see Check automatically.
x problem(s) or all ok Number of targets that are currently down. A target showing its maintenance page does not count.
New project Creates a project, see Create projects and targets. Locked on Free once a project exists.
Check all Checks every target of every project right away, without SEO audits.

On Free, a note below explains the limit of one project with three targets. If you are offline, a yellow note appears: checks pause, and no target is reported as down.

The project header

On the left are the project name, the number of targets (x target(s)) and, if there are any, the number of targets with a problem. On the right:

  • Check all: checks every target of this project right away, without SEO audits.
  • Lighthouse: runs Lighthouse for every target of the project, desktop and mobile. The button only appears once Lighthouse is installed. While the runs are going it shows the progress, for example Lighthouse 1/3. More in Lighthouse.
  • New target: adds a target to the project.
  • automatic: the switch for every target of this project.
  • Trash can (Delete project): deletes the project after a confirmation, with all its targets and their history. SEO audits of the project are deleted as well.

A target row

The first line starts with the status, followed by the label and the measurements:

Display Meaning
Status code, such as 200 (green) The last check succeeded. A response with 2xx or 3xx after at most five redirects counts as a success. If a required keyword is set, it has to appear in the response text.
down (red) The last check failed. The reason is on the line below, for example timeout, an HTTP status or a missing keyword.
maintenance (yellow) The shop shows its maintenance page, recognised by Shopware's maintenance mode. This counts as planned: it is not a problem and sends no notification.
not checked (grey) There is no check for this target yet.
Key icon The checks log in with user and password (Basic Auth).
143 ms Response time of the last successful check.
SSL 54 d Days until the TLS certificate expires. Yellow from 21 days, red from 7 days.
by hand only This target is not checked automatically.

Under the name you see the address or, if the last check failed, the error.

The second line shows the measurements that are not taken on every check:

  • A button with the profile name (desktop or mobile) opens the detail view. Next to it are the four Lighthouse scores Perf, A11y, Best and SEO for the profile that the list shows. From 90 they are green, from 50 yellow, below that red. A dash means: not measured yet.
  • JSON-LD: the number of structured data blocks found, plus x error(s), x warning(s) or no errors. An exclamation mark means the data cannot be read, a yellow 0 that the page has none.

The domain expiry is not in the list, only in the detail view, because many domain endings do not publish a date.

Actions in a target row

Element What it does
Switch (Check this target automatically) Adds the target to the automatic checks or takes it out.
Open in browser Opens the address in your default browser.
Check now Checks this target right away, even if it is checked by hand only.
Edit Opens the Edit target dialog.
Delete target Deletes the target and its history after a confirmation.

Clicking the name or the address opens the detail view.

If a project has SEO audits, a line such as 2 SEO audits in this project with Open in SEO sits below its targets. It leads to the SEO page, filtered on this project. Without the SEO package, the line carries a lock with SEO package.

Free and Premium

On Free, New project and New target turn off at the limit, and the tooltip says why. After switching to Free, locked projects and targets carry a note. Their results stay visible, Check now and the switch are locked.

Troubleshooting

What you see Why What to do
Note that you are offline Your Mac cannot reach the internet. Nothing. Checks resume once the connection is back.
down with keyword not found: … below The site responds, but the keyword is missing from the text. Check the site or adjust the keyword under Edit.
down with Credentials rejected below The site rejects user or password. Fix the credentials under Edit.
Lots of dashes on the second line Lighthouse has not run for this profile yet. Start Lighthouse in the detail view.

See also

Create projects and targets Free & Premium

A project groups a customer's addresses, a target is a single address the Monitor checks. You create the project first and then add one or more targets to it. You can enter several addresses in one go, one per line.

Where to find it

Sidebar › Monitoring › Monitor. New project sits at the top right, New target in the header of each project. You can also create a project on the SEO page, and it then shows up in both views.

How to do it

Create a project

  1. Click New project.
  2. Enter a name, for example the customer's name (placeholder Customer name).
  3. Click Save or press Enter.

A new project takes the current position of the Check automatically switch at the top of the page.

Add targets

  1. Click New target in the project.
  2. Enter the addresses under URL, one per line. Each line becomes its own target. An address without http:// or https:// automatically gets https:// in front.
  3. Enter a Label if you like. Left empty, WebDonkey uses the hostname. If you enter several lines, each target gets its hostname as label.
  4. Under Check every, choose how often the target is checked automatically.
  5. Optionally enter a word under Must contain (optional) that has to appear on the page, for example Impressum.
  6. If the site is password-protected, see below.
  7. Click Save.

A new target takes the automatic switch of its project. If the target is checked automatically, its first check comes with the Monitor's next round. Otherwise click Check now.

Password-protected sites

Staging and pre-launch sites often sit behind password protection via .htaccess.

  1. Tick Site is password-protected (.htaccess / Basic Auth).
  2. Enter User and Password.
  3. Save.

The credentials are used by the uptime check, the structured data, the SEO audit and Lighthouse. They are only ever sent to this site's own address, never to embedded third-party services, and not after a redirect to another host either. When you edit the target, the password field stays empty (Leave empty to keep): leave it empty and the stored password is kept.

Edit or delete a target

  • Edit (pencil in the target row) opens Edit target with the same fields. Here URL takes one line only.
  • Delete target (trash can in the target row) deletes the target and its history after a confirmation.
  • Delete project (trash can in the project row) deletes the project with all its targets, their history and the project's SEO audits.

Fields and options

Field Meaning Default
Label Name of the target in the list (placeholder Defaults to the hostname). Hostname
URL The address that is checked. One per line when you create targets. empty
Site is password-protected (.htaccess / Basic Auth) Checks log in with User and Password. off
Check every Interval of the automatic checks: 5 min, 15 min, 30 min, 60 min, 6 h or 24 h. 15 min
Must contain (optional) A word that has to appear in the response text. This catches an empty page that still returns status 200. empty

Save only works once a URL is entered and, with password protection on, a user.

What happens in the background

The dialog remembers what you type, even across an app restart. Open it again and your draft is still there. The password is never stored in the draft. If you close the dialog with input in it, WebDonkey asks Discard your input?: Discard deletes the draft, Keep editing takes you back.

The password is stored encrypted in WebDonkey's database, the key in a separate file outside the database. It is only decrypted for the duration of a check.

Free and Premium

Free allows one project with three targets. With the SEO package, the project's SEO audits count as well. At the limit, New project and New target are off, and their tooltip names the Free limit. A target that is locked after switching to Free can only be renamed: Only the name can be changed. Premium removes the limit.

Troubleshooting

What you see Why What to do
Save stays grey No URL entered, or password protection on without a user. Fill in the field.
Please enter a user name. Password protection is on, the user is missing. Enter the user.
The target row says the stored password cannot be read The password cannot be decrypted, for example after restoring a backup on another Mac. Edit the target and enter the password again.

See also

Check automatically Free & Premium

Check automatically decides which targets the Monitor checks on its own at their interval and which only when you trigger a check. The switch exists on three levels: for everything, per project and per target. Checking by hand always works, even for targets that are checked by hand only.

Where to find it

Sidebar › Monitoring › Monitor:

  • at the top right next to the problem count: Check automatically
  • in the header of each project: automatic
  • in each target row: the switch on the far left of the actions (Check this target automatically)

On the command line, wd monitor auto on or wd monitor auto off switches everything, see Monitor and SEO.

How to do it

Pause everything, for example before a server move

  1. Turn off Check automatically at the top.
  2. All projects and targets are now off. Every target carries the by hand only badge.
  3. Turn the switch back on later. All projects and targets are then checked automatically again.

Pause one customer

  1. Turn off automatic in the project header.
  2. All targets of this project are now checked by hand only.

Pause a single target

Turn off the switch in the target row. Only this target is no longer checked automatically.

How the levels work together

What counts is always the target's own switch. The two upper switches only set it:

You switch What happens
Check automatically (top) Sets every project and every target to the same state.
automatic (project) Sets every target of this project to the same state.
A target's switch Applies to this target only.

Afterwards you can switch any lower level differently. If you turn a project off and then one of its targets on, exactly that target keeps being checked automatically. A new project takes the state of the top switch, a new target the state of its project.

You check by hand at any time with Check now in the target row or the detail view, and with Check all in the project or at the top of the page. These buttons check every target, whatever its switch says.

What happens in the background

Once a minute the Monitor looks for automatically checked targets that are due. A target is due when its last check is older than the interval under Check every. Targets on the same server are checked one after another with a short pause, different servers in parallel. If WebDonkey was closed for a while, the due checks are caught up on the next round. After your Mac wakes up, the Monitor waits about 30 seconds for the network to come back.

SEO audits never run automatically, whatever the switches say. They only start when you trigger them (see Start an audit).

Free and Premium

The switches are available on Free and Premium. Targets locked after switching to Free are checked neither automatically nor by hand, and their switch is locked.

Troubleshooting

What you see Why What to do
A target is not checked although Check automatically is on at the top The project or the target was switched off afterwards. Turn on the switch in the target row. The by hand only badge disappears.
Gaps in the history WebDonkey was closed or the Mac was offline. Nothing. Gaps are not outages.

See also

Target detail view Free & Premium

The detail view shows everything the Monitor knows about a target: the history of checks with response times, the page's structured data, the TLS certificate, the domain and the Lighthouse results. It is also where you confirm that a fix worked, without leaving the dialog.

Where to find it

In the overview, click a target's name or address. The button with the profile name on the second line opens the same view. The open view stays open when you switch pages and come back.

The header

At the top are the target's label and address. On the right:

  • Check now (circular arrow): checks the target right away and also reads certificate, domain and structured data again.
  • Full screen and Shrink: enlarge the dialog to the whole window and back.

History

  • At the top you pick the period: Today, 7 days or 30 days.
  • In large type you see the response time of the last check (last response), next to it the average of all successful checks in the period (Ø x ms).
  • The bar has one segment per check: green for success, red for failure. Hover over it to see time and response time, or the error.
  • Below is the share of successful checks, such as "98% ok · 96 checks in this period".

If there is no check in the period, it says No checks in this period.

Structured data

The Structured data section reads the page's JSON-LD blocks. These are the machine-readable details search engines use to build, for example, prices, ratings or breadcrumbs in a search result.

  • x JSON-LD block(s), x entities and how many of them are ok, with warnings or with errors.
  • Per entity its type with x error(s) and x warning(s). Expanded you see Required, missing, Recommended, missing and, under Content, the values that were read.
  • Known rules are checked for types including Product, Offer, Article, Organization, LocalBusiness, BreadcrumbList, FAQPage, Event, Recipe, VideoObject, Review and WebSite. For other types the view only shows the content that was read, without rule checks.
  • Google Rich Results opens the page in Google's Rich Results Test. That is Google's own verdict, which can differ.

Other states: Not checked yet., No structured data found or Structured data is broken with the reason when a block cannot be read.

TLS certificate and domain

  • TLS certificate: days until expiry (SSL x d), plus expiry date and issuer. For an HTTP target or a failed handshake it says No certificate data (HTTP target or handshake failed). The certificate is read over a separate connection, so the Monitor also reports a certificate that has already expired.
  • Domain: days until the registration expires (Domain x d), expiry date and registrar. If the domain ending publishes no date, it says No expiry date published for this TLD. That is not an error.

Lighthouse

The last section shows the Lighthouse results for desktop and mobile side by side and starts new runs. Everything about it is in Lighthouse.

What happens in the background

  • The Monitor keeps individual checks for 90 days and deletes older ones on its own.
  • On automatic checks it reads the certificate at most every 6 hours, the domain at most every 24 hours and the structured data at most every 10 minutes. Check now and Check all read everything again right away.
  • For the domain expiry date, WebDonkey asks the public RDAP service rdap.org about the domain name.

Free and Premium

If the target is locked after switching to Free, all earlier results stay visible. New checks and Lighthouse only run again with Premium.

Troubleshooting

What you see Why What to do
No certificate data … on an HTTPS site The TLS handshake failed. Check the site's certificate and port, then Check now.
No expiry date published for this TLD. The registry for this ending does not publish the date. Keep an eye on the expiry at your registrar.
Structured data is broken A JSON-LD block is not valid JSON. Check the output of the shop or plugin, then Check now.

See also

Lighthouse Free & Premium

Lighthouse is Google's page audit. It loads a page in a Chrome browser without a window and rates it in four areas from 0 to 100: performance, accessibility, best practices and SEO. It also measures the figures Google uses for loading behaviour. The Monitor runs Lighthouse on your Mac, for one target or for every target of a project.

Where to find it

  • For one target: open the detail view and scroll to the Lighthouse section.
  • For a whole project: Lighthouse in the project header.
  • On the command line: wd monitor lighthouse, see Monitor and SEO.

How to do it

Set it up once

Lighthouse needs two things on your Mac:

  1. Node.js with npm. If it is missing, the section says Needs Node/npm and points to the Services page. Install Node.js there.
  2. A Chrome-family browser: Google Chrome, Chromium, Brave or Microsoft Edge in the Applications folder. If none is found, it says Needs Chrome, Chromium, Brave or Edge. WebDonkey does not download a browser of its own.

Once Node.js is there but Lighthouse is not, click Install Lighthouse once. WebDonkey installs the npm package lighthouse globally.

Measure one target

  1. Open the target's detail view.
  2. In the Lighthouse section, click Test both, or only Desktop or Mobile.
  3. While it runs, the section shows which profile is running, for example Desktop · 1 of 2. One profile takes about 30 to 60 seconds.
  4. Afterwards the results of both profiles sit side by side.

The Mobile profile throttles CPU and network. The same page often scores noticeably lower there.

Measure a whole project

  1. Click Lighthouse in the project header.
  2. WebDonkey measures every target of the project one after another, desktop and mobile each. Allow about a minute per target.
  3. The button shows the progress, for example Lighthouse 2/5. Waiting targets show queued in their detail view.

Stop

Stop in the detail view applies to this one target. If it is running, Lighthouse stops after the current profile (stopping after this profile …). If it is still waiting, WebDonkey takes it out of the queue. Profiles already measured are kept, other targets in the queue carry on.

The results

Each profile has a block:

Element Meaning
Perf, A11y, Best, SEO The four scores as rings: green from 90, yellow from 50, red below.
LCP Largest Contentful Paint: when the main content is visible.
CLS Cumulative Layout Shift: how much the layout jumps while loading.
TBT Total Blocking Time: how long the page does not respond.
FCP First Contentful Paint: when the first content appears.
Speed Speed Index: how quickly the page visibly fills.
Date When it was measured.
Open report Opens the full Lighthouse HTML report.
in list Decides which profile the overview shows in the target row. The default is desktop.

Hover over a figure for a tooltip that explains it. If a profile has not been measured yet, it says Not run yet.

What happens in the background

  • Only one Lighthouse run happens at a time, others wait in a queue. Two windowless browsers at once would slow each other down and distort the scores.
  • A run carries on when you close the detail view or switch pages. The result is there as soon as it finishes.
  • One HTML report per target and profile stays on your Mac. A new run replaces it, deleting the target removes it.
  • If password protection is set for the target, Lighthouse logs in with it. The credentials are removed from the HTML report afterwards.
  • Lighthouse only starts when you click, never automatically.

Free and Premium

Lighthouse is part of the Monitor on Free and Premium. On Free you measure the up to three targets of your project. Targets locked after switching to Free are not measured.

Troubleshooting

What you see Why What to do
Needs Node/npm Node.js is not installed. Install Node.js on the Services page.
Install Lighthouse instead of the start buttons The npm package is still missing. Click the button once.
Needs Chrome, Chromium, Brave or Edge. No suitable browser found. Install one of these browsers in the Applications folder.
No Lighthouse in the project row Lighthouse is not set up yet, or every target is locked. Set it up once in a detail view.
Red message in the Lighthouse section The run failed. The scores of the other profile may still be fine. Read the message, close it with the cross and start again.

See also

Notifications and limits Free & Premium

The Monitor tells you when something changes on a target that you need to know about: a site goes down, is reachable again, or a certificate or domain is about to expire. It only reports real changes and never the same thing twice. This page explains when a notification comes, when it deliberately does not, and where the limits of a monitor running on your Mac lie.

Where to find it

Notifications land in the bell at the top of the sidebar (see Bell). If the WebDonkey window is in the background, macOS also shows a banner. You switch them on and off under Settings › Notifications, entry Monitoring.

When a notification comes

Event Notification
A target goes down Only once the outage still holds in the second check round.
A reported outage is over A notification that the target is reachable again.
TLS certificate As soon as the remaining time reaches 21 days, 7 days or 0 days, once per threshold. If it has already expired, the notification says so.
Domain registration As soon as the remaining time reaches 60 days, 14 days or 0 days, once per threshold.
SEO audit When an audit has finished, was cancelled, was interrupted or failed.

If several targets go down in one check round, you get a single notification with every target and its reason. The same goes for several targets that come back together. Notifications only come from the automatic checks, not from Check now or Check all.

The Monitor remembers which threshold it has already reported while WebDonkey is running. After an app restart it therefore reports the current threshold of a certificate or domain once more.

When there is deliberately no notification

  • Offline or asleep: without internet the Monitor measures nothing and reports nothing. It checks whether your Mac is online before every round.
  • Brief hiccups: if a check fails on a timeout, the connection, DNS or the certificate, or a server error (5xx, 429, 408), the Monitor repeats it twice, after about 20 and again after 40 seconds. It only counts as failed if every attempt fails. A deliberate answer from the site, such as 404, a missing keyword or rejected credentials, counts right away. A site flapping between up and down sends no notification.
  • Maintenance page: if a shop shows its maintenance page, it is listed as maintenance. Neither the start nor the end of the maintenance is reported.
  • Repetition: a site that is down for a week produces one notification, not hundreds.
  • Already down at start: the first checks after WebDonkey opens set the starting state. If a target is already down then, there is no notification, only on a later change.

What happens in the background

  • To find out whether your Mac is online, the Monitor sends short requests to Cloudflare (one.one.one.one) and Google (dns.google). If neither answers, the round pauses.
  • Targets on the same server are checked one after another, so a brief bottleneck on the server does not hit all its targets at once.
  • Check now repeats such a hiccup only once after three seconds and then shows you what it measured.

Limits

  • Not a 24/7 service: checks only run while WebDonkey is running. If the Mac sleeps or the app is closed, the history has a gap. A gap is not an outage.
  • Measured from your network: if a customer's firewall locks you out, the Monitor sees an outage that others do not.
  • If you need round-the-clock alerting, combine the Monitor with an external service.

In return you need no account with a monitoring service, and the list of your customer URLs stays on your Mac only.

Troubleshooting

What you see Why What to do
No notification despite an outage The Monitoring notification type is off, or the outage did not last two rounds. Turn it on under Settings › Notifications. Look at the history in the detail view.
No notification, target shows by hand only The target is not checked automatically. Turn on the switch in the target row, see Check automatically.
No banner, but an entry in the bell The window was in the foreground. Nothing. Banners only appear when the window is in the background.

See also

Cookie preferences

This website uses cookies to ensure the best experience possible. Your choice applies to webdonkey.io and the shop at shop.webdonkey.io. More information...

Technically required

Cookies required for this website to function:

Always on
WebDonkey
WebDonkey
Provider: BuI Hinsche GmbH, Neumarkt 7, 06712 Zeitz, Germany
Purpose: Your consent, colour scheme and language for website and shop, price switches; with wd_debug in the address, the measurement events in the developer console for troubleshooting
Cookies and storage: Cookie wd_consent on .webdonkey.io, shared with shop.webdonkey.io (12 months); cookies wd_theme and wd_lang on .webdonkey.io, shared with shop.webdonkey.io, only when you switch colour scheme or language yourself (365 days); localStorage wd:consent, wd:theme, wd:lang; sessionStorage wd:acc, wd:term, wd:debug (only with wd_debug in the address; until the tab closes)

Statistics

Shows us which pages and products people look at on webdonkey.io and in the shop, where visitors come from and how they get to a purchase (with order number, amount and products, without name or email address). Provider: Google. Transfer to the USA possible (EU-US Data Privacy Framework). Your choice applies to webdonkey.io and the shop together.

Google Tag Manager, Google Analytics 4
Google Tag Manager
Provider: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Ireland
Purpose: Loads the services you agreed to, here and in the shop. Sets no cookies of its own.
Cookies and storage: none
Privacy policy
Google Analytics 4
Provider: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Ireland
Purpose: Usage statistics: page views, clicks, scroll depth, sources, devices, load times; in the shop also basket, checkout, purchases, registration and sign-in
Cookies and storage: _ga, _ga_<ID> (2 years)
Privacy policy

Marketing

Measures whether our ads on Facebook, Instagram and TikTok lead to visits and downloads on webdonkey.io and to registrations and purchases in the shop, and builds audiences for ads. Providers: Meta and TikTok, with whom we are jointly responsible for this. With this consent Google may also set advertising cookies (_gcl_…). Transfer to the USA and other countries outside the EU possible. Your choice applies to webdonkey.io and the shop together.

Google Tag Manager, Meta Pixel (Facebook, Instagram), TikTok Pixel
Google Tag Manager
Provider: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Ireland
Purpose: Loads the services you agreed to, here and in the shop. Sets no cookies of its own.
Cookies and storage: none
Privacy policy
Meta Pixel (Facebook, Instagram)
Provider: Meta Platforms Ireland Limited, Merrion Road, Dublin 4, D04 X2K5, Ireland
Purpose: Ad measurement and target groups on Facebook and Instagram, also in the shop (basket, checkout, purchases, registration)
Cookies and storage: _fbp (3 months), _fbc (3 months, only if you arrive through an ad), fr on facebook.com (3 months)
Privacy policy
TikTok Pixel
Provider: TikTok Technology Limited, 10 Earlsfort Terrace, Dublin, D02 T380, Ireland
Purpose: Ad measurement and target groups on TikTok, also in the shop (basket, checkout, purchases, registration)
Cookies and storage: _ttp, _tt_enable_cookie (13 months)
Privacy policy