今天我们很高兴地宣布洞察终点的稳定性Circleci的API v2。The newest version of our API offers all the flexibility and intelligence engineering teams want, so you can get even more out of CircleCI. A pipelines-first approach introduces efficiency to your test suite, while our insights endpoints unlock key data around workflows and consumption.

在此帖子中,我们将概述现在稳定用于生产使用的端点。

更多数据意味着更明智的决策

洞察端点已在预览中已有几个月,允许用户:

  • 跟踪状态 -查看哪些工作失败,工作流程具有片状测试,并优先考虑管道改进的努力。
  • 监控持续时间 -了解哪些工作流或作业正在进行最长并确定缓存,并行化和我们新便利图像的机会可以帮助速度速度。
  • 优化消费 -优化Circleci的用途,并熟悉每个作业和/或工作流程的信用支出。可预测的计划月份的月份。

四个新终点

With the insights endpoints, users can retrieve aggregate historic data on credit consumption and duration at the workflow and/or job level to build their own dashboards. The endpoints currently return data for a particular workflow within a project and a branch.

View aggregate data at a job and workflow level

获取//www.drag240sx.com/api/v2/insights/ waswlows get //www.drag240sx.com/api/v2/insights/ {project-slug} / workflows/(worwswlow-name}/职位

检索指定分支的项目作业和工作流的聚合数据。有效载荷包含以下字段:

  • 名称
  • Aggregation window start (UTC)
  • 聚合窗口端(UTC)
  • 成功运行
  • 失败运行
  • Total runs
  • 成功率
  • 吞吐量(平均运行/天数)
  • 恢复的平均时间
  • 使用的总收益
  • 持续时间统计:MAX,MIN,平均值,中位数,P95,标准差(全部以秒为单位)

查看作业和工作流执行数据

获取//www.drag240sx.com/api/v2/insights/nowlows// {workflow-name} /作业/ {作业名称}

检索指定分支的命名项目工作流程的最新250次运行(或在过去90天内运行,而不是)。有效载荷包含以下字段:

  • ID
  • 状态
  • 使用的学分
  • 持续时间(秒)
  • 在(UTC)创建
  • 停在(UTC)

看看我们的文件了解更多。

通过有意义的指标改善软件交付

工程表现是许多组织的头脑之外,成功的团队发现,持续整合是提供结果的关键。在Circleci,我们有一个独特的特权,能够先看到这一进化 - 并在我们的报告中分享了这些发现CI的数据驱动案例

我们的结果证明了CI将高性能人员与其余部分分开。考虑到这一点,我们很高兴继续提供沿着他们的Devops旅程移动团队的工具和智慧。

通过利用这些见解端点,工程团队可以访问关键的工作流程集合信息,该信息显示工作流程如何在更长的持续时间内执行如何跟踪成功/失败率,吞吐量和平均时间恢复,以及持续时间指标。类似地,工作流程运行数据允许用户跟踪用于特定工作流的执行时间和学分。最后,访问作业聚合信息概述了特定工作流程中的作业如何在更长的时间内执行较长持续时间 - 增强测量成功率/故障率和吞吐量的能力。

我们迫不及待地想看到用户如何将这些数据用于使用,并期待不断增强客户的智能。如果您有任何疑问或想了解更多信息,请查看以下相关资源或观看用Circleci的新见解端点提高您管道的可见性网络研讨会。

有关: