华为云用户手册

ua_parse_agent 解析User-Agent中的浏览器信息。 函数格式 ua_parse_agent(value) 参数说明 参数名称 数据类型 是否必填 说明 value String 是 待解析的User-Agent字符串。 返回结果 返回JSON类型的数据集。 函数示例 测试数据 { "http_user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36" } 加工规则 e_set("new_column",ua_parse_agent(v("http_user_agent"))) 加工结果 http_user_agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36 new_column:{'family': 'Chrome', 'major': '192', 'minor': '168', 'patch': '0'

ua_parse_os 解析User-Agent中的操作系统信息。 函数格式 ua_parse_os(value) 参数说明 参数名称 数据类型 是否必填 说明 value String 是 待解析的User-Agent字符串。 返回结果 返回JSON类型的数据集。 函数示例 测试数据 { "http_user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36" } 加工规则 e_set("new_column",ua_parse_os(v("http_user_agent"))) 加工结果 http_user_agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36 new_column:{'family': 'Mac OS X', 'major': '10', 'minor': '9', 'patch': '4'}

查看数字图 登录 云日志 服务控制台。 在左侧导航栏中，选择“日志管理”，进入日志管理页面。 在日志管理页面中，选择目标日志组和日志流，进入日志流详情页面。 选择“ 日志分析 ”。 请参考SQL分析语法输入查询和分析语句，设置查询和分析的时间范围，单击“查询”。 单击图标，使用数字图展示查询数据。在通用配置下方，参考表1配置参数。 图1 数字图 表1 数字图参数说明 类别 参数 说明 查询分析设置 数值列 支持数字或字符串数据。 同比数据 选择待对比的字段，在图表中显示该字段对应的值。 主体设置 图表名称字号 设置图表名称的字号大小。 格式化 将数据按照指定格式进行显示。 数值字号 显示值的字号，取值范围为12px~80px。 数值单位 显示值的单位 单位字号 显示值单位的字号，取值范围为12px~50px。 小数点位数 设置显示数值小数点位数。 添加对比值 开启后，显示待对比字段对应的值。 对比值格式化 将待对比数据按照指定格式进行显示。 对比值字号 待对比值的字号，取值范围为12px~50px。 对比值单位 待对比值的单位。 对比值单位字号 显示待对比值单位的字号，取值范围为12px~50px。 描述 对显示的数值及对比值趋势的描述，显示在数值下方。 背景配置 背景色 图表的背景颜色，支持深色或浅色。

使用说明 当用户修改权限后，权限信息在一天后生效。 SDK支持跨云/本地上报日志，当前仅支持华北-北京四、华东-上海一、华南-广州、西南-贵阳一。使用详情见Appender配置参数说明表中的“enableLocalTest”参数，当该参数为true时，上报日志规格为单个机器200次/秒（即每秒只能发送200次，每次批量发送数量/大小详情见参数“batchSizeThresholdInBytes、batchCountThreshold、lingerMs”）。 通过SDK上报日志到LTS的时间相距当前时间不超过2天，否则上报日志会被LTS删除。

参数获取方式 区域表 表4 区域表 区 域名 称 RegionName 华北-北京二 cn-north-2 华北-北京四 cn-north-4 华北-北京一 cn-north-1 华东-上海二 cn-east-2 华东-上海一 cn-east-3 华南-广州 cn-south-1 华南-深圳 cn-south-2 西南-贵阳一 cn-southwest-2 亚太-新加坡 ap-southeast-3 日志组ID：在云日志服务控制台，选择“日志管理”，鼠标悬浮在日志组名称上，可查看日志组名称和日志组ID。 日志流ID：单击日志组名称对应的，鼠标悬浮在日志流名称上，可查看日志流名称和日志流ID。

注意事项 由于Java-SDK默认对SK明文存储，不符合某些对于安全有更高要求的用户，LTS提供了一种用户自定义的加解密方式，建议用户优先使用加解密方式。 加密过程如下： 用户编写一个java类，比如com.demo.DecryptDemo类，在该类中增加一个解密方法，比如decrypt方法，输入和输出均为字符串。 编写decrypt的方法内容，客户自行实现SK加解密算法，返回解密后的值。 当用户调用Java-SDK初始化时，会需要传入SK，这时使用DecryptDemo.decrypt方法即可。

查看饼图 登录云日志服务控制台。 在左侧导航栏中，选择“日志管理”，进入日志管理页面。 在日志管理页面中，选择目标日志组和日志流，进入日志流详情页面。 选择“日志分析”。 请参考SQL分析语法输入查询和分析语句，设置查询和分析的时间范围，单击“查询”。 单击图标，使用饼图展示查询数据。在通用配置下方，参考表1配置参数。 图1 饼图 表1 饼图参数说明 类别 参数 说明 标准配置 格式化 在下拉框选择K,Mil,Bil、1000000或Byte,KB,MB等格式，将Y轴按照指定格式进行显示。 单位 自定义配置Y轴的单位。 小数点位数 设置显示数值小数点位数。 图表名称字号 设置图表名称的字号大小。 饼图配置 饼图类型 包括饼图、环图和南丁格尔玫瑰图。 饼图 饼图是一种用于展示各部分组成在整体中所占百分比的图形。‌它通过将一个圆形划分为不同的扇区，‌每个扇区的面积（‌或弧长和圆心角）‌大小对应所表示的数据的比例，‌从而直观地展示出各部分与整体之间的关系。‌ 环图 环图本质上是将饼图中心挖空，相比于饼图来说有如下优点： 在原有构成的基础上增加了总数显示，展示了更多的信息。 两个饼图直接进行比较是非常不直观的，两个环图间可以通过环状条长度进行简单的对比。 南丁格尔玫瑰图 南丁格尔玫瑰图本质上并不是环图，而是在极坐标系下画出来的柱状图，每一个分类数据被圆弧平分，使用圆弧的半径长短表示数据的大小，相比于饼图来说有如下优点： 饼图适用于不超过10条的分类数据，南丁格尔玫瑰图则适用于分类较多的场景（10-30条数据）。 由于半径和面积是成平方的关系，南丁格尔玫瑰图放大了各个分类数据之间值的差异，尤其适合对比大小相近的数值。 由于圆形有周期的特性，南丁格尔玫瑰图也适用于表示一个周期的时间概念，比如星期、月份。 是否显示刻度 开启后，显示饼图上的文本标签，可用于说明图形的一些数据信息，比如值，名称等。 刻度文本格式 可配置为分类、百分比、分类：百分比或分类：数值（百分比）。 标签位置 开启是否显示刻度后，可配置此参数，调整标签在图表中的位置。 查询分析设置 数据 分类数据对应的数值。 第一层数据 类目 分类数据。 展示数量 显示分类数据的个数。 排序方式 升序或降序。 其余归为其他 开启后，除了展示的数据，其余归为其他方式展示。 添加分层 单击添加分层，设置第二层数据，每层数据包括类目、展示数量、排序方式、其余归为其他。 图例配置 隐藏图例 开启后，可以隐藏图例和图例内容的显示。 图例内容 选择显示值和百分比，可勾选多个。 图例位置 图例在图表中的位置，选择图表顶部或图表右边。 图形配置 外半径 指定饼图外半径值。取值范围为40~100 。 内半径 指定饼图内半径值。取值范围为0~100。 上边距 坐标轴距离图表上边界距离。 下边距 坐标轴距离图表下边界距离。 左边距 坐标轴距离图表左边界距离。 右边距 坐标轴距离图表右边界距离。

查看表格 登录云日志服务控制台。 在左侧导航栏中，选择“日志管理”，进入日志管理页面。 在日志管理页面中，选择目标日志组和日志流，进入日志流详情页面。 选择“日志分析”。 请参考SQL分析语法输入查询和分析语句，设置查询和分析的时间范围，单击“查询”。 日志下方默认使用表格展示日志数据查询结果，在通用配置下方，参考表1配置参数。 图1 表格 表1 表格参数说明 类别 参数 说明 标准配置 格式化 将表格数据按照指定格式进行显示。 单位 自定义配置表格数据的单位。 小数点位数 设置显示数值小数点位数。 图表名称字号 设置图表名称的字号大小。 查询分析设置 隐藏字段 选择目标字段，将该字段在表格中隐藏。 表格配置 每页显示 每页显示的数据条数。 显示总数 显示表格数据的总条目数。 列配置 对齐方式 表格数据的对齐方式，支持左对齐，右对齐以及居中。 开启搜索 开启后，即可对表格列数据进行搜索功能。 开启排序 开启后，即可对表格列数据进行排序功能。 字体大小 表格字体的大小，取值范围为12px~24px 。

查看漏斗图 登录云日志服务控制台。 在左侧导航栏中，选择“日志管理”，进入日志管理页面。 在日志管理页面中，选择目标日志组和日志流，进入日志流详情页面。 选择“日志分析”。 请参考SQL分析语法输入查询和分析语句，设置查询和分析的时间范围，单击“查询”。 单击图标，使用漏斗图展示查询数据。在通用配置下方，参考表1配置参数。 图1 漏斗图 表1 漏斗图参数说明 参数 说明 系列名称 漏斗图的名称。 数值列 选择数值字段，某个字段对应的数值越大，在越上面。 隐藏图例 开启后，可以隐藏漏斗图上方的字段名显示。

操作步骤 云日志服务接入方式为 云审计 CTS 时，按照如下操作完成接入配置。 登录云日志服务控制台。 在左侧导航栏中，选择“日志接入”，单击“云审计 CTS”进行CTS接入配置。 选择日志流。 单击“所属日志组”后的目标框，在下拉列表中选择具体的日志组，若没有所需的日志组，单击“所属日志组”目标框后的“新建”，在弹出的创建日志组页面创建新的日志组。 单击“所属日志流”后的目标框，在下拉列表中选择具体的日志流，若没有所需的日志流，单击“所属日志流”目标框后的“新建”，在弹出的创建日志流页面创建新的日志流。 单击“下一步”：CTS配置。 单击“前往CTS配置”。具体的操作步骤及参数配置，请见云审计服务《用户指南》。 单击下一步：日志流配置。 表1 日志流配置参数表 参数 说明 自动对日志流进行结构化配置和索引配置 开启该按钮，日志流结构化配置为CTS系统模板，索引配置时将所有CTS解析出来的字段打开快速分析按钮。配置结构化和索引后，才能对CTS日志进行SQL分析，并提供可视化图表。 单击“提交”。

查看折线图 登录云日志服务控制台。 在左侧导航栏中，选择“日志管理”，进入日志管理页面。 在日志管理页面中，选择目标日志组和日志流，进入日志流详情页面。 选择“日志分析”。 请参考SQL分析语法输入查询和分析语句，设置查询和分析的时间范围，单击“查询”。 单击图标，使用折线图展示查询数据。在通用配置下方，参考表1配置参数。 图1 折线图 表1 折线图参数说明 类别 参数 说明 标准配置 格式化 在下拉框选择K,Mil,Bil、1000000或Byte,KB,MB等格式，将Y轴按照指定格式进行显示。 单位 自定义配置Y轴的单位。 小数点位数 设置显示数值小数点位数。 图表名称字号 设置图表名称的字号大小。 查询分析设置 X轴数据 支持数字或字符串数据。 Y轴数据 支持数字或字符串数据，可以选择多个数据。 维度列 请从下拉列表中选择，一般为有序数据类别。 趋势对比 当X轴为时间数据时，且不设置维度列时，可开启该按钮。 开启后，设置比较对象时间，时间小于等于24小时。设置完成后，将当前时间的数据与对象时间数据进行比较。 图例配置 隐藏图例 开启后，可以隐藏图例和对比值的显示。 图例位置 选择图表顶部或图表右边。 对比数值 选择显示最大值、最小值、平均值、求和值等，可勾选多个。 图形配置 连接方式 设置线图显示格式，可选择直线或曲线。 线宽 折线的线宽。 是否显示点 开启该功能后，显示折线的连接点。 上边距 坐标轴距离图表上边界距离。 下边距 坐标轴距离图表下边界距离。 左边距 坐标轴距离图表左边界距离。 右边距 坐标轴距离图表右边界距离。 Tooltip配置 排序方式 提示框配置，当Y轴数据选择多个时，可对其进行排序显示。 X轴 显示X轴 开启后，显示X轴数据。 X轴名称 设置X轴名称。 Y轴 显示Y轴 开启后，显示Y轴数据。 Y轴名称 设置Y轴名称。 Y轴位置 设置Y轴位置，左边或者右边。

日志转储至 DLI 登录云日志服务控制台，在左侧导航栏中选择“日志转储 ”。 在“日志转储”页面中，单击右上角“配置转储”。 在“配置转储”页面中，选择转储对象“DLI集群”，并配置各参数信息。 表1 配置转储参数说明 参数名称 说明 示例 是否开启转储 选择是否开启转储。 开启 转储对象 选择转储的云服务。 DLI集群 日志组名称 选择已创建的日志组。 - 企业项目 选择已创建的企业项目。 如果当前账号未开通企业项目则不显示该参数。 如果当前账号已开通企业项目，则存在以下情况： 当转储当前账号日志时，下拉框显示当前账号的全部企业项目。 当转储其他账号日志时，若委托账号未开通企业项目，则默认显示“default”。 当转储其他账号日志时，若委托账号已开通企业项目，则显示委托账号的全部企业项目。 default 日志流名称 选择已创建的日志流。 说明： 已配置过DLI集群转储的日志流不能重复配置。 - DLI-数据库 需要转储的目标DLI数据库名称。更多信息请参见DLI库表管理。 test DLI-数据表 需要转储的目标DLI数据库表名称。更多信息请参见DLI库表管理。 - 表普通列映射 将内置字段以及日志中配置的结构化字段和类型，映射到数据库表字段。 说明： 内置字段有13个，分别是hostIP、 hostId、hostName、pathFile、collectTime、clusterName、clusterId、 podName、containerName、regionName、projectId、logGroupName和logStreamName。 在结构化字段和表字段的下拉框，选择您需要转储的字段。 单击操作列下的，删除不需要转储的字段。 单击，添加您需要转储的字段。 表普通列映射和表分区列映射添加表字段的总数为创建表的总列数。 - 表分区列映射 存储时根据设置的字段值进行分区。将内置字段以及日志中配置的结构化字段和类型，映射到数据库表字段。 说明： 内置字段有13个，分别是hostIP、 hostId、hostName、pathFile、collectTime、clusterName、clusterId、 podName、containerName、regionName、projectId、logGroupName和logStreamName 在结构化字段和表字段的下拉框，选择您需要转储的字段。 单击操作列下的，删除不需要的转储字段。 单击，添加您需要转储的字段，只能添加一个表字段。 - 完成后单击“确定”。

继承批量安装（Linux环境） 如果您有多个服务器需要安装ICAgent，其中一个服务器已经通过首次安装方式装好了ICAgent，且该服务器“/opt/ICAgent/”路径下存在ICAgent的安装包ICProbeAgent.tar.gz，对于没有安装ICAgent的服务器，可以通过该方式对服务器进行一键式继承批量安装。 批量安装的服务器需同属一个VPC下，并在同一个网段中。 批量安装功能依赖python3.*版本，如果安装时提示找不到python请安装python版本后重试。

查看地图 登录云日志服务控制台。 在左侧导航栏中，选择“日志管理”，进入日志管理页面。 在日志管理页面中，选择目标日志组和日志流，进入日志流详情页面。 选择“日志分析”。 请参考SQL分析语法输入查询和分析语句，设置查询和分析的时间范围，单击“查询”。 单击图标，使用地图展示查询数据。在通用配置下方，参考表1配置参数。 图1 地图 表1 地图参数说明表 参数 说明 地图类型 区域定位：设置地图显示的区域范围，包含中国省级地图和世界地图两种。 省份 地图类型为中国省级地图，该字段为具体省份。例如浙江省 国家 地图类型为世界地图，该字段为具体国家。例如中国 数值列 选择用于展示数值的字段。 图表名称字号 设置图表名称的字号大小。

查看数字折线图 登录云日志服务控制台。 在左侧导航栏中，选择“日志管理”，进入日志管理页面。 在日志管理页面中，选择目标日志组和日志流，进入日志流详情页面。 选择“日志分析”。 请参考SQL分析语法输入查询和分析语句，设置查询和分析的时间范围，单击“查询”。 单击图标，使用数字折线图展示查询数据。在通用配置下方，参考表1配置参数。 图1 数字折线图 表1 数字折线图参数说明 类别 参数 说明 查询分析设置 X轴数据 支持数字或字符串数据。 Y轴数据 支持数字或字符串数据，可以选择多个数据。 图表样式 连接方式 设置线图显示格式，可选择直线或曲线。 主体设置 图表名称字号 设置图表名称的字号大小。 数据格式 将数据按照指定格式进行显示。 数值字号 显示值的字号，取值范围为12px~80px。 数值单位 显示值的单位。 单位字号 显示值单位的字号，取值范围为12px~50px。 小数点位数 设置显示数值小数点位数。 背景配置 背景色 图表的背景颜色，支持深色或浅色。

日志转储至DWS 登录云日志服务控制台，在左侧导航栏中选择“日志转储 ”。 在“日志转储”页面中，单击右上角“配置转储”。 在“配置转储”页面中，选择转储对象“DWS集群”，并配置各参数信息。 表1 配置转储参数说明 参数名称 说明 示例 是否开启转储 选择是否开启转储。 开启 转储对象 选择转储的云服务。 DWS集群 日志组名称 选择已创建的日志组。 - 企业项目 选择已创建的企业项目。 如果当前账号未开通企业项目则不显示该参数。 如果当前账号已开通企业项目，则存在以下情况： 当转储当前账号日志时，下拉框显示当前账号的全部企业项目。 当转储其他账号日志时，若委托账号未开通企业项目，则默认显示“default”。 当转储其他账号日志时，若委托账号已开通企业项目，则显示委托账号的全部企业项目。 default 日志流名称 选择已创建的日志流。 说明： 已配置过DWS集群转储的日志流不能重复配置。 - 集群名称 已创建的集群名称。 test 数据库名称 集群的数据库名称。有两种数据库，分别是“gaussdb”和“postgres”。默认集群数据库为“gaussdb”。 gaussdb 用户名 数据库的管理员用户名。 lts-test 密码 数据库的管理员密码。 - schema名称 数据库对象的集合名称。 - 表名 schema中的表名称。 - 字段映射 将内置字段以及日志中配置的结构化字段和类型，映射到数据库字段。 说明： 内置字段有13个，分别是hostIP、 hostId、hostName、pathFile、collectTime、clusterName、clusterId、 podName、containerName、regionName、projectId、logGroupName和logStreamName。 当结构化字段类型和数据库表字段类型一致时，支持将日志的结构化字段转储至 数据仓库 服务 GaussDB (DWS)，否则转储无效。 在结构化字段和表字段的下拉框，选择您需要转储的字段。 单击操作列下的，删除不需要的转储字段。 单击，添加需要转储的字段。 hostIP 完成后单击“确定”。

使用说明 当用户修改权限后，权限信息在一天后生效。 SDK支持跨云/本地上报日志，当前仅支持华北-北京四、华东-上海一、华南-广州、西南-贵阳一。使用详情见Appender配置参数说明表中的“enableLocalTest”参数，当该参数为true时，上报日志规格为单个机器200次/秒（即每秒只能发送200次，每次批量发送数量/大小详情见参数“batchSizeThresholdInBytes、batchCountThreshold、lingerMs”）。 通过SDK上报日志到LTS的时间相距当前时间不超过2天，否则上报日志会被LTS删除。

参数获取方法 区域表 表2 区域表 区域名称 RegionName 华北-北京二 cn-north-2 华北-北京四 cn-north-4 华北-北京一 cn-north-1 华东-上海二 cn-east-2 华东-上海一 cn-east-3 华南-广州 cn-south-1 华南-深圳 cn-south-2 西南-贵阳一 cn-southwest-2 亚太-新加坡 ap-southeast-3 日志组ID：在云日志服务控制台，选择“日志管理”，鼠标悬浮在日志组名称上，可查看日志组名称和日志组ID。 日志流ID：单击日志组名称对应的按钮，鼠标悬浮在日志流名称上，可查看日志流名称和日志流ID。

截图回调 直播截图回调用于推送截图状态信息，当截图文件生成时触发该回调事件。回调消息字段如表3所示。 表3 消息体字段说明 字段 描述 domain 推流域名。 app 应用名称。 stream_name 流名称。 snapshot_url 截图下载链接。 width 图片宽度。 单位：像素。 height 图片高度。 单位：像素。 obs_addr 截图所在的OBS桶地址，具体结构体说明如下所示： bucket：OBS的桶名称。 location：OBS桶所在数据中心。 object：OBS对象路径。 auth_timestamp 事件通知签名过期UNIX时间戳。当配置了“鉴权密钥”时，携带该字段。 格式为十进制的UNIX时间戳，即从1970年1月1日（UTC/GMT的午夜）以来的当前时间秒数。 示例：1592639100（即2020-06-20 15:45） auth_sign 事件通知签名。当配置了“鉴权密钥”时，携带该字段。 auth_sign = HmacSHA256（domain + app + stream_name + snapshot_url + width + height + obs_addr.bucket + obs_addr.location + obs_addr.object + auth_timestamp,key） 其中，key为鉴权密钥值。 消息示例如下所示： { "domain": "play.example.com", "app": "live", "stream_name": "test001", "snapshot_url": "https://xxx.obs.cn-north-4.myhuaweicloud.com:443...", "width":"720", "height":"1280", "obs_addr": { "bucket": "xxx", "location": "cn-north-4", "object": "xxx.jpg" }, "auth_timestamp":1587954140, "auth_sign":"4918b1axxxxxxb583cffa119d72513bbc35a989f8569fxxxxxx057646154a04a" }

录制回调 直播录制至OBS提供了录制回调功能，用于推送录制状态信息，包括录制开始、开始创建新的录制文件、录制文件生成完成、录制结束和录制失败。回调消息字段如表2所示。 表2 消息体字段说明 字段 描述 project_id 项目ID。 job_id 用于标识同一个文件。当“event_type”为“RECORD_NEW_FILE_START”或“RECORD_FILE_COMPLETE”时，携带该字段。 task_id 录制任务ID，用于唯一标识一个录制任务。 event_type 消息类型。 取值如下： RECORD_START：表示录制开始。若配置了录制模板和录制回调，则直播推流开始时，开始录制，触发该事件。 RECORD_NEW_FILE_START：表示开始创建新的录制文件。以下情况会触发该事件： 直播推流开始，开始创建第一个录制文件。 直播断流恢复后，若“最大断流合并时长”配置为“断流后生成新文件”，则开始创建新的录制文件。 当前录制时长超过了配置的录制周期，则开始新的录制文件生成。 RECORD_FILE_COMPLETE：表示录制文件生成完成。以下情况会触发该事件： 录制时长达到配置的录制周期，则当前录制文件生成完成，并开始新的录制生成。 直播断流后，若“最大断流合并时长”配置为“断流后生成新文件”，则当前录制文件生成完成，若断流恢复，将开始新的录制文件生成。 RECORD_OVER：表示录制结束，直播断流时长超过了最大断流合并时长，当前录制任务结束，触发该事件。 RECORD_FAILED：表示录制失败，当拉流失败、录制文件上传OBS失败等因素导致录制失败时，触发该事件。 publish_domain 直播推流域名。 app 应用名。 stream 录制的流名。 record_format 录制格式，支持HLS、FLV和MP4格式。 download_url 录制文件的下载地址。当“event_type”为“RECORD_FILE_COMPLETE”时，携带该字段。 说明： 使用该下载地址用于视频播放无法保证播放效果。 asset_id 用于标识一个录制文件。 当“event_type”为“RECORD_FILE_COMPLETE”时，携带该字段。 file_size 文件大小。 单位：Byte。 record_duration 录制文件的时长。 单位：秒。 start_time 录制文件的开始时间，即接收到第一帧数据的时间，格式为yyyy-mm-ddThh:mm:ssZ。 当“event_type”为“RECORD_FILE_COMPLETE”时，携带该字段。 end_time 录制文件的结束时间，格式为yyyy-mm-ddThh:mm:ssZ。 当“event_type”为“RECORD_FILE_COMPLETE”时，携带该字段。 width 录制文件分辨率的宽。 当“event_type”为“RECORD_FILE_COMPLETE”时，携带该字段。 height 录制文件分辨率的高。 当“event_type”为“RECORD_FILE_COMPLETE”时，携带该字段。 obs_location 存储录制文件的OBS桶所在区域。 当“event_type”为“RECORD_FILE_COMPLETE”时，携带该字段。 obs_bucket 存储录制文件的OBS桶。 当“event_type”为“RECORD_FILE_COMPLETE”时，携带该字段。 obs_object OBS桶存储录制文件的路径。 当“event_type”为“RECORD_FILE_COMPLETE”时，携带该字段。 auth_sign 事件通知签名。当配置了“鉴权密钥”时，携带该字段。 MD5方式：auth_sign=MD5(key + auth_timestamp) HMA CS HA256方式：HMACSHA256(auth_timestamp + event_type + publish_domain + app + stream + download_url + play_url，key) 其中，key为鉴权密钥值。 auth_timestamp 事件通知签名过期UNIX时间戳。当配置了“鉴权密钥”时，携带该字段。 格式为十进制的UNIX时间戳，即从1970年1月1日（UTC/GMT的午夜）开始所经过的秒数。 若 消息通知 中的auth_timestamp值所指定的时间已经过期，则此消息通知无效，进而防止网络重放攻击。 error_message 录制失败的描述信息。 当“event_type”为“RECORD_FAILED”时，携带该字段。 消息示例如下所示： 录制开始事件，即“event_type”=“RECORD_START”，若配置了录制模板和录制回调，则直播推流开始时，开始录制，产生该事件回调。 { "project_id" : "70b76xxxxxx34253880af501cdxxxxxx", "publish_domain" : "push.example.com", "event_type" : "RECORD_START", "app" : "live", "stream" : "mystream", "record_format" : "HLS", "file_size" : 3957964, "record_duration" : 120 }

推流回调 推流回调用于推送推流状态信息，包括推流成功和推流中断，回调消息字段如表1所示。 表1 消息体字段说明 字段 描述 domain 推流域名。 app 应用名称。 stream 流名称。 user_args 推流参数。 client_ip 推流客户端IP。 node_ip 接受流的节点IP。 publish_timestamp 推流Unix时间戳，一次推流活动会产生相同时间戳的推流和断流消息。 event 直播推流和断流标识。 取值为： PUBLISH：开播。 PUBLISH_DONE：停播。 auth_timestamp 事件通知签名过期UNIX时间戳。当配置了“鉴权密钥”时，携带该字段。 格式为十进制的UNIX时间戳，即从1970年1月1日（UTC/GMT的午夜）以来的当前时间秒数。 示例：1592639100（即2020-06-20 15:45） auth_sign 事件通知签名。当配置了“鉴权密钥”时，携带该字段。 auth_sign = HmacSHA256（event + domain + app + stream + auth_timestamp, key） 其中，key为鉴权密钥值。 消息示例，如下所示： { "domain":"push.example.com", "app":"live", "stream":"example_stream", "user_args":"auth_info=yz1TG0PVN/5isfyrGrRj10gKPCWqSS2X02t6QsRrocH+mEq0gQ0g8k6KhalS84sQ+kDprFyqI0yajbYiFmUO8e45B7ryaS+MpJBlYkhwnuFLnRiKK/IXG7.33436b625354564f6e4d4d434f55&cdn=hw", "client_ip":"100.111.*.*", "node_ip":"112.11.*.*", "publish_timestamp":"1587954134,", "event":"PUBLISH" "auth_timestamp":1587954140, "auth_sign":"ff3b2bxxx5cfd56e76d72bed4c4aa2dxxxca8c2e46467d205a6417d4fc" }

处理方法 在工作项文件中删除之前超出300条数据量的空行后，再重新导入工作项数据。 在工作项文件中删除了几条工作项数据后，如果需要再补充到300条，则建议执行如下操作： 直接导入删除数据后的工作项文件。 检查导入成功的工作项条数是否跟工作项文件中的一致。 如果一致，未统计删除的几条工作项，则可在另一份工作项文件中填写需要增加的工作项数据后再导入。 如果不一致，统计了删除的几条工作项，则需要在需求管理服务中删除同等条数的工作项数据后，再重新导入一份工作项文件。

操作步骤 在IPD项目2中新建一个原始需求。 图1 原始需求列表页 单击原始需求名称，进入原始需求详情页。 将原始需求走到“规划”阶段。 单击“关联项”页签。 在“协同下游需求”后，单击“分发需求”，弹出“分发需求”窗口。 配置需求信息。 图2 分发需求 “归属项目”选择非本项目。 单击“确定”。 图3 原始需求详情/关联项 单击分发需求的名称，进入分发需求详情页，即可修改承接人。 图4 分发需求详情页

创建项目 单击软件开发生产线首页“新建项目”。 在“选择模板”页面，选择“IPD-系统设备类”，单击“选用”，进入“新建项目”页面。 填写基本信息。 根据下表输入“项目名称” 、“工作配置数据”“项目代号”、“项目描述”，然后单击“确定”按钮。 表1 新建项目 参数名 参数说明 项目名称 根据自己需求设置。 同一租户下的项目群/项目，名称不能重复。 取值范围：1～128个字符。 工作配置数据 可选择复用与当前项目/项目群同类型的项目工作配置数据。 工作配置数据范围：项目工作配置下所有数据，不包括导入导出记录和基础配置下的工作配置数据 项目代号 针对第三方业务。设置项目代号后，便于业务管理。 取值范围：0～200个字符，仅支持字母、数字、下划线和连字符。 项目描述 对项目的简要说明。 取值范围：0~1024个字符。 创建成功后，项目自动进入到主页，提示 “新建项目成功”。 父主题： 管理员：初始化项目

新建Bug 在项目主页，切换至“缺陷”页签。 单击“+新建Bug”按钮，进入“新建Bug”页面。 在“新建Bug”页面，填入缺陷的基本属性值。各属性值含义见下表。 参数名 参数说明 标题 标题名称。 描述 对需求的文字、图片、链接等形式的说明。 根据工作项的类型不同，系统提供不同的模板，Bug的描述信息格式如下： 【故障现象描述】 【环境信息】 【故障现场定位开发人员】 【开发定位初步原因】 提出项目 缺陷创建人所在的项目，不可修改。 提出人 发现Bug的测试人员。 归属项目 缺陷归属的项目。 责任人 一般为修复Bug的开发人员。 严重程度 提示、一般、严重、致命四个等级。 发现PI 指计划。在“计划管理”可以创建PI。 发现迭代 PI的下一个层级，叫做迭代。创建PI后，通过分解PI创建迭代。 发现环境 开发自测环境，测试环境，生产环境。 抄送人 项目其他成员，被选中的成员会收到系统通知。 期望修复时间 期望修复时间。 字段属性值填写完毕后，单击“提交”按钮。 系统会自动跳转到主页，并且在主页右上角有系统提示：“新建Bug成功”。主页的列表展示刚刚创建的Bug单，状态为“分析”。

分解IR、SR、AR 单击IR“操作”列中的 分解图标，出现“分解子需求”弹窗。 在“分解子需求”弹窗中，SR标题默认继承IR的标题，一般情况下，需要手动修改标题内容。填写完毕后，单击“确定”，完成分解。 分解完成后，SR位于IR的目录下。 单击SR“操作”列中的 分解图标，出现“分解子需求”弹窗。 在“分解子需求”弹窗中，AR标题默认继承SR的标题，一般情况下，需要手动修改“标题内容”。填写完毕后，单击“确定”，完成分解。 分解完成后，AR位于SR的目录下。

新建迭代 在列表视图下，选择要操作的PI，单击其操作列中的图标，出现“新建迭代”弹窗。 填写基本信息。 在新建迭代弹窗中，填入“迭代名称”、“起止时间”、“预估工作量”、“描述”等属性字段值。单击“确定”。出现新建迭代成功，在列表视图下展示已新建迭代。 表2 参数 参数名 说明 迭代名称 描述迭代名称，可自定义，必填参数。 起止时间 起始时间和结束时间，必填参数。 预估工作量 输入预估工作量，可精确到小数点后一位，必填参数。 描述 对新建迭代的简要描述。选填。

新建计划 在项目主页，切换至“计划管理”页签。 单击“+新建PI”按钮，出现“新建PI”弹窗。 填写基本信息。 在新建PI弹窗中，输入“PI名称”、“起止时间”、“预估工作量”、“描述”等属性字段值，单击“确定”，完成PI创建。在列表视图下展示刚刚新建的PI条目。 表1 参数 参数名 说明 PI名称 描述PI名称，可自定义，必填参数。 起止时间 起始时间和结束时间，必填参数。 预估工作量 输入预估工作量，可精确到小数点后一位，必填参数。 描述 对新建PI的简要描述。选填。

新建RR 在项目主页，切换至“原始需求”。 单击“+新建RR”按钮，进入“新建RR”页面。 在“新建RR” 页面，填入需求的基本属性值。 表1 参数说明 参数名 参数说明 标题 原始需求名称。 描述 对需求的文字、图片、链接等形式的说明。 根据工作项的类型不同，系统提供不同的模板，例如RR的描述信息格式如下： 【需求背景】 【需求价值】 【需求详情】 附件 单个原始需求的附件数量最多为100个，附件总容量为50MB。 提出项目 默认是RR所在项目，不可修改。 提出人 默认是RR创建者，支持多选。 期望完成时间 期望完成时间。 归属项目 RR创建时，可以指定到本项目或者其他项目。默认本项目。 承接人 RR的责任人。 优先级 分低、中、高三个等级。 抄送人 项目组内其他成员。 属性值填写完毕后，单击“提交”按钮。 系统会自动跳转到主页，并且在主页右上角有系统提示：“提交需求成功”。主页的列表展示刚刚创建的RR需求。

请求示例 https://coc.myhuaweicloud.com/v1/event/huawei/custom/{integration_key} { "alarmId" : "18cfxxxxxxxxxx0f8", "alarmName" : "Cpu 使用超额预警", "alarmLevel" : "Critical", "time" : 1709118444540, "nameSpace" : "shanghai", "regionId" : "cn-north-4", "applicationId" : "18cfa0a5ef8d", "resourceName" : "machine-1", "resourceId" : "18cxxxxxxxxxxxxff68625", "alarmDesc" : "string", "URL" : "https://example.com", "alarmStatus" : "alarm", "alarmSource" : "coc", "additional" : { } }