一、監(jiān)控架構(gòu)圖

二、實現(xiàn)思路

• 在 Jenkins 上安裝 Metrics 插件，使 Jenkins 暴露 metrics api；
• 編寫python代碼從api抓取數(shù)據(jù)，并將數(shù)據(jù)解析為zabbix可以識別的格式；
• 配置 Zabbix server 及 agent 以實現(xiàn)監(jiān)控及告警

三、具體配置

1、安裝Jenkins Metrics插件

插件下載地址：http://updates.jenkins-ci.org/download/plugins/metrics/

安裝 Metrics 插件，在系統(tǒng)配置中，會多出“Metrics”的配置，如下圖：

配置項不復(fù)雜。我們需要點擊“Generate...”生成一個 Access Key（生成后，記得要保存）。這個 Key 用于身份校驗，后面我們會用到。

保存后，我們在瀏覽器中輸入URL：http://jenkins.local,me/metrics/<剛生成的 Access Key> 驗證 Jenkins 是否已經(jīng)暴露 metrics。如果看到如下圖，就說明可以進行下一步了:

1.1 Metrics 插件介紹

Metrics 插件是基于 dropwizard/metrics 實現(xiàn)。它通過4個接口暴露指標數(shù)據(jù)：/metrics，/ping，/threads，/healthcheck。

1.2 Metrics 插件：/metrics 接口介紹

點擊上圖中的metric鏈接（http://jenkins.local.me/metrics/<Access Key>/metrics），它暴露了以下指標數(shù)據(jù)：

{
 version: "4.0.0",
 gauges: {...},
 counters: {...},
 histograms: {...},
 meters: {...},
 timers: {...}
}

Gauges：某項指標的瞬時值，例如：當前 Jenkins executor 的總個數(shù)（jenkins.executor.count.value）
Counters：某項指標的總數(shù)值，例如：http 請求活動連接數(shù)（http.activeRequests）
Meters：一段時間內(nèi)，某事件的發(fā)生概率，例如：Jenkins成功執(zhí)行的任務(wù)每分鐘的執(zhí)行次數(shù)（jenkins.runs.success.m1_rate）
Histogram：統(tǒng)計指標的分布情況。例如：Jenkins executor 數(shù)量的分布（jenkins.executor.count.history）
Timer：某項指標的持續(xù)時間。例如：Jenkins 任務(wù)等待時間（jenkins.job.waiting.duration）

1.3 Metrics插件其他接口

/ping：接口返回pong代表 Jenkins 存活，如下圖：

/threads：返回 Jenkins 的線程信息

/healthcheck：返回以下指標：

{
 "disk-space" : {
  "healthy" : true
 },
 "plugins" : {
  "healthy" : true,
  "message" : "No failed plugins"
 },
 "temporary-space" : {
  "healthy" : true
 },
 "thread-deadlock" : {
  "healthy" : true
 }
}

Zabbix server 通過與 Zabbix agent 進行通信實現(xiàn)數(shù)據(jù)的采集。而 Zabbix agent 又分為被動和主動兩種模式。我們使用的是被動模式，也就是Zabbix server 向 agent 索要數(shù)據(jù)。
所以，我們需要在 Zabbix agent 所在機器放一個獲取 Jenkins 指標數(shù)據(jù)的腳本。再配置 Zabbix server 定時從該 agent 獲取數(shù)據(jù)，最后配置觸發(fā)器（trigger）實現(xiàn)告警。

2.1 創(chuàng)建監(jiān)控模板并鏈接至主機組

2.2 創(chuàng)建監(jiān)控項

這里需要解釋其中幾個選項為什么要那樣填：

• 類型：是 Zabbix server 采集指標的類型，我們選擇的是 Zabbix agent，如上文所說。
• 鍵值：由于我們要監(jiān)控的指標并不是 Zabbix 預(yù)定義的。所以，需要使用用戶自定義參數(shù)來實現(xiàn)監(jiān)控 Jenkins 指標。Key 填的值為：jenkins.metrics[gauges.jenkins.node.count.value.value]。jenkins.metrics是需要執(zhí)行的真正的 Key 名稱。而 [] 內(nèi)是傳給該 Key 對應(yīng)的命令的參數(shù)。對于初學(xué)者，Zabbix 這部分概念非常不好理解。也許這樣會更好理解：在使用用戶自定義參數(shù)來實現(xiàn)監(jiān)控的情況下，Zabbix server 會將這個 Key 發(fā)送給 agent，然后 agent 根據(jù)這個 Key 執(zhí)行指定的 邏輯 以獲取指標數(shù)據(jù)。這個 邏輯 通常是一段腳本（shell命令或Python腳本等）。而腳本也是可以傳參的，[]中的值就是傳給腳本的參數(shù)。
• 信息類型：監(jiān)控數(shù)據(jù)的數(shù)據(jù)類型，由于該監(jiān)控項監(jiān)控的是 Jenkins node 節(jié)點的個數(shù)，所以，使用數(shù)字整型。
• 更新間隔：指 Zabbix server 多長時間向 agent 獲取一次數(shù)據(jù)。

到此，Zabbix server 端已經(jīng)配置完成?？梢栽诒O(jiān)測->最新數(shù)據(jù)中查看是否有最新的數(shù)據(jù)，然后可以創(chuàng)建儀表盤將數(shù)據(jù)以圖形的方式呈現(xiàn)出來。其他監(jiān)控項也可以按此方法進行配置。

監(jiān)控腳本代碼

以上就是本文的全部內(nèi)容，希望對大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評論