cfilt man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

cfilt(8)							      cfilt(8)

NAME
       cfilt - A filter for Collect

SYNOPSIS
       /usr/sbin/cfilt-an-finput-fileexpressionexpression ...-p-u

OPTIONS
       Average	values for N (number of samples).  Selects the input data file
       and the expressions used to operate on that data. If this option is not
       used,  cfilt gets input from stdin.  Selects only the samples that con‐
       tain process data. This is useful when a separate process interval  was
       given  to  Collect,  such  -i1,4,  but  you  want to graph process data
       against some non-process data, such as cpu idle.	 Unbuffered mode as -u
       for  the	 cat  command: forces a flush for each line. Used by the -live
       option of collgui.

DESCRIPTION
       The cfilt utility allows the arbitrary selection	 of  values  from  the
       output of Collect. It condenses the output of Collect into one line per
       sample, or per N samples, if using the -a option to average N  samples.
       The data in this form can be graphed using gnuplot or Excel.

       cfilt  can  also	 be  used live , that is, as a filter to Collect while
       it's collecting and writing to standard output. This only works	if  no
       normalization  is being done, as that requires that all samples be seen
       so that cfilt can determine the highest value, which is	then  used  to
       normalize.

       The first two columns in cfilt's output are always the epoch-second and
       sample-number. The epoch-second is the internal UNIX time  format,  the
       number of seconds since the beginning of the epoch , January 1st, 1970.
       This is extracted directly from the Collect output: at the beginning of
       each  record  there  is	a  line similar to the following: ### RECORD 1
       (873230968:160) (Tue Dec 2 22:09:28 2000) ###

       In this example, epoch-seconds is 873230968. The sample-number is  also
       extracted from this line. In this example it is 1.

   Expressions
       An expression has the following syntax:

       subsystem:selection-criterion:tag-expr1:tag-expr2:...:tag-exprN

   Subsystems
       The  following  comprise	 the  subsystems cfilt recognizes: proc, disk,
       mem, net, cpu, sin, file, tty, and lsm (first 3 chars are significant).

       If a plus-sign (+) is on the end, or no selection  criterion  has  been
       given,  then  numerical values are summed for all lines of a subsystem.
       If a selection criterion has been provided, and there is no  plus  sign
       on  the end of the subsystem name, then for each value in the selection
       criterion, the corresponding values for each tag-expr will be  printed.
       For example, given the following output from Collect:

    Table 1: # DISK Statistics""
       ────────────────────────────────────────────────────────────
       #DSK   NAME   B/T/L   R/S   RKB/S   W/S	 AVS   QLEN   %BSY
       ────────────────────────────────────────────────────────────
       O      rz1    0/1/0   5	   300	   10	 10    0      70
       1      rz2    0/2/0   7	   400	   11	 10    0      80
       2      rz3    0/3/0   9	   500	   212	 10    0      90
       ────────────────────────────────────────────────────────────

       Assuming that cfilt is called with the single following expression:

       disk:r/s

       cfilt would sum reads/second for all disks. That is, 5+7+9=21. The out‐
       put of cfilt would be:

       YYYY:MM:DD:HH:mm:SS sample# 21

       The expression disk+:name=rz1,rz2:r/s would sum reads/second for	 disks
       rz1 and rz2, 5+7=12.		   (name=rz1,rz2 is a selection-crite‐
       rion, which is discussed below.) The output of cfilt would be:

       YYYY:MM:DD:HH:mm:SS sample# 12

       The expression disk+:name=rz1,rz2:rkb/s+wkb/s would sum KiloBytes  read
       and     written	   for	   disks		    rz1	   and	  rz2,
       300+400+1000+2000=3700, as follows (rkb/s+wkb/s	is  a  tag-expression,
       which is		       discussed below.):

       YYYY:MM:DD:HH:mm:SS sample# 3700

       The  expression	disk:name=rz1,rz2:r/s would print reads/second for rz1
       and reads/second for rz2,		as follows:

       YYYY:MM:DD:HH:mm:SS sample# 5 7

RESTRICTIONS
       The following restrictions apply when using cfilt:

       When normalizing and averaging are used, the highest  normalized	 value
       will  not		     necessarily  be as high as the value used
       for normalizing.

EXAMPLES
       This command provides a CPU summary:

	      # cfilt -fdata.in cpu:user+sys:intr#:sysc#:cs#

	      The command generates the following output:

	      [time] [sample#] [user+sys] [interrupts] [syscalls] [conswitch]

	      (where interrupts,  syscalls,  and  conswitch  are  normalized).
	      This command provides a CPU summary:

	      # cfilt -fdata.in cpu:user+sys:intr#:sysc#:cs#

	      The command generates the following output:

	      [time]  [sample#] [user+sys] [interrupts] [syscalls] [conswitch]
	      This command provides a system overview:

	      # cfilt -fdata.in cpu:idle net:inpck+outpck# mem:free#

	      The command generates the following output:

	      [time]  [sample#]	 [cpu:idle]  [net:inpck=outpck	 (normalized)]
	      [mem:free	 (normalized)]	This  command  provides	 user  process
	      information:

	      # cfilt -fdata.in proc+:user=smith:rss

	      The command generates the following output:

	      [time] [sample#] [rss (resident  set  size)  for	all  processes
	      owned by smith] This command provides user process information:

	      # cfilt -fdata.in pro:pid=1234,8888:rss:vsz

	      The command generates the following output:

	      [time]	 [sample#]     [rss(pid=1234)]	   [vsz	   (pid=1234)]
	      [rss(pid=8888)] [vsz(pid=8888)] This  command  provides  process
	      information:

	      # cfilt -fdata.in pro+:pid=1234,8888:rss:vsz

	      The command generates the following output:

	      [time]  [sample#] [rss(sum for pid 1234, 8888)] [vsz (sum)] This
	      command provides process information:

	      # cfilt -fdata.in pro+:rss:vsz

	      The command generates the following output:

	      [time] [sample#] [rss(sum all procs)] [vsz (sum for all procs)]

FILES
       The executable image.

SEE ALSO
       Commands: collgui(8), collect(8)

       Manuals: System Configuration and Tuning Guide,	System	Administration
       Guide

								      cfilt(8)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net