Gecko#
Gecko captures the state of an instrument machine at the moment something goes wrong, so engineers can diagnose the problem later without asking the operator to dig up files in the middle of the night.
One command records system information, copies the logs and summarizes their recent errors and warnings, screenshots every X11 display, grabs the newest science images, and packages it all into a single bundle that can be emailed to the team.
gecko -init
gecko -u "your.name" -m "Slicecam frames all zeros since 02:10 UT"
Get Gecko onto a Linux instrument machine, including the optional screenshot and email tools.
File a report when something breaks, and write a message engineers can use.
Every setting: log and science folders, report output, timestamps, and email.
The report folder, the .tar.gz bundle, and each section of the text report.
Error messages, missing screenshots, and errors that don’t show up in the summary.
All gecko options, exit codes, and environment variables.
Where to go next#
If you’re an operator, the operator guide is the only page you need. If you’re setting Gecko up on a machine, start with installation and then configuration. If you’re upgrading a checkout from before 0.2, read the upgrade notes before you pull.