腾讯云语音
FlashCat 支持使用腾讯云语音渠道进行告警通知,下面就介绍如何配置对接腾讯云语音。
配置字段说明
夜莺模版参数 | 腾讯云 | 解释说明 |
---|---|---|
TcSecretId | SecretId | 云API密钥是构建腾讯云 API 请求的重要凭证。用于调用腾讯云API时生成签名。仅支持在创建时查看,请及时保存SecretKey。 |
TcSecretKey | SecretKey | 同上 |
TcSdkAppId | SDK AppID | 语音应用的唯一标识,调用语音API接口时,需要提供该参数。 |
TcTplId | 语音模板 ID | 控制台审核通过的模板 ID |
TcEndpoint | 腾讯语音就近地域接入域名"vms.tencentcloudapi.com" | 指定地域接入参考 服务地址 。 |
TcRegion | Region | 地域参数,用来标识希望操作哪个地域的数据。接口 Region 字段的可选值如下:华北地区(北京)ap-beijing;华南地区(广州)ap-guangzhou; |
使用配置示例
1.创建 SecretId & SecretKey
在腾讯云控制台 API 密钥管理中新建密钥
注意:新建的密钥只在创建时提供SecretKey,后续不可再进行查询,请保存好SecretKey。
2.创建 SDK AppID
腾讯云控制台应用管理—>应用列表—>创建应用,创建好后就可以看到 SDKAppID 。
3.创建语音模板获取语音模板 ID
腾讯云控制台应用管理—>语音模版—>创建语音模版。
注意:
● 选择对应应用再创建语音模版。
● 语音模版中不支持任何变量。
● 创建完成语音模版需要等待腾讯云审核,腾讯云审核规范。
填写模版内容就是你要语音播报的内容。
常规模版(无变量使用)
变量语音模版
在创建语音模板时,模板内容使用变量{1},这样在告警通知时,会把{1}替换为tx-voice通知模板内容。
创建完成后就可以在页面看到语音模版 ID ,在语音模版状态是审核已通过才能使用。
4. FlashCat 填写腾讯云语音配置
根据上面在腾讯云获得的参数值填写到对应字段中即可。
注意:
TcEndpoint :vms.tencentcloudapi.com是腾讯语音就近地域接入域名,如指定地域接入参考 服务地址 。
TcRegion :地域参数,可选值 ap-beijing 或 ap-guangzhou ;
5.配置通知模版
在系统设置通知模版—>选择 tx-voice 模版,在 tx-voice 模版中可以自定义告警展示信息。上面在创建语音模版使用变量,那么{1}
会替换为下面模板中S{{.Severity}}{{if .IsRecovered}}Recovered{{else}}Triggered{{end}}{{.RuleName}}
的变量内容。通知模板编写可以参考此文档 https://flashcat.cloud/docs/content/flashcat-monitor/nightingale-v6/faq/go-template/
6.配置腾讯云语音
-
通知媒介中勾选
tx-voice
-
选择告警接收组 (组内成员必须填写正确手机联系方式才能接收到短信通知)
在人员组织—>用户管理 配置用户手机号码
日志排错
如果无法正常发送消息,可以在 FlashCat 的 ERROR.log 中查看相关报错信息进行排查,过滤关键词sender
。