华为云用户手册

步骤3：新建变更 重新进入微服务“概览”页面。 切换到“变更”页签，进入微服务变更列表页面。 单击“新建变更”，进入“新建变更 ”页面，配置以下信息。 表3 新建变更 参数项 说明 变更标题 变更的名称，输入“bugfix”。 代码仓 变更关联的源码仓库，自动和微服务保持一致。 代码分支 变更新需求的开发分支，变更通过流水线发布成功后，会将代码分支自动合并至微服务的默认分支。选择“从默认分支拉取新分支”并输入分支名称“buxfix”。 关联工作项 变更关联的工作项，选择准备工作中已创建的工作项“BUGFIX”。 单击“确定”，完成变更的创建。 变更创建完成后，进入代码开发阶段，系统自动基于微服务默认分支创建出本次变更的特性分支，开发人员可以基于该特性分支进行代码开发活动。可根据需要，模拟向新拉取的分支提交代码更新。

步骤2：新建变更流水线 在微服务列表页面，单击微服务名称，进入微服务“概览”页面。 切换到“流水线”页签，进入微服务流水线列表页面。 单击“新建流水线”，进入“新建流水线 ”页面，配置以下信息。 表2 新建变更流水线 参数项 说明 所属项目 变更流水线所在的项目，不可更改。 名称 变更流水线的名称，使用自动生成的即可。 代码源 变更流水线关联的源码类型，自动和微服务保持一致。 代码仓 变更流水线关联的源码仓库，自动和微服务保持一致。 默认分支 默认使用的分支，自动和微服务保持一致。 Repo https授权 打开“基于变更触发”后需配置“Repo HTTPS授权”，配置授权扩展点以提升代码仓操作权限。选择准备工作中已创建的授权扩展点“https-endpoint”。 别名 输入别名，会生成该仓库对应的相关系统参数，这里不设置。 基于变更触发 打开“基于变更触发”，将当前流水线设置为微服务变更流水线。 描述 变更流水线的描述，选填。 微服务变更流水线仅支持基于变更触发运行，且单个微服务下只能存在一条微服务变更流水线。 单击“下一步”，选择“新手上路”模板，自动生成代码检查、构建、部署等阶段，可根据需要对流水线进行编排，这里使用默认配置即可。 单击“保存”，完成微服务变更流水线的创建。

步骤4：执行变更流水线 代码更新完成后，即可通过变更流水线执行变更。 在微服务变更列表页面，单击变更名称，进入“变更详情”页面。 单击右上角“提交发布”，弹出“提交发布”确认框，提示是否确认将变更提交至变更流水线。 图1 提交发布 单击“确定”，完成变更提交，页面跳转至对应变更流水线发布列表页面。 单击右上角“执行”，弹出“执行配置”侧滑框，选择刚提交的变更，并根据需要配置运行参数、选择执行阶段和任务等。 单击“执行”，启动变更流程。 微服务变更流水线在运行过程中，会自动增加“合并集成分支”和“合并主干”阶段，并将本次变更关联的特性分支合并到该集成分支上。 代码检查、构建、部署任务执行成功后，系统自动进入“合并主干”阶段，并弹出“手动确认”对话框。 图2 执行流水线 单击“继续执行”，“合并主干”阶段执行完成后，系统将自动完成以下事项。 将本次发布的变更状态更新为“已发布”。 将本次发布的变更关联的工作项状态更新为“已关闭”。 将本次发布使用的集成分支代码内容合并到微服务默认分支，实现代码自动合并。 至此，即完成了一次基本的微服务变更发布流程。

步骤2：新建策略并添加规则 策略实行分层管理，可分为租户级策略和项目级策略。其中，租户级策略可以应用到当前租户下所有项目的流水线，项目级策略可以应用到当前项目下所有流水线。本节以租户级策略为例进行介绍。 单击左侧导航“策略”，进入策略管理页面。 租户级策略中默认存在一条“系统策略”，用户可查看和使用该策略，但不能进行编辑和删除。 单击“新建策略”，进入“新建策略”页面，策略名称输入“策略01”，勾选步骤1中新建好的规则“规则01”。 图2 新建策略 单击“确定”，完成策略创建。

更多操作 您还可以根据需要执行以下操作，具体请参见表 相关操作。 表5 相关操作 操作 说明 改变指标排列顺序 在“指标量（最近10分钟）”或“占比”列后单击，可改变指标在列表中的排列顺序。为默认排序，为按大小正序排序（即数据大的显示在最后方），为按大小倒序排序（即数据小的显示在最后方）。 新增指标 单击“新增指标”，在指标列表中选择需要新增的指标，单击“确定”。 说明： 单次新增指标最多支持新增100个指标。 废弃指标 废弃一个指标：选择一个指标，单击操作列的。 废弃一个或多个指标：选中一个或多个指标前的复选框，在弹出框中选择“废弃”，可以废弃一个或多个指标。 说明： 单次废弃指标最多支持废弃100个指标。

注意事项 目前仅default类型、CCE类型、云服务类型、ECS类型的Prometheus实例支持指标查看、新增和废弃功能。 default类型的Prometheus实例下，指标名以“aom_”、“apm_”开头以及资源类型为ICAgent的指标暂不支持废弃。 ECS类型的Prometheus实例仅支持展示和配置UniAgent插件采集的指标。 CCE类型的Prometheus实例仅支持废弃如下指标： 只有在CCE “插件市场” 页面或AOM “集成中心” 页面安装的3.9.0以上的云原生监控插件（kube-prometheus-stack）上报的指标可以被废弃，且只有kube-prometheus-stack处于“运行中”状态时，指标才能废弃成功。 查看kube-prometheus-stack插件状态的方法：登录CCE控制台，单击集群名称进入集群，在左侧导航栏中选择“插件中心”，在右侧找到“云原生监控插件”卡片，查看插件的状态。

