Scorecard configuration parameters
Parameters in your application configuration file for managing homepage cards and portfolio data logic.
Homepage card properties Copy linkLink copied!
Properties of the aggregated Scorecard card in the widgetLayout section of the dynamic home page layout in your app-config.yaml file.
| Property | Description |
|---|---|
|
|
Identifies the metric or custom aggregation that the Scorecard card displays. Specify a metric ID or the key of a custom |
|
|
[Deprecated] Legacy identifier for the source metric string. Supported for backwards compatibility but scheduled for removal in a future release. Replace with |
Application configuration properties (scorecard.aggregationKPIs) Copy linkLink copied!
| Property | Description |
|---|---|
|
|
The primary textual label rendered on the header block of the homepage card. |
|
|
A brief text string summarizing the target scope of the KPI. |
|
|
The aggregation algorithm. Specify |
|
|
The unique provider identifier mapping to the individual source plugin collection layer. |
|
|
Optional. Scalar types only. Restricts the calculation to entities whose latest threshold evaluation matches the given status key. Silently ignored on |
Supported aggregation types
| Type ID | Category | Supports filter |
Supports options.thresholds |
|---|---|---|---|
|
Grouped (counts per threshold status) |
No |
No |
|
Grouped (normalized weighted score) |
No |
Yes |
|
Scalar (rollup of latest numeric values) |
Yes |
Yes |
|
Scalar (rollup of latest numeric values) |
Yes |
Yes |
|
Scalar (rollup of latest numeric values) |
Yes |
Yes |
|
Scalar (rollup of latest numeric values) |
Yes |
Yes |
|
Scalar (rollup of latest numeric values) |
Yes |
Yes |
The weightedStatusScore type was previously named average. Deployments with type: average configured for a weighted portfolio score must update to type: weightedStatusScore. Otherwise, the backend does not fail startup: it silently falls back to the scalar average type described in this table, which calculates the numeric mean of the metric instead of the weighted portfolio score, changing the value shown on the homepage card without any warning.
Options parameters for the weightedStatusScore tracking type
options.statusScores-
Map of threshold status rule keys (
success,warning,error) to numeric weight integers. This parameter is required for theweightedStatusScoretype and must be non-empty; missing or empty maps cause application startup failures. options.thresholds-
Optional numeric value array tracking custom status levels evaluated against the weighted score output value on a scale from 0 to 100 with one decimal place. If omitted, the system falls back to default values: less than 30 indicates an error, 30 to 79 indicates a warning, and 80 or higher indicates a success. Custom configurations must provide full real-line range coverage with no numeric gaps.
Options parameters for scalar tracking types
filter.status-
Optional. Threshold status key (case-sensitive) that must match a threshold rule for
metricId. Only the latest entities with that status contribute to the aggregated value. options.thresholds-
Optional. Classifies the aggregated scalar output using the same threshold rule syntax as metric thresholds. If omitted, the aggregated value is returned without a status classification.