---
title: Using Scorecards
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > Internal Developer Portal > Scorecards > Using Scorecards
---

# Using Scorecards

{% callout %}
# Important note for users on the following Datadog sites: app.ddog-gov.com

{% alert level="danger" %}
This product is not supported for your selected [Datadog site](https://docs.datadoghq.com/getting_started/site). ().
{% /alert %}

{% /callout %}

After configuring your Scorecards, you can view entity-level scores, track scores over time, and generate Scorecard reports to automatically update your team with Scorecard information.

## View entity-level details and scores{% #view-entity-level-details-and-scores %}

The Scorecard summary is accessible on the [**Explore** page](https://app.datadoghq.com/services) in the Software Catalog under the **Scorecards** column in the **Ownership** tab. You can see what level your specific entity or subset of entities has reached and the number of rules passed within each level.

Click **View Details** from the Scorecard, or open the entity details side panel and navigate to the Scorecards tab. Both views lists all levels, the rules applied within each level, and the entity's state—`pass`, `fail`, or `no data`—for each rule.

## Track scores over time{% #track-scores-over-time %}

You can visualize how teams' scores progress over time as they make changes and remediate known issues through historical timeseries in the Scorecards UI. You can also export these time series to Dashboards and Notebooks where you can filter on different tags such as `team`, `rule`, `scorecard`, `application`, `tier`, and `lifecycle`.

{% image
   source="https://datadog-docs.imgix.net/images/tracing/software_catalog/scorecard-historical-metrics.9ee43eb3bf6f6c368f725668d7f35cdc.png?auto=format"
   alt="Timeseries that shows change in scores over time in Scorecard UI" /%}

## Generate Scorecard reports{% #generate-scorecard-reports %}

You can generate Scorecard reports, which send scheduled overviews of Scorecard information to your team's Slack channel to help everyone understand how entities and teams are meeting the expected standards. Creating a report generates a Workflow using [Datadog Workflow Automation](https://docs.datadoghq.com/service_management/workflows/), which runs at a scheduled time.

{% alert level="danger" %}
Running this Workflow may impact your billing. Read the [pricing page](https://www.datadoghq.com/pricing/?product=workflow-automation#products) for more information
{% /alert %}

To create a Report:

1. Click **Create Report** on the Scorecards page.
1. Choose whether to include all defined entities across your organization or a specific team's entities.
1. Set the date, time, and frequency at which you want to receive these reports.
1. Set the Slack workspace and channel where the reports should be sent. The selected channel must be public and have the Datadog Slack app installed.
1. Click **Enable this Workflow**.

Using this information, Datadog sends you reports on the highest and lowest scoring rules, entities, and teams.

{% image
   source="https://datadog-docs.imgix.net/images/tracing/software_catalog/scorecard-reports.738cf1a328a5bcef7bb4f6de7e332ec5.png?auto=format"
   alt="Scorecard reports creation modal showing how to create report for all services" /%}

### Manage Scorecard reports{% #manage-scorecard-reports %}

To edit or delete a Workflow, click **Manage Reports** on the Scorecards page and select the Workflow. Make edits to the Workflow or delete it using the Settings menu.

## Further reading{% #further-reading %}

- [Software Catalog](https://docs.datadoghq.com/tracing/software_catalog/)
- [Scorecards API](https://docs.datadoghq.com/api/latest/service-scorecards/)
- [Prioritize and promote service observability best practices with Scorecards](https://www.datadoghq.com/blog/service-scorecards/)
- [Formalize best practices with custom Scorecards](https://www.datadoghq.com/blog/datadog-custom-scorecards/)
- [Track DORA Metrics with Datadog](https://docs.datadoghq.com/continuous_integration/dora_metrics/)