Best Practice for PagerDuty User Load

The best practice for the PagerDuty user load provides you with the information that you need to complete and run the integration successfully, and gain visibility of the data that is ingested by Oomnitza.

The following items are in the package:

• The Integration
  • PagerDuty Users Load
• The Business Objects
  • Email (secondary)
• The Credentials
  • PagerDuty User Load
• The Workflow
  • PagerDuty SaaS Users Role

For the integration to run, information such as authorization and integration values, must be added or updated.

Navigation

Before you start

Updating the credentials

Updating the integration

Adding fields to the People view

Before you start

Best practice
For the integration with Oomnitza, create a dedicated user account.

Before you can configure any of the available integrations with PagerDuty, you need to follow the steps in Updating the credentials. PagerDuty requires an API key for authorization.

You must ensure that you put the word Token token= before the API key you generated when Updating the credentials in Oomnitza. Only account administrators have the ability to generate account API tokens. To find our more about the PagerDuty API refer to the PagerDuty API documentation links below.

PagerDuty API documentation

Generating API keys

Authentication 

Updating the credentials

1. Click Configuration > Security >  Credentials, and then click Add new credential (+).
2. Add the information details.
3. On the AUTHORIZATION tab, complete these actions:
   • Ensure that API Key is selected.
   • Ensure that the token name is Authorization.
4. Enter Token token= followed by a space and the API Key. For example, Token token=y_NbAkKc66ryYTWUXYEu.
5. Ensure that Add to Header is selected.
6. Click SAVE. 

 Updating the integration

1. From the Configuration menu, click Integrations, and then click Integrations List View .
2. Click the integration tile for the PagerDuty user load.
3. Go to the Connect page and make the following changes:
   • Change the value selected for Integration preference. If this is the first time that you have run the integration, select Create & Update.   
   • To identify who made the integration changes, add a valid username in the Integration user field.
4. Click NEXT.
5. On the Mappings page, click Edit Connector. You can add rules to exclude the user records that you don't want to monitor such as system users and bots.
6. When you complete making your changes, click NEXT until you get to the final page and then click FINISH.

Adding fields to the People view

New fields that are ingested by Oomnitza are not automatically listed on the People page.

Add new fields

1. Click People.
2. Click Add.
3. Click Configure the view .
4. Click + Add Fields.
5. Select the fields that you want to add and click ADD.
6. Click List View Configs .
7. Select the fields.

Tip
If you want to add multiple new fields that are related, create a group in screen builder and add the fields to the group.