Configure a Cribl data input in Health Log Analytics

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture
  • Configure a dedicated Cribl data input to enable Health Log Analytics to process Cribl log messages streaming into your ServiceNow instance.

    Avant de commencer

    • Verify that a MID Server is installed and configured with the Log Ingestion capability enabled. For more information, see MID Server system requirements.

      MID Server configuration with Log Ingestion capability enabled.

      Important :
      Health Log Analytics does not support IPv6. To work with the application, configure the MID Server to IPv4.
    • Unless the MID Server and external clients are on the same network, the MID Server must have a public IP address. This is required when its IP is exposed through network address translation (NAT), a load balancer, or a similar device. The public IP address enables external clients, such as Filebeat agents located outside its network, to reach the MID Server. Private IP addresses are not routable over the internet. Without a public IP, external clients cannot connect to the MID Server even if they are configured with its address. In the MID Server properties, add a property named mid.public_ip with the public IP address as the value. For more information, see Create a MID Server property. If the MID Server and external clients are on the same network, connections can be made using the private IP address.

    Role required: evt_mgmt_admin

    Pourquoi et quand exécuter cette tâche

    If your organization uses Cribl for filtering and routing large volumes of log data from various sources, the log format Health Log Analytics receives is distinct from other types. The Cribl data input enables HLA to detect and separate transport headers from inner log messages in this format, forwarding only the inner message to the source type structure for processing.

    Procédure

    1. Navigate to All > Health Log Analytics > Data Input > Data Inputs.
    2. On the Data Inputs page, select New.
    3. Choose the Cribl data input.
    4. On the Getting Started tab, fill in the form fields and then select Next.
      For a description of the fields, see Cribl data input configuration fields.
    5. On the Config tab, fill in the form fields and then select Next.
      For a description of the fields, see Cribl data input configuration fields.
    6. On the Process tab, select the required route and then select Next.
      For more information, see Cribl data input configuration fields.
      Remarque :
      For troubleshooting issues related to this step, see the Cribl - Setting up Cribl data input | Troubleshooting setup & data ingestion issues [KB0558611] article in the Now Support Knowledge Base.
      The Finish tab opens.
    7. On the Cribl instance, verify that the configuration of the data input is correct.
      You can use the Cribl commands displayed on the Finish tab as needed.
    8. When the configuration is correct, return to the data input configuration Finish tab and select Publish to publish the data input.

    Résultats

    The data input configuration process is complete. The data input starts streaming log data to your ServiceNow instance.

    For resolving issues related to the ingestion of log data from Cribl, see the Cribl - Setting up Cribl data input | Troubleshooting setup & data ingestion issues [KB0558611] article in the Now Support Knowledge Base.

    Remarque :
    If the HLA engine is down and data has stopped streaming, a notification appears at the top of the data input configuration page. When this happens, contact ServiceNow support.

    Que faire ensuite

    Make sure that the data input is streaming data.