采集CCE集群的业务数据 通过新增PodMonitor方式为应用配置可观测监控Prometheus版的采集规则，监控部署在CCE集群内的应用的业务数据。 配置信息如下： apiVersion: monitoring.coreos.com/v1 kind: PodMonitor metadata: name: mysql-exporter namespace: default spec: namespaceSelector: matchNames: - default # exporter 所在的命名空间 podMetricsEndpoints: - interval: 30s path: /metrics port: metric-port selector: matchLabels: k8s-app: mysql-exporter

数据库授权 登录集群执行以下命令： kubectl exec -it ${mysql_podname} bash mysql -u root -p 图1 执行命令 登录数据库，执行以下命令： CREATE USER 'exporter'@'x.x.x.x(hostip)' IDENTIFIED BY 'xxxx(password)' WITH MAX_USER_CONNECTIONS 3; GRANT PROCESS, REPLICATION CLIENT, SELECT ON *.* TO 'exporter'@'x.x.x.x(hostip)'; 验证授权是否成功。 输入以下命令查询sql，查看是否有exporter的数据，host为mysql所在节点的IP。 select user,host from mysql.user; 图2 查询sql

更多仪表盘操作 仪表盘创建完成后，您还可以执行表5中的操作。 表5 相关操作 操作 说明 设置列表项 在仪表盘列表右上角单击，通过选中/取消选中各展示项前的复选框，自定义列表项的展示/隐藏。 收藏仪表盘 选择一个仪表盘，单击“操作”列的。 移动仪表盘分组 移动一个仪表盘分组：选择一个仪表盘，单击“操作”列的，选择“移动分组”。 批量移动仪表盘分组：选中多个仪表盘前的复选框，在弹出框中选择“移动分组”可修改仪表盘分组。 删除仪表盘 删除一个仪表盘：选择一个仪表盘，单击“操作”列的，选择“删除”。 批量删除仪表盘：选中多个仪表盘前的复选框，在弹出框中选择“删除”可批量删除仪表盘。 修改仪表盘分组名称 在“仪表盘”列表，单击仪表盘名称。 进入对应仪表盘页面，在“仪表盘”页面左上角，单击仪表盘名称。 将光标移至待操作的仪表盘分组名称后，单击，选择“编辑”可修改分组名称。 删除仪表盘分组 删除仪表盘分组功能有两种入口方式： 入口一： 在“仪表盘”列表，单击仪表盘名称。 进入对应仪表盘页面，在“仪表盘”页面左上角，单击仪表盘名称。 将光标移至待操作的仪表盘分组名称后，单击 ，选择“删除”。 在弹出框中单击“确定”，删除仪表盘分组。 入口二：在仪表盘分组列表中，将光标移至需要删除的仪表盘分组名称后，单击，选择“删除”，在弹出框中单击“确定”，删除仪表盘分组。 删除仪表盘中的图表 选择待操作的仪表盘，在“仪表盘”页面右上角单击，将光标移至某个图表框右上角，单击，在下拉列表中选择“删除图表”。 单击，将已创建图表删除。 调整仪表盘中图表的位置 选择待操作的仪表盘，在“仪表盘”页面右上角单击，将光标移至待操作的图表框内，选中该图表，可将该图表移动至仪表盘内任意位置。 单击，调整当前图表布局。 全屏显示 选择待操作的仪表盘，在“仪表盘”页面右上角单击，可全屏显示仪表盘。 退出全屏显示 将光标移至屏幕上方，单击弹出的，或者单击，或者按键盘中的“Esc”可退出全屏模式。 手动刷新 选择待操作的仪表盘，在“仪表盘”页面右上角单击可手动刷新当前页面。 自动刷新 选择待操作的仪表盘，在“仪表盘”页面右上角单击后的下拉箭头，开启仪表盘自动刷新开关。 手动刷新单个图表 选择待操作的仪表盘，将光标移至某个图表框右上角，单击，在下拉列表中选择“刷新”，可手动刷新当前图表。 修改单个图表 选择待操作的仪表盘，将光标移至某一图表框右上角，单击，选择“编辑”，可修改图表数据，具体操作请参见添加图表至仪表盘。 修改完成后，单击“确定”。 在“仪表盘”页面右上角单击，保存修改结果。 新增告警规则 添加图表时，新增告警规则 单击页面中的“添加图表”或单击页面右上角的。 选择指标后，在指标列表右上方单击，可为当前添加的所有指标新增告警规则。具体操作请参见创建指标告警规则。 修改图表时，新增告警规则 选择待操作的仪表盘，将光标移至某一图表框右上角，单击，选择“编辑”。 选择指标后，在指标列表右上方单击，可为当前添加的所有指标新增告警规则。具体操作请参见创建指标告警规则。 全屏显示单个图表 选择待操作的仪表盘，将光标移至某一图表框右上角，单击，选择“全屏”，可全屏显示图表数据。 退出全屏显示单个图表 将光标移至屏幕上方，单击弹出的，或者单击，选择“退出全屏”，或者按键盘中的“Esc”可退出全屏模式。 轮播仪表盘 选择待操作的仪表盘，在“仪表盘”页面右上角单击。具体操作请参见设置全屏模式在线时长。 仪表盘设置 选择待操作的仪表盘，在“仪表盘”页面右上角单击。具体操作请参见新增变量。 查询时间设置 选择待操作的仪表盘，在“仪表盘”页面右上角单击前面的下拉框，在下拉框可选择“近30分钟”、“近1小时”、“近6小时”、“近一天”、“近一周”、“自定义时间段”。若选择“自定义时间段”，在弹出日历表中选择对应的时间段，时间可精确至秒数。单击“确定”后，可根据选择时间查询仪表盘中所有图表数据。 导出仪表盘 可将该仪表盘的指标图表数据以JSON格式导出，并保存到本地便于进一步分析。导出仪表盘功能有两种入口方式： 入口一：在仪表盘列表中，选择一个仪表盘，单击“操作”列的，选择“导出仪表盘”。 入口二：选择待操作的仪表盘，在“仪表盘”页面右上角单击，并选择“导出仪表盘”。 导入仪表盘 将本地存储的JSON格式仪表盘数据导入AOM，便于在AOM上可视化分析。导入仪表盘功能有两种入口方式： 入口一：在“仪表盘”页面，单击“导入仪表盘”。 入口二：在仪表盘分组列表中，将光标移至需要导入仪表盘的的分组名称后，单击，选择“导入仪表盘”。 导入方法： 选择待导入的JSON格式仪表盘文件，上传或拖入“导入仪表盘”对话框的文本上传区域，然后单击“创建”。 在“新建仪表盘”对话框，依次设置仪表盘名称等信息，具体请参见表1。 设置完成，单击“创建”。 导出监控报告 选择待操作的仪表盘，在“仪表盘”页面右上角单击，选择“导出折线图监控报告”，可将该指标的折线图表以CSV格式导出，以便进行本地存储及进一步分析。 表6 日志图表相关操作 操作 说明 创建日志组 输入日志组名称。日志组名称只支持输入英文、数字、中文、中划线、下划线及小数点，且不能以小数点、下划线开头或以小数点结尾。 设置日志存储时间。存储时间默认为7天，可设置为1~30天内的时间节点。超出存储时间的日志将会被自动删除，您可以按需将日志数据转储至OBS桶中长期存储。 单击“确定”完成创建。 创建日志流 输入日志流名称。日志流名称只支持输入英文、数字、中文、中划线、下划线及小数点，且不能以小数点、下划线开头或以小数点结尾。 单击“确定”完成创建。

