腾讯云语音
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。
