taskotop

8 Version 1.0

`taskotop`

Utility to monitor what the taskomatic daemon is doing.

            taskotop

    	    -e
    	    -r

            -m MAXAGE
            -n NUMITERATIONS
            -t
            -v-v-v-v
            --hide-elapsed
            --show-start
            --logfile LOGFILE

            taskotop

    	    --each-task
    	    --recent-history

            --max-age MAXAGE
            -n NUMITERATIONS
            --taskomatic
            --verbose--verbose--verbose--verbose
            --hide-elapsed
            --show-start
            --logfile LOGFILE

            taskotop
            -h

            taskotop
            --help

## Description

`taskotop` is a utility that displays the status of currently-executing or recently-completed taskomatic tasks. It optionally displays information about the running taskomatic daemon.

`taskotop` provides an updating terminal-window view of the currently-executing taskomatic tasks, similar to the way the top command works for general processes. It provides the following information for tasks that are currently executing or which have finished within the last minute:

RUN ID

- Unique ID of the run. An ID can be used to obtain additional information. If a specific task produced any standard output or error output during its run, it can be found in /var/log/rhn/tasko/sat/*/*_RUN_ID_{out,err}.

TASK NAME

- Name of a taskomatic task as shown on Admin/Task Schedules, 'Bunch' details. For example, the cleanup-data-bunch includes the TASK NAMEs 'cleanup-packagechangelog-data' and 'cleanup-timeseries-data'.

START

- The date and time the task run was started. This column of information is hidden by default and can be enabled with the `--show-start` command line argument.

ELAPSED

- How long the task has been running. This column of information is displayed by default and can be hidden with the `--hide-elapsed` command line option.

END

- The date and time the task run ended.

CHANNEL

- When a channel-repodata task is in the running state, this column shows the label of the channel for which taskomatic is currently processing data.

The general taskomatic log file can be found at /var/log/rhn/rhn_taskomatic_daemon.log

## Options

-h, --help

- Display the help screen with a list of options.

-e, --each-task

- Display most recent run for each task instead of recent task run history.

-r, --recent-history

- Display recent history of task runs. This is the default display mode.

-H, --human-readable

- Use human readable time output. Time will be displayed in the format [[days:]hours:]min:sec instead of total seconds.

-m `MAXAGE`, --max-age `MAXAGE`

- Retrieve past events up to this old (in seconds, default 60). This has no effect if -e/--each-task is specified.

-n `NUMITERATIONS`

- `taskotop` will iterate the specified number of times and then exit. If not specified or 0 (the default), `taskotop` will run until the user exits taskotop.

-t, --taskomatic

- Include taskomaticd process information in the output.

-v [-v [-v [-v] ] ], --verbose [--verbose [--verbose [--verbose] ] ]

- Increase log output verbosity. Specify multiple times, up to 4 to increase verbosity.

--hide-elapsed

- Hide the ELAPSED column in the display.

--show-start

- Include the START column in the display.

--logfile `LOGFILE`

- Specify logfile to use if at least one verbose arg specified. Default is ./taskotop.log

## Interactive Commands

While `taskotop` is running, these one-character interactive commands may be used.

e

- Change display mode to show each task's latest run.

h

- Display the interactive command help page.

H

- Toggle human readable format. This toggles the time display between [[days:]hours:]min:sec format and total seconds.

q

- Quit `taskotop`.

r

- Change display mode to show recent history of task runs.

t

- Toggle taskomatic process information display.

## Authors

- Tomas Kasparektkasparek@redhat.com
- Eric Hergeteherget@redhat.com