Querying FireWorks and Workflows / Generating Reports

FireWorks provides two functions for getting information about your Workflows. The lpad get_fws command queries individual FireWorks (steps in a Workflow), whereas the lpad get_wflows command queries entire Workflows. The reporting features allows you to generate detailed reports about runtime statistics.

Full usage of these commands can be found through the built-in help:

lpad get_fws --help
lpad get_wflows --help
lpad report --help

Note that there is also a visual web interface to job status, see web interface guide.

Example queries - FireWorks

1. Count the number of completed FireWorks:

   lpad get_fws -s COMPLETED -d count
   

2. Show all information for the 3 most recently updated FIZZLED FireWorks:

   lpad get_fws -s FIZZLED -d all -m 3 --rsort updated_on
   

3. Show all information of the Firework with name set to my_fw:

   lpad get_fws -n my_fw -d all
   

4. Show a summary of the Firework with fw_id of 1:

   lpad get_fws -i 1 -d more
   

5. Show a summary of all FireWorks where the spec contains a value of my_parameter equal to 3:

   lpad get_fws -q '{"spec.my_parameter":3}' -d more
   

Example queries - Workflows

1. Count the number of completed Workflows:

   lpad get_wflows -s COMPLETED -d count
   

2. Show all information for the 3 most recently updated FIZZLED Workflows:

   lpad get_wflows -s FIZZLED -d all -m 3 --rsort updated_on
   

3. Show all information of the Workflow with name set to my_wf:

   lpad get_wflows -n my_wf -d all
   

4. Show a summary of the Workflow containing a Firework with fw_id of 1:

   lpad get_wflows -i 1 -d more
   

5. Show a summary of all Workflows where the metadata contains a value of my_parameter equal to 3:

   lpad get_wflows -q '{"metadata.my_parameter":3}' -d more
   

Example queries - Reporting

1. Get a report of what happened to recently updated Fireworks:

   lpad report
   

2. Get report about workflows or jobs:

   lpad report -c wflows
   lpad report -c launches
   

3. Customize the reporting interval, e.g. see what happened the last 6 months:

   lpad report -i months -n 6
   

4. You can easily e-mail the report by using the mail command on a unix system:

   lpad report | mail -s "Fireworks report" you@example.com