Notifications

43 views

Description

Business Requirement:

  • The requirement is to send the metric data using operational intelligence API and view the same using Insight explorer. This KA will help to achieve the same business requirement.

Instructions

Prerequisites

    • Active Plugins: Event Management, Operational Intelligence
    • Working Clotho Database
    • Rest API Tool.
    • Working Mid Server.

Steps:

  • Configure Mid Web Server

    • Connect to the instance and Navigate to Mid Server >> Extensions >> Mid Web Server table
    • Create New Record and fill the details. make a note of the port and Authentication User Name and password.
    • Submit the record and Start the Web Server Record. It should look like below.



  • Configure the Operational Intelligence Metrics Context:

    • Connect to the instance and Navigate to Mid Server >> Extensions >> Operational Intelligence - open the table.
    • Create a new record, fill the required details. Make sure to select the "Enable Rest Listener" checkbox.
    • Submit the record - the final record should look like below.


  • Instance level Configuration:

    • Event Rule Configuration:
      Create an Event Rule for the metric source that will be used to bind the CI to the metric. - This is also a mandatory step.

  • Setting Up Rest API Tool:

    • Connect to the host which will be used to send the metric data.
    • Install Rest API Chrome Extension or Any other rest tool and set up the tool as per the below setting.

      Method - Post
      API Name - api/mid/sa/metrics
      Target URL : https://<Mid_IP_Address: Web Server Port>- Refer Configure Mid Web Server Section.
      Authorization: Mid Web Server User name and password. - Refer Configure Mid Web Server Section.
      Payload: The payload must start and end with "[" "]" brackets and the timestamp used in the payload must be an EPOCH time in milliseconds.

    • If you are trying to send data using any OOTB source value defined in the sa_metric_registration table, kindly enable the source first. By default, it is set to False. 
    • Below is the screenshot of the API tool.



    • Send the payload and check the response. If the response is 200 Ok which means the metric record is sent to the instance successfully.
  • Validating the result:

    • Open the "em_events" table and see if the event is generated as per the details sent in the payload.
    • Open the "sa_metric_map" table and see if the Metric to CI mapping is generated and validate if the configuration Item field is mapped to the valid CI.

  • Checking the metric details in Insight Explorer:

    • Once the metric is generated, Insight explorer will start displaying the same metric data.
    • Navigate to Operational Intelligence >> Insight Explorer.
    • Search for the CI under configuration item and it will display the details. Below is a sample screenshot.





Additional Information

Article Information

Last Updated:2020-09-16 05:25:24
Published:2020-09-16