.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "TORRUS_SCHEDULERINFO 8" .TH TORRUS_SCHEDULERINFO 8 "2021-01-07" "torrus 3.00" "torrus" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" schedulerinfo \- Displays extended scheduler tasks information. .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBtorrus schedulerinfo\fR \-\-tree=\fI\s-1TREENAME\s0\fR [\fIoptions...\fR] .SH "DESCRIPTION" .IX Header "DESCRIPTION" This utility displays the extended scheduler tasks information for tree \&\fI\s-1TREENAME\s0\fR on standard output. This might be useful for scheduler planning and analysis. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-\-config\fR" 4 .IX Item "--config" Reports scheduler's configuration. The values are explained below. .RS 4 .IP "Total collector/monitor leaves: \fIN\fR" 8 .IX Item "Total collector/monitor leaves: N" Total number of datasources being processed by collector or monitor daemon. .IP "Scheduled leaves by type" 8 .IX Item "Scheduled leaves by type" Torrus supports arbitrary number of collector types, and this report shows how many datasources belong to every type. Currently the monitor leaves are not divided into types. .IP "Least common period: \fIN\fR seconds" 8 .IX Item "Least common period: N seconds" The report below shows how the tasks are distributed across the time line, and the least common period shows the period of this time line. .IP "Tasks execution timeline" 8 .IX Item "Tasks execution timeline" This report tells which task and how many datasources are involved in each task startup event, and how these events are dispersed across the time. The column \fIInterval\fR shows the time interval from each task execution event to the next event on the timeline. .RE .RS 4 .RE .IP "\fB\-\-runtime\fR" 4 .IX Item "--runtime" Reports scheduler's runtime statistics, such as running cycle times, late starts etc. The meaning of the output values is as follows. Values that have zero values are usually not printed. .RS 4 .IP "Task: \fIName\fR, Period: \fIN\fR seconds, Offset: \fIM\fR seconds" 8 .IX Item "Task: Name, Period: N seconds, Offset: M seconds" Each scheduler task is characterized by its name (usually Collector or Monitor), period, and timeoffset. Fore example, if period is set to 300 seconds, and offset is 14 seconds, then the task would be executed at 00:00:14, 00:05:14, 00:10:14, and so on for every hour in a day. .IP "\fIN\fR running cycles passed" 8 .IX Item "N running cycles passed" How many times the task was executed since last reset. The counter is normally reset after \fBtorrus_compilexml\fR\|(8) successfully compiles the configuration. .IP "\fIN\fR late starts" 8 .IX Item "N late starts" How many times the task has started with a delay from its normal schedule. .IP "\fIN\fR too long runs" 8 .IX Item "N too long runs" How many times the task execution time was longer than its period. .IP "\fIN\fR overrun periods" 8 .IX Item "N overrun periods" How many periods have been missed because of too long executions. .IP "\fIN\fR missed periods" 8 .IX Item "N missed periods" How many periods were missed because of any reason (such as other tasks delaying). .IP "Min, Max, Average, Exp Average" 8 .IX Item "Min, Max, Average, Exp Average" The time values are displayed in four columns: Minimum, Maximum and Average values since last reset, and Exponential decay value, which may be interpreted as the average for last several values. With defaults defined in \&\fItorrus\-config.pl\fR, 95% of the average is calculated from last 3 values. .IP "Running Time" 8 .IX Item "Running Time" How long the task executes each period. .IP "Late Start" 8 .IX Item "Late Start" How long the task start was delayed. .IP "Too Long" 8 .IX Item "Too Long" How much time the too long run took. .IP "\s-1RRD\s0 Queue" 8 .IX Item "RRD Queue" In a multithreaded environment, the \s-1RRD\s0 files are written in a background thread. This value shows the length of the \s-1RRD\s0 update queue at the beginning of each update cycle. .RE .RS 4 .RE .IP "\fB\-\-help\fR" 4 .IX Item "--help" Displays a help message. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBtorrus\fR\|(8), \&\fBtorrus_compilexml\fR\|(8) .SH "NOTES" .IX Header "NOTES" See more documentation at Torrus home page: http://torrus.org .SH "AUTHOR" .IX Header "AUTHOR" Stanislav Sinyagin