Skip to content
Set up integrations from Integrations Launchpad › Set up HLA on your instance › Configuring › Health Log Analytics › ITOM AIOps › IT Operations Management
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Set up an ACC Log Analytics integration for Health Log Analytics

Set up an ACC Log Analytics (ACC-L) integration for streaming log messages to your ServiceNow instance. This integration can be used when agent-less log collection is impractical, for example because of security requirements or host accessibility.

Before you begin

  • Verify you're using the latest release version of the Health Log Analytics plugin to enable ACC Log Analytics integration setupfrom the Integrations Launchpad.
  • Verify that a MID Server is installed and configured. For more information, see MID Server system requirements.
  • The MID Server must support the Agent Client Collector Listener. The ACC Listener can be enabled during ACC Log Analytics integration setup from the Integrations Launchpad.
  • The Agent Client Collector Log Analytics application has a dependency on the following ServiceNow applications, available from the ServiceNow Store:
    • Health Log Analytics, Version 22.0.12 - December 2021 and later releases.
    • Agent Client Collector - Framework, Version 2.7.0 - December 2021 and later releases.

Important: Health Log Analytics does not support IPv6. To work with the application, configure the MID Server to IPv4.

Note: Currently, this setup only supports basic authentication with the MID Server. mTLS is not supported.

Role required: evt_mgmt_admin

About this task

Set up an integration from the Integrations Launchpad in Service Operations Workspace, which you access from the ITOM AIOps configuration center. The AIOps configuration center is a centralized workspace for configuring and managing AIOps features from a single place. The integrations setup process reduces implementation time compared to manual data input setup in the classic interface in Health Log Analytics. For more information, see Integrations Launchpad in Service Operations Workspace for ITOM.

Procedure

  1. Navigate to Workspaces > Service Operations Workspace.

  2. From the bottom of the navigation pane, select the AIOps configuration center icon

Image omitted: icon-itom-aiops-config.png
ITOM AIOps configuration center icon.
The ITOM AIOps configuration center page appears. The configuration center is a centralized workspace. Use it to configure and manage AIOps features from a single place.

  1. From the Integrate section, under Integrations, select Add integration.

    The Integrations Launchpad appears.

  2. In the Browse integrations tab, search for Agent Log Analytics.

  3. Select the Agent Log Analytics integration tile.

    Note: If you start an integration setup before meeting all prerequisites, a message appears. You can cancel the setup and complete the prior requirements first. Alternatively, you can continue in draft mode and complete the requirements later. Note that you can't activate the integration until you have completed all the prerequisites.

  4. On the Provide details form, complete the fields.

    For a description of the fields, see the Provide details table in ACC Log Analytics (ACC-L) integration configuration fields.

  5. Select Advanced settings and complete the advanced configuration fields.

    For a description of the fields, see the Advanced settings table in ACC Log Analytics (ACC-L) integration configuration fields.

  6. Select Next to save your settings and proceed to the Setup instructions tab.

  7. Enable Agent Client Collector Log Analytics to stream logs from your IT infrastructure to Health Log Analytics by creating log collection policies for your configuration items (CIs).

    For more information, see Create an Agent Client Collector log policy.

  8. Do one of the following:

    • If you completed all the prerequisites before starting the configuration, select Activate.

      The integration is activated and the Overview tab is displayed. On the Integrations Launchpad, the integration tile is available in the Installed integrations tab.

    • If you didn't complete all the prerequisites, select Save draft.

      The system saves the integration as a draft in the Integrations Launchpad. It appears in the Installed integrations tab, under Waiting for your action. You can complete the prerequisites and activate the integration later. For more information, see Activate a draft integration in Health Log Analytics.

What to do next

On the Overview tab, do the following:

Image omitted: more-options.png
More options menu icon.\) to open the **Data Input Mapping**, **Source Type Structures**, or **Log Sources** pages with context from the integration. If your log data is not properly mapped, structured, or sourced, go back and adjust the configuration. If the Service Operations Workspace Log Analytics application is installed, the More options menu also provides direct access to the **Log Viewer**. Use the **Log Viewer** to review raw log messages ingested by the integration. For more information, see:
-   [Log data auto-mapping and mapping](hla-data-input-automapping.md)
-   [Source type structure adjustment](hla-source-type-structure-adjustment.md)
-   [Review alert logs on the Log viewer](hla-op-logs-log-viewer-concept-sow.md)

Parent Topic:Set up Health Log Analytics on your ServiceNow instance