注意事项 系统预置的仪表盘模板都保存在“系统内置”分组下，包含容器、云服务、原生中间件、应用四种。预置仪表盘不允许删除或调整分组，仪表盘模板不支持创建。 系统预置的容器类型仪表盘需要在CCE集群下的“插件管理”中安装“kube-prometheus-stack”插件后，才能正常使用。 系统预置的原生中间件类型仪表盘需要在UniAgent中创建中间件采集任务后，才能正常使用。 1个区域中最多可创建1000个仪表盘分组。 1个区域中最多可创建1000个仪表盘。 1个仪表盘中最多可添加30个图表。 1个折线图最多支持展示200条指标数据。 1个数字图只能展示1个资源，最多可添加12个资源，默认展示第一个资源。

操作场景 使用ElasticSearch过程中需要对ElasticSearch运行状态进行监控，例如集群及索引状态等。Prometheus监控服务提供了CCE容器场景下基于Exporter的方式来监控ElasticSearch运行状态。本文介绍如何部署ElasticSearch Exporter以及实现ElasticSearch Exporter告警接入等操作。 为了方便安装管理Exporter，推荐使用CCE进行统一管理。

采集CCE集群的业务数据 通过新增PodMonitor方式为应用配置可观测监控Prometheus版的采集规则，监控部署在CCE集群内的应用的业务数据。 如下示例中指标采集的周期是30秒，所以等待大概30秒后才能在AOM的界面上查看到上报的指标。 apiVersion: monitoring.coreos.com/v1 kind: PodMonitor metadata: name: elasticSearch-exporter namespace: default spec: namespaceSelector: # 选择监控Exporter部署所在的namespace matchNames: - default # exporter所在的命名空间 podMetricsEndpoints: - interval: 30s # 设置指标采集周期 path: /metrics # 填写Prometheus Exporter对应的Path的值，默认/metrics port: metric-port # 填写Prometheus Exporter对应YAML的ports的name selector: # 填写要监控Exporter Pod的Label标签，以定位目标Exporter matchLabels: k8s-app: elasticSearch-exporter

告警标签说明 告警标签可应用于告警降噪模块的分组规则、抑制规则和静默规则，告警管理系统根据标签属性进行告警管理和通知。 告警标签为key:value键值对格式，支持用户自定义。key 和value只能包含中文、字母、数字和下划线。 如果在创建告警规则时设置了告警标签，触发的告警会自动添加该标签为告警属性。 消息模板中通过$event.metadata.key1变量获取告警标签信息，具体请参见消息模板变量说明。 如您的组织已经设定AOM服务的相关标签策略，则需按照标签策略规则添加告警标签。标签如果不符合标签策略的规则，则可能会导致添加标签失败，请联系组织管理员了解标签策略详情。

更多操作 日志指标规则创建完成后，您还可以执行表3中的相关操作。 表3 相关操作 操作 说明 查看日志指标规则 在左侧日志指标规则列表中，单击规则名称。 在右侧可查看该规则的启用状态、日志类型、接入指标等信息。 停用日志指标规则 在左侧日志指标规则列表中，单击规则名称。 在右侧页面右上角，单击“停用规则”。 编辑日志指标规则 在左侧日志指标规则列表中，单击规则名称。 在右侧页面右上角，单击，在下拉列表中选择“编辑”。具体操作请参见创建日志指标规则。 删除日志指标规则 在左侧日志指标规则列表中，单击规则名称。 在右侧页面右上角，单击，在下拉列表中选择“删除”。 添加接入指标 在左侧日志指标规则列表中，单击规则名称。 在右侧页面单击“添加接入指标”。具体操作请参见添加接入指标。 编辑接入指标 在左侧日志指标规则列表中，单击规则名称。 在右侧页面选择一个接入指标卡片，单击。具体操作请参见添加接入指标。 删除接入指标 在左侧日志指标规则列表中，单击规则名称。 在右侧页面选择一个接入指标卡片，单击。 搜索接入指标 在左侧日志指标规则列表中，单击规则名称。 在右侧页面“添加接入指标”后的搜索框中输入规则名称关键字，单击后显示匹配对象。

