将来自多个源的数据聚集到一个工具链中
默认情况下，管道或其他工具生成的数据会汇总到工具所包含的工具链中。 运用 IBM Cloud® DevOps Insights，您可以将 IBM Cloud® Continuous Delivery 生成的高质量数据从多个源聚集到单一工具链中。
{: caption="链在一个中央工具链中汇集数据并制定特定" caption-side="bottom"}
准备工作
识别您的工具链标识
您需要使用工具链 ID 将Jenkins、Travis CI 以及其他持续集成和持续交付（CI/CD）工具与IBM Cloud® DevOps Insights 集成。 您还可以使用工具链 ID 将多个来源的数据聚合到一个工具链中。
有关将 Jenkins 或其他持续集成和持续交付工具与 DevOps Insights集成的更多信息，请参阅 将 Jenkins 与 DevOps Insights集成 或 将其他持续集成和持续交付工具与 DevOps Insights 集成。
查找您的工具链标识
您的工具链 ID 包含在 URL 中。 要查找工具链 ID，请完成以下步骤：
- 从IBM Cloud®控制台，单击菜单图标
>平台自动化>工具链。 - 在“工具链”页面上，选择工具链。
- 在工具链的“概述”页面的 IBM Cloud 工具 卡上，单击 DevOps Insights。
- 在 URL 中，复制字符串中
?toolchainId=之后的所有内容。 此字符串的长度为 36 个字符，由字母数字字符和短划线组成。
如果您想要查找 Jenkins 的工具链标识，请在工具链中选择 Jenkins，而不是 DevOps Insights。 您还可以使用同一方法在 URL 中查找工具链标识。
例如，https://cloud.ibm.com/devops/insights/overview?toolchainid=99c643c3-23d9-4030-9b1f-3aadfd7f9d09。 工具链标识为 99c643c3-23d9-4030-9b1f-3aadfd7f9d09。
脚本中用于登录IBM Cloud的 "API_KEY 必须能够访问所提供的新工具链 ID。 有关创建和管理 API 密钥的更多信息，请参阅管理用户 API 密钥。
将记录发布到集中的目标工具链
要将数据发布到单个工具链，您必须修改管道阶段的脚本，但必须修改的是据以发布数据的阶段。 仅当要在其他工具链中发布数据时，才须修改阶段。 要将数据发布到管道所在的当前工具链时，不必修改阶段。
要将记录发布到集中式工具链，请完成以下步骤：
- 单击菜单图标，然后选择资源列表。
- 选择工具链。
- 在工具链的“概述”页面上的 交付管道 卡上，单击要使用的管道。
- 单击 设置 图标
和 配置阶段。 - 在脚本部分进行更改。 对于您调用命令以发送构建、测试和部署记录的每个阶段，请将 TOOLCHAIN_ID 作为环境变量并将其设置为工具链标识。 在变量调用命令前导出工具链标识。
- 调用检测点决策的命令，或者将构建、测试和部署记录发送到 DevOps Insights。 有关更多信息，请参阅使用 IBM Cloud® CLI 设置一致的参数值。
对于使用 DevOps Insights CLI 的管道阶段，可导出 TOOLCHAIN_ID 作为环境变量。
以下示例显示如何将构建记录发送到另一个工具链中的 DevOps Insights。 您必须先覆盖工具链标识，然后再调用命令来评估检测点，以及发布构建、测试或者部署记录。
#!/bin/bash
#install the latest version of the DevOps Insights plugin
ibmcloud plugin install -f doi
# Login to IBMCloud if you are not already logged in. Assumes that $API_KEY environment variable has been set as a secured property in environment variable
ibmcloud login --apikey $API_KEY --no-region
# Overwrite the default TOOLCHAIN_ID with the Toolchain ID of the DevOps Insights instance you would like to send data to
export TOOLCHAIN_ID="$DEVOPS_INSIGHTS_TOOLCHAIN_ID"
# $GIT_BRANCH, $GIT_URL, $GIT_COMMIT are environment variables made available by the Continuous Delivery pipeline
# Assumes you have set $MY_APP_NAME and $MY_BUILD_NUMBER as described earlier
ibmcloud doi buildrecord-publish --logicalappname="$MY_APP_NAME" --buildnumber="$MY_BUILD_NUMBER" --branch $GIT_BRANCH --repositoryurl $GIT_URL --commitid $GIT_COMMIT --status pass
在 Insights 质量仪表板中汇总DevOps数据
质量仪表板为每个应用程序提供了多个质量数据集，例如单元测试、代码覆盖、功能验证测试以及静态安全扫描。 “质量仪表板”页面使用 IBM® Continuous Delivery Pipeline for IBM Cloud®、Jenkins、Travis 以及其他持续集成和持续交付 (CI/CD) 工具。 您还可以将在多个云或内部部署环境中运行的应用程序的质量数据聚集到单个 IBM Cloud® DevOps Insights 实例中。 每个类别中提供有关特定测试的更多详细信息并可确定趋势。 您可以指定要在仪表板中显示的测试的类型。 有关数据集的更多信息，请参阅管理数据集。
“质量仪表板”页面显示与 IBM Cloud® DevOps Insights 关联的每个应用程序的信息行。 有关每个应用程序的每个测试的成功数和失败数的所有信息都在一个屏幕上提供。 质量仪表板 "页面还会显示上传时与测试相关联的标记。 从菜单中选择一个标签，就可以将页面上显示的信息限制在该标签范围内。 默认情况下，页面会显示与测试相关的所有标记。
您可以在 DevOps Insights 仪表板中找到“质量仪表板”页面。
- 从IBM Cloud控制台，单击菜单图标>平台自动化>工具链。
- 在“工具链”页面，单击工具链打开“概述”页面。
- 在 IBM Cloud工具卡上，单击DevOps Insights工具集成。
- 从菜单中选择质量仪表板。