What’s in a report#

Each run writes into a folder named after the UTC date, inside the configured report_path:

<report_path>/
└── 2026-11-06/
    ├── gecko_report_07:13:05.123456.txt         # the text report
    ├── gecko_screenshot_:0_07:13:05.123456.png  # one per X11 display
    ├── camera.log                                # copies of every file in logs_dir
    ├── motor.log
    ├── acam_0002.fits                            # newest science file(s)
    └── gecko_2026-11-06_071305_1234560000.tar.gz # the bundle

The times in file names are the UTC time of the run. All files are placed flat in the dated folder, so the folder structure of logs_dir is not kept.

The bundle (.tar.gz)#

The bundle is what gets emailed and is the file to share. It contains:

  • the text report from this run,

  • this run’s screenshots,

  • the newest science file(s) copied by this run,

  • every file in the dated folder whose name contains .log.

Unpack it with:

$ tar -xzf gecko_2026-11-06_071305_1234560000.tar.gz

Note

Because logs are copied flat into the dated folder, a bundle can also contain logs copied by earlier runs on the same UTC day. Two log files with the same name in different sub-folders of logs_dir overwrite each other. Both are known limitations and are planned to change.

The text report#

gecko_report_<time>.txt has these sections, in order:

Reported Error From User

The USER: and MESSAGE: given on the command line.

System Information

The configured OS and version, CPU counts, per-CPU usage sampled over 3 seconds, CPU frequencies, CPU statistics and times, temperature sensors (where the hardware reports them) and memory usage. Values are printed as Python’s psutil reports them.

One section per .log file (headed =====/path/to/file.log=====)

Lines from that log that mention error or warning and have a timestamp from the last 24 hours. See time_pattern in the [Report] section for the exact rules. An empty section means nothing matched.

Science directory notes

Only present when a science folder was missing or empty.