管理接入规则 您可以在“接入LTS”界面对已添加的接入规则进行搜索、查看、编辑和删除。 搜索 单击搜索框，选择搜索维度，如选择“工作负载”，然后继续选择该维度下的可选项。如未选择搜索维度，直接输入搜索关键字，则默认按照接入规则名称搜索。 查看 在规则列表中可查看已创建的接入规则的集群名称、命名空间等信息。单击搜索框右上方的，自定义列表项的展示。单击“接入日志组”列的日志组名称，可以跳转到LTS控制台的日志组详情。 编辑 单击“操作”列的“编辑”，可以编辑该接入规则。修改接入规则的影响请参见修改映射。 删除 单击“操作”列的“删除”，可以删除该接入规则。勾选多个规则名称前的复选框，单击“批量删除”，可批量删除接入规则。 删除接入规则或删除映射日志流不可恢复，请您谨慎操作。删除接入规则的影响请参见删除映射。

数据订阅格式说明 AOM格式的指标JSON格式代码片断 package metric type MetricDatas struct { Metrics []Metrics `json:"metrics"` ProjectId string `json:"project_id"` } type Metrics struct { Metric Metric `json:"metric"` Values []Value `json:"values"` CollectTime int64 `json:"collect_time"` } type Metric struct { Namespace string `json:"namespace"` Dimensions []Dimension `json:"dimensions"` } type Value struct { Value interface{} `json:"value"` Type string `json:"type"` Unit string `json:"unit"` StatisticValues string `json:"statisticvalues"` MetricName string `json:"metric_name"` } type Dimension struct { Name string `json:"name"` Value string `json:"value"` } kafka消息示例 key:, value:{"metrics":[{"metric":{"namespace":"PAAS.NODE","dimensions":[{"name":"nodeName","value":"test-aom-4-vss-cop-master-1"},{"name":"nodeIP","value":"1.1.1.1"},{"name":"hostID","value":"75d97111-4734-4c6c-ae9e-f6111111111"},{"name":"nameSpace","value":"default"},{"name":"clusterId","value":"46a7bc0d-1d8b-11ea-9b04-333333333333333"},{"name":"clusterName","value":"test-aom-4-vss-111"},{"name":"diskDevice","value":"vda"},{"name":"master","value":"true"}]},"values":[{"value":0,"type":"","unit":"Kilobytes/Second","statisticvalues":"","metric_name":"diskReadRate"},{"value":30.267,"type":"","unit":"Kilobytes/Second","statisticvalues":"","metric_name":"diskWriteRate"}],"collect_time":1597821030037}],"project_id":"111111111111111111111"} 告警数据格式说明 示例： { "events": [{ "id": "4346299651651991683", "starts_at": 1597822250194, "ends_at": 0, "arrives_at": 1597822250194, "timeout": 300000, "resource_group_id": "312313123112222222222232131312131", "metadata": { "kind": "Pod", "event_severity": "Major", "resource_type": "service", "clusterId": "6add4ef5-1358-11ea-a5bf-111111111", "event_type": "alarm", "clusterName": "cce-ief-4516140c-96ca-4a5f-8d85-1111111", "namespace": "PAAS.NODE", "name": "test15769793809553052-f5557bd7f-qnfkm", "event_name": "调度失败##FailedScheduling", "resource_id": "clusterName=cce-ief-4516140c-96ca-4a5f-8d85-111111;clusterID=6add4ef5-1358-11ea-a5bf-11111111111;kind=Pod;namespace=30d5758f166947c6b164af604a654b09;name=test15769793809553052-f5557bd7f-qnfkm;uid=589fc746-245d-11ea-a465-fa163e5fc15d", "nameSpace": "30d5758f166947c6b164af604a654b09", "resource_provider": "CCE", "nodeID": "589fc746-245d-11ea-a465-fa163e5fc15d" }, "annotations": { "alarm_probableCause_zh_cn": "FailedScheduling", "alarm_probableCause_en_us": "FailedScheduling", "message": "0/110 nodes are available: 1 node(s) had taints that the pod didn't tolerate, 109 node(s) didn't match node selector." }, "attach_rule": { } }], "project_id": "312313123112222222222232131312131" } 参数说明： 表3 告警参数 参数 参数类型 描述 events Array of objects，详见 表4。 事件或者告警详情。 project_id String 租户从IAM申请到的projectid，一般为32位字符串。 表4 EventModel 参数 参数类型 描述 id String 事件或者告警id，系统自动生成。 starts_at Long 事件或者告警产生的时间，CST毫秒级时间戳。 ends_at Long 事件或者告警清除的时间，CST毫秒级时间戳，为0时表示未删除。 arrives_at Long 事件或者告警到达AOM的时间，CST毫秒级时间戳。 timeout Long 告警自动清除时间。毫秒数，例如一分钟则填写为60000。默认清除时间为3天。 resource_group_id String 资源组预留字段，当前默认和projectid的值一样。 metadata Object 事件或者告警的详细信息，为键值对形式。必须字段为： event_name：事件或者告警名称,类型为String； event_severity：事件级别枚举值。类型为String，四种类型 "Critical", "Major", "Minor", "Info"； event_type：事件类别枚举值。类型为String，event为普通告警，alarm为告警事件； resource_provider：事件对应云服务名称。类型为String； resource_type：事件对应资源类型。类型为String； resource_id：事件对应资源信息。类型为String。 annotations Object 事件或者告警附加字段，可以为空。 attach_rule Object 事件或者告警预留字段，为空。

