云服务器内容精选

  • 其他报表开发功能介绍 功能 功能介绍 添加告警数据图表 可以对告警数据生成图表并添加在报表中。 在“告警配置”,单击“保存”,系统会自动生成告警图表“_alertlist-_alert”。 在报表编辑页面,单击“配置图表”选择该图表,将告警数据展示在报表中。 配置报表查询条件 在报表编辑页面,单击“配置查询条件”可以配置页面的查询条件,目前每个页面最多支持配3个查询框,查询字段可以从数据源自动获取,也可以自定义输入。 新增辅助图形 在报表编辑页面,单击“新增辅助图形”,可以对图表进行组合,也可以为报表新增标题框、背景框和时钟。 切换至预览模式 进入报表编辑页面,默认为编辑模式,单击“切换至预览模式”,可以切换至预览模式,查看编辑效果。 画辅助线 在报表编辑页面,单击“画辅助线”,可以选择多种辅助线,便于编辑页面时对页面报表布局。 保存业务报表 在报表编辑页面,单击“保存”,保存已开发的业务报表。 发布业务报表 在报表编辑页面,单击“发布”,发布业务报表,发布后服务下所有用户可以在“业务报表”页面查看该报表。 下线业务报表 在报表编辑页面,单击“下线”,下线业务报表后将不会展示在“业务报表”页面。 复制业务报表 在报表编辑页面,单击“复制”,可以复制已开发的业务报表。
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 status String success|error result ResultValueListCustomReportListVo object 请求的返回的数据对象 表5 ResultValueListCustomReportListVo 参数 参数类型 描述 total Integer 起始记录数 大于 实际总条数时, 值为0, 分页请求才有此值 value Array of CustomReportListVo objects 实际的数据类型:单个对象,集合 或 NULL reason String 业务失败的提示内容 page_size Integer 每页展示条数 page_no Integer 页码 has_more Boolean 是否有更多 表6 CustomReportListVo 参数 参数类型 描述 id String 报表id name String 报表名称 filter ReportFilter object 过滤条件 workpiece_type String 工件类型(用例:case,测试套:task) analysis_dimension String 分析维度 compare_dimension String 对比维度 chart_data Array of ReportChartDataVo objects 报表数据 表7 ReportFilter 参数 参数类型 描述 creatorIds String 创建人 ownerIds String 所属人 ranks String 级别 releaseIds String releaseId status String 状态 moduleIds String 级别 results String 结果 labelIds String 标签 startTime String 开始时间 endTime String 结束时间 isAssociateIssue String 是否关联需求 表8 ReportChartDataVo 参数 参数类型 描述 id String 报表id name String 报表名称 analyze_dim ReportDimVo object 对比维度数据 compare_dim Array of ReportDimVo objects 对比维度数据 表9 ReportDimVo 参数 参数类型 描述 id String id name String 名称 value Integer 值 状态码: 400 表10 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码: 401 表11 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码: 404 表12 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码: 500 表13 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容
  • URI GET /testreport/v4/{project_id}/versions/{version_id}/custom-reports 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释: 项目id,对应"需求管理 CodeArts Req"项目唯一标识,测试计划管理页面地址栏url https://{host}/cloudtestportal/project/{project_id}/testplan中project_id变量的值 约束限制: 不涉及 取值范围: 项目uuid应符合如下规则:长度等于32位,包含大小写字母、数字 默认取值: 不涉及 version_id 是 String 版本id 表2 Query参数 参数 是否必选 参数类型 描述 page_size 是 Long 每页显示的条目数量,最大支持200条 offset 是 Long 页数,page_no大于等于1 type 是 Integer 报表类型 1:首页用例库, 2:质量报告
  • 响应示例 状态码: 200 OK { "status" : "success", "result" : { "total" : 1, "value" : [ { "uri" : "v91t0000vrn1e27h", "name" : "XXX项目第一期测试报告", "creator" : "e8d27b5521a64fb28a8fd9c99cd66eb3", "version_uri" : "v91i0000vq98suqq", "branch_uri" : "v91i0000vq98suq1", "version_name" : "样例测试计划", "branch_name" : "基线", "test_conclusion" : "商用发布", "defect_details_by_severity" : [ ], "defect_details_by_module" : [ ], "create_time" : "2024-09-10 15:23:01", "create_timestamp" : 1725952981000, "creator_name" : "paas_testplan_wwx1114369_01" } ], "page_size" : 10, "page_no" : 1 } }
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 status String success|error; result ResultValueListTestReportVo object 请求的返回的数据对象 error ApiError object 失败时的error信息 request_id String 由接口调用方传入,建议使用UUID保证请求的唯一性。 server_address String 本次请求的受理的服务地址 表5 ResultValueListTestReportVo 参数 参数类型 描述 total Integer 起始记录数 大于 实际总条数时, 值为0, 分页请求才有此值 value Array of TestReportVo objects 实际的数据类型:单个对象,集合 或 NULL reason String 业务失败的提示内容 page_size Integer 每页展示条数 page_no Integer 页码 has_more Boolean 是否有更多 表6 TestReportVo 参数 参数类型 描述 uri String 测试报告Uri name String 测试报告名称 creator String 创建人ID updator String 修改人ID version_uri String 测试计划Uri branch_uri String 分支Uri version_name String 测试计划名称 branch_name String 分支名称 test_conclusion String 测试结论 test_conclusion_details String 测试结论描述 defect_resolution_rate String 缺陷解决率 defect_resolution_score String 缺陷解决分数 case_execution_rate String 用例执行率 case_execution_score String 用例执行分数 case_pass_rate String 用例通过率 case_pass_score String 用例通过分数 issue_pass_rate String 需求通过率 issue_pass_score String 需求通过分数 issue_coverage_rate String 需求覆盖率 issue_coverage_score String 需求覆盖分数 project_residual_defect_index String 项目总遗留DI iterator_residual_defect_index String 计划新增DI case_automation_details CaseAutomationDetailsVo object 用例自动化率详情 case_validity_ratio String 用例有效性比例 issue_details IssuePassDetailsVo object 需求通过情况 case_details Array of NameAndValueVo objects 用例通过情况 defect_details_by_severity Array of IdAndNameAndValueVo objects 缺陷严重程度 defect_details_by_module Array of IdAndNameAndValueVo objects 缺陷按照模块分布情况 case_pass_rate_by_test_type Array of DetailTestTypeCasePassRateVo objects 每个测试类型的用例通过率 test_report_custom_report_detail Array of CustomReportListVo objects 测试报告自定义报告详情 create_time String 创建时间 create_timestamp Long 创建时间戳 creator_name String 创建人名 update_time String 修改时间 update_timestamp Long 修改时间戳 updator_name String 修改人名 project_id String 项目ID risk_analysis String 风险分析 表7 CaseAutomationDetailsVo 参数 参数类型 描述 case_automation_rate String 用例自动化率 service_type_number_list Array of NameAndValueVo objects 服务类型对应的用例数目 表8 IssuePassDetailsVo 参数 参数类型 描述 testing Integer 统计测试中的需求 finished Integer 统计已完成的需求 not_tested Integer 统计未完成的需求 表9 NameAndValueVo 参数 参数类型 描述 name String 名称 value Integer 值 表10 IdAndNameAndValueVo 参数 参数类型 描述 name String 名称 value Integer 值 id String id 表11 DetailTestTypeCasePassRateVo 参数 参数类型 描述 test_type Integer 测试类型 case_pass_rate String 用例通过率 表12 CustomReportListVo 参数 参数类型 描述 id String 报表id name String 报表名称 filter ReportFilter object 过滤条件 workpiece_type String 工件类型(用例:case,测试套:task) analysis_dimension String 分析维度 compare_dimension String 对比维度 chart_data Array of ReportChartDataVo objects 报表数据 表13 ReportFilter 参数 参数类型 描述 creatorIds String 创建人 ownerIds String 所属人 ranks String 级别 releaseIds String releaseId status String 状态 moduleIds String 级别 results String 结果 labelIds String 标签 startTime String 开始时间 endTime String 结束时间 isAssociateIssue String 是否关联需求 表14 ReportChartDataVo 参数 参数类型 描述 id String 报表id name String 报表名称 analyze_dim ReportDimVo object 对比维度数据 compare_dim Array of ReportDimVo objects 对比维度数据 表15 ReportDimVo 参数 参数类型 描述 id String id name String 名称 value Integer 值 表16 ApiError 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码: 400 表17 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码: 401 表18 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码: 404 表19 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码: 500 表20 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息
  • URI GET /testreport/v4/{project_id}/test-reports 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释: 项目id,对应"需求管理 CodeArts Req"项目唯一标识,测试计划管理页面地址栏url https://{host}/cloudtestportal/project/{project_id}/testplan中project_id变量的值 约束限制: 不涉及 取值范围: 项目uuid应符合如下规则:长度等于32位,包含大小写字母、数字 默认取值: 不涉及 表2 Query参数 参数 是否必选 参数类型 描述 key_word 否 String 名称关键词 own 否 Boolean 是否是我的测试报告 page_no 否 Integer 页数 page_size 是 Integer 每页条数
  • 报表概述 AstroZero对内部数据提供了一种汇总方式的视图,即为报表。利用报表功能,可以让数据进行可视化的展示,并进行分析与洞察,更好地了解业务现存的问题与机遇。 AstroZero提供报表构建器,让您完成报表的开发。报表构建器由如下两个主要模块组成。 报表 报表定义了报表数据来源于哪些对象,以及对象的连接关系,支持创建一个带有多个对象连接起来的汇总报表,不必局限于单个对象。同时支持对已有的原始记录数据,进行归类、筛选、分组、公式计算以及数据汇总。 仪表板 仪表板是多张报表的可视化集合。通过仪表板,可以对一个主题对多张报表进行汇总,并以图表化的方式呈现。 报表构建器中的报表和仪表板既可以单独使用,也可以联合使用。仪表板则提供了丰富的图表功能,如下图所示。仪表板能够让用户高效地查看报表数据,有效洞察出当前系统存在的问题和机遇。 图1 仪表盘 在实际的应用开发过程中,需要先利用报表Widget创建一个报表展示页面,再调用本章节介绍的AstroZero创建报表或仪表板。 父主题: 报表和仪表板
  • 查看运行态报表 报表运行态可以对报表进行进一步的数据筛选和可视化呈现,也是对报表的一种预览和检查。 参考登录AstroZero新版应用设计器中操作,登录应用设计器。 在左侧导航栏中,选择“界面”。 在报表中,单击对应的报表,进入报表设计页面。 单击页面上方的,运行报表。 单击右上角“显示图表”,可以设置报表的展示样式。 您需要在创建报表时设置分组字段(参考6.b),该界面才会有“显示图表”。 图1 设置报表的展示样式 式样与类型:可以为数据选择合适的图表类型,如柱状图、堆叠图、折线图、饼图、仪表图、漏斗图、散点图等,不同的图表有不同的选项,可以在“设置”页签中配置。 柱状图、堆叠图、折线图的设置页签配置如下: 图例位置:图例的位置。 X轴:选择一个分组字段作为X轴。 X轴标签:X轴显示名称。 次级分组:可以额外地指定一个分组字段作为次级分类,在同一个柱状图上显示,或者作为堆叠图中的堆叠。 Y轴:选择一个公式字段(默认记录计数)作为Y轴。 Y轴标签:Y轴显示名称。 显示参考线:在图中显示一个参考线,以便比较不同分组的Y轴的值。 显示数值:显示每个柱状的数值。 饼图的设置页签配置如下: 图例位置:图例的位置。 值:可以指定一个公式字段(默认位记录计数)。 切片:可以指定一个分组字段。 显示数值:显示每个饼的数值。 仪表图:仪表图是一种相对简单的图表,用于展示一个具体数值,以及该数值在3 段范围内的状态(最小、中等、最差)。仪表图的设置页签配置如下: 测量:可以指定一个公式字段(默认位记录计数)。 最小值:指定一个度量的最小值。 最大值:指定一个度量的最大值。 漏斗图的设置页签配置如下: 值:选择一个公式字段作为数值度量。 着色依据:选择一个分组字段作为分组度量。 显示数值:显示每层的数值。 散点图的设置页签配置如下: X轴:指定一个公式度量。 Y轴:指定一个公式度量。 详情:指定一个分组度量。 显示数值:显示每点的数值。 调色板:可以为图表选择不同的配色方案,以便制作出个性化的图表。 运行报表界面上的操作仅为用户提供一种快速的数据探索的途径,并不会保存到数据库中。 单击图标,设置展示数据,可以对数据进行过滤展示。 图2 数据过滤展示 分组汇总:是否显示每个分组的汇总信息。 整体汇总:在表格底部显示汇总信息。
  • 约束限制 趋势图最多呈现连续180天的运维数据变化趋势。 默认按小时呈现当天运维数据变化趋势。 筛选周期时间在同一月且在同一周时,仅可选择按天呈现趋势图。 筛选周期时间跨月且在同一周时,可选择按天和按月呈现趋势图。 筛选周期时间在同一月且跨周时,仅可选择按天和按周呈现趋势图。 筛选周期时间跨月且跨周时,仅可选择按天、按周和按月呈现趋势图。 趋势图可选择线状图、柱状图、饼状图形式。 表示线状图形式。 表示柱状图形式。 仅命令拦截动作趋势图可呈现饼状图形式。 默认呈现运维时间段内总的趋势图。 支持按目标用户呈现运维统计趋势图,最多可选择5个目标用户。 支持按目标资源呈现运维统计趋势图,最多可选择5个目标资源。
  • 用户状态 呈现僵尸账户和密码强度的用户账号数量。 僵尸账户是当前未登录时间超过14天的已生效用户,按未登录天数统计。 默认呈现TOP5僵尸账户信息。可选择查看TOP5、TOP10、TOP20的僵尸账户。 在“详细数据”区域,可查看上一次成功登录的时间、用户登录名、来源IP、操作、操作结果等信息。 密码强度则是对系统内用户密码强度的划分,分为高、中、低三个等级。 在“详细数据”区域,可查看上一次改密的用户登录名、密码强度、上次改密时间,以密码强度由低至高排列。 密码强度的划分具体按照以下规则: 高:8位及以上,包含大写字母、小写字母、数字、特殊字符。 中:8位及以上,包含大写字母、小写字母、数字、特殊字符中的两种或三种。 低:8位及以上,包含大写字母、小写字母、数字、特殊字符中的一种,或8位以下。
  • 数据湖 准备 在本示例中,选择 数据湖探索 DLI )服务作为数据湖。为确保 DataArts Studio 与DLI网络互通,在创建DLI队列时区域和企业项目应与DataArts Studio实例保持一致。 当前由于DLI的“default”队列默认Spark组件版本较低,可能会出现无法支持建表语句执行的报错,这种情况下建议您选择自建队列运行业务。如需“default”队列支持建表语句执行,可联系DLI服务客服或技术支持人员协助解决。 DLI的“default”队列为共享队列,仅用于用户体验,用户间可能会出现抢占资源的情况,不能保证每次都可以得到资源执行相关操作。当遇到执行时间较长或无法执行的情况,建议您在业务低峰期再次重试,或选择自建队列运行业务。 开通DLI服务后,您需要在管理中心创建DLI连接,然后通过数据开发组件新建数据库,再执行SQL来创建OBS外表。操作步骤如下: 参考访问DataArts Studio实例控制台,登录DataArts Studio管理控制台。 在DataArts Studio控制台首页,选择对应工作空间的“管理中心”模块,进入管理中心页面。 在“数据连接”页面,单击“创建数据连接”按钮。 图1 数据连接 创建一个到DLI的连接,数据连接类型选择“数据湖探索(DLI)”,数据连接名称设置为“dli”。 完成设置后,单击“测试”,测试成功后单击“确定”,完成DLI数据连接的创建。 图2 创建数据连接 DLI连接创建完成后,跳转到数据开发页面。 图3 跳转到数据开发页面 参见图4,在DLI连接上右键单击,创建一个数据库用于存放数据表,数据库名称为“BI”。 图4 创建数据库 创建一个DLI SQL脚本,以通过DLI SQL语句来创建数据表。 图5 新建脚本 在新建脚本弹出的SQL编辑器中输入如下SQL语句,并单击“运行”来创建数据表。其中,user、product、comment、action为OBS外表,使用指定OBS路径中的 CS V文件来填充数据,用于存放原始数据;top_like_product和top_bad_comment_product为DLI表,用于存放分析结果。 create table user( user_id int, age int, sexuality int, rank int, register_time string ) USING csv OPTIONS (path "obs://fast-demo/user_data"); create table product( product_id int, a1 int, a2 int, a3 int, category int, brand int ) USING csv OPTIONS (path "obs://fast-demo/product_data"); create table comment( deadline string, product_id int, comment_num int, has_bad_comment int, bad_comment_rate float ) USING csv OPTIONS (path "obs://fast-demo/comment_data"); create table action( user_id int, product_id int, time string, model_id string, type string ) USING csv OPTIONS (path "obs://fast-demo/action_data"); create table top_like_product(brand int, like_count int); create table top_bad_comment_product(product_id int, comment_num int, bad_comment_rate float); 图6 创建数据表 关键参数说明: 数据连接:步骤3中创建的DLI数据连接。 数据库:步骤5中创建的数据库。 资源队列:可使用提供的默认资源队列“default”。 当前由于DLI的“default”队列默认Spark组件版本较低,可能会出现无法支持建表语句执行的报错,这种情况下建议您选择自建队列运行业务。如需“default”队列支持建表语句执行,可联系DLI服务客服或技术支持人员协助解决。 DLI的“default”队列为共享队列,仅用于用户体验,用户间可能会出现抢占资源的情况,不能保证每次都可以得到资源执行相关操作。当遇到执行时间较长或无法执行的情况,建议您在业务低峰期再次重试,或选择自建队列运行业务。 脚本运行成功后,可以通过如下脚本检查数据表是否创建成功。 SHOW TABLES; 确认数据表创建成功后,该脚本后续无需使用,可直接关闭。
  • 查看运行态报表 报表运行态可以对报表进行进一步的数据筛选和可视化呈现,也是对报表的一种预览和检查。 在报表列表页面,单击需要查看运行态的报表后面的,运行报表。 单击右上角的“显示图表”,可以设置报表的展示样式。 您需要在创建报表时,设置分组字段(参考5.b),该界面才会有“显示图表”。 图11 设置报表的展示样式 式样与类型:可以为数据选择合适的图表类型,如柱状图、堆叠图、折线图、饼图、仪表图、漏斗图、散点图等,不同的图表有不同的选项,可以在“设置”页签中配置。 柱状图、堆叠图、折线图的设置页签 图例位置:图例的位置。 X轴:选择一个分组字段作为X轴。 X轴标签:X轴显示名称。 次级分组:可以额外的指定一个分组字段作为次级分类,在同一个柱状图上显示,或者作为堆叠图中的堆叠。 Y轴:选择一个公式字段(默认记录计数)作为Y轴。 Y轴标签:Y轴显示名称。 显示参考线:在图中显示一个参考线,以便比较不同分组的Y轴的值。 显示数值:显示每个柱状的数值。 饼图的设置页签 图例位置:图例的位置。 值:可以指定一个公式字段(默认位记录计数)。 切片:可以指定一个分组字段。 显示数值:显示每个饼的数值。 仪表图:仪表图是一种相对简单的图表,用于展示一个具体数值,以及该数值在3段范围内的状态(最小、中等、最差)。 测量:可以指定一个公式字段(默认位记录计数)。 最小值:指定一个度量的最小值。 最大值:指定一个度量的最大值。 漏斗图的设置页签 值:选择一个公式字段作为数值度量。 着色依据:选择一个分组字段作为分组度量。 显示数值:显示每层的数值。 散点图的设置页签 X轴:指定一个公式度量。 Y轴:指定一个公式度量。 详情:指定一个分组度量。 显示数值:显示每点的数值。 调色板:可以为图表选择不同的配色方案,以便制作出个性化的图表。 运行报表界面上的操作仅为用户提供一种快速的数据探索的途径,并不会保存到数据库中。 单击齿轮图标,设置展示数据,可以对数据进行过滤展示。 图12 数据过滤展示 显示细节:显示分组的详细记录信息。 分组汇总:是否显示每个分组的汇总信息。 整体汇总:在表格底部显示汇总信息。
  • 请求示例 质量报告看板统计 post https://{{endpoint}}/testreport/v4/testhub/projects/875ab809ae454c808b8565bd8695692d/data-dashboard/overview { "plan_id" : "vx785d2300op22kb6c", "branch_id" : "v9050000uop22kb6", "module_id" : "889109272257798144,-2", "fixed_version_id" : "884537509955936256,884770598208577537,-2" }
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 defect DefectVo object 缺陷统计信息 case_pass_rate CasePassRateVo object 用例通过率信息 case_completion_rate CaseCompletionRateVo object 用例通过率信息 project_type String 项目类型 issue_cover_rate IssueCoverRateVo object 需求覆盖率信息 表5 DefectVo 参数 参数类型 描述 total Integer 缺陷数 not_solved Integer 未关闭缺陷数 severity_number_list Array of NameAndValueVo objects 组装缺陷每种重要程度的名称和对应的数目 表6 CasePassRateVo 参数 参数类型 描述 pass_rate String 用例通过率 result_number_list Array of NameAndValueVo objects 用户自定义结果对应的用例数目 表7 CaseCompletionRateVo 参数 参数类型 描述 total Integer 总用例数 completion_rate String 用例完成率 status_number_list Array of NameAndValueVo objects 用户自定义状态对应的用例数目 表8 NameAndValueVo 参数 参数类型 描述 name String 名称 value Integer 值 表9 IssueCoverRateVo 参数 参数类型 描述 epic CoverRateVo object epic类型需求覆盖率, 仅scrum项目返回 feature CoverRateVo object feature类型需求覆盖率, 仅scrum项目返回 story CoverRateVo object story类型需求覆盖率, 仅scrum项目返回 summary CoverRateVo object story类型需求覆盖率, 仅scrum项目返回 表10 CoverRateVo 参数 参数类型 描述 testing Integer 统计测试中的需求 finished Integer 统计已完成的需求 not_tested Integer 统计未测试的需求 total_number Integer 计算需求总数 cover_rate String 需求覆盖率 状态码: 400 表11 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码: 401 表12 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码: 404 表13 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码: 500 表14 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息
  • 响应示例 状态码: 200 OK { "defect" : { "total" : 3, "not_solved" : 3, "severity_number_list" : [ { "name" : "提示", "value" : 3 } ] }, "case_pass_rate" : { "pass_rate" : "99.5%", "result_number_list" : [ { "name" : "成功", "value" : 3000 }, { "name" : "未执行", "value" : 15 } ] }, "project_type" : "ipd", "issue_cover_rate" : { "summary" : { "testing" : 0, "finished" : 0, "not_tested" : 17, "total_number" : 17, "cover_rate" : "0.0%" } } }