Diagnostics

Diagnostics

The web interface

If it is switched on, most of this page is a browser tab instead: what each station sends, the last twenty raw uploads, which columns are missing, and which of them already hold readings. See Web interface.

The rest of this page is what to do without it, or before WeeWX is running at all.

All of it is about hardware that uploads. A station this machine reads over a cable sends nothing to inspect: there is no upload, no raw payload and no port to test. What it has instead is the log, which says whether the driver opened and what it is doing. See Troubleshooting.

When a sensor is missing

The driver writes out what it could not place, by itself:

cat /var/tmp/weewx-ultimate-push-report.txt

That file appears the first time a station sends something the driver cannot handle. It says which protocol it was, and holds the raw upload with everything that names the station replaced. See Reporting a new sensor.

Everything else

One command answers the rest:

python -m user.ultimatepush --port 8001

It listens for one upload, works out which protocol sent it, prints what it made of it, and changes nothing. WeeWX can keep running, as long as the port differs. Every protocol that posts is listened for, and each is answered the way its own firmware expects, so a console will not decide the upload failed.

Point the station at that port for one interval: for an Ecowitt console, WS View Plus → Weather Services → Customized, change the port, save. Change it back afterwards.

A WeatherFlow hub cannot be pointed anywhere, so this command does not see it. Enable the protocol in the driver and read the log instead.

Options

Option	Default	Meaning
--port	8000	Port to listen on.
--address	every interface	Address to bind to.
--path	every path	Accept this path only.
--samples	1	How many uploads to wait for.
--timeout	300	Seconds before giving up.
--config	/etc/weewx/weewx.conf	Used for the database check and the printed commands.
--infer-unknown	all	Here everything gets a proposal, so nothing is hidden.
--no-database		Skip the database check.

What it prints

Which protocol it was, and which catalog read it.

POST / from 1.2.3.6, 762 bytes
  Ecowitt, read with the 'ecowitt' catalog

That line matters more than it looks. Half a station's fields going missing is usually this being something other than what you expected.

Every reading, with the field it went to.

37 readings
  UV                         2.0
  barometer                  29.92
  extraTemp9                 66.2
  lightning_distance         1.0
  soilMoist1                 30.0
  ...

Anything the catalog did not cover, with how it was worked out:

2 fields were not in the catalog
  last24hrainin  -> ecowitt_last24hrainin  group_rain  guessed: name matches rain.*in$
  yearlyrainin   -> ecowitt_yearlyrainin   group_rain  guessed: name matches rain.*in$

The columns that are missing, as commands to run:

20 readings have nowhere to live. To keep them:

  weectl database add-column soilTemp2 --type REAL --config=/etc/weewx/weewx.conf -y
  ...

Fields waiting for a decision, as a block to paste:

6 fields are not being written, because where they go is your call and
not the hardware's. Paste this into your driver section and uncomment the
line you want:

    [[field_map_extensions]]
        # tf_ch1
        #tf_ch1 = extraTemp9        # this driver
        #tf_ch1 = soilTemp1         # ecowittcustom

Which of those columns already hold readings:

12 of these fields already hold readings:

  soilTemp1                     104832 values, last 2026-08-25

Raw uploads in the log

For a continuous view, or when the console cannot be pointed elsewhere:

[UltimatePush]
    log_raw = true

Restart WeeWX. Every upload appears at debug level:

DEBUG weewx.listener: Raw request: PASSKEY=...&tempinf=75.4&humidityin=51&...

Debug logging has to be on for it to be visible:

debug = 1

Turn both off afterwards. At an eight second interval this fills a log quickly.

Is anything arriving at all

sudo tcpdump -i any -n port 8000

Nothing there means the problem is between the console and the machine: wrong address, wrong port, a firewall, or the console not saving the setting. WS View Plus sometimes reports a save that did not happen; check the page again after leaving it.

Is the port open

ss -tlnp | grep 8000

Should show weewxd. If it shows something else, the driver never got the port and the log says so:

ERROR weewx.listener: Cannot listen on 0.0.0.0:8000: [Errno 98] Address already in use