2.3 KiB
weectl report
Use the weectl subcommand report to run and list reports.
Specify --help to see the actions and options.
List reports
weectl report list
[--config=FILENAME]
The list action will list all the reports in the configuration file, along
with which skin they use, and other information. For example:
$ weectl report list
The configuration file /Users/ted_user/weewx-data/weewx.conf will be used.
Report Skin Enabled Units Language
SeasonsReport Seasons Y US EN
SmartphoneReport Smartphone N US EN
MobileReport Mobile N US EN
StandardReport Standard N US EN
FTP Ftp N US EN
RSYNC Rsync N US EN
Run reports on demand
weectl report run
[--config=FILENAME]
[--epoch=EPOCH_TIME | --date=YYY-MM-DD --time=HH:MM]
In normal operation, WeeWX generates reports at each archive interval after new
data has arrived. The action weectl report run is used to generate reports on
demand. It uses the same configuration file that weewxd uses.
By default, the reports are generated as of the last timestamp in the database,
however, an explicit time can be given by using either option --epoch, or by
using options --date and --time.
For example, to specify an explicit unix epoch time, use option --epoch:
weectl report run --epoch=1652367600
This would generate a report for unix epoch time 1652367600 (12-May-2022 at 8AM PDT).
Alternatively, you can specify a date and time, by using options --date and
--time:
weectl report run --date=2022-05-12 --time=08:00
This would generate a report for 12-May-2022 at 8AM (unix epoch time 1652367600).
Options
These are options used by most of the actions.
--help
Show the help message, then exit.
--config
Path to the configuration file. Default is ~/weewx-data/weewx.conf.
--epoch=EPOCH_TIME
Generate the reports so that they are current as of the given unix epoch time.
--date=YYYY-MM-DD and --time=HH:MM
Generate the reports so that they are current as of the given date
and time. The date should be given in the form YYYY-MM-DD and the time should
be given as HH:DD.