Promethus与BMCTrueSight集成实现（第一篇）

　　整个实现步骤分为四篇：
　　第一篇：TrueSight接口调试
　　第二篇：golang HTTP程序编写
　　第三篇：Promethus Webhook配置
　　第四篇：docker镜像打包和部署
　　一、背景
　　国内几乎没有Promethus与TrueSight集成实现的资料，原因主要还是因为TrueSight比较小众，过去大多是金融行业用得比较多，随后因为微服务架构、K8S、Docker这些的盛行，TrueSight已经很难体现出优势，为此BMC官方也推出了BMC Helix的产品，只是目前国内还未有完整的案例，大多是在实施中。
　　二、目的
　　本人使用和运维BMC TrueSight是在2016年，还包括了BMC Remedy、CMDB、ADDM等相关产品，希望通过此次Promethus与TrueSight集成案例，带大家去实现Promethus的事件集成，此方案也可用于需要与Promethus告警事件集成的其他的事件平台，后续也将会更多的带来相关的一些讲解和案例，帮助可能使用或正在使用BMC产品的同学更全面的了解其产品的功能，当然目前我也在着手对BMC相关产品进行技术替换，也将分享给大家。
　　三、实现方案
　　实现方案思路为通过GO或python启动HTTP服务，文章里我将以Go为例，实现Prometheus webhook的监听，处理接收到的告警事件，并将事件转发到TrueSight或者其他事件平台上，方法是通用的，大家可以自行尝试。
　　四、实现步骤及完整代码
　　1.TrueSight（版本：11.3.05.001）
　　1.1 TrueSight本身提供了丰富的集成方式，可以将第三方监控工具和业务系统的告警事件集成到BMC Truesight中进行统一处理和展示，包括调用BMC Truesight Restful API、BMC MSEND命令行脚本、SNMP TRAP等方式。
　　1.2 首先进行本地调用测试，分为2步，第一步：调用truesight认证API接口获取token（24小时有效），第二步：获取token后，再调用发送告警事件API发送事件。（本地用postman等api工具先行进行验证）
　　1.3 POST获取token请求地址：https://XXXX:8043/tsws/10.0/api/authenticate/login,调用时添加Header：
　　1.4 请求body参数：
　　{
　　＂username＂:＂账号＂,
　　＂password＂:＂密码＂,
　　＂tenantName＂:＂*＂
　　}
　　1.5 收到如下返回说明获取token成功
　　1.6 根据拿到的token进行模拟事件发送，POST接口请求地址：https://XXXX/bppmws/api/Event/create?routingId=这里是pncell的名字&routingIdType=CELL_NAME
　　1.7 请求header参数（注意：authtoken后面是＂空格＂+token）
　　1.8 请求Body参数样例
　　[
　　{
　　＂attributes＂ :  {
　　＂CLASS＂ :  ＂DIAODU_EV＂ ,
　　＂itsm_category＂ :  ＂firing＂ ,
　　＂itsm_company＂ :  ＂＂ ,
　　＂itsm_location＂ :  ＂＂ ,
　　＂itsm_manufacturer＂ :  ＂＂ ,
　　＂itsm_product_name＂ :  ＂＂ ,
　　＂itsm_item＂ :  ＂cluster.pod.status.phase.not.running-y1k00-6bed5db83e16c8ab82b6668afddbc0c0＂ ,
　　＂itsm_operational_category1＂ :  ＂2023-03-01T07:02:27.334013278Z＂ ,
　　＂itsm_operational_category2＂ :  ＂0001-01-01T00:00:00Z＂ ,
　　＂itsm_operational_category3＂ :  ＂APPLICATION＂ ,
　　＂mc_host＂ :  ＂gjtest＂ ,
　　＂mc_host_address＂ :  ＂＂ ,
　　＂mc_object＂ :  ＂global＂ ,
　　＂mc_object_class＂ :  ＂Cluster＂ ,
　　＂mc_origin_sev＂ :  ＂Critical＂ ,
　　＂mc_parameter＂ :  ＂cluster.memory.utilization＂ ,
　　＂mc_parameter_threshold＂ :  ＂0.01＂ ,
　　＂mc_parameter_value＂ :  ＂0.27842724083472054＂ ,
　　＂msg＂ :  ＂集群的实际内存使用率2 > 0.01 ＂
　　}
　　}
　　]
　　1.9 返回成功样例
　　{
　　＂responseList＂ :  [
　　{
　　＂mc_ueid＂ :  ＂mc.pncell_GDVUTSIMAP01.207ea691.0＂ ,
　　＂statusMsg＂ :  ＂OK＂ ,
　　＂statusCode＂ :  ＂200＂
　　}
　　] ,
　　＂responseTimeStamp＂ :  ＂2023-03-01T10:01:53＂ ,
　　＂statusMsg＂ :  ＂OK＂ ,
　　＂statusCode＂ :  ＂200＂
　　}
　　1.10 返回失败样例（例如token失效，token值不对）
　　{
　　＂responseTimeStamp＂ :  ＂2023-03-01T09:50:34＂ ,
　　＂statusMsg＂ :  ＂Authentication failed. Invalid Username/Password OR Invalid/Expired Token＂ ,
　　＂statusCode＂ :  ＂401＂
　　}
　　进行到这步，说明truesight的接口已经调通，下一步将带大家完整实现通过go监听promethus webhook，同时发送到truesight事件平台。
　　--------------------------------------------
　　本人录制的微服务与分布式系统实战课程（连载中）：https://study.163.com/course/introduction/1213354804.htm?inLoc=ss_ssjg_qblb_%E5%BE%AE%E6%9C%8D%E5%8A%A1