oe-performance API接口深度解析：性能数据查询与管理的技术实现

oe-performance API接口深度解析：性能数据查询与管理的技术实现

【免费下载链接】oe-performanceThe repository of the lastest version of openEuler Performance Test website项目地址: https://gitcode.com/openeuler/oe-performance

前往项目官网免费下载：https://ar.openeuler.org/ar/

openEuler性能测试平台（oe-performance）是一个专门用于管理和查询系统性能数据的强大工具。作为openEuler社区的重要组成部分，该项目提供了完整的性能测试数据管理和可视化解决方案，帮助开发者和测试工程师高效地进行系统性能分析和优化。😊

🎯 核心功能概述

oe-performance平台的核心功能围绕性能数据的收集、存储、查询和展示展开。系统支持多种性能测试套件，包括CPU、内存、存储、网络和基础库等基础性能测试组件。每个测试组件都有专门的API接口来处理数据查询和分析需求。

📊 系统架构设计

oe-performance采用前后端分离的架构设计，前端基于Vue.js构建，后端通过统一的/data-api/search接口与Elasticsearch数据库进行通信。这种设计使得系统具有高度的可扩展性和灵活性。

主要数据表结构

系统主要使用以下Elasticsearch索引（表）来存储不同类型的数据：

🔍 API接口详解

1. 统一数据查询接口

oe-performance的核心API接口是/data-api/search，这是一个统一的Elasticsearch查询接口，支持多种查询模式和聚合操作。

基本查询示例

// 查询stream测试套件的性能数据 export const getsubmitidAxios = (param) => http({ url: '/data-api/search', method: 'POST', data: { index: 'jobs', query: { size: 0, _source: ['submit_id'], query: { bool: { must: [ { match: { suite: "stream" }, exists: { field: "submit_id" } } ] }, aggs: { uid_aggs: { terms: { field: "submit_id", size: 10 } } } } } } });

2. 性能数据查询接口

性能数据查询是oe-performance最核心的功能之一。系统支持多种查询模式：

单测试套件查询

• 接口路径:/data-api/search
• 请求方式: POST
• 主要参数:
  • index: 指定查询的数据表（如'jobs'）
  • query: Elasticsearch查询语句
  • size: 返回数据量限制

多条件组合查询

系统支持复杂的多条件查询，可以组合硬件配置、操作系统版本、测试套件等多种条件进行筛选。

3. 测试任务管理接口

测试任务管理API提供了完整的任务生命周期管理功能：

4. 硬件配置查询接口

通过machine_info索引，系统可以查询详细的硬件配置信息：

// 查询特定测试机的硬件配置 export const getMachineInfo = (testbox) => http({ url: '/data-api/search', method: 'POST', data: { index: 'machine_info', query: { size: 1, query: { bool: { must: [ { match: {"testbox": testbox} } ] } } } } });

🛠️ 技术实现细节

数据聚合策略

oe-performance采用多层数据聚合策略来处理复杂的性能数据：

1. 第一层聚合: 按submit_id分组，获取不同的测试任务组
2. 第二层聚合: 按测试参数（p1参数）分组，形成不同的测试表格
3. 第三层聚合: 按KPI指标分组，展示具体的性能数据

性能测试套件支持

系统支持以下主要性能测试套件：

📈 数据可视化与展示

性能基线展示

性能基线页面展示每个测试组件的性能数据，支持以下功能：

1. 数据筛选: 根据硬件配置、操作系统版本、测试参数等进行筛选
2. 数据对比: 支持不同配置的性能数据对比
3. 趋势分析: 展示性能数据的变化趋势

测试任务详情

测试任务详情页面提供完整的测试信息展示：

• 任务基本信息: submit_id, 提交人, 提交时间, 任务状态
• 硬件配置: CPU型号, 内存规格, 硬盘配置, BIOS版本
• 软件环境: 操作系统版本, 内核版本, 编译器版本
• 性能数据: 详细的KPI指标和测试结果

对比分析功能

系统支持多组测试数据的对比分析，包括：

