演示 zabbix LLD(Low-Level Discov
演示 zabbix LLD(Low-Level Discovery) 如何使用
2017/3/3
目的:以監(jiān)控 couchbase 上多個(gè) buckets 的需求來舉例說明 zabbix lld 是如何工作的。
關(guān)于 lld,網(wǎng)絡(luò)上的文章也挺多的,希望自己能寫一個(gè)簡(jiǎn)單明了的 howto 來幫助初學(xué)者。
一、準(zhǔn)備工作
1、【zabbix-agent】
1)腳本示例
[root@node33 scripts]# cat monitor_couchbase.sh
#!/bin/bash
#
#2017/3/3
#v1.0.4
#PC
#echo "[`date`] $1 $2 $3" >>/tmp/test.log
cb_opts='-c 127.0.0.1:8091 -u Administrator -p xxx'
curl_opts='-s -u Administrator:xxx http://127.0.0.1:8091/pools/default/buckets'
##
usage(){
cat <<_EOF
usage: $0 [cluster_info|cluster_list|cluster_healthy]
$0 [node_healthy|node_active]
$0 [bucket_list|bucket_info|bucket_lld]
_EOF
}
###### cb cluster details ######
cb_cluster_info(){
/opt/couchbase/bin/couchbase-cli server-info $cb_opts
}
cb_cluster_list(){
/opt/couchbase/bin/couchbase-cli server-list $cb_opts
}
cb_cluster_healthy(){
cb_cluster_list |grep -o '8091 healthy active' |wc -l
}
###### cb current node status ######
cb_node_healthy(){
local stat=`cb_cluster_info |jq '.status' |cut -d '"' -f2`
if [ "X$stat" == "Xhealthy" ]; then echo 1; else echo 0;fi
}
cb_node_active(){
local stat=`cb_cluster_info |jq '.clusterMembership' |cut -d '"' -f2`
if [ "X$stat" == "Xactive" ]; then echo 1; else echo 0;fi
}
###### cb bucket details ######
cb_bucket_list(){
/opt/couchbase/bin/couchbase-cli bucket-list $cb_opts |sed -E '/(bucketType|authType|saslPassword|proxyPort|numReplicas|ramQuota|ramUsed)/d'
}
cb_bucket_info(){
# exp:
# memUsed, dataUsed, diskUsed, itemCount, diskFetches, opsPerSec, quotaPercentUsed
local bucket_name=$1
curl $curl_opts/$bucket_name |jq ".basicStats.$2" |cut -d '"' -f2
}
cb_bucket_lld_pre(){
local buckets=`cb_bucket_list`
echo $buckets |grep -o 'ERROR' >/dev/null && exit 2
for i in $buckets
do
echo -e '\t\t{'
echo -e "\t\t\t\"{#BUCKETNAME}\": \"$i\""
echo -e '\t\t},'
done
}
cb_bucket_lld(){
echo -e '{'
echo -e '\t"data": ['
cb_bucket_lld_pre |sed '$d'
echo -e '\t\t}'
echo -e '\t]'
echo -e '}'
}
##
case $1 in
cluster_info|cluster_list|cluster_healthy|node_healthy|node_active|bucket_list|bucket_info|bucket_lld)
cb_$1 $2 $3
;;
*)
usage
;;
esac
2)zabbix-agent 配置示例
[root@node33 scripts]# cat /etc/zabbix/zabbix_agentd.d/userparameter_couchbase.conf
## cluster
UserParameter=couchbase.cluster.healthy[*], /bin/bash /etc/zabbix/scripts/monitor_couchbase.sh cluster_healthy
## node
UserParameter=couchbase.node.healthy[*], /bin/bash /etc/zabbix/scripts/monitor_couchbase.sh node_healthy
UserParameter=couchbase.node.active[*], /bin/bash /etc/zabbix/scripts/monitor_couchbase.sh node_active
## bucket
UserParameter=couchbase.bucket.discovery[*], /bin/bash /etc/zabbix/scripts/monitor_couchbase.sh bucket_lld
UserParameter=couchbase.bucket.get[*], /bin/bash /etc/zabbix/scripts/monitor_couchbase.sh bucket_info $1 $2
3)重啟zabbix-agent
[root@node33 scripts]# service zabbix-agent restart
2、【zabbix-server】
1)測(cè)試 discovery 得到的數(shù)據(jù)
[root@zabbix-server ~]# zabbix_get -s 10.50.200.33 -k 'couchbase.bucket.discovery'
{
"data": [
{
"{#BUCKETNAME}": "account"
},
{
"{#BUCKETNAME}": "bbs"
},
{
"{#BUCKETNAME}": "client"
},
{
"{#BUCKETNAME}": "pay"
},
{
"{#BUCKETNAME}": "shop"
}
]
}
2)如上所示的格式,才是 zabbix lld 執(zhí)行后所期望得到的數(shù)據(jù)。
二、在 zabbix web 上配置模版和對(duì)應(yīng)的 lld 規(guī)則
1)新建一個(gè)模版:zbx_couchbase
2)在模版中,選擇“Discovery rules”,新增一個(gè)規(guī)則名:“couchbase.bucket.discovery”,重點(diǎn)是:
a. 在“key”中填寫上一節(jié)在 zabbix-agent 中定義的名稱:“couchbase.bucket.discovery”
b. 在“Filters”這一節(jié)增加一個(gè) Macro 為:{#BUCKETNAME}(這個(gè)名稱是在上一節(jié)的腳本中定義的,可以自定義)
3)下一步的重點(diǎn)是,增加幾個(gè)“Item prototypes”,和普通的 Item 的區(qū)別在于:在 Key 中引用了上一步定義的 Macro,示例:
Name: couchbase bucket [{#BUCKETNAME}] - quotaPercentUsed
Key: couchbase.bucket.get[{#BUCKETNAME},quotaPercentUsed]
注:lld執(zhí)行后,將獲取到的每個(gè) {#BUCKETNAME} 對(duì)應(yīng)的值 ,自動(dòng)生成對(duì)應(yīng)的 Item,可以理解為一個(gè)循環(huán)操作。
4)接下來就是創(chuàng)建對(duì)應(yīng)的 “Trigger prototypes”,在此處略過不提;
5)當(dāng)然了,也可以在這個(gè)模版中增加幾個(gè)普通的 items,triggers,graphs,在此略過不提;
6)請(qǐng)參考附圖的示例。
F-01
F-02
F-03
F-04
F-05
F-06
F-07
F-08