Skip to main content
Version: Release 24.3

Change and Risk Prediction (CRP) Plugin

The Release Change and Risk Prediction (CRP) plugin lets you predict high-risk changes and take actions to prevent failure, while also identifying low-risk changes and automating deployment. This helps you make data-driven decisions to avoid downtime and improve user experience.

Features​

  • Get Risk Prediction task
  • Change Risk Prediction: Risk Prediction Gate task

Requirements​

The plugin requires the following:

  • An instance of a change and risk prediction (CRP) server running on your local network.
  • The client identifier issued during the application registration process.
  • The client secret issued during the application registration process

Set up a Change and Risk Prediction (CRP) Server​

You can define a Change and Risk Prediction (CRP) server configuration in two locations:

  • On a global level in Connections under the CONFIGURATION group in the navigation pane.
  • On a folder level in Overview > Folders of the navigation pane, under the CONFIGURATION tab of the desired folder.

To set up a connection to a CRP server:

  1. In Release, go to one of the specified locations.

  2. Click Add button next to Change and Risk Prediction: Server.

  3. In the Title field, specify a name for your CRP server configuration.

  4. In the Symbolic name field, enter a unique identifier for this configuration.

  5. In the URL field, specify the server's address where it can be reached.

  6. In the Authentication section, configure the following:

    • Username: Enter the login user ID for the server.
    • Password: Enter the login password for the server.
    • Access token URL: Enter the endpoint URL for the authentication server.
    • Client ID: Enter the client identifier provided during the application registration process.
    • Client Secret: Enter the client secret provided during the application registration process.
    • Scope: Specify the scope of the access request. For multiple scopes, use space-delimited values.
    • Grant Type: Select "password" or the appropriate grant type.

  7. In the Proxy section, configure the following (if a proxy connection is needed):

    • Proxy Host: Enter the HTTP proxy host.
    • Proxy Port: Enter the HTTP proxy port.
    • Proxy Username: Enter the username for proxy access.
    • Proxy Password: Enter the password for proxy access.
    • Proxy Domain: Enter the domain for NTLM proxy authentication, if required.

  8. To test the server connection, click Test.

  9. Click Save.

    Add CRP Server

Create a Change Risk Prediction: Get Risk Prediction Task​

The Get Risk Prediction task in the Release CRP integration plugin lets you retrieve the risk prediction value for a specific change request. It helps you predict high-risk changes and take actions to prevent failure.

To add a Change Risk Prediction: Get Risk Prediction task:

  1. In the release flow view of a release or a template, add a task of the type Change Risk Prediction > Get Risk Prediction.
  2. Open the added task and configure the following in the Input Properties:
    • In the Server field, select the Change Risk Prediction server connection.
    • In the Change Request Number field, enter the ServiceNow Change Request number (e.g., 'CHG0030007').
    • In the Project Name field, enter the name of the project for which the Change Risk Prediction (CRP) value is to be retrieved (e.g., 'ChangeFailure').
    • In the Model Name field, enter the name of the model used to calculate the Change Risk Prediction (CRP) value (e.g., 'CRPModel').
  3. Next, configure the following in the Output Properties:
    • In the Risk Prediction Value field, select a variable of Text type to store the output value. This value indicates whether the risk prediction for the change request exceeds the threshold.

The Risk Prediction Value is the key output of this task and helps assess the risk level of the change request.

Create CRP Task

Create a Change Risk Prediction: Risk Prediction Gate task​

The Change Risk Prediction: Risk Prediction Gate task in the Release CRP integration plugin lets you define a gate threshold for a specific change request based on its risk prediction score. This helps prevent high-risk changes from progressing in the release pipeline, giving your team the opportunity to address issues before they reach production.

To add a Change Risk Prediction: Risk Prediction Gate task:

  1. In the release workflow or template, add a task of type Change Risk Prediction > Risk Prediction Gate.

  2. Open the added task and configure the following in the Input Properties:

    • In the Server field, select the Change Risk Prediction server connection.
    • In the Change Request Number field, enter the ServiceNow Change Request number (e.g., 'CHG0030007').
    • In the Threshold % field, specify the threshold percentage that defines the acceptable risk level (e.g., '25'). If the risk prediction exceeds this threshold, the gate will prevent further progression.
    • In the Project Name field, enter the name of the project associated with the Change Risk Prediction (CRP) value (e.g., 'ChangeFailure').
    • In the Model Name field, enter the model name used to calculate the CRP value (e.g., 'CRPModel').

  3. Configure the following in the Output Properties:

    • In the Change Prediction Probability field, select a variable of type Text to store the output value. This value represents the calculated probability of change risk, providing a basis for evaluating the risk level.

    Create CRP Task