shell 操作釘釘機器人實現告警提醒

我們知道，之前的運維告警多通過mail 等方式通知到相應的人員，難以實現隨時隨地的查看。隨著手機APP的發展，很多告警開始發送到IM軟體上去。目前比較常用的是發送到微信和釘釘上，今天我們將重點放在釘釘上。群機器人是釘釘群的高級擴展功能，群機器人可以將第三方服務的信息聚合到群聊中，實現自動化的信息同步。藉助釘釘機器人，通過官方提供的API，可以很方便的post數據到相應的接收人 。群機器人支持Webhook協議的自定義接入，支持更多可能性，例如：你可將運維報警通過自定義機器人聚合到釘釘群實現提醒功能。

Shell 腳本語言是實現Linux系統管理及自動化所必須的重要工具。熟練地編寫Shell語言可以提升運維人員的工作效率，適應複雜的工作環境。

在本文，我們聚焦通過shell腳本語言實現藉助釘釘機器人發送告警信息。

1: 瞭解更多群機器人的信息，大家可登入官網學習

https://ding-doc.dingtalk.com/doc#/serverapi2/qf2nxq

2.給自己的機器人起個好聽的名字

操作如下：

 3.使用命令行工具curl

curl是一個命令行工具，通過指定的URL來上傳或下載數據，並將數據展示出來。curl中的c表示client，而URL，就是URL。

3.1 與curl一起使用的協議，最多的還是HTTP

在每一個HTTP請求中，都有一個對應的方法，常用的方法有：GET、POST、HEAD和PUT。如果在一個curl命令中不指定具體的方法，那麼預設的就是使用GET方法。對於其它的方法，可以在curl命令中指定：

POST是HTTP中向服務端提交數據的一種方法。在瀏覽器中，可以在表單中填寫完數據後，瀏覽器就會預設將填寫的數據使用key=value串的形式進行轉化。在curl中，我們可以使用-d或--data選項來指定具體的數據。

3.2 釘釘使用curl工具主要相關的兩個參數

3.3 調用格式（案例）

curl 'https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxx' \
   -H 'Content-Type: application/json' \
   -d '{"msgtype": "text", 
        "text": {
             "content": "我就是我, 是不一樣的煙火"
        }
      }'

測試過程中，請將上面命令直接複製到命令行，再將xxxxxxxx替換為真實access_token。

4.不一樣的markdown類型

官網中除markdown類型，其它的消息類型的 測試例子（腳本） 都可以直接在shell中演示

官網markdown類型的測試案例

{
     "msgtype": "markdown",
     "markdown": {
         "title":"杭州天氣",
         "text": "#### 杭州天氣 @156xxxx8827\n" +
                 "> 9度，西北風1級，空氣良89，相對溫度73%\n\n" +
                 "> ![screenshot](https://gw.alicdn.com/tfs/TB1ut3xxbsrBKNjSZFpXXcXhFXa-846-786.png)\n"  +
                 "> ###### 10點20分發佈 [天氣](http://www.thinkpage.cn/) \n"
     },
    "at": {
        "atMobiles": [
            "156xxxx8827", 
            "189xxxx8325"
        ], 
        "isAtAll": false
    }
 }

　在shell中執行報錯信息，錯誤信息為：

{"errcode":40035,"errmsg":"缺少參數 json"}

 報錯原因是  "text" 欄位對應的 value 值中的 “+” 運算符導致，將中間的

" +
"

刪除。

即可執行代碼更新為：

{
     "msgtype": "markdown",
     "markdown": {
         "title":"杭州天氣",
         "text": "#### 杭州天氣 @156xxxx8827\n> 9度，西北風1級，空氣良89，相對溫度73%\n\n> ![screenshot](https://gw.alicdn.com/tfs/TB1ut3xxbsrBKNjSZFpXXcXhFXa-846-786.png)\n> ###### 10點20分發佈 [天氣](http://www.thinkpage.cn/) \n"
     },
    "at": {
        "atMobiles": [
            "156xxxx8827", 
            "189xxxx8325"
        ], 
        "isAtAll": false
    }
 }

執行OK，錯誤消失。

執行情況如下：

 成功收到的信息，內容截圖如下：

5. 將釘釘機器人代碼放到文件中，方便調用

例如：創建用於監控當QQOrder_ERP集群的VIP漂移時，調用用來發送釘釘告警的可執行文件 ddalarm.sh。

其主要代碼如下：

#!/bin/bash

webhook='https://oapi.dingtalk.com/robot/send?access_token=34XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
cluster='QQOrder_ERP'
host=`hostname -I | awk '{print $1}'`
vip=$1

function SendMsgToDingding() {
    curl $webhook -H 'Content-Type: application/json' -d "
    {
        'msgtype': 'text',
        'text': {
            'content': '集群名稱：$cluster\n告警信息：虛擬IP<$vip>已漂移至節點<$host>，請註意\n'
        },
        'at': {
            'isAtAll': true
        }
    }"
}


SendMsgToDingding

此測試文件，調用執行時需要傳入一個參數（VIP）。

觸發執行，案例如下：

 手機釘釘收到的告警信息

參考資料：

1.釘釘群機器人

https://ding-doc.dingtalk.com/doc#/serverapi2/krgddi 

2.curl使用指南

https://www.jianshu.com/p/fc0eb6c60816