Install Health Log Analytics (HLA)

Install Health Log Analytics by requesting ServiceNow HLA installation from ServiceNow Customer Support.

Before you begin

Verify that the Health Log Analytics application and all of its associated ServiceNow Store applications have valid ServiceNow entitlements. To obtain the entitlements, contact your ServiceNow Solution Consultant.

The minimum version of the ServiceNow AI Platform required for Health Log Analytics installation is Australia.

Important:

Health Log Analytics uses the default user sn_occ_occultus for internal communication. Make sure that this user is active and do not deactivate it.

Role required: admin

Procedure

1. On the ServiceNow Store website, opt into the ITOM AIOps product.
   1. Go to the ServiceNow Store website and search for the Health Log Analytics app.

      Figure 1. Health Log Analytics app in the ServiceNow Store

      

   2. Select the Health Log Analytics tile.
      The Health Log Analytics product page displays.

      Figure 2. Health Log Analytics product page in the ServiceNow Store

      

   3. Under Included in Products, select ITOM AIOps.
   4. Select Opt-in to opt-in to ITOM AIOps.
2. Install the Health Log Analytics application on your ServiceNow instance.
   1. On your instance, navigate to System Applications > All Available Applications > All.
   2. Find the Health Log Analytics application using the search bar.
   3. On the Health Log Analytics tile, select Install.
      When the application is successfully installed on the instance, an automatic change request (CHG) is triggered to request provisioning for the necessary endpoints. The instance admin receives the request and any relevant notifications.

      Note:

      Even when the Health Log Analytics application is installed successfully, it will not work until the endpoints have been provisioned. Provisioning endpoints configures your source systems to collect and send their log data to your ServiceNow instance. Health Log Analytics depends on this ingested data to detect anomalies, correlate events, and generate alerts.
   4. On the Installed tab, verify that the application and its dependencies were installed successfully.

      Figure 3. Health Log Analytics is installed on the instance

      

3. Optional: Observe the status of the provisioning process by reviewing the CHG.
   Note:

   Some steps in the provisioning process might require your explicit approval. In such cases, ServiceNow Customer Support will reach out.
4. When provisioning is completed, verify that the Health Log Analytics application is up and running on your ServiceNow instance.
   1. On the instance, enter sn_occ_stats.do in the navigator and press the Enter keyboard key.
      The Health Log Analytics Package Dependencies and Versions table displays.

      Figure 4. Health Log Analytics Package Dependencies and Versions table

      

      The provisioned endpoints are listed along with their version number:

      • Occultus
      • MetricBase
      • ElasticSearch

      The Health Log Analytics application is up and running on your instance.

Result

The Health Log Analytics application is installed and provisioned on your instance.

What to do next

• Set up the data input process for Health Log Analytics
• (Optional) Install the ServiceNow® Agent Client Collector Log Analytics (ACC-L) plugin.

  Agent Client Collector Log Analytics enables you to stream log data from Linux and Windows hosts to a ServiceNow instance using the Agent Client Collector. For more information, see the Agent Client Collector Log Analytics documentation.