Working with DNS Response Probe

Prerequisites

OpsRamp Classic Gateway 14.0.0 and above.
OpsRamp Nextgen Gateway 14.0.0 and above.
Note: OpsRamp recommends using the latest Gateway version for full coverage of recent bug fixes, enhancements, etc.

Application Migration

Check for the gateway version as a prerequisite step - classic gateway-12.0.1 and above.
Notes:
- You only have to follow these steps when you want to migrate from sdk 1.0 to sdk 2.0.
- For the first time installation below steps are not required.
Disable all configurations associated with sdk 1.0 adaptor integration application.
Install and Add the configuration to that sdk 2.0 application.
Note: refer to Configure DNS Response Probe Integration & Discover Resources in DNS response probe Integration sections of this document.
Once all discoveries are completed with the sdk 2.0 application, follow any one of the approaches.
- Direct uninstallation of the sdk 1.0 adaptor application through the uninstall API with skipDeleteResources=true in the post request
  
  End-Point: https://{{host}}/api/v2/tenants/{tenantId}/integrations/installed/{installedIntgId}
  
  Request Body:
```
    {
    "uninstallReason": "Test",
    "skipDeleteResources": true
    }
```
  (OR)
- Delete the configuration one by one through the Delete adaptor config API with the request parameter as skipDeleteResources=true
  
  End-Point: https://{{host}}/api/v2/tenants/{tenantId}/integrations/installed/config/{configId}?skipDeleteResources=true.
- Finally, uninstall the adaptor application through API with skipDeleteResources=true in the post request.
  
  End-Point: https://{{host}}/api/v2/tenants/{tenantId}/integrations/installed/{installedIntgId}
  
  Request Body:
```
    {
    "uninstallReason": "Test",
    "skipDeleteResources": true
     }
```

Configure DNS response probe Integration

Click here to Configure and install the DNS Integration

To select your client, navigate to All Clients, and click the Client/Partner dropdown menu.
Note: You may either type your client’s name in the search bar or select your client from the list.
Navigate to Setup > Account. The Account Details screen is displayed.
Click Integrations. The Installed Integrations screen is displayed with all the installed applications.
Note: If you do not have any installed applications, you will be navigated to the Available Integrations and Apps page with all the available applications along with the newly created application with the version.
Click + ADD on the Installed Integrations page.
Note: Search for the integration either by entering the name of the integration in the search bar or by selecting the category of the integration from the All Categories dropdown list.
Click ADD in the DNS response probe application.
In the Configuration screen, click + ADD. The Add Configuration screen appears.
Enter the following BASIC INFORMATION:

Field Name	Description	Field Type
Name	Enter the name for the configuration.	String
Host Name / Domain Name	Enter the IP Address/Host Name of DNS Server. It should be accessible from Gateway.	String
DNS Server	DNS Server information. Note: By default *.ROOT.SERVER.NET is provided.	Integer
Port	Port Note: Default port value is 53.	String
Protocol	Select the protocol from the dropdown. You can either choose: TCP UDP	Dropdown
Class Type	Select the class type from the dropdown. You can either choose: IN CH	Dropdown
Number of Retries	Enter the number of retries. Note: By default 3 is the default value.	String
TimeOut (sec)	Enter the timeout information. Note: By default 5 is the default timeout value.	String
Reverse Lookup IPv4	Enter the reverse lookup IPv4 value.	Integer
Reverse Lookup IPv6	Enter the reverse lookup IPv6 value.	Integer
Notification Alert	Select the Notification Alert checkbox to be notified in case of Critical/Recovery failure alert for Connectivity, Authentication Exceptions.	Checkbox

CUSTOM ATTRIBUTES: Custom attributes are the user-defined data fields or properties that can be added to the preexisting attributes to configure the integration.

Field Name	Description	Field Type
Custom Attribute	Select the custom attribute from the dropdown. You can add attributes by clicking the Add icon (+).	Dropdown
Value	Select the value from the dropdown.	Dropdown

Note: The custom attribute that you add here will be assigned to all the resources that are created by the integration. You can add a maximum of five custom attributes (key and value pair).

In the RESOURCE TYPE section, select:
- ALL: All the existing and future resources will be discovered.
- SELECT: You can select one or multiple resources to be discovered.
In the DISCOVERY SCHEDULE section, select recurrence pattern to add one of the following patterns:
- Minutes
- Hourly
- Daily
- Weekly
- Monthly
Click ADD.

Now the configuration is saved and displayed on the configurations page after you save it.
Note: From the same page, you may Edit and Remove the created configuration.
12. Under the ADVANCED SETTINGS, Select the Bypass Resource Reconciliation option, if you wish to bypass resource reconciliation when encountering the same resources discovered by multiple applications.
Note: If two different applications provide identical discovery attributes, two separate resources will be generated with those respective attributes from the individual discoveries.
13. Click NEXT.
14. (Optional) Click +ADD to create a new collector. You can either use the pre-populated name or give the name to your collector.
15. Select an existing registered profile.

Click FINISH.
The integration is installed and displayed on the INSTALLED INTEGRATION page. Use the search field to find the installed integration.

Modify DNS response probe Integration

Click here to Modify the Configuration

See Modify an Installed Integration or Application article.
Note: Select DNS response probe.

Discover Resources in DNS response probe Integration

Click here to View the DNS response probe Details

The DNS integration is displayed in the Infrastructure > Resources > Endpoint. You can navigate to the Attributes tab to view the discovery details, and Metrics tab to view the metric details for DNS integration.

Note: By default, we provide A record metrics. You may also add additional metrics, apart from A records, by cloning the global template and using it.