For the complete documentation index, see llms.txt. This page is also available as Markdown.

Manage Scorecards

Manage, monitor, and 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 in the Harness IDP admin view.

  1. Click Configure in the side navigation bar to open the admin view of Harness IDP.

  2. Click Scorecards to view all available Scorecards in your account.

  3. Select the Scorecard you want to update and click Edit.

  4. Update the Scorecard configuration and click Update.


Refresh scorecards

You can manually refresh a component's Scorecard evaluation from the Harness IDP UI. This triggers an on-demand evaluation and updates the component's score in real time.

  1. Navigate to the component in the catalog whose Scorecard evaluation you want to refresh.

  2. Click Scorecard - Overall Score from the Overview page or the top navigation bar.

  3. On the Scorecard page, locate the 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

  1. Navigate to the entity details view in the Catalog

  2. Click Scorecard in the navigation bar.

  3. Click a 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 shows which data points did not meet the expected criteria.


Disable scorecards

If you need to temporarily or permanently disable scorecards, follow these steps:

Remove scorecard components from catalog pages

  1. Navigate to ConfigureLayout in IDP.

  2. Comment out the Scorecard-related lines under Layout pages to remove Scorecard components from 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:

  1. Navigate to the Scorecards section in IDP Configure view.

  2. Select the Scorecard you want to delete.

  3. 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.

  • New Scorecards or Checks appear after the next update at 12:00 AM UTC.

Scorecard check jobs

  • Check jobs run twice a day with a 12-hour interval.

  • A manually run check triggers its next automatic run after 12 hours.


Next steps

Last updated

Was this helpful?