---
sourceDocument: Australia IT Service Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/it-service-management

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia IT Service Management

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

# Configure KPIs with example

# Configure KPIs in Digital Portfolio Management with service availability example {#ariaid-title1}

Release version: Australia  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes to read  
Configure key performance indicators (KPIs) in Digital Portfolio Management (DPM) to surface performance information in the context of your solutions. This procedure uses the example of configuring service availability to display the availability score in the Run
life-cycle phase.

## Before you begin

* Plugins required: sn_team_perf_kpi_group and com.snc.service_portfolio
* Role required: sn_dpm.dpm_admin
{#dpm-configure-kpi-availability__ul_wgc_xrg_2zb}

## About this task

As a user with the sn_dpm.dpm_admin role, you can configure KPIs to display in DPM. This task uses the Outage and Availability KPI group to show how to configure the service availability KPI.  
Note:  
You must have Service Portfolio Management premium subscription to perform this task. This premium subscription automatically installs if you have DPM installed.

For general information about KPI groups, see [KPI groups in Digital Portfolio Management](https://servicenow-prod.fluidtopics.net/nBbjv8yisE3GhqfaAx28Dw "Define and configure the key performance indicator (KPI) groups in DPM that matter most to you. When you associate KPI groups with your services and applications, you can analyze their performance in a centralized area.").

To create KPI groups, see [Create KPI groups, mappings, and visualizations](https://servicenow-prod.fluidtopics.net/ssKOKVZljyW698cSzI2P4w "Create key performance indicator (KPI) groups and mappings in Digital Portfolio Management (DPM) to monitor the overall health and progress of all your services and offerings.").  
This procedure includes the following tasks:

1. Create the KPI group mapping.
2. Create the service commitment.
3. Associate the service commitment to the service offering.
4. Create an outage for the service offering.
5. Run the data collection job and verify.
6. Ensure that the KPI displays in DPM.
{#dpm-configure-kpi-availability__ol_kd2_n34_jtb}

## Procedure

1. Create the KPI group mapping.  
   The mapping you create sets up the service offering that you want to view availability.
   1. Navigate to Digital Portfolio Management WorkspaceKPI Group Mappings.
   2. Select New.
   3. On the form, fill in the fields.{#dpm-configure-kpi-availability__table_n3z_2v5_2sb__entry__2}

      | Field | Description |
      |-|-|
      | KPI Group | KPI group name to add the mapping. For this example, map to the Outage and Availability KPI group. This mapping may already be done as part of the base DPM system. |
      | * Service portfolio * Taxonomy node * Service * Offering * Service instance {#dpm-configure-kpi-availability__ul_yhf_5w5_2sb} | Mapping that you want to associate with this KPI group. The fields that are displayed depend on the type of KPI group that you selected. For this example, the mapping is Offering. |
      [Table 1. KPI Group Mapping form]

      {#dpm-configure-kpi-availability__table_n3z_2v5_2sb}
   4. Select Submit.
   {#dpm-configure-kpi-availability__ol_rn1_1n3_trb}
2. Create the service commitment.  
   For this example, select a service portfolio that you want to configure the service availability KPI. You can select a personal portfolio or an enterprise portfolio.
   1. Navigate to AllService Portfolio ManagementCommitments.
   2. Select New to set up availability data.
   3. On the form, fill in the fields.{#dpm-configure-kpi-availability__table_pyb_pb3_ktb__entry__2}

      | Field | Description |
      |-|-|
      | Name | Commitment name. |
      | Type | Type of commitment. The Availability type sets up availability data. |
      | Percentage available | Percentage that the commitment is available. For example, 90%. |
      | Schedule | Duration that the commitment is available. For example, 24 x 7 sets the commitment for every day. |
      | Time zone | Time zone for the commitment. |
      | Description | Description of the commitment. |
      [Table 2. Commitment form]

      {#dpm-configure-kpi-availability__table_pyb_pb3_ktb}
   4. Select Submit.
   {#dpm-configure-kpi-availability__ol_oyb_pb3_ktb}
3. Associate the service commitment to the service offering.  
   1. Navigate to AllService Portfolio ManagementService commitment.  
      Note:  
      If the plugin is not installed, then enter the table name in the filter navigator: service_offering_commitment.list, and then press Enter.
   2. Select New.
   3. On the form, fill in the fields.{#dpm-configure-kpi-availability__table_yyp_cf3_ktb__entry__2}

      | Field | Description |
      |-|-|
      | Service offering | The service offering associated with the service commitment. |
      | Service commitment | The service commitment associated to the service offering. |
      [Table 3. Service commitments form]

      {#dpm-configure-kpi-availability__table_yyp_cf3_ktb}
   4. Select Submit.
   {#dpm-configure-kpi-availability__ol_xyp_cf3_ktb}
4. Create an outage for the service offering.  
   Set the service availability for the past seven days prior to creating the outage record.
   1. Navigate to AllService Portfolio ManagementOutages.
   2. Select New.
   3. On the form, fill in the fields.{#dpm-configure-kpi-availability__table_gqp_533_ktb__entry__2}

      | Field | Description |
      |-|-|
      | Number | System-generated number for the outage record. |
      | Configuration Item | The service offering associated with the outage. |
      | Begin | The start date of the outage. |
      | End | The end date of the outage. |
      [Table 4. Outage form]

      {#dpm-configure-kpi-availability__table_gqp_533_ktb}
   4. Select Submit.  
      Note:  
      The outage that you create for the service offering also generates a service availability record for the service offering.
   {#dpm-configure-kpi-availability__ol_fqp_533_ktb}
5. Run the data collection job and verify.  
   The job collects data from all Performance Analytics indicators on the scheduled jobs list. This step also provides you with verification steps to ensure that the job ran successfully.
   1. Navigate to AllSystem DefinitionScheduled Jobs.
   2. In the Name column, search for SPM Data Collection job for PA.
   3. Select edit.
   4. Ensure that the Relative start is set to the number of days to collect data (default is 1).
   5. Select Execute now.
   6. Refresh the screen to see your job log on the Job Logs tab. Review the created date and ensure that the State is Collected.
   7. Open the Indicators tab and under the Name column, search for the SPM Availability indicator.
   8. Select SPM Availability, and then select edit.
   9. On the form, open the SPM Availability indicator record to verify that you created the job successfully.
   10. Select the Show Analytics Hub related link to verify that the availability score is displayed for the offering. If several values are displayed, then search for the offering name to verify that you set the availability score properly for that offering.
   {#dpm-configure-kpi-availability__ol_htw_4l3_ktb}
6. Ensure that the KPI is displayed in DPM.  
   1. Navigate to WorkspaceDigital Portfolio Management.
   2. Find the service portfolio that has the availability KPI that you created.
      * If you created the availability KPI for a personal portfolio, then open the personal portfolio card that has the availability KPI.
      * If you created the availability KPI for an enterprise portfolio, then use the enterprise portfolio tree structure to find the service offering record.
      {#dpm-configure-kpi-availability__ul_w4s_pxk_ktb}
   3. On the Run tab, ensure that the Performance snapshot Availability card displays the correct percentage value.
   {#dpm-configure-kpi-availability__ol_gpv_vq3_ktb}
**Related tasks**   

* [Create KPI groups and mappings in Digital Portfolio Management](https://servicenow-prod.fluidtopics.net/ssKOKVZljyW698cSzI2P4w "Create key performance indicator (KPI) groups and mappings in Digital Portfolio Management (DPM) to monitor the overall health and progress of all your services and offerings.")

*[\>]: and then


