|
@@ -27,7 +27,7 @@
|
|
.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
.\" POSSIBILITY OF SUCH DAMAGE.
|
|
.\" POSSIBILITY OF SUCH DAMAGE.
|
|
.\"
|
|
.\"
|
|
-.Dd November 23, 2009
|
|
|
|
|
|
+.Dd October 20, 2010
|
|
.Dt SYMON 8
|
|
.Dt SYMON 8
|
|
.Os
|
|
.Os
|
|
.Sh NAME
|
|
.Sh NAME
|
|
@@ -99,46 +99,74 @@ resources should be monitored and to which
|
|
.Xr symux 8
|
|
.Xr symux 8
|
|
the information should be streamed to.
|
|
the information should be streamed to.
|
|
.Pp
|
|
.Pp
|
|
-Multiple monitor statements to different muxes are allowed. Whitespace,
|
|
|
|
-newlines and text behind '#' are ignored. The format in BNF:
|
|
|
|
|
|
+Multiple monitor statements are allowed. Whitespace, newlines and text
|
|
|
|
+behind '#' are ignored. The format in BNF:
|
|
.Pp
|
|
.Pp
|
|
-.nf
|
|
|
|
|
|
+.Bd -literal -offset indent -compact
|
|
monitor-rule = "monitor" "{" resources "}" [every]
|
|
monitor-rule = "monitor" "{" resources "}" [every]
|
|
"stream" ["from" host] ["to"] host [ port ]
|
|
"stream" ["from" host] ["to"] host [ port ]
|
|
resources = resource [ version ] ["(" argument ")"]
|
|
resources = resource [ version ] ["(" argument ")"]
|
|
[ ","|" " resources ]
|
|
[ ","|" " resources ]
|
|
-resource = "cpu" | "cpuiow" | "debug" | "df" | "if" | "io" |
|
|
|
|
- "load" | "mbuf" | "mem" | "pf" | "pfq" | "proc" |
|
|
|
|
- "sensor" | "smart"
|
|
|
|
|
|
+resource = "cpu" | "cpuiow" | "debug" | "df" | "flukso" |
|
|
|
|
+ "if" | "io" | "load" | "mbuf" | "mem" | "pf" |
|
|
|
|
+ "pfq" | "proc" | "sensor" | "smart"
|
|
version = number
|
|
version = number
|
|
argument = number | name
|
|
argument = number | name
|
|
every = "every" time
|
|
every = "every" time
|
|
time = "second" | number "seconds"
|
|
time = "second" | number "seconds"
|
|
host = ip4addr | ip6addr | hostname
|
|
host = ip4addr | ip6addr | hostname
|
|
port = [ "port" | "," ] portnumber
|
|
port = [ "port" | "," ] portnumber
|
|
-.fi
|
|
|
|
|
|
+.Ed
|
|
.Pp
|
|
.Pp
|
|
Note that symux(8) data files default to receiving data every 5
|
|
Note that symux(8) data files default to receiving data every 5
|
|
-seconds. Adjusting the monitoring interval will also require adjusting every
|
|
|
|
-symux(8) datafile.
|
|
|
|
|
|
+seconds. Adjusting the monitoring interval will also require adjusting the
|
|
|
|
+associated symux(8) datafile(s).
|
|
.Pp
|
|
.Pp
|
|
The pf probe will return data that is collected for the
|
|
The pf probe will return data that is collected for the
|
|
.Pa loginterface
|
|
.Pa loginterface
|
|
set in /etc/pf.conf(5).
|
|
set in /etc/pf.conf(5).
|
|
|
|
+.Pp
|
|
|
|
+The Linux io, df, and smart probes support device names via id, label, path and uuid.
|
|
|
|
+.Pp
|
|
|
|
+The OpenBSD io probe supports device uuids.
|
|
|
|
+.Pp
|
|
.Sh EXAMPLE
|
|
.Sh EXAMPLE
|
|
-Here is an example
|
|
|
|
|
|
+Here is an example OpenBSD
|
|
.Ar symon.conf
|
|
.Ar symon.conf
|
|
that monitors cpu, memory, pf, interfaces xl0/de0/lo0/wi0, disks
|
|
that monitors cpu, memory, pf, interfaces xl0/de0/lo0/wi0, disks
|
|
wd[0-3]/cd[0-1], debug variables debug0 to debug19 and streams that
|
|
wd[0-3]/cd[0-1], debug variables debug0 to debug19 and streams that
|
|
information to localhost on port 2100.
|
|
information to localhost on port 2100.
|
|
.Pp
|
|
.Pp
|
|
-.nf
|
|
|
|
|
|
+.Bd -literal -offset indent -compact
|
|
monitor { cpu(0), mem, pf, if(xl0), if(de0),
|
|
monitor { cpu(0), mem, pf, if(xl0), if(de0),
|
|
if(lo0), if(wi0), io(wd0), io(wd1),
|
|
if(lo0), if(wi0), io(wd0), io(wd1),
|
|
io(wd2), io(wd3), io(cd0), io(cd1),
|
|
io(wd2), io(wd3), io(cd0), io(cd1),
|
|
io(ccd0), df(sd0a), df(sd0d), df(sd0e),
|
|
io(ccd0), df(sd0a), df(sd0d), df(sd0e),
|
|
debug, proc(httpd) } stream to 127.0.0.1 2100
|
|
debug, proc(httpd) } stream to 127.0.0.1 2100
|
|
-.fi
|
|
|
|
|
|
+.Ed
|
|
|
|
+.Sh EXAMPLE
|
|
|
|
+Here is an example Linux
|
|
|
|
+.Ar symon.conf
|
|
|
|
+that monitors cpu including iowait, memory, load, interface eth0, io and df for
|
|
|
|
+a set of disks every 5 seconds. Smart data is to be collected every 60 seconds.
|
|
|
|
+Disks in the smart and io statements are identified using ids, filesystem
|
|
|
|
+volumes in df using labels.
|
|
|
|
+.Bd -literal -offset indent -compact
|
|
|
|
+monitor { smart(ata-Hitachi_HDS722020ALA330_JK1130ABABABAB),
|
|
|
|
+ smart(ata-Hitachi_HDS722020ALA330_JK1130ACACACAC),
|
|
|
|
+ } every 60 seconds stream to 192.168.0.2 port 2100
|
|
|
|
+
|
|
|
|
+monitor { cpuiow(0), cpuiow(1), mem, if(eth0),
|
|
|
|
+ io(ata-Hitachi_HDS722020ALA330_JK1130ABABABAB),
|
|
|
|
+ io(ata-Hitachi_HDS722020ALA330_JK1130ACACACAC),
|
|
|
|
+ df(data_1),
|
|
|
|
+ df(data_2),
|
|
|
|
+ df(data_3),
|
|
|
|
+ df(home),
|
|
|
|
+ df(var),
|
|
|
|
+ load
|
|
|
|
+ } stream to 192.168.0.2 port 2100
|
|
|
|
+.Ed
|
|
.Sh SIGNALS
|
|
.Sh SIGNALS
|
|
.Bl -tag -width Ds
|
|
.Bl -tag -width Ds
|
|
.It SIGHUP
|
|
.It SIGHUP
|
|
@@ -171,7 +199,7 @@ The proc module is too simple: memory shared between two instances of the same
|
|
process is simply counted twice.
|
|
process is simply counted twice.
|
|
.Pp
|
|
.Pp
|
|
.Nm
|
|
.Nm
|
|
-does not check whether resources mentioned in
|
|
|
|
|
|
+does not check whether all resources mentioned in
|
|
.Pa /etc/symon.conf
|
|
.Pa /etc/symon.conf
|
|
exist.
|
|
exist.
|
|
.Pp
|
|
.Pp
|