创建订阅规则 登录AOM 2.0控制台。 在左侧导航栏中选择“设置”，进入全局配置界面。 在左侧导航栏中选择“数据订阅”，单击“创建订阅规则”，根据实际需求，选择订阅内容为“分布式消息DMS订阅”或“Webhook”。 订阅内容选择“分布式消息服务DMS”。 请参考表1配置参数，设置相关参数后，单击“确定”。 表1 数据订阅规则参数说明 参数 说明 规则名称 订阅规则名称。 只能由大小写字母、数字、中划线和下划线组成，且必须以英文字母开头，最多不能超过64个字符。 订阅内容 选择“分布式消息DMS订阅”。 数据类型 支持“指标”和“告警”。 Prometheus实例 从下拉列表中选择需要转发指标的Prometheus实例。下拉列表中显示当前账号下的所有Remote Write类型Prometheus实例。 该功能当前受限开放，如有需求可以通过提交工单，为您开放此功能。 实例 从下拉列表中选择合适的DMS实例。如现有DMS实例均不满足需要，请单击“创建DMS实例”创建。 验证DMS实例连通性。 数据订阅至DMS需要在IAM委托界面增加名为 "apm_admin_trust"委托，请确认是否已经创建。创建“apm_admin_trust”委托的详细操作请参见如何创建委托apm_admin_trust。 输入DMS用户名和密码。 单击“验证并保存DMS配置信息”。 选择数据发送topic后，单击“确定”。 订阅内容选择“Webhook”。 请参考表2配置参数，设置相关参数后，单击“确定”。 表2 数据订阅规则参数说明 参数 说明 规则名称 订阅规则名称。 只能由大小写字母、数字、中划线和下划线组成，且必须以英文字母开头，最多不能超过64个字符。 订阅内容 选择“webhook”。 自建普罗 Remote Write地址 请输入用户侧Prometheus实例的Remote Write地址，作为指标发送的目标地址。 传输请求的协议，请根据实际情况从下拉列表中选择，推荐使用HTTPS协议。 数据类型 默认为“指标”。 Prometheus实例 从下拉列表中选择需要转发指标的Prometheus实例。下拉列表中显示当前账号下的所有Remote Write类型Prometheus实例。 鉴权方式 访问用户侧Prometheus实例的认证方式。 基础认证：输入用户侧Prometheus实例的用户名和密码。 Token：输入访问用户侧Prometheus实例的Token。 无认证：无需认证，即可访问用户侧Prometheus实例。 规则创建成功后，即可在规则列表中查看当前创建的数据订阅规则。

更多操作 表1 仪表盘相关操作 操作 说明 全屏显示 选择待操作的仪表盘，在“仪表盘”页面右上角单击，可全屏显示仪表盘。 退出全屏显示 将光标移至屏幕上方，单击弹出的，或者单击，或者按键盘中的“Esc”可退出全屏模式。 手动刷新 选择待操作的仪表盘，在“仪表盘”页面右上角单击可手动刷新当前页面。 自动刷新 选择待操作的仪表盘，在“仪表盘”页面右上角单击后的下拉箭头，开启仪表盘自动刷新开关。 轮播仪表盘 选择待操作的仪表盘，在“仪表盘”页面右上角单击。具体操作请参见设置全屏模式在线时长。 查询时间设置 选择待操作的仪表盘，在“仪表盘”页面右上角单击前面的下拉框，在下拉框可选择“近30分钟”、“近1小时”、“近6小时”、“近一天”、“近一周”、“自定义时间段”。若选择“自定义时间段”，在弹出日历表中选择对应的时间段，时间可精确至秒数。单击“确定”后，可根据选择时间查询仪表盘中所有图表数据。 导出监控报告 选择待操作的仪表盘，在“仪表盘”页面右上角单击，选择“导出折线图监控报告”，可将该指标的折线图表以CSV格式导出，以便进行本地存储及进一步分析。

注意事项 按搜索分析创建告警规则功能目前在邀测中，暂不支持申请开通。 按SQL统计创建告警规则功能仅支持全部用户使用的局点有：华南-广州、华北-北京四、华北-乌兰察布二零一、华北-乌兰察布一、华东-上海一、华东-上海二、中国-香港、亚太-曼谷、亚太-新加坡，支持部分白名单用户使用的局点有：华北-北京一、西南-贵阳一、亚太-曼谷、华南-深圳、华北-乌兰察布一、华北-乌兰察布二零二，其他局点暂不支持该功能。

使用限制 单账号跟踪的事件可以通过云审计控制台查询。多账号的事件只能在账号自己的事件列表页面去查看，或者到组织追踪器配置的OBS桶中查看，也可以到组织追踪器配置的CTS/system日志流下面去查看。 用户通过云审计控制台只能查询最近7天的操作记录。如果需要查询超过7天的操作记录，您必须配置转储到对象存储服务(OBS)，才可在OBS桶里面查看历史文件。否则，您将无法追溯7天以前的操作记录。 云上操作后，1分钟内可以通过云审计控制台查询管理类事件操作记录，5分钟后才可通过云审计控制台查询数据类事件操作记录。

