Skip to content

Latest commit

 

History

History
51 lines (43 loc) · 2.06 KB

README.md

File metadata and controls

51 lines (43 loc) · 2.06 KB

dynflowparser

Reads the dynflow files from a sosreport and generates user friendly html pages for Tasks, Plans, Actions and Steps

  • Only unsuccessful Tasks are parsed by default. (Use '-a' to parse all).
  • Failed Actions & Steps are automatically expanded on the Plan page for easy error location.
  • Indented Actions & Steps json fields.
  • Useful data on header: Hostname, Timezone, Satellite version, RAM, CPU, Tuning.
  • Dynflow UTC dates are automatically converted to honor sosreport timezone according to "/sos_commands/systemd/timedatectl".
  • Automatically opens output on default browser.
  • Lynx friendly.
Tasks list Task details Lynx

Dependencies

Required python libraries:

  • python3-dateutil
  • python3-jinja2

Usage

Usage: dynflowparser.py [Options] [INPUTDIR] [OUTPUTDIR]
  Options:
    [-a|--all]: Parse all Plans. By default only unsuccess are parsed.
    [-d|--debug]: Debug level [D,I,W,E]. Default Warning.
    [-f|--from]: Filter events running from this datetime.
    [-h|--help]: Show help.
    [-n|--nosql]: Reuse existent sqlite file. (Useful for self debuging)
    [-t|--to]: Filter events running up to this datetime.
    [-q|--quiet]: Quiet. Don't show progress bar.
  Arguments:
    [INPUTDIR]: Default is current path.
    [OUTPUTDIR]: Default is current path plus '/dynflowparser/'.

Limitations

  • sosreport by default requests last 14 days.
  • sosreport truncates output files at 100M, hence some records could be missing.
  • Only Dynflow schema version 24 is supported. (v20 is not CSV compliant)

How to accurately export tasks.

Included export-tasks.sh can be used to overcome sosreport size limitations and get an accurate tasks export tarball. Just execute it as follows.

Usage: export-tasks.sh DAYS RESULT
  DAYS: Number of days to export.
  RESULT: Filter exported tasks by result: [all cancelled error pending warning].
Example: ./export-tasks.sh 3 all