Configuring Health Log Analytics

  • Release version: Australia
  • Updated March 12, 2026
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Configuring Health Log Analytics

    As a ServiceNow administrator, you are guided through setting up and configuring Health Log Analytics (HLA) to enable operators to efficiently analyze log data and maintain system performance. This involves installing the HLA application, configuring log data inputs, handling log streaming issues, and mapping logs for contextual alerting. Proper configuration ensures Health Log Analytics can process, analyze, and generate meaningful insights from your log data.

    Show full answer Show less

    Key Configuration Tasks

    • Install Health Log Analytics: Request installation from ServiceNow Customer Support to deploy HLA in your instance.
    • Set Up Log Data Inputs: Stream raw log messages into ServiceNow using integrations from the Integrations Launchpad for simplified setup, or alternatively use guided or manual setup within HLA.
    • Configure MID Server Requirements: Ensure MID Server system requirements are met and that the log ingestion capability is enabled for log data ingestion through MID Servers. Consider proxy preconditions when applicable.
    • Resolve Log Streaming Issues: Identify and troubleshoot any streaming problems to confirm data inputs deliver log data correctly.
    • Edit Raw Log Data Before Processing: Modify raw logs prior to MID Server processing to improve data quality and relevance.
    • Map Logs to Service Instances and Components: Associate logs with service entities to enable alert generation with proper context. Automatic mapping can be disabled to allow manual script-based mapping.
    • Refine Source Type Structure: Customize how HLA interprets inner log messages by adjusting extracted properties and reclassifying auto-detected labels to enhance machine learning accuracy.
    • Perform Additional Setup: After mandatory configurations, optional advanced data input configurations and further refinements can be implemented to optimize analytics.

    Administration

    Ongoing administration ensures Health Log Analytics operates efficiently. This includes monitoring performance, maintaining configurations, and addressing any operational challenges to keep the analytics system running smoothly and delivering value.

    As an administrator, set up and configure Health Log Analytics for operators to use, and carry out administration tasks to confirm that the system runs efficiently.

    Configuration overview

    Complete the following tasks for a successful setup and configuration of Health Log Analytics.

    Important:
    Regardless of how you implement Health Log Analytics, for log data ingestion via a MID Server you must first configure MID Server system requirements and ensure that the MID Server log ingestion capability is enabled.

    For MID Server proxy requirements, see MID Server proxy preconditions for streaming logs to Health Log Analytics.

    Setup and configuration tasks:

    1. Install Health Log Analytics (HLA).

      Install the Health Log Analytics application.

    2. Set up log data inputs for streaming raw log messages from external sources into your ServiceNow instance.
      You're encouraged to integrate data inputs with Health Log Analytics from the Integrations Launchpad. This tool provides a unified interface for convenient integration setup:
    3. Identify and resolve a log streaming issue in Health Log Analytics.

      Identify and address log streaming issues to confirm that the data inputs you have configured are streaming data properly to your instance.

    4. Edit raw log data before processing in Health Log Analytics.

      Modify raw log messages before they are processed in the MID Server, and therefore before Health Log Analytics maps and structures it.

    5. Map your logs to service instances and components for log context.

      Map your logs to service instances and components so that Health Log Analytics can generate alerts in context.

      If you turn off automatic mapping, you must define a mapping script manually in the Data Input Mapping page. For more information, see Map raw log data in Health Log Analytics.

    6. Refine the source type structure in Health Log Analytics.

      Fine-tune how Health Log Analytics reads your inner log messages and detects anomalies by customizing the extracted properties in the source type structure.

      Health Log Analytics enables you to reclassify auto-classified properties and change auto-mapped labels. These adjustments help the system's machine learning better understand your priorities.

    7. Perform additional data input setup tasks.

      After performing the mandatory data input setup and configuration, you can continue with optional setup tasks.

    8. Perform advanced data input configuration tasks.

    For a brief explanation of key terms and concepts used in HLA, see the Health Log Analytics terminology.