管理索引 支持属性、特征、关系的搜索项配置以及过滤项配置，并支持对已配置的索引进行编辑、删除操作，具体操作说明见表5。 表5 索引配置说明 操作 说明 添加搜索项/过滤项 包含添加属性/特征/关系的搜索项以及过滤项。 在架构设计的左侧菜单栏，选择索引下的属性/特征/关系索引，在搜索项/过滤项右侧单击，在弹框中配置搜索项/过滤项信息，单击“确定”，搜索项/过滤项配置完成。 具体参数说明如下： 名称：搜索项/过滤项名称，用户自定义，名称包含英文字母、数字、下划线、中文以及空格，并且只能以中文和英文开头。 编码：搜索项/过滤项编码，用户自定义。 描述：对搜索项/过滤项的描述说明。 是否启用：当启用时，配置项生效。 设置属性/特征/关系搜索项 在架构设计的左侧菜单栏，选择索引下的属性/特征/关系索引，单击已经创建好的属性/特征/关系搜索项名称，设置搜索项的基础信息以及属性/特征/关系路径。 具体参数说明如下： 搜索项：选择已添加的搜索项。 属性配置项在Elasticsearch会映射为一个逻辑字段，帮助用户按照实体属性的值进行关键词匹配从而搜索到实体。 特征配置项在Elasticsearch会映射为一个逻辑字段，此字段帮助用户按照特征属性的值进行关键词匹配从而搜索到与该特征关联的实体。 关系配置项在Elasticsearch会映射为一个逻辑字段，此字段帮助用户按照关系路径的属性值进行关键词匹配从而搜索到与该关系路径属性关联的实体。 属性/特征/关系路径：由搜索的实体开始，并以要作为搜索项的属性结束，单击，选择属性/特征/关系路径。 设置属性/特征/关系过滤项 在架构设计的左侧菜单栏，选择索引下的属性/特征/关系索引，单击已经创建好的属性/特征/关系过滤项名称，设置过滤项的基础信息以及属性/特征/关系路径。 具体参数说明如下： 过滤项：选择已添加的过滤项。 属性配置项在Elasticsearch会映射为一个逻辑字段，此字段帮助用户按照实体属性的值进行聚合以从搜索结果中过滤相关实体。 特征配置项在Elasticsearch会映射为一个逻辑字段，此字段帮助用户按照特征属性的值进行聚合以从搜索结果中过滤与此特征关联的实体。 关系配置项在Elasticsearch会映射为一个逻辑字段，此字段帮助用户按照关系路径的属性值进行聚合以从搜索结果中过滤与此关系路径属性关联的实体。 属性/特征/关系路径：由过滤的实体开始，并以要作为过滤项的属性结束，单击，选择属性/特征/关系路径。 修改搜索项/过滤项 包含修改属性/特征/关系的搜索项以及过滤项。 在架构设计的左侧菜单栏，选择索引下的属性/特征/关系索引，在搜索项/过滤项名称右侧单击，在弹框中修改搜索项/过滤项信息，单击“确定”，搜索项/过滤项修改完成。 删除搜索项/过滤项 包含删除属性/特征/关系的搜索项以及过滤项。 在架构设计的左侧菜单栏，选择索引下的属性/特征/关系索引，在搜索项/过滤项名称右侧单击，在弹框中单击“确定”，搜索项/过滤项删除。

管理索引 支持属性、特征、关系的搜索项配置以及过滤项配置，并支持对已配置的索引进行编辑、删除操作，具体操作说明见表5。 表5 索引配置说明 操作 说明 添加搜索项/过滤项 包含添加属性/特征/关系的搜索项以及过滤项。 在架构设计的左侧菜单栏，选择索引下的属性/特征/关系索引，在搜索项/过滤项右侧单击，在弹框中配置搜索项/过滤项信息，单击“确定”，搜索项/过滤项配置完成。 具体参数说明如下： 名称：搜索项/过滤项名称，用户自定义，名称包含英文字母、数字、下划线、中文以及空格，并且只能以中文和英文开头。 编码：搜索项/过滤项编码，用户自定义。 描述：对搜索项/过滤项的描述说明。 是否启用：当启用时，配置项生效。 设置属性/特征/关系搜索项 在架构设计的左侧菜单栏，选择索引下的属性/特征/关系索引，单击已经创建好的属性/特征/关系搜索项名称，设置搜索项的基础信息以及属性/特征/关系路径。 具体参数说明如下： 搜索项：选择已添加的搜索项。 属性配置项在Elasticsearch会映射为一个逻辑字段，帮助用户按照实体属性的值进行关键词匹配从而搜索到实体。 特征配置项在Elasticsearch会映射为一个逻辑字段，此字段帮助用户按照特征属性的值进行关键词匹配从而搜索到与该特征关联的实体。 关系配置项在Elasticsearch会映射为一个逻辑字段，此字段帮助用户按照关系路径的属性值进行关键词匹配从而搜索到与该关系路径属性关联的实体。 属性/特征/关系路径：由搜索的实体开始，并以要作为搜索项的属性结束，单击，选择属性/特征/关系路径。 设置属性/特征/关系过滤项 在架构设计的左侧菜单栏，选择索引下的属性/特征/关系索引，单击已经创建好的属性/特征/关系过滤项名称，设置过滤项的基础信息以及属性/特征/关系路径。 具体参数说明如下： 过滤项：选择已添加的过滤项。 属性配置项在Elasticsearch会映射为一个逻辑字段，此字段帮助用户按照实体属性的值进行聚合以从搜索结果中过滤相关实体。 特征配置项在Elasticsearch会映射为一个逻辑字段，此字段帮助用户按照特征属性的值进行聚合以从搜索结果中过滤与此特征关联的实体。 关系配置项在Elasticsearch会映射为一个逻辑字段，此字段帮助用户按照关系路径的属性值进行聚合以从搜索结果中过滤与此关系路径属性关联的实体。 属性/特征/关系路径：由过滤的实体开始，并以要作为过滤项的属性结束，单击，选择属性/特征/关系路径。 修改搜索项/过滤项 包含修改属性/特征/关系的搜索项以及过滤项。 在架构设计的左侧菜单栏，选择索引下的属性/特征/关系索引，在搜索项/过滤项名称右侧单击，在弹框中修改搜索项/过滤项信息，单击“确定”，搜索项/过滤项修改完成。 删除搜索项/过滤项 包含删除属性/特征/关系的搜索项以及过滤项。 在架构设计的左侧菜单栏，选择索引下的属性/特征/关系索引，在搜索项/过滤项名称右侧单击，在弹框中单击“确定”，搜索项/过滤项删除。

使用限制 单账号跟踪的事件可以通过云审计控制台查询。多账号的事件只能在账号自己的事件列表页面去查看，或者到组织追踪器配置的OBS桶中查看，也可以到组织追踪器配置的CTS/system日志流下面去查看。 用户通过云审计控制台只能查询最近7天的操作记录。如果需要查询超过7天的操作记录，您必须配置转储到对象存储服务(OBS)，才可在OBS桶里面查看历史文件。否则，您将无法追溯7天以前的操作记录。 云上操作后，1分钟内可以通过云审计控制台查询管理类事件操作记录，5分钟后才可通过云审计控制台查询数据类事件操作记录。

