Manage Scorecards
Learn how to manage, monitor & track scorecard performance
Once you have created Scorecards and Checks, you can monitor their performance, track trends, refresh evaluations, and view detailed check results. This guide covers all aspects of managing your scorecards effectively.
Update scorecards
You can update a Scorecard's configuration by editing the Scorecard in the admin view of Harness IDP.
Click Configure in the side navigation bar to open the admin view of Harness IDP.
Click Scorecards to view all available Scorecards in your account.
Select the Scorecard you want to update and click on Edit.
Update the Scorecard configuration and click Update.
Refresh scorecards
You can manually refresh a component's Scorecard evaluation from the Harness IDP UI, triggering an on-demand evaluation and updating the component's score in real time.
Navigate to the component in the catalog for which you want to refresh the Scorecard evaluation
Click Scorecard - Overall Score from either the overview page or the navigation bar at the top
On the Scorecard page, locate the specific Scorecard you want to refresh and click Rerun Checks
This will manually trigger a refresh, updating the component's score immediately.
View check details
You can view detailed information about each check's execution status directly from the entity's Scorecard view. This helps you understand why a check passed or failed and take appropriate action.
Access check details
Navigate to the entity details view in the Catalog
Click on Scorecard from the navigation bar
Click on any Check to view its detailed execution results
Passed checks
When a check passes, you will see a "Passed" status with a confirmation message.
What You will See:
About the check: Description of what the check validates
Rule Expression: Toggle between two views:
JQL View: Shows the JEXL expression that was evaluated
Visual View: Displays the rule in a basic format showing the data point, condition, and resulted value
Failed checks
When a check fails, you will see a "Failed" status with an AI-powered explanation of why the check failed and what needs to be fixed.
What You will See:
About the check: Description of what the check validates
Rule Expression: Toggle between two views:
JQL View: Shows the JEXL expression that was evaluated
Visual View: Displays a table with all rules, their conditions, and the actual resulted values that caused the failure
The Visual view is particularly helpful for failed checks as it shows you exactly which data points did not meet the expected criteria, making it easier to troubleshoot and resolve issues.
Disable scorecards
If you need to temporarily or permanently disable scorecards, follow these steps:
Remove scorecard components from catalog pages
Navigate to the Layout section in IDP Configure
Comment out the Scorecard-related lines you added under Layout pages to remove the Scorecard components from the Catalog pages
Change scorecard status to draft
Additionally, you can change the status of all your Scorecards to "draft". This ensures that:
Scorecard computations will not run
Scorecards will not be shown to developers
Delete scorecards
To delete a Scorecard, follow these steps:
Navigate to the Scorecards section in IDP Configure view.
Select the Scorecard you want to delete.
Click Delete.
Scorecard execution schedule
Understanding when scorecards and checks run helps you plan your evaluations and troubleshooting.
Scorecard trends dashboard updates
The Trends Dashboard updates every 24 hours
Newly created Scorecards (or Checks) will appear in the dashboard after the next update at 12:00 AM UTC
Scorecard check jobs
Check jobs run twice a day with a 12-hour interval between each run
If you manually run a check now, the next automatic run will occur after 12 hours
Next steps
Learn how to create custom checks for your scorecards
Explore available data sources for your checks
Review scorecard tutorials for advanced use cases:
Last updated
Was this helpful?