演示zabbixLLD(Low-LevelDiscov-創新互聯

演示 zabbix LLD(Low-Level Discovery) 如何使用

成都創新互聯公司是創新、創意、研發型一體的綜合型網站建設公司，自成立以來公司不斷探索創新，始終堅持為客戶提供滿意周到的服務，在本地打下了良好的口碑，在過去的10年時間我們累計服務了上千家以及全國政企客戶，如柔性防護網等企業單位，完善的項目管理流程，嚴格把控項目進度與質量監控加上過硬的技術實力獲得客戶的一致表揚。

2017/3/3

目的：以監控 couchbase 上多個 buckets 的需求來舉例說明 zabbix lld 是如何工作的。

關于 lld，網絡上的文章也挺多的，希望自己能寫一個簡單明了的 howto 來幫助初學者。

一、準備工作

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）測試 discovery 得到的數據

[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 執行后所期望得到的數據。

二、在 zabbix web 上配置模版和對應的 lld 規則

1）新建一個模版：zbx_couchbase

2）在模版中，選擇“Discovery rules”，新增一個規則名：“couchbase.bucket.discovery”，重點是：

a. 在“key”中填寫上一節在 zabbix-agent 中定義的名稱：“couchbase.bucket.discovery”

b. 在“Filters”這一節增加一個 Macro 為：{#BUCKETNAME}（這個名稱是在上一節的腳本中定義的，可以自定義）

3）下一步的重點是，增加幾個“Item prototypes”，和普通的 Item 的區別在于：在 Key 中引用了上一步定義的 Macro，示例：

Name:	couchbase bucket [{#BUCKETNAME}] - quotaPercentUsed
Key:    couchbase.bucket.get[{#BUCKETNAME},quotaPercentUsed]

注：lld執行后，將獲取到的每個 {#BUCKETNAME} 對應的值，自動生成對應的 Item，可以理解為一個循環操作。

4）接下來就是創建對應的 “Trigger prototypes”，在此處略過不提；

5）當然了，也可以在這個模版中增加幾個普通的 items，triggers，graphs，在此略過不提；

6）請參考附圖的示例。