smokeping config 详解

孤独海岸线

　　SmokePing之配置文件config详解
　　这个配置文件不管在Linux下面还是在BSD下面是一致的。
　　如下解说：
　　整个config文件里面只有#是注释
　　第一部分 General 属于基本配置。值得注意的地方有imgcache和imgurl这两个参数，要注意一下，和apache配置相关联，如果配置不好的话，打开web的时候图片会显示不出来。
　　*** General ***
　　owner
　　   = test
　　contact  =
　　[email=***@sohu.com
　　mailhost = smtp.sohu.com
　　sendmail = /usr/sbin/sendmail
　　# NOTE: do not put the Image Cache below cgi-bin
　　# since all files under cgi-bin will be executed ... this is not
　　# good for images.
　　imgcache = /usr/local/smokeping/htdocs/img
　　imgurl   = img
　　datadir  = /usr/local/var/smokeping
　　piddir  = /usr/local/var/smokeping
　　cgiurl   =
　　http://192.168.0.206/smokeping/smokeping.cgi
　　smokemail = /usr/local/etc/smokeping/smokemail
　　tmail = /usr/local/etc/smokeping/tmail
　　# specify this to get syslog logging
　　syslogfacility = local0
　　# each probe is now run in its own process
　　# disable this to revert to the old behaviour
　　# concurrentprobes = no
　　第二部分Alerts 是属于报警配置， 这个我还没有测试过。以后再说
　　*** Alerts ***
　　to =
　　alertee@address.somewhere
　　from =
　　smokealert@company.xy
　　+someloss
　　type = loss
　　# in percent
　　#pattern = >0%,*12*,>0%,*12*,>0%
　　#comment = loss 3 times  in a row
　　pattern = ==S,>0%,>0%,>0%
　　comment = loss at startup
　　+rttdetect
　　type = rtt
　　# in milli seconds
　　pattern = 100,>100,>100
　　comment = routing mesed up again ?
　　第三部分 Database  RRD数据库配置。step和pings这两个参数要在启动smokeping之前配置好，如果在smokeping启动后再配置这两个参数，需要把原来 的rrd文件都删除，然后再启动smokeping才可以。所以这个一定要先配置好。默认是step=300 pings=20  应该是每300s内执行20次ping的动作
　　*** Database ***
　　step     = 300
　　pings    = 60
　　# consfn mrhb steps total
　　AVERAGE  0.5   1  1008
　　AVERAGE  0.5  12  4320
　　   MIN  0.5  12  4320
　　   MAX  0.5  12  4320
　　AVERAGE  0.5 144   720
　　   MAX  0.5 144   720
　　   MIN  0.5 144   720
　　第四部分Presentation 是关于网络状态的一些配置和解释，基本不需要更改
　　*** Presentation ***
　　template = /usr/local/etc/smokeping/basepage.html
　　charset = gb2312
　　+ charts
　　menu = Charts
　　title = The most interesting destinations
　　++ stddev
　　sorter = StdDev(entries=>4)
　　title = Top Standard Deviation
　　menu = Std Deviation
　　format = Standard Deviation %f
　　++ max
　　sorter = Max(entries=>5)
　　title = Top Max Roundtrip Time
　　menu = by Max
　　format = Max Roundtrip Time %f seconds
　　++ loss
　　sorter = Loss(entries=>5)
　　title = Top Packet Loss
　　menu = Loss
　　format = Packets Lost %f
　　++ median
　　sorter = Median(entries=>5)
　　title = Top Median Roundtrip Time
　　menu = by Median
　　format = Median RTT %f seconds
　　下面的overview和detail里面是图片大小设置，可以按需来设置
　　+ overview
　　width = 800
　　height = 50
　　range = 10h
　　+ detail
　　width = 800
　　height = 200
　　unison_tolerance = 2
　　"Last 3 Hours"    3h
　　"Last 30 Hours"   30h
　　"Last 10 Days"    10d
　　"Last 400 Days"   400d
　　+ hierarchies
　　++ owner
　　title = Host Owner
　　++ location
　　title = Location
　　第五部分Porbes 指针配置，我们一般只用到fping所以就只要以下配置就可以了，确定路径是否正确，这里还可以设置fping包的大小，参数是packetsize
　　*** Probes ***
　　+ FPing
　　binary = /usr/local/sbin/fping
　　packetsize = 2000
　　第六分部Slaves  主从关系里面的从服务器相关配置，smokeping里面从服务器只需要安装好就可以了，不需要配置，smokeping的所有配置都是在master上 面设置。这里主要设置好secrets密码文件和从服务器配置就可以了。下面我配置了两个从服务器。一个是st，一个是fy
　　*** Slaves ***
　　#secrets=/home/oetiker/checkouts/smokeping/trunk/software/etc/smokeping_secrets.dist
　　secrets = /usr/local/etc/smokeping/slavesecrets.conf
　　#+boomer
　　#display_name=boomer
　　#color=0000ff
　　#location = HuaDong
　　+ st
　　display_name = ShanTou Monitor
　　color = 0000ff
　　#location = HuanDong
　　+ fy
　　display_name = FuYong
　　color = 00ff00
　　#++ override
　　#Probes.FPing.binary = /usr/bin/fping
　　第七部分 Targets 目标配置。在这里可以单独配置一台服务器的监控情况，需要从slave服务器上取值的配置也是在这里配置。我已经用注释说明的很清楚了。
　　这里要注意一下。+代表一级菜单 +下面的++是继承上面的+成为二级菜单。 而且可以有多个一级菜单和二级菜单。
　　*** Targets ***
　　probe = FPing
　　menu = Top
　　title = Network Latency Grapher
　　remark = Welcome to the SmokePing website of ShenZhen Wang Yu Company. \
　　        Here you will learn all about the latency of our network.
　　####### Slaves Configure ###########
　　+ Slaves
　　menu = Slaves
　　title = All of the Monitor From the Slaves
　　++ ShanTou
　　menu = ShanTou
　　title = Host 192.168.0.208 Monitor From Slaves
　　slaves = st fy
　　host = 192.168.0.208
　　++ FuYong
　　menu = FuYong
　　title = Host 192.168.0.210 Monitor From Slaves
　　slaves = fy st
　　host = 192.168.0.210
　　######## Single Hosts Monitor Configure ########
　　+ Hosts
　　menu = Single
　　#parents = owner:/Test/James location:/
　　#title = Host in Test
　　title = Single Host Monitor
　　#++ James
　　#menu = James
　　#title =James
　　#alerts = someloss
　　#slaves = boomer slave2
　　#host = 192.168.0.205
　　++ QQ
　　menu = QQ
　　title =
　　www.qq.com
　　host =
　　www.qq.com
　　++ MFS-Monitor
　　menu = MFS-Monitor
　　title = Monitor
　　host = 192.168.0.210
　　++ TaiWan
　　menu = TaiWan-Server
　　title = 229.84.216.221
　　host = 229.84.216.221
　　+ Monitor
　　menu = Monitor Servers
　　title = Monitor Server Hosts
　　++ ShenZhen
　　menu = ShenZhen
　　title = SZ-Cacti
　　host = 192.168.0.208
　　############# MultiHost Monitor In One Graph Configure #####
　　+ MultiHost
　　menu = Multihost
　　#title = James and James as seen from Boomer
　　title = All Host In One Graph
　　host = /Hosts/QQ /Hosts/MFS-Monitor /Hosts/TaiWan
　　主/从 做分布式监控的时候有几点需要注意
　　1.主从服务器上面的密码文件权限必须为600  而且主服务器上面的密码文件的属主必须为apache的启动用户
　　2.从服务器上面的密码文件只需要一个密码就行，也就是主上面为它配置的那个密码。同样从服务器上面的密码文件的属主必须为smokeping的启动用户
　　下面是主/从做分布式监控时我碰到的问题，及解决办法。写了一个简单的FQA
　　Q:Slave启动的时候报错。
　　[root@Nagios etc]# /usr/local/smokeping/bin/smokeping  --master-url=http://192.168.0.206/smokeping/smokeping.cgi  --cache-dir=/usr/local/smokeping/var/  --shared-secret=/usr/local/smokeping/etc/smokeping_secrets  --slave-name=ShenZhen
　　WARNING: Opening secrets file /usr/local/etc/smokeping/slavesecrets.conf: Permission denied
　　ERROR: we did not get config from the master. Maybe we are not configured as a slave for any of the targets on the master ?
　　A:
　　在master上面 对slavesecrets.conf文件 执行如下命令：
　　chow smokeping slavesecrets.conf
　　Q:
　　[root@Nagios etc]# /usr/local/smokeping/bin/smokeping  --master-url=http://192.168.0.206/smokeping/smokeping.cgi  --cache-dir=/usr/local/smokeping/var/  --shared-secret=/usr/local/smokeping/etc/smokeping_secrets  --slave-name=ShenZhen
　　WARNING: Data from ShenZhen was signed with 58e8b1b17440aa40fac67161b8c7a328 which does not match our expectation
　　ERROR: we did not get config from the master. Maybe we are not configured as a slave for any of the targets on the master ?
　　A:
　　这个错误就是本地的密码文件配置错误，本地密码文件只保存master上面配置你这台slave的密码，只需要一个密码就可以了
　　Q:
　　[root@Nagios etc]# /usr/local/smokeping/bin/smokeping  --master-url=http://192.168.0.206/smokeping/smokeping.cgi  --cache-dir=/usr/local/smokeping/var/  --shared-secret=/usr/local/smokeping/etc/smokeping_secrets
　　WARNING: No secret found for slave Nagios.kevinadmin.org
　　ERROR: we did not get config from the master. Maybe we are not configured as a slave for any of the targets on the master ?
　　A:
　　在master上面的密码文件里加上Nagios.kevinadmin.org及对应的密码就可以了。
　　Q:
　　[root@Nagios etc]# /usr/local/smokeping/bin/smokeping  --master-url=http://192.168.0.206/smokeping/smokeping.cgi  --cache-dir=/usr/local/smokeping/var/  --shared-secret=/usr/local/smokeping/etc/smokeping_secrets
　　WARNING: I don't know the slave Nagios.kevinadmin.org ignoring it
　　ERROR: we did not get config from the master. Maybe we are not configured as a slave for any of the targets on the master ?
　　A:
　　这个是指在config文件里面没有定义Nagios.kevinadmin.org这个从服务器