【文章內(nèi)容簡(jiǎn)介】 件、短信發(fā)送接口。 sender 這個(gè)模塊和 redis 隊(duì)列部署在一臺(tái)機(jī)器上即可。公司即使有幾十萬(wàn)臺(tái)機(jī)器，一個(gè) sender 也足夠了。 配置說(shuō)明 { debug: true, : { enabled: true, listen: :6066 }, redis: { addr: :6379, 此處配置的 redis 地址要和后面的judge、 alarm 配置成相同的 maxIdle: 5 }, queue: { sms: /sms, 短信隊(duì)列名稱(chēng)，維持默認(rèn)即可， alarm 中也會(huì)有一個(gè)相同的配置 mail: /mail 郵件隊(duì)列名稱(chēng)，維持默認(rèn)即可， alarm 中也會(huì)有一個(gè)相同的配置 }, worker: { sms: 10, 調(diào)用短信接口的最大并發(fā)量 mail: 50 調(diào)用郵件接口的最大并發(fā)量 }, api: { sms: 各公司自行提供的短信發(fā)送接口， 這個(gè) ip 只是個(gè)例子嘍 ，如果未提供相應(yīng)接口可刪除該項(xiàng) mail: 各公司自行提供的郵件發(fā)送接口 } } 如果沒(méi)有郵件發(fā)送接口，可以使用 OpenFalcon mailprovider。 sender 的配置文件中配置了監(jiān)聽(tīng)的 端口，我們可以訪問(wèn)一下 /health接口看是否返回 ok，我們所有的 Go后端模塊都提供了 /health 接口，上面的配置的話(huà)就是這樣驗(yàn)證： curl :6066/health 另外就是查看 sender 的 log， log 在 var 目錄下 mailprovider { debug: true, : { listen: :4000, token: }, smtp: { addr: :25,發(fā)件服務(wù)器地址 username: ,發(fā)件箱用戶(hù) password: XXXX,發(fā)件用戶(hù)密碼 from: 此處表面郵件 來(lái)源，來(lái)件地址必須與發(fā)件服務(wù)器地址一致，如此處都為 @163 } } 配置啟動(dòng) mailprovider 后，可使用如下命令測(cè)試是否能正常發(fā)送 curl d amp。subject=thisismytestmailamp。content=helloWorld 該命令向 qq郵箱發(fā)送了一個(gè)測(cè)試郵件，成功后郵箱中會(huì)收到該郵件： 注：不同的郵箱由于對(duì)郵件設(shè)置的安全過(guò)濾情況不同，可能導(dǎo)致測(cè)試郵件有收取不到的情況，如使用搜狐郵箱測(cè)試時(shí)，提示 success，但是仍然收不到郵件。 163做接收郵箱時(shí)，會(huì)報(bào)錯(cuò)，提示該郵件為垃圾郵件之類(lèi)的（隔天還郵件提醒安全隱患。） 注意：測(cè)試成功后需要修改 sender 的郵件發(fā)送接口，接口地址改為： mail: web 前端 (Fe) 這是 Go版本的 UIC，也是一個(gè)統(tǒng)一的 web 入口，因?yàn)楸O(jiān)控組件眾多，記憶ip、 port 去訪問(wèn)還是比較麻煩。 fe像是一個(gè)監(jiān)控的 hao123. 與 UIC 區(qū)別 Fe模塊除了提供了一個(gè)簡(jiǎn)單的導(dǎo)航之外，最大的不同是密碼存放方式發(fā)生了變化，所以 Java 版 UIC 用戶(hù)如果要遷移過(guò)來(lái)，需要修改 Fe 模塊配置的 salt，配置為空字符串，就可以和原來(lái) Java 版本的 UIC 共用同一個(gè)數(shù)據(jù)庫(kù)了，不過(guò)配置成空字符串不夠安全，建議 salt 配置一個(gè)隨機(jī)字符串，然后通過(guò) Fe 注冊(cè)一個(gè)新用戶(hù)，把數(shù)據(jù)庫(kù)中所有用戶(hù)的密碼都重置為這個(gè)新用戶(hù)的密碼，發(fā)個(gè)通知，讓各個(gè)注冊(cè)用戶(hù)重新自己登錄修改密碼。 Fe作為一個(gè)前端模塊，無(wú)狀態(tài)，可以水平擴(kuò)展，至少部署兩臺(tái)機(jī)器以保證可用性。前面做一個(gè)負(fù)載均衡設(shè)備， nginx 或者 lvs 都可以。最后為其申請(qǐng)一個(gè)域名，搞定！ 配置介紹 { log: debug, pany: MI, 填寫(xiě)自己公司的名稱(chēng)，用于生成聯(lián)系人二維碼 : { enabled: true, listen: :1234 自己隨便搞個(gè)端口，別跟現(xiàn)有的重復(fù)了，可以使用 8080，與老版本保持一致 }, cache: { enabled: true, redis: :6379, 這個(gè) redis 跟 judge、 alarm 用的redis 不同，這個(gè)只是作為緩存來(lái)用 idle: 10, max: 1000, timeout: { conn: 10000, read: 5000, write: 5000 } }, salt: 0i923fejfd3, 搞一個(gè)隨機(jī)字符串 canRegister: true, ldap: { enabled: false, addr: :389, baseDN: dc=example,dc=, bindDN: =mananger,dc=example,dc=, bindPasswd: 12345678, userField: uid, attributes: [sn,mail,telephoneNumber] }, uic: { addr: root:password@tcp(:3306)/uic?charset=utf8amp。loc=Asia%2FChongqing, 數(shù)據(jù)庫(kù) schema 在 scripts 目錄下 idle: 10, max: 100 }, shortcut: { falconPortal: 瀏覽器可訪問(wèn)的portal 地址 falconDashboard: 瀏覽器可訪問(wèn)的 dashboard 地址 falconAlarm: 瀏覽器可訪問(wèn)的alarm 的 地址 } } 注意： shortcut 中 設(shè)置的地址，按實(shí)際配置成內(nèi) /外網(wǎng)訪問(wèn)地址。內(nèi)網(wǎng) ip:port 或者外網(wǎng) ip:port 設(shè)置 root 賬戶(hù)密碼 該項(xiàng)目中的注冊(cè)用戶(hù)是有不同角色的，目前分三種角色：普通用戶(hù)、管理員、 root 賬號(hào)。 系統(tǒng)啟動(dòng)之后第一件事情應(yīng)該是設(shè)置 root 的密碼，瀏覽器訪問(wèn)： （此處假設(shè)你的項(xiàng)目訪問(wèn)地址是 ，也可以使用 ip） ,這樣就設(shè)置了 root 賬號(hào)的密碼為abc。普通用戶(hù)可以支持注冊(cè)。 然后通過(guò)訪問(wèn) fe 即可使用 root 登錄（也可注冊(cè)新用戶(hù)）， ldap 認(rèn)證 Fe 現(xiàn)在支持通過(guò) ldap 來(lái)進(jìn)行用戶(hù)認(rèn)證。不需要提前在 Fe 內(nèi)開(kāi)設(shè)賬號(hào)。Fe 會(huì)自動(dòng)將 ldap 認(rèn)證過(guò)來(lái)的新用戶(hù)插入到 Fe 的數(shù)據(jù)庫(kù)內(nèi)。 配置說(shuō)明 addr: :389, ldap 的地址和端口 baseDN: dc=example,dc=, ldap 的 baseDN， ldap 認(rèn)證的時(shí)候?qū)倪@個(gè)路徑開(kāi)始查詢(xún)用戶(hù) bindDN: =mananger,dc=example,dc=, 你用來(lái)連接 ldap 的賬戶(hù)，至少要有只讀的查詢(xún)權(quán)限。 注意這里應(yīng)該是賬戶(hù)的完整 dn 值。對(duì)于 AD 的話(huà)，則可以直接填賬戶(hù)的 userPrincipalName (）。 如果你的 ldap 允許匿名查詢(xún)的話(huà)，填 值即可 bindPasswd: 12345678, 如果你的 ldap 允許匿名查詢(xún)的話(huà)，填 值即可 userField: uid, 用于認(rèn)證的屬性（即你輸入的用戶(hù)名），通常為 uid 或 sAMAccountName(AD)。 也可以使用諸如 mail 的屬性，這樣認(rèn)證的用戶(hù)名就是郵箱 (前提 ldap 里有這個(gè)屬性 ) attributes: [sn,mail,telephoneNumber] 數(shù)組順序重要，依次為姓名，郵箱，電話(huà)在 ldap 中的屬性名 . 建議根據(jù)自己 ldap 內(nèi)的實(shí)際情況修改。 用戶(hù) ldap 登錄時(shí)， fe 將按這些屬性名去 ldap 中查詢(xún)新用戶(hù)的屬性，并插入到 fe 的數(shù)據(jù)庫(kù)內(nèi)。 }, 這里我們先安裝了 Fe 這個(gè)模塊， portal、 dashboard、 alarm 等模塊都還沒(méi)有安裝，所以 shortcut 中不知道如何配置才好。不用著急，先維持默認(rèn)，等之后部署完了 portal、 dashboard、 alarm 等模塊之后再回來(lái)修改 fe 的配置。 portal Portal 是用來(lái)配置報(bào)警策略的 . Portal 是個(gè) web 項(xiàng)目，無(wú)狀態(tài)，可以水平擴(kuò)展，至少部署兩臺(tái)機(jī)器以保證可用性，前面架設(shè) nginx 或者 lvs 這種負(fù)載設(shè)備，申請(qǐng)一個(gè)域名，搞定！ Portal的配置文件在 frame/ virtualenv ./env ./env/bin/pip install defaulttimeout=100 r 修改一下數(shù)據(jù)庫(kù)配置，數(shù)據(jù)庫(kù) schema 文件在 scripts 目錄 DB_HOST = DB_PORT = 3306 DB_USER = root DB_PASS = DB_NAME = falcon_portal SECRET_KEY 盡量搞一個(gè)復(fù)雜點(diǎn)的隨機(jī)字符串 SECRET_KEY = SESSION_COOKIE_NAME = falconportal PERMANENT_SESSION_LIFETIME = 3600 * 24 * 30 如果你使用的是 Go版本的 UIC，即 Fe 那個(gè)項(xiàng)目，下面的配置就配置成 Fe的地址即可，注意端口， Fe 的默認(rèn)端口是 1234 internal 是內(nèi)網(wǎng)可訪問(wèn)的 UIC（或者 Fe）地址 external 是外網(wǎng)可訪問(wèn)的 UIC（或者 Fe）地址，即用戶(hù)通過(guò)瀏覽器訪問(wèn)的 UIC（或者 Fe）地址 UIC_ADDRESS = { 39。internal39。: 39。 39。external39。: 39。 39。external39。: 39。 } MAINTAINERS = [39。root39。] CONTACT = 39。 社區(qū)版必須維持默認(rèn)配置 COMMUNITY = True 我們可以 cp 用 中的配置覆蓋 中的配置 嫌麻煩的話(huà)維持默認(rèn)即可，也不用制作: from import *except Exception, e: print [warning] %s % e Portal 正常啟動(dòng)之后，就可以回去配置 Fe 這個(gè)項(xiàng)目的 shortcut 了。當(dāng)然，dashboard 和 alarm 還沒(méi)有搭建，這倆 shortcut 還沒(méi)法配置。修改完了shortcut，要重啟 fe模塊。 heartbeat server(HBS) HBS 第一個(gè)功能： agent 發(fā)送心跳信息給 HBS 的時(shí)候，會(huì)把 hostname、 ip、agent version、 plugin version 等信息告訴 HBS， HBS 負(fù)責(zé)更新 host 表。 falconagent 有一個(gè)很大的特點(diǎn)，就是自發(fā)現(xiàn)，不用配置它應(yīng)該采集什 么數(shù)據(jù)，就自動(dòng)去采集了。比如 cpu、內(nèi)存、磁盤(pán)、網(wǎng)卡流量等等都會(huì)自動(dòng)采集。我們除了要采集這些基礎(chǔ)信息之外，還需要做端口存活監(jiān)控和進(jìn)程數(shù)監(jiān)控。那我們是否也要自動(dòng)采集監(jiān)聽(tīng)的端口和各個(gè)進(jìn)程數(shù)目呢？我們沒(méi)有這么做，因?yàn)檫@個(gè)數(shù)據(jù)量比較大，匯報(bào)上去之后用戶(hù)大部分都是不關(guān)心的，太浪費(fèi)。于是我們換了一個(gè)方式，只采集用戶(hù)配置的。比如用戶(hù)配置了對(duì)某個(gè)機(jī)器 80 端口的監(jiān)控，我們才會(huì)去采集這個(gè)機(jī)器 80 端口的存活性。那 agent 如何知道自己應(yīng)該采集哪些端口和進(jìn)程呢？向 HBS 要， HBS 去讀取 Portal 的數(shù)據(jù)庫(kù)，返回給agent。 之后 我們會(huì)介紹一個(gè)用于判斷報(bào)警的組件： Judge， Judge 需要獲取所有的報(bào)警策略