RHIDP-12523: Platform engineer should be able to drill down from the card into the entities it represents

Author: rh-tokeefe

modules/observability_evaluate-project-health-using-scorecards/proc-configure-aggregated-scorecard-kpis.adoc

@@ -0,0 +1,31 @@
+:_mod-docs-content-type: PROCEDURE
+
+[id="configure-aggregated-scorecard-kpis_{context}"]
+= Configure Aggregated Scorecard KPIs to Monitor the Health of Multiple Applications
+
+[role="_abstract"]
+Aggregated scorecard Key Performance Indicators (KPIs) enable platform engineers to monitor the collective health, security, and compliance posture of multiple software applications from a single interface.
+
+[NOTE]
+====
+When you add multiple components to a scorecard, the system calculates an average compliance value. To maintain precision, ensure that all selected applications utilize matching verification metrics.
+====
+
+== Prerequisites
+
+* You have administrator access to the developer portal instance.
+* You have a verified list of the software component IDs that you want to aggregate.
+
+== Procedure
+
+. Navigate to the *Administration* workspace in the developer portal.
+
+* select *Scorecard Configuration* from the left panel.
+
+. Click *Create Aggregated Card*.
+
+. In the *Component Selection* field, enter the application component IDs that you want to group together.
+
+. From the *KPI Metrics* drop-down list, select the compliance checks—such as code quality, vulnerability thresholds, or test coverage—that you want to combine.
+
+. Click *Save Configuration*.

modules/observability_evaluate-project-health-using-scorecards/proc-drill-down-from-aggregated-scorecards-to-identify-specific-services-impacting-team-kpis.adoc

@@ -0,0 +1,39 @@
+:_mod-docs-content-type: PROCEDURE
+
+[id="drill-down-from-aggregated-scorecards-to-identify-specific-services-impacting-team-kpis_{context}"]
+= Drill Down From Aggregated Scorecards to Identify Specific Services Impacting Team KPIs
+
+[role="_abstract"]
+Drilling down into aggregated scorecard metrics allows engineering managers to isolate the specific software services or applications that are negatively impacting broader performance KPIs.
+
+[NOTE]
+====
+The breakdown view displays code repositories, software components, and dependencies in a descending impact stack. Services with critical errors or security vulnerabilities appear at the top of the stack and require immediate remediation.
+====
+
+.Prerequisites
+
+* You have an active user account with access to the Engineering Leadership Dashboard viewport.
+* One or more aggregated scorecard Key Performance Indicators (KPIs) are already configured and deploying metrics.
+
+.Procedure
+
+. Open the *Engineering Leadership Dashboard* in your portal viewport.
+
+. Locate the aggregated scorecard widget for your department ecosystem.
+
+. Hover your mouse pointer over any tracking line that displays a decreasing health grade or safety alert.
+
+. Click the specific KPI score value to reveal the granular breakdown window.
+
+. Select the name of any degraded software service within the breakdown list to navigate directly to its isolated health path.
+
+== Aggregated Scorecard Metric Definitions
+
+[cols="1,2", options="header"]
+|===
+| KPI Card Element | Evaluation Rule
+| Combined Grade | The aggregate letter score representing your software components' average check results.
+| Contributing Services | The total number of individual applications sending live metrics to the consolidated card calculation.
+| Core Vulnerabilities | The cumulative count of high-severity safety exposures identified inside child software layers.
+|===

modules/observability_evaluate-project-health-using-scorecards/ref-aggregated-scorecard-metric-definitions.adoc

@@ -0,0 +1,23 @@
+:_mod-docs-content-type: REFERENCE
+
+[id="aggregated-scorecard-metric-definitions_{context}"]
+= Aggregated Scorecard Metric Definitions
+
+[role="_abstract"]
+Review definitions and evaluation rules for the Key Performance Indicator (KPI) metrics displayed on {product} aggregated scorecards.
+
+Use these reference definitions to interpret card data when monitoring multi-application systems or diagnosing underlying compliance failures.
+
+[cols="1,2", options="header"]
+|===
+| KPI Card Element | Evaluation Rule
+
+| Combined Grade
+| The aggregate letter score representing your software components' average check results.
+
+| Contributing Services
+| The total number of individual applications sending live metrics to the consolidated card calculation.
+
+| Core Vulnerabilities
+| The cumulative count of high-severity safety exposures identified inside child software layers.
+|===