|
@@ -1,6 +1,6 @@
|
|
.\" -*- nroff -*-
|
|
.\" -*- nroff -*-
|
|
.\"
|
|
.\"
|
|
-.\" Copyright (c) 2001-2003 Willem Dijkstra
|
|
|
|
|
|
+.\" Copyright (c) 2001-2004 Willem Dijkstra
|
|
.\" All rights reserved.
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
@@ -72,11 +72,13 @@ the rrd files. It should be run as
|
|
The options:
|
|
The options:
|
|
.Bl -tag -width Ds
|
|
.Bl -tag -width Ds
|
|
.It Fl v
|
|
.It Fl v
|
|
-Show version information.
|
|
|
|
|
|
+Show version.
|
|
.It Fl d
|
|
.It Fl d
|
|
Stop
|
|
Stop
|
|
.Nm
|
|
.Nm
|
|
-from becoming a daemon and show debug information on stdout.
|
|
|
|
|
|
+from becoming a daemon and show debug information on stdout. Use this setting
|
|
|
|
+to find hosts or specific statistics that do get sent, but are ignored due to
|
|
|
|
+configuration.
|
|
.It Fl f Ar filename
|
|
.It Fl f Ar filename
|
|
Read configuration from
|
|
Read configuration from
|
|
.Ar filename
|
|
.Ar filename
|
|
@@ -102,12 +104,17 @@ stmt = mux-stmt | source-stmt
|
|
mux-stmt = "mux" host [ port ]
|
|
mux-stmt = "mux" host [ port ]
|
|
host = ip4addr | ip6addr | hostname
|
|
host = ip4addr | ip6addr | hostname
|
|
port = [ "port" | "," ] portnumber
|
|
port = [ "port" | "," ] portnumber
|
|
-source-stmt = "source" host "{" accept-stmts write-stmts [ datadir-stmt ] "}"
|
|
|
|
|
|
+source-stmt = "source" host "{"
|
|
|
|
+ accept-stmts
|
|
|
|
+ write-stmts
|
|
|
|
+ [ datadir-stmt ] "}"
|
|
accept-stmts = accept-stmt [accept-stmts]
|
|
accept-stmts = accept-stmt [accept-stmts]
|
|
accept-stmt = "accept" "{" resources "}"
|
|
accept-stmt = "accept" "{" resources "}"
|
|
-resources = resource ["(" argument ")"] [ ","|" " resources ]
|
|
|
|
|
|
+resources = resource version ["(" argument ")"]
|
|
|
|
+ [ ","|" " resources ]
|
|
resource = "cpu" | "mem" | "if" | "io" | "pf" | "debug" |
|
|
resource = "cpu" | "mem" | "if" | "io" | "pf" | "debug" |
|
|
- "proc" | "mbuf" | "sensor"
|
|
|
|
|
|
+ "proc" | "mbuf" | "sensor"
|
|
|
|
+version = "" | number
|
|
argument = number | interfacename | diskname
|
|
argument = number | interfacename | diskname
|
|
datadir-stmt = "datadir" dirname
|
|
datadir-stmt = "datadir" dirname
|
|
write-stmts = write-stmt [write-stmts]
|
|
write-stmts = write-stmt [write-stmts]
|
|
@@ -122,9 +129,13 @@ in the
|
|
specifies the port-number for both the udp port (incoming
|
|
specifies the port-number for both the udp port (incoming
|
|
.Xr symon 8
|
|
.Xr symon 8
|
|
traffic) and the tcp port for incoming listeners.
|
|
traffic) and the tcp port for incoming listeners.
|
|
|
|
+.It Va version
|
|
|
|
+is needed to distinguish between the same type of information (i.e.
|
|
|
|
+.Va io
|
|
|
|
+) coming from different versions of OpenBSD. If no version number is
|
|
|
|
+supplied, the latest will be assumed.
|
|
.It Va datadir
|
|
.It Va datadir
|
|
-will guess filenames for all
|
|
|
|
-accepted streams.
|
|
|
|
|
|
+will guess filenames for all accepted streams.
|
|
.Va write
|
|
.Va write
|
|
statements always take precendence over a
|
|
statements always take precendence over a
|
|
.Va datadir
|
|
.Va datadir
|
|
@@ -148,7 +159,7 @@ source 127.0.0.1 {
|
|
io(wd0), io(wd1), io(wd2),
|
|
io(wd0), io(wd1), io(wd2),
|
|
io(wd3), io(cd0), io(cd1) }
|
|
io(wd3), io(cd0), io(cd1) }
|
|
|
|
|
|
- datadir "/export/symon/localhost"
|
|
|
|
|
|
+ datadir "/var/www/symon/rrds/localhost"
|
|
}
|
|
}
|
|
.fi
|
|
.fi
|
|
.Sh LISTENERS
|
|
.Sh LISTENERS
|
|
@@ -158,23 +169,25 @@ offers received
|
|
data to other programs via tcp. An example of a listener session:
|
|
data to other programs via tcp. An example of a listener session:
|
|
.Pp
|
|
.Pp
|
|
.nf
|
|
.nf
|
|
-hoard:~/project/symon$ telnet 127.0.0.1 2100
|
|
|
|
-Trying 127.0.0.1...
|
|
|
|
-Connected to 127.0.0.1.
|
|
|
|
|
|
+nexus:~/project/symon$ telnet 10.0.0.1 2100
|
|
|
|
+Trying 10.0.0.1...
|
|
|
|
+Connected to 10.0.0.1.
|
|
Escape character is '^]'.
|
|
Escape character is '^]'.
|
|
|
|
|
|
-127.0.0.1;io:cd1:1027452867:262:308:536576;io:cd0:1027452867
|
|
|
|
-:0:0:0;io:wd3:1027452867:249140:249140:11797277696;io:wd2:10
|
|
|
|
-27452867:4074001:4074001:64923271168;io:wd1:1027452867:43183
|
|
|
|
-9:431839:11880622080;io:wd0:1027452867:10890717:10890717:125
|
|
|
|
-382360064;if:lo0:1027452867:86952111:86952111:1164079422:116
|
|
|
|
-4079422:0:0:0:0:0:0;if:de0:1027452867:117562055:90333984:405
|
|
|
|
-8603563:1844391820:2588654:1:0:0:4013757:0;if:xl0:1027452867
|
|
|
|
-:149845272:187785769:2494862812:739916810:43291:1:3:0:318440
|
|
|
|
-7:0;mem::1027452867:26566656:68579328:323141632:3571712:1047
|
|
|
|
-67488;cpu:0:1027452867:0.00:0.00:0.00:0.00:99.00;
|
|
|
|
-^]
|
|
|
|
|
|
+10.0.0.1;mem::1077662160:7630848:53850112:469417984:0:25600;cpu:0:
|
|
|
|
+1077662160:0.00:0.00:0.30:0.20:99.50;io:wd0:1077662160:2074:12759:
|
|
|
|
+0:30736384:131780608;
|
|
|
|
+10.0.0.2;mbuf::1077658247:138:74:0:0:41:0:23:0:90:360:868352:25:0:
|
|
|
|
+0:0;pf::1077658247:700930123:535398451:0:352:1107229:706391:119833
|
|
|
|
+9:4:0:0:2:3:29:4109383:83291:83262:980325:0:1:6:0:0;mem::107765824
|
|
|
|
+7:79155200:131956736:391430144:0:536739840;cpu:0:1077658247:0.50:0
|
|
|
|
+.00:0.00:0.90:98.60;proc:httpd:1077658247:9:216:172:8:3:0.00:14999
|
|
|
|
+552:0;if:lo0:1077658247:147104:147104:45868177:45868177:0:0:0:0:0:
|
|
|
|
+0;if:xl0:1077658247:284267:452077:150620236:273265863:372:89478:0:
|
|
|
|
+0:0:0;if:de0:1077658247:1813721:1197722:729054136:568900227:101:2:
|
|
|
|
+0:0:198:0;
|
|
|
|
|
|
|
|
+^]
|
|
telnet> close
|
|
telnet> close
|
|
Connection closed.
|
|
Connection closed.
|
|
.fi
|
|
.fi
|
|
@@ -184,7 +197,7 @@ The format is
|
|
:
|
|
:
|
|
.Va symon-host-ip
|
|
.Va symon-host-ip
|
|
:
|
|
:
|
|
-.Va io|if|cpu|mem|pf|mbuf|proc|debug
|
|
|
|
|
|
+.Va stream-name
|
|
:
|
|
:
|
|
.Va stream-argument
|
|
.Va stream-argument
|
|
:
|
|
:
|
|
@@ -199,15 +212,19 @@ Time spent in ( user, nice, system, interrupt, idle ). Total time is 100, data
|
|
is offered with precision 2.
|
|
is offered with precision 2.
|
|
.It mem
|
|
.It mem
|
|
Memory in ( real_active, real_total, free, swap_used, swap_total ). All values
|
|
Memory in ( real_active, real_total, free, swap_used, swap_total ). All values
|
|
-are in bytes rounded of to page boundaries. Values are 32 bit unsigned integers
|
|
|
|
-internally.
|
|
|
|
|
|
+are in bytes rounded of to page boundaries. Values are 32 bit unsigned integers.
|
|
.It if
|
|
.It if
|
|
Interface counters ( packets_in, packets_out, bytes_in, bytes_out,
|
|
Interface counters ( packets_in, packets_out, bytes_in, bytes_out,
|
|
multicasts_in, multicasts_out, errors_in, errors_out, collisions, drops
|
|
multicasts_in, multicasts_out, errors_in, errors_out, collisions, drops
|
|
-). Values are 32 bit unsigned integers internally.
|
|
|
|
|
|
+). Values are 32 bit unsigned integers.
|
|
.It io
|
|
.It io
|
|
-Io/disk counters ( total_transfers, total_seeks, total_bytes ). Values are 64
|
|
|
|
-bit unsigned integers internally.
|
|
|
|
|
|
+Alias for io2. See below.
|
|
|
|
+.It io1
|
|
|
|
+Pre OpenBSD 3.5 io/disk counters ( total_transfers, total_seeks, total_bytes
|
|
|
|
+). Values are 64 bit unsigned integers.
|
|
|
|
+.It io2
|
|
|
|
+Io/disk counters ( total_rxfers, total_wxfers, total_seeks, total_rbytes,
|
|
|
|
+total_wbytes). Values are 64 bit unsigned integers.
|
|
.It pf
|
|
.It pf
|
|
Packet filter statistics ( bytes_v4_in : bytes_v4_out : bytes_v6_in :
|
|
Packet filter statistics ( bytes_v4_in : bytes_v4_out : bytes_v6_in :
|
|
bytes_v6_out : packets_v4_in_pass : packets_v4_in_drop : packets_v4_out_pass :
|
|
bytes_v6_out : packets_v4_in_pass : packets_v4_in_drop : packets_v4_out_pass :
|
|
@@ -215,7 +232,7 @@ packets_v4_out_drop : packets_v6_in_pass : packets_v6_in_drop :
|
|
packets_v6_out_pass : packets_v6_out_drop : states_entries : states_searches :
|
|
packets_v6_out_pass : packets_v6_out_drop : states_entries : states_searches :
|
|
states_inserts : states_removals : counters_match : counters_badoffset :
|
|
states_inserts : states_removals : counters_match : counters_badoffset :
|
|
counters_fragment : counters_short : counters_normalize : counters_memory
|
|
counters_fragment : counters_short : counters_normalize : counters_memory
|
|
-). Values are 64 bit unsigned integers internally.
|
|
|
|
|
|
+). Values are 64 bit unsigned integers.
|
|
.It debug
|
|
.It debug
|
|
Kernel variables debug0 to debug19. ( debug0 : ... : debug19 ). Values are 32
|
|
Kernel variables debug0 to debug19. ( debug0 : ... : debug19 ). Values are 32
|
|
bit unsigned integers.
|
|
bit unsigned integers.
|
|
@@ -254,6 +271,44 @@ daemon.
|
|
.Nm
|
|
.Nm
|
|
system wide configuration file.
|
|
system wide configuration file.
|
|
.El
|
|
.El
|
|
|
|
+.Sh LEGACY FORMATS
|
|
|
|
+.Nm
|
|
|
|
+supports symon(8) clients that send pre OpenBSD 3.5 disk
|
|
|
|
+statistics. These streams should be identified as io1(<disk>) instead of
|
|
|
|
+io(<disk>) in
|
|
|
|
+.Pa /etc/symux.conf.
|
|
|
|
+Note that symon(8) measures io1 or io2 depending on whether it was
|
|
|
|
+compiled on a host that supports version 1 or 2.
|
|
|
|
+.Pp
|
|
|
|
+Because the structure of the incoming data has changed, the rrd files
|
|
|
|
+concerning io need to change as well:
|
|
|
|
+.Bl -tag -width Ds
|
|
|
|
+.It Upgrading symux only
|
|
|
|
+Move all
|
|
|
|
+.Pa io_<disk>.rrd
|
|
|
|
+files to
|
|
|
|
+.Pa io1_<disk>.rrd.
|
|
|
|
+Change the
|
|
|
|
+.Nm
|
|
|
|
+configuration file to accept and write io1.
|
|
|
|
+.Pp
|
|
|
|
+.It Upgrading hosts to OpenBSD 3.5 and updating symon(8)
|
|
|
|
+create new
|
|
|
|
+.Pa io_<disk>.rrd
|
|
|
|
+files using c_smrrds.sh for the upgraded host. Both symon(8) and
|
|
|
|
+.Nm
|
|
|
|
+configuration files can be left untouched as their io statements will
|
|
|
|
+now default to io2.
|
|
|
|
+.El
|
|
|
|
+.Pp
|
|
|
|
+.Nm
|
|
|
|
+will output what version of information it is offered by symon(8)s on
|
|
|
|
+the network when started with the
|
|
|
|
+.Va -d
|
|
|
|
+flag.
|
|
|
|
+.Pp
|
|
|
|
+Note that although an io1 can be translated into an io2 using rrdtool
|
|
|
|
+dump - vi dump - rrdtool restore, this is not recommended.
|
|
.Sh BUGS
|
|
.Sh BUGS
|
|
.Nm
|
|
.Nm
|
|
writes incoming data to rrd files "in process". An rrdupdate on a somewhat
|
|
writes incoming data to rrd files "in process". An rrdupdate on a somewhat
|