更多操作 通道创建成功后，您可以执行如表2所示操作。 表2 相关操作 操作 说明 测试通道连接 在通道列表中，选择需要测试的通道，单击“操作”列的“测试连接”，检测通道与第三方系统之间是否能够连通。 如果测试结果为“测试连接成功！”，则继续下一步。 如果测试结果为“测试连接失败！”，则检查第三方系统状态和通道参数配置，然后单击“测试连接”，直到连接成功为止。 编辑通道 在通道列表中，选择需要编辑的通道，单击“操作”列的“编辑”，在通道配置界面中，参考表1修改配置，单击“保存”，完成通道编辑。 删除通道 在通道列表中，选择需要删除的通道，单击“操作”列的“删除”，在弹出的“是否删除该数据源”对话框中，单击“确认”，完成通道删除。

管理域名 对域名进行管理，实现任意域名生效就会运行流的目的。域名管理的操作请参考表3。 需要绑定到API分组的域名需要满足以下条件： 已有独立域名。 需要绑定的域名已经cname解析到该分组的子域名b4dff2cc395e474eb0c837624c75eac6.apig.cn-north-7.huaweicloudapis.com，否则无法绑定。 需要绑定的域名已经完成ICP备案，否则无法绑定。 如果API分组中的API支持HTTS请求协议，则需要为独立域名添加SSL证书。 表3 管理域名的操作 操作项 操作及说明 绑定独立域名 单击“绑定独立域名”，输入域名，单击“确定”。创建成功的域名展示在列表中，最多支持创建5个独立域名。 域名的格式为：abc.com 解除绑定独立域名 在独立域名列表中，在对应的“操作”列下，单击“解除绑定”，单击“确定”。 添加SSL证书 当API分组中的API支持HTTS请求协议时，才有此操作。 在独立域名列表中，在对应的“操作”列下，单击“添加SSL证书”，输入已获取的证书名称、证书内容及密钥。单击“确定”。 证书内容及密钥使用的是pem编码，可以单击“样例”，查看样例。 查看证书 当API分组中的API支持HTTS请求协议时，才有此操作。 在独立域名列表中，在对应的“操作”列下，单击“查看证书”，可以查看证书详细信息。 编辑SSL证书 当API分组中的API支持HTTS请求协议时，才有此操作。 在独立域名列表中，在对应的SSL证书列下，单击，可以修改证书名称、证书内容及密码。 删除证书 当API分组中的API支持HTTS请求协议时，才有此操作。 在独立域名列表中，在对应的“操作”列下，单击“删除证书”，可以删除已添加的证书。

响应 “响应”执行动作需和API流的触发动作一起配合使用，用户通过此执行动作可以根据需要定制接口的响应信息。 其中响应体为Json格式的字符串，响应头为键值对（key=value）形式返回。 输入参数 用户配置响应执行动作，相关参数说明如表2所示。 表2 响应输入参数说明 参数 必须 说明 状态码 是 选择状态码，有200、201、400、401、500、502。支持输入框和下拉框两种模式。 响应体 否 设置响应体名称。 响应头的key 否 设置响应头的键，为数组模式。 响应头的值 否 设置响应头的数值，为数组模式。 响应头 否 设置响应头，需要选择数组类型的节点输出，为输入框模式。 输出参数 该执行动作无输出参数说明。

选择合适的分片键 背景 分片集群中数据的分片以集合为基础单位，集合中的数据通过分片键被分成多个部分。分片键是在集合中选择的一个合适的字段，数据拆分时以该分片键的值为依据均衡地分布到所有分片中。如果您没有选择到合适的的分片键，可能会降低集群的使用性能，出现执行分片语句时执行过程卡住的问题。 分片键一旦设置后不能再更改。如果未选取到合适的分片键，需要使用正确的分片策略，将数据迁移到新的集合后重新执行分片。 合适的分片键的特点 所有的插入、更新以及删除操作，将会均匀分发到集群中的所有分片中。 key的分布足够离散。 尽量避免scatter-gather查询。 如果所选分片键不具备以上所有特点，将会影响集群的读写扩展性。例如，通过find()操作读取的工作量在分片中非均匀分布，最终会产生查询热分片。同样，如果写工作量（插入、更新和修改）在分片中非均匀分布，最终会产生写热分片，严重限制分片的优势。因此，您需要根据应用读写状态（重读取还是重写入）、经常查询及写入的数据等业务需求，调整您的分片键。 需要注意，对已有数据分片后，如果update请求的filter中未携带片键字段并且选项upsert:true或者multi:false，那么update 请求会报错，并返回“An upsert on a sharded collection must contain the shard key and have the simple collation.” 判断标准 您可以通过表2中的几个维度，判断所选分片键是否能够满足业务需求。 表2 合理分片键的判断依据 判断依据 说明 片键基数 片键基数是指划分数据块的能力。例如，要记录某个学校的学生信息，由于学生的年龄比较集中，如果选择年龄作为分片键，同一个数据段中将存储很多同龄学生的数据，影响集群的性能以及可管理性。由于学生的学号唯一，如果选择学号作为分片键，分片基数较大，有利于数据的均匀分布。 写分布 若用户业务在同一时间段有大量写操作，则希望这些写操作能够均匀分布到各个分片上。如果数据分布策略为范围分片，并以一个单调递增的值作为分片键，此时，大量写入的数据同样是片键字段递增，数据将写入同一个分片。 读分发 若用户业务在同一时间段有大量读操作，则希望这些读操作能够均匀分布到各个分片上，以充分利用各分片节点的计算性能。 定向读 dds mongos查询路由器可以执行定向查询（只查询一个分片）或scatter/gather查询（查询所有分片）。只有查询中存在分片键，dds mongos才能定位到单一分片，因此，您需要选择在业务运行时可用于普遍查询的分片键。如果您选择合成的分片键，将无法在定向查询中使用该片键，所有的查询方式将变成scatter/gather查询，从而限制扩展读数据的能力。

