Integrating with IBM Cloud Pak for Watson AIOps

You can integrate IBM Z® Resource Discovery Data Service with IBM Cloud Pak® for Watson AIOps.

Procedure

To integrate with IBM Cloud Pak for Watson AIOps, complete the following steps.

Enable access to the topology URL routes.
By default, the topology URL routes is not enabled.
To enable the topology URL routes, complete the following steps:
1. Log in to the OpenShift® Container Platform console, navigate to Administration -> Custom Resource Definitions, and search the CRD, for example, NOI.
2. Go into the instance evtmanger of NOI.
3. Add the following content to the YAML file to enable the routes.
```
helmValuesASM:
  global.enableAllRoutes: true
```
After you enable the route, you can see all the topology related routes in the Routes tab under Networking.
Get the access username and password of topology API.
1. Log in the OpenShift Container Platform console, navigate to the Secrets page under Workloads, and search for a name of a secret, for example, evtmanager-topology-asm-credentials.
  In this secret, you can get the username and password in the Data tab.
Load Z Application Performance Management monitoring data by running AppDynamics Observer jobs in IBM Cloud Pak for Watson AIOps.
For more information about how to configure and run AppDynamics Observer jobs, see Configuring AppDynamics Observer jobs.

Upload configuration to enable the processes that integrates with IBM Cloud Pak for Watson AIOps. Send the request /config with ZRD-DS core API by running the following cURL command:

curl -k -X POST \
https://hostname:8080/api/v1/config \
-H 'Content-Type: application/json' -H "ApiToken: API_TOKEN" \
-d '{"process":{"version":"ProcessSupported&Formatversion","process":[{"schedule":{},"process":"MergeASM","invoke":[{"pipeline":"MergeASM","extract":[],"plugin":"sansa","id":0,"persist":["3"],"type":"pipeline","version":"pluginversion","timestamp":0}],"id":0,"version":"processversion","timestamp":0},{"schedule":{},"process":"CopyIntoASM","invoke":[{"pipeline":"CopyIntoASM","extract":[],"plugin":"sansa","id":0,"persist":["3"],"type":"pipeline","version":"pluginversion","timestamp":0}],"id":0,"version":"processversion","timestamp":0}]},"extract":{"version":"DataSoruceSupported&FormatVersion","extract":[]},"persist":{"version":"DataPersistSupported&FormatVersion","persist":[{"id":"3","type":"url","version":"****","url":"https://cluster_address","option":{"topologyUrl":"topology_url","fileObserverUrl":"file_observer_url","mergeUrl":"merge_url","user":"username","password":"password"},"timestamp":0}]}}'

API_TOKEN: Specifies the value of the zrdds-core API_TOKEN that you set in the application.properties file.
cluster_address: Specifies the console route of IBM Cloud Pak for Watson AIOps. For more information about how to get this console route, see Accessing the console.
topology_url: Specifies the location of topology-topology service. Normally, you can get this location from the Routes tab under Networking in the OpenShift Container Platform console with Administration perspective.
file_observer_url: Specifies the location of topology-file-observer service.
merge_url: Specifies the location of topology-merge service.
username: Specifies the username for topology URL access that you obtain from the secrets in Step 2.
password: Specifies the password for topology URL access that you obtain from the secrets in Step 2.

Example command:

curl -k -X POST \
https://localhost:8080/api/v1/config \
-H 'Content-Type: application/json' -H "ApiToken:56ab24c15b72a457069c5ea42fcfc640" \
-d '{"process":{"version":"ProcessSupported&Formatversion","process":[{"schedule":{},"process":"MergeASM","invoke":[{"pipeline":"MergeASM","extract":[],"plugin":"sansa","id":0,"persist":["3"],"type":"pipeline","version":"pluginversion","timestamp":0}],"id":0,"version":"processversion","timestamp":0},{"schedule":{},"process":"CopyIntoASM","invoke":[{"pipeline":"CopyIntoASM","extract":[],"plugin":"sansa","id":0,"persist":["3"],"type":"pipeline","version":"pluginversion","timestamp":0}],"id":0,"version":"processversion","timestamp":0}]},"extract":{"version":"DataSoruceSupported&FormatVersion","extract":[]},"persist":{"version":"DataPersistSupported&FormatVersion","persist":[{"id":"3","type":"url","version":"****","url":"https://zdiscovery1.fyre.ibm.com","option":{"topologyUrl":"https://zdiscovery1.fyre.ibm.com/1.0/topology","fileObserverUrl":"https://zdiscovery1.fyre.ibm.com/1.0/file-observer","authorizeUrl":"https://zdiscovery1.fyre.ibm.com/1.0/authorize","mergeUrl":"https://zdiscovery1.fyre.ibm.com/1.0/merge","user":"asm","password":"asm"},"timestamp":0}]}}

Copy and merge the IBM® Discovery Library Adapter for z/OS® (z/OS DLA) data with IBM Netcool® Agile Service Manager data and load into IBM Cloud Pak for Watson AIOps.
While configuring the Data Service, you have populated the z/OS DLA output into PostgreSQL, in this step, copy the z/OS DLA data from PostgreSQL to IBM Cloud Pak for Watson AIOps and merge it with IBM Netcool Agile Service Manager data.
1. Send a GET request to the ZRD-DS core /process/CopyIntoASM API by running the following cURL command:
```
curl -k -H "Content-type: application/json" -H "ApiToken: API_TOKEN" -X GET https://hostname: 8080/api/v1/process/CopyIntoASM/X-TenantID
```
  X-TenantID
  
  Specifies the tenant ID.
2. Send a GET request to the ZRD-DS core /process/MergeASM API by running the following cURL command:
```
curl -k -H "Content-type: application/json" -H "ApiToken: API_TOKEN" -X GET https://hostname:8080/api/v1/process/MergeASM/X-TenantID
```
  X-TenantID
  
  Specifies the tenant ID.
IBM Z Resource Discovery Data Service supports the event matching with z/OS resources.

Before the event matching, you must configure and enable the event management for the event source. After event manager receives the event data, if the naming rule of event data matches that of IBM Z Resource Discovery Data Service data, IBM Netcool Agile Service Manager performs matching according to the z/OS resources automatically.
Check the topology view in IBM Cloud Pak for Watson AIOps.
1. Log in to the console. From the main navigation, click Topology viewer.
2. Search for the resource or resource group to find the topology that you want to view.