Creating an extended integration for New Relic assets and users

Let Oomnitza be your single source of truth!

You'll get visibility of your assets and users as data from New Relic is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and New Relic in minutes

Get the information and insights that you need to reduce costs and the time that you spend on administration tasks such as:

• Configurable dashboards and list views of key asset and user information
• Configurable reports to share information about assets and users with your colleagues and management
• Configurable asset and user workflows that you can easily create such as:
  • Workflows for getting device details
  • Workflows for deleting devices
  • Workflows for getting a user's details
  • Workflows for getting a user's role and deactivating users

Navigation

 Add credentials to Oomnitza

 Create an asset integration

 Create a user integration

 Create workflows

Before you start

To save time entering information when you create workflows, you can add your New Relic domain as a global variable.

To stream New Relic data into Oomnitza, you must add your New Relic authentication credentials to the credentials vault in Oomnitza.

Useful links

 New Relic API key

 New Relic API domains

Add the New Relic API domain as a global setting

To save time entering information when you create workflows, you can add your API domain as a global variable in Oomnitza.

1. Log into Oomnitza and click Settings > Global Settings.
2. Click Add new variable (+).
3. Enter New Relic.New Relic Api Domain as the variable name.
4. Enter the domain. For example, api.newrelic or if you have an EU region account api.eu.newrelic.
5. Click SAVE.

Add credentials to the vault in Oomnitza

To authorize connections between Oomnitza and New Relic, complete these steps:

1. Log into Oomnitza.
2. Click Settings > Credentials, and then click Add new credential (+).
3. Add the information details.
4. Click the AUTHORIZATION tab.
5. As authorization type select API Key.
6. Enter X_Api_Key as the name of the token. 
7. Enter the API Key, which is the secret key that you got from New Relic.
8. Ensure that Add to Header is selected.
9. Click CREATE. 

You use the credentials that you added to create and customize your New Relic integrations with Oomnitza.

Extended connector integration for assets

Info and connect details

1. From the menu, select Settings.
2. On the Integrations page, scroll down to the Extended section for Assets.
3. Click NEW INTEGRATION.
4. In the New Asset Integration sidebar, click  New Relic .
5. To integrate Oomnitza with the  New Relic Asset Load, click APPLY and then click NEXT twice.

Connect page

1. Enter a descriptive name for the integration such as New Relic Assets. That'll be the name of the integration that is shown on the Integrations page.
2. Select Cloud as the installation type.
3. From the Credentials list, select the credentials from the Oomnitza vault that you added for the connection.
4. From the Integration Preferences list, select Create & Update. 
5. Enter the name of the user of the integration.
6. Enter the API domain for your New Relic instance such as api.newrelic or api.eu.newrelic.
7. Click Next.

Mappings

Map the New Relic fields to Oomnitza fields and create custom mappings to get the information that you need to manage your assets.

To take advantage of workflows, ensure you map the following New Relic fields to Oomnitza:

Complete the following actions:

1. To map the New Relic fields, complete these steps:
   1. Click the down arrow.
   2. Select Add additional asset field.
   3. Change the name of the field. For example, change the name of the ID field to New Relic ID.
   4. Click CREATE.
2. Select a sync key. The field must have unique values.
3. When you've completed mapping the fields, click NEXT.

Custom mappings

You can map the following fields to Oomnitza:

Application Summary Apdex Score
Application Summary Apdex Target
Application Summary Concurrent Instance Count
Application Summary Error Rate
Application Summary Host Count
Application Summary Instance Count
Application Summary Response Time
Application Summary Throughput
Connector Sync Time
Health Status
Id
Language
Last Reported At
Name
Reporting

Schedule

By default, asset data is streamed to Oomnitza once every day.

You can configure the schedule to meet your needs such as changing the interval or changing the time so that the data is streamed when your system isn't busy.

1. Configure your schedule.
2. Click FINISH.

Result

A new tile is created for the integration on the Integrations page. 

What to do next

If you want to see what information is collected now, click the tile on the Integrations page and click RUN.

Figure: Mock-up for illustration purposes

If you want to change the integration settings, you can click a navigation link on the page, such as 4 Mappings, and edit the settings. 

Tip
To view the information that is collected about your assets, click Assets.

