Monitoring

The Monitoring feature enables you to receive notifications whenever there are changes to content contained in specific data products or attribute values for the DUNS Number in the registration.

With D&B monitoring, you can receive updates on a intra-day, daily, weekly, or monthly frequency and Reltio D&B connector provides the capability to read these notifications and update the entities through an automated job. For more information, see Monitoring APIs.

D&B monitoring consists of following process steps:

  • Registration - Represents a request to monitor a set of DUNS numbers and other details, such as D&B Direct+ product and version, frequency to receive notifications, how the notifications are delivered, and an option to process seed data.
  • Seed data - Includes an optional step to process the seed file to update the baseline data for all DUNS to be monitored.
  • Updating the notification - Includes regular notifications that are delivered to S3 bucket at the frequency specified in the registration and a batch job that updates the profile in Reltio.

Prerequisites

D&B Monitoring requires additional entitlements to be enabled for your D&B Direct+ license. You can reach out to your Dun & Bradstreet representative to get the additional entitlements.

Registration

D&B monitoring registration represents a request to monitor a set of DUNS numbers against the D&B Direct+ Data Product you use. It also includes details on how notifications are to be delivered and other information necessary for monitoring.

To register for D&B monitoring, you will need to work directly with your Dun & Bradstreet representative or create a support ticket with D&B. For more information, see Create Monitoring Registration.

A monitoring registration must be created for each tenant and D&B Direct+ product and version being used in the D&B connector for that tenant. You will need to provide the following details for creating the registration:
  • Initial set of DUNS that you want to monitor for changes against the specific D&B product
  • How frequently you wish to receive the notifications

D&B connector provides the following options to create the monitoring registration:

Parameter Description Allowed Options
D&B Direct+ Product Product ID provided by Dun & Bradstreet that is configured in the D&B Connector enrichment APIs. Only one product can be included in a registration. The product cannot be changed once the registration is created. CMPELF, CMPELK
Product version (versionID) The version ID (for example,v1) that identifies the product version to be used for this registration. Only one version can be included in a registration. The version cannot be changed once the registration is created. V1, V2
List of DUNS (LOD) Indicates the registration is for List of DUNS Numbers. A file containing the list of D-U-N-S numbers (one per line) to be included in the registration must be provided. Supported file types:
  • .txt
  • .zip
 
Notification Frequency (deliveryFrequency) Indicates how often notifications will be delivered. Valid values are as follows:
  • INTRA_DAY: Dun & Bradstreet will send notifications as many times as the D&B pipeline runs in a 24 hour period.
  • DAILY: Dun & Bradstreet system processes notifications shortly after midnight UTC.
  • WEEKLY: Dun & Bradstreet system processes notifications shortly after midnight UTC each Sunday.
  • MONTHLY: Dun & Bradstreet system processes notifications shortly after midnight UTC on the first of each month.
Recommended Option: Daily, Weekly
Delivery Trigger Indicates how notifications will be delivered.

PUSH notifications will be sent via file.

PUSH
Notification Type Indicates the level of detail each change notification will include for any D-U-N-S number that has changed.

FULL_PRODUCT: For each DUNS number that has changed, the full details are included in the notification. This is equivalent to a seed for the DUNS number.

FULL_PRODUCT
Destination Type The communications protocol used to transfer change notifications Amazon S3. S3
File Transfer Profile Specific location for file delivery.

S3 ARN path

 
S3 Encryption Key Key used to encrypt the files delivered to S3.  
Email Addresses Email addresses for users to be notified regarding monitoring activities for this Registration.  
Note: The registration of DUNS for monitoring is not a finite list. You can register with an initial list of DUNS to be monitored or create it with an empty list and use the Reltio D&B Connector to add or modify the list of DUNS. Reltio D&B connector provides the capability to check, add, and remove additional DUNS to the list of DUNS being monitored.

Receiving the baseline data

You can optionally request for Baseline data (also known seed file). The seed file contains the baseline data of the DUNS to be monitored. For more information, see Seed Delivery.

Updating the Notification

After the registration is complete, regular updates are provided by Dun and Bradstreet to the destination (Amazon S3 bucket) and at the frequency specified in the registration. The updates contain changes to the content of the DUNS being monitored. For more information, see Change Notifications.

D&B Connector provides a background job to process the monitoring of events or updates. The background jobs are to be scheduled at the frequency provided in the monitoring registration and will read the file provided by D&B and update the changes in the Reltio profile entities.

Contents of Notification Data File

A notification file may contain:
  • Status changes for DUNS Numbers
  • DUNS Number data changes as seed records
  • Seed records for DUNS Numbers added to the registration

For information on D&B Monitoring APIs, see Monitoring APIs.