1.创建钉钉机器人
创建告警群聊
就拉一个普通群聊就可以
创建机器人
群设置选择机器人
选择自定义机器人
定义机器人相关信息,重点关注关键词
保存Webhook
2.PostMan测试发送API
基于官方提供的API,我们可以做下述测试
官方请求示例
请求示例(HTTP)
下面的token需要替换成webhook中的地址
请求正文
下面消息类型支持多种,通过msgtype声明你要哪种
at,标识群里@哪些人,如果isAtAll就标识@群里所有人,@atMobiles标识指定手机号,其余参数同理
测试@所有人
测试@指定人
测试卡片消息
3.编写发送代码
有了上述PostMan的测试,下面的java代码编写对于我们来说就很简单了
引入pom依赖
公司内网则直接下载好:https://open-dev.dingtalk.com/sdk/download/java
编写java代码
Java
运行代码
复制代码
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
import com.dingtalk.api.DefaultDingTalkClient;
import com.dingtalk.api.DingTalkClient;
import com.dingtalk.api.request.OapiRobotSendRequest;
import com.dingtalk.api.response.OapiRobotSendResponse;
import com.taobao.api.ApiException;
import java.util.Arrays;
public class DingTalk {
public static void main(String[] args) {
try {
// 1-初始化API调用Client
DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/robot/send?access_token=87b520af3e0b6aacc137d1525e4d9b21f61c901f1c8ac4f05a17bc12a8e7f737");
// 2-初始化请求参数
OapiRobotSendRequest req = new OapiRobotSendRequest();
// 2-1 设置消息类型
req.setMsgtype("text");
// 2-2 设置消息@人
OapiRobotSendRequest.At at = new OapiRobotSendRequest.At();
at.setAtMobiles(Arrays.asList("17600477102"));
req.setAt(at);
// 2-3 设置消息内容(必须匹配关键词),工作中这里就对应error日志
OapiRobotSendRequest.Text text = new OapiRobotSendRequest.Text();
text.setContent("[告警]测试java代码消息");
req.setText(text);
// 3 消息发送
OapiRobotSendResponse rsp = client.execute(req, "");
System.out.println(rsp.getBody());
} catch (ApiException e) {
e.printStackTrace();
}
}
}
代码测试
4.工作中到底怎么用
上面我们完成了简单的告警通知,实际工作中也是这么来做,但是会做一点点优化
将上述代码封装成一个工具类,如:DingTalkMessageUtil
将token保存在nacos中,与代码解耦
在有异常日志、慢SQL等关键场景中调用此工具类,将消息发送到群,让开发人员及时感知并处理
5.失败原因分析
看看你发送消息中,是不是没有自己定义的关键词
看看你消息的接收方,是不是userId或手机号不对