Extended connector integration for users

Info and connect details

1. From the menu, click Settings.
2. On the Integrations page, scroll down to the Extended section for User Integrations.
3. Click NEW INTEGRATION.
4. In the New User Integration sidebar, click New Relic .
5. To integrate Oomnitza with the  New Relic User Load, click APPLY and then click NEXT twice.

Connect page

Best practice
To ensure that only live user records are streamed from New Relic to Oomnitza, choose Update only as your integration preference. When you run the integration, you can check the error logs to see which user records weren't uploaded and why they weren't uploaded. You can then decide whether to upload the user records that were skipped by changing your integration preference to create and upload. See Access error logs.

1. Enter a descriptive name for the integration such as New Relic Users. That'll be the name of the user integration that is shown on the Integrations page.
2. From the User Selection list, select User plus SaaS User.
3. From the installation type list, select Cloud.
4. From the Credentials list, select the credentials from the Oomnitza vault.
5. From the Integration Preferences list, select Update only.   
6. Enter the name of the user of the integration.
7. Enter the API domain for your New Relic instance such as api.newrelic or api.eu.newrelic.
8. Click Next.

Understanding SaaS user role workflows 

Mappings

Map the New Relic fields to Oomnitza fields and create custom mappings to get the user information that you need.

Standard New Relic to Oomnitza mappings

The following New Relic fields can be mapped to Oomnitza: 

• Connector Synch Time
• Email
• Id
• First Name
• Last Name
• Role

Ensure that you select one of the fields as the Sync Key such as the email address of the user. 

Want to map more New Relic fields to Oomnitza?
Contact Support, or see Mapping extended connectors.

When you've completed mapping the New Relic fields to Oomnitza fields, click NEXT.

Schedule

By default, user data is streamed to Oomnitza once every day.

You can configure the schedule to meet your needs such as changing the interval or changing the time so that the data is streamed when your system isn't busy.

1. Configure your schedule.
2. Click FINISH.

Result

A new tile is created for the integration on the Integrations page. 

What to do next

If you want to see what information is collected now, click the tile on the Integrations page and click RUN.

Figure: Mock-up for illustration purposes

If you want to change the integration settings, you can click a navigation link on the page, such as 4 Mappings, and edit the settings. 

Create workflows

To reduce costs by automating repetitive and  complex tasks, take advantage of the built-in presets that Oomnitza provides.

Create asset workflows

To create an asset workflow, you must select credentials and enter the New Relic API domain.

To choose a preset, complete these steps:  

1. Click Assets > Workflow.
2. Click Add (+) and enter the name and description of the workflow.
3. Click Add new. A Begin and End block are automatically added to the Sandbox.
4. Drag and drop the API block onto the Sandbox.
5. Click Edit on the API block and enter New Relic in the search field. 
6. Select a preset:
   • New Relic Delete Device
   • New Relic Get Device Details
   • New Relic Get User Details
7. To choose a preset, click the forward arrow (>), configure the API Block, and save your changes.
8. To trigger the workflow, edit the Begin Block. You can create a schedule and add rules.
9. Connect the Blocks. 
10. Validate, launch, and save your workflow.

Understanding Workflows

Create user role workflows

The user role workflow allows you to read a user’s role from New Relic.

If the Deactivate checkbox is selected, the SaaS user is deactivated in Oomnitza if the user was not found in your New Relic instance.

1. From the menu, click Software.
2. Click Workflow and click SaaS Users
3. Click Add (+). The Begin and End blocks are added to the canvas.
4. Edit the Begin block. Choose a schedule to determine when the workflow is run and add the rules that determine when the workflow is triggered.
5. Click the Blocks tab.
6. Drag and drop the SaaS User Role Retrieval block onto the canvas.
7. Edit the block.
8. Enter New Relic as the search criteria.
9. Click the right arrow next to New Relic User Role API.
10. Select your credentials. By default, the Deactivate checkbox is selected.
11. Click SAVE.

Unleash the power of Oomnitza

To get valuable actionable insights that help you manage your assets, learn how to:

• Configure dashboards for your assets and users
• Create asset and user workflows to automate tasks
• Configure custom reports about your assets and users

See Getting started.