选择合适的数据分布策略 分片集群支持将单个集合的数据分散存储在多个分片上，用户可以根据集合内文档的分片键来分布数据。 目前，主要支持两种数据分布策略，即范围分片（Range based sharding）和Hash分片（Hash based sharding），设置方式请参见4。 下面分别介绍这两种数据分布策略以及各自的优缺点。 范围分片 基于范围进行分片，即集群按照分片键的范围把数据分成不同部分。假设有一个数字分片键，为一条从负无穷到正无穷的直线，每一个片键的值均在直线上进行标记。可以理解为将该直线划分为更短的不重叠的片段，并称之为数据块，每个数据块包含了分片键在一定的范围内的数据。 图1 数据分布示意图 如上图所示，x表示范围分片的片键，x的取值范围为[minKey,maxKey]，且为整型。将整个取值范围划分为多个chunk，每个chunk（通常配置为64MB）包含其中一小段的数据。其中，chunk1包含x值在[minKey, -75]中的所有文档，每个chunk的数据都存储在同一个分片上，每个分片可以存储多个chunk，并且chunk存储在分片中的数据会存储在config服务器中，dds mongos也会根据各分片上的chunk的数据自动执行负载均衡。 范围分片能够很好的满足范围查询的需求，例如，查询x的取值在[-60,20]中的文档，仅需dds mongos将请求路由到chunk2。 范围分片的缺点在于，如果分片键有明显递增（或递减）趋势，新插入的文档很大程度上会分布到同一个chunk，从而无法扩展写的能力。例如，使用“_id”作为分片键，集群自动生成id的高位值将是递增的时间戳。 Hash分片 根据用户的分片键值计算出Hash值（长度64bit且为整型），再按照范围分片策略，根据Hash值将文档分布到不同的chunk中。基于Hash分片主要的优势为保证数据在各节点上分布基本均匀，具有“相近”片键的文档很可能不会存储在同一个数据块中，数据的分离性更高。 图2 数据分布示意图 Hash分片与范围分片互补，能将文档随机分散到各个chunk，充分扩展写能力，弥补范围分片的不足。但所有的范围查询要分发到后端所有的分片，才能获取满足条件的文档，查询效率低。

准备工作 注册华为云并实名认证。 如果您已有一个华为账户，请跳到下一个任务。如果您还没有华为账户，请参考以下步骤创建。 打开华为云官网，单击“注册”。 根据提示信息完成注册，详细操作请参见如何注册华为云管理控制台的用户？。 注册成功后，系统会自动跳转至您的个人信息界面。 参考实名认证完成个人或企业账号实名认证。 为账户充值。 您需要确保账户有足够金额。 关于Redis实例的价格，请参见分布式缓存服务价格详情。 关于充值，请参见如何给华为账户充值。 为用户添加操作权限。 用户在创建依赖资源和Redis实例前，需要具备相应的操作权限。添加用户权限的操作，请参考创建用户并授权使用DCS。 创建VPC和子网。 DCS实例运行于虚拟私有云（VPC）中，并需要绑定具体的子网。在创建DCS实例前请提前准备VPC和子网。创建虚拟私有云和子网的方法，请参考创建虚拟私有云和子网。如果已有可用的VPC和子网，不需要再次创建。 创建的VPC与使用的Redis应在相同的区域。 创建VPC和子网时，如无特殊需求，参数使用默认配置即可。

创建Redis实例 进入购买缓存实例页面。 选择“计费模式”，此处以创建“按需计费”Redis为例。 在“区域”下拉列表中，选择靠近您应用程序的区域，可降低网络延时、提高访问速度。 “项目”保持默认即可。 选择实例配置，配置详情请参考表1 选择实例配置。 表1 选择实例配置 参数 配置说明 缓存类型 DCS的缓存类型为“Redis”。 产品类型 DCS支持的产品类型为“基础版”和“企业版”。如需了解产品类型的差异，请参考Redis企业版与基础版差异。 本次操作请选择“基础版”。 CPU架构 CPU架构请选择“x86”。 版本号 当前DCS支持的Redis版本有：4.0、5.0和6.0。 本次操作请选择“5.0”。 实例类型 Redis实例类型，本次操作请选择“单机”类型。Redis单机实例为单节点架构，不支持数据持久化，成本相对较低，适用于开发测试环境搭建。 可用区 每个区域包含多个可用区（AZ），本次操作保持默认的可用区即可。 实例规格 选择实例的规格，例如，您可以选择内存为“128 MB”的实例规格。 虚拟私有云 请选择已准备的VPC和子网。 IP地址 支持选择“自动分配IP地址”或“手动分配地址”，支持输入自定义端口，当不输入端口时，为默认的6379端口。 为简单起见，此处保持默认的“自动分配IP地址”和默认6379端口即可。 安全组 Redis 5.0不支持配置安全组，建议创建实例后配置实例白名单。 名称 实例名称。 创建时会默认会生成一个随机的名称，请根据需要自定义。 企业项目 通过选择企业项目可以帮助您将相关的资源集中在一起，按企业项目的方式来管理云资源。您可以选择默认的企业项目“default”。 如果没有可选的企业项目，请参考创建DCS时选择不到需要的企业项目。 访问方式 连接实例方式可选择“密码访问”或“免密访问”。 如选择“密码访问”，请输入“密码”和“确认密码”。 参数配置 选择“系统默认”的参数模板即可。 数量 设置购买的实例数量，默认创建1个实例。 更多配置（可选） 单击展开“更多配置”，可根据需要设置实例的“描述”、“命令重命名”、“维护时间窗”和“标签”。 为简单起见，此处无需配置。您也可以在实例创建完成后，根据需要在控制台对实例进行命令重命名、管理标签、或修改实例维护时间窗。 配置费用 页面左下角为当前实例配置的参考价格，如需了解更多价格详情，单击“了解计费详情”。 单击“立即购买”。 确认实例信息无误后，单击“提交”。 当实例“状态”为“运行中”，实例创建成功。 缓存实例创建成功后，您可以在“缓存管理”页面，查看并管理自己的缓存实例。