1. 技术规格对比: 硬件和软件配置的详细对比
2. 性能数据对比: 不同配置下的性能指标对比
3. 性能提升率计算: 自动计算性能提升百分比

🔧 开发与集成指南

前端API调用

前端通过src/api/performance/index.ts中的API函数与后端交互：

// 获取性能数据 export function getPerformanceData( params: PerformanceApi.PerformanceDataParams ) { return createAxios({ url: api.requestDataApi, method: 'post', data: params }) } // 获取测试任务列表 export function getJobValueList(params: PerformanceApi.JobValueListParams) { const { jobFieldList, searchTime = 10, byScene, searchParams } = params // ... 构建查询参数 return createAxios({ url: api.requestDataApi, method: 'post', data: { index: 'jobs', query } }) }

数据模型定义

系统使用TypeScript类型定义来确保数据的一致性：

• PerformanceApi.PerformanceDataParams: 性能数据查询参数
• PerformanceApi.JobValueListParams: 任务列表查询参数
• SearchPanel.SearchParams: 搜索面板参数

🚀 最佳实践与使用技巧

1. 高效查询优化

• 使用聚合查询: 对于大数据量的查询，尽量使用Elasticsearch的聚合功能
• 合理设置size参数: 避免一次性返回过多数据
• 利用缓存机制: 对频繁查询的数据进行缓存

2. 数据筛选策略

• 分层筛选: 先按测试套件筛选，再按硬件配置筛选
• 时间范围限制: 使用range查询限制时间范围，提高查询效率
• 字段选择: 只查询需要的字段，减少数据传输量

3. 错误处理

• 参数验证: 对所有输入参数进行严格验证
• 异常捕获: 对API调用进行异常捕获和错误处理
• 重试机制: 对网络错误实现自动重试机制

📋 实际应用场景

场景一：性能基准测试

开发团队可以使用oe-performance API进行系统性能基准测试：

1. 提交测试任务到测试环境
2. 通过API查询测试结果
3. 分析性能数据，识别性能瓶颈
4. 优化系统配置，重新测试验证

场景二：版本性能对比

在新版本发布前，可以通过API对比新旧版本的性能数据：

// 对比两个版本的性能数据 const version1Data = await getPerformanceData({ index: 'jobs', query: { query: { bool: { must: [ { match: { suite: 'stream' } }, { match: { os_version: '20.03' } } ] } } } }) const version2Data = await getPerformanceData({ index: 'jobs', query: { query: { bool: { must: [ { match: { suite: 'stream' } }, { match: { os_version: '20.09' } } ] } } } })

场景三：自动化测试集成

将oe-performance API集成到CI/CD流水线中，实现自动化性能测试：

1. 在构建完成后自动触发性能测试
2. 通过API获取测试结果
3. 与性能基线进行比较
4. 自动生成性能测试报告

🔮 未来发展方向

oe-performance平台正在持续演进，未来的发展方向包括：

1. 更多测试套件支持: 扩展支持更多的性能测试工具
2. AI性能分析: 引入机器学习算法进行性能趋势预测
3. 实时监控: 实现性能数据的实时监控和告警
4. API扩展: 提供更丰富的API接口，支持第三方集成

💡 总结

oe-performance API接口为openEuler性能测试提供了强大的数据管理和查询能力。通过统一的Elasticsearch查询接口，系统实现了灵活的数据检索和复杂的聚合分析。无论是进行性能基准测试、版本对比还是自动化集成，oe-performance都能提供可靠的技术支持。

通过深入了解oe-performance的API接口设计和技术实现，开发者可以更好地利用这一平台进行系统性能分析和优化。随着openEuler生态系统的不断发展，oe-performance将继续在系统性能测试领域发挥重要作用。

提示: 在实际使用中，建议先从小规模测试开始，逐步熟悉API的使用方式，再扩展到生产环境。同时，关注openEuler社区的更新，及时了解新功能和改进。👍

【免费下载链接】oe-performanceThe repository of the lastest version of openEuler Performance Test website项目地址: https://gitcode.com/openeuler/oe-performance