新功能发布记录
接入外部监控 Prometheus
操作场景
TDMQ MQTT 版目前已接入腾讯云可观测平台的 Prometheus 监控服务-云监控模块，该模块集成了云产品基础监控能力，通过 Prometheus 监控服务可以实现数据的统一采集、存储和可视化展示，使得线上运维更加自动化。
操作步骤
步骤1：新建 MQTT 集群实例
1. 登录 TDMQ MQTT 版控制台。
2. 在左侧导航栏选择集群管理 > 集群列表，在左上角击新建集群，进入购买页。
3. 在购买页面，选择地域、可用区、集群类型型号、集群规格等信息，具体参数说明请参考新建集群。
4. 信息填写完成后，单击立即购买，等待集群完成创建，记录集群的“ID”信息，在后续的 Prometheus 监控采集配置中使用。
步骤2：用 Prometheus 采集监控数据
1. 登录 可观测平台 > Prometheus 监控，如果没有 Prometheus 实例，请先单击新建去创建实例，具体指引请见 创建Prometheus实例。
注意：
在创建 Prometheus 实例时，绑定的 VPC 和子网需要与步骤1中 vpcId 和 subnetId 保持一致，否则会出现网络不通的问题。
2. 在实例列表中点击一个 Prometheus 实例，进入实例详情。选择数据采集 > 集成中心，在监控中找到云监控，点击进入。
3. 在弹窗中，输入基本信息并勾选地域，云产品选择消息队列 MQTT 版。
参数配置说明如下：
参数 | 说明 |
名称 | 集成名称，命名规范如下： 名称具有唯一性。 名称需要符合下面的正则：'^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$'。 |
地域 | 必填，要采集的 MQTT 实例所在地域。 |
数据拉取配置 | 单位秒。若设置为0，将忽略原始数据的时间戳；若设置大于0，将上报原始数据的时间戳，由于监控数据上报到基础监控存在一定的延迟，该延迟将会体现在最新的数据上。 拉取数据范围：(当前时间 - 数据采集延迟 - 固定的时间间隔, 当前时间 - 数据采集延迟)。 |
实例刷新间隔 | 单位分钟，最小值为10。每隔一个实例刷新间隔，集成会重新拉取实例信息。如果修改了实例名、云标签或者增删实例，会在一个实例刷新间隔内更新监控数据。 |
实例 ID 过滤 | 选填。不填默认采集主账号下所有实例的数据，填写键值对只会采集填写的实例。键值对形式填写，键是选择消息队列 MQTT 版，值是逗号分隔的您要监控的MQTT 实例 ID。 |
云标签过滤 | 选填。键值对形式填写，一个标签键可以对应多个标签值，以 | 分割。不同的标签键取交集，同一标签键下的多个标签值取并集。如果同时配置了实例 ID 过滤，云标签过滤将不会生效。 |
云标签键替换 | 选填。将不合法的标签键替换为合法值，例如将中文名转换成自定义的英文名。 |
云标签键操作 | 集成默认将标签键的大写字母转换成下划线+小写字母。支持标签键的转换操作： ToUnderLineAndLower：默认操作。 ToLower：表示全转成小写字母。 NoOperation：表示不做转换。 |
标签 | 选填。可以给集成采集到的指标添加额外的自定义标签。 |
跨账号采集 | 本账号角色：自定义角色，用于获取本账号临时密钥。 目标账号角色：自定义角色，用于获取目标账号临时密钥。 目标账号 uin：目标账号的主账号 ID。 |
Metric Relabel 配置 | 选填。Prometheus Operator 原生的 metricRelabelings 配置。配置方式与 Prometheus 抓取配置的 metric_relabel_configs 相同，只有部分字段命名方式不同。 |
4. 在抓取任务中点击已集成页签，等待2-3分钟，可以看到运行状态变化为“已部署”，Targets也可以看到具体的数据抓取对象。点击指标明细可以看到抓取的监控指标。
步骤3：查看监控数据
1. 回到 Prometheus 实例详情 > 基本信息，在 Grafana 卡片中绑定 Grafana。如果没有 Grafana 实例，需要先新建。新建指引请见 Grafana 服务。
注意：
绑定或新建的 Grafana 实例，VPC 和 子网必须和第一步第4点中的 vpcId 和 subnetId 一致，否则会网络不通。
2. 绑定 Grafana 完成后，选择数据采集 > 集成中心，在集成中心页面，找到并单击云监控，选择 Dashboard > Dashboard 操作下的安装/升级 Dashboard，单击安装/升级安装对应的 Grafana Dashboard。
3. 选择已集成，在已集成列表中单击 Grafana 图标即可自动打开云监控集成大盘列表，选择对应消息队列 MQTT 版，查看实例相关的监控数据。
文档反馈