Splunk TCP integration configuration fields

  • Release version: Australia
  • Updated March 12, 2026
  • 3 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 Splunk TCP Integration Configuration Fields

    The Splunk TCP integration configuration fields facilitate the setup of log data ingestion from Splunk into Health Log Analytics (HLA). This configuration is essential for ensuring that log data is processed correctly and securely, enabling efficient monitoring and analysis of system performance.

    Show full answer Show less

    Key Features

    • Integration Name: A unique identifier for the integration, which auto-adjusts the generic name on the form.
    • MID Server Name: Selects the appropriate MID Server for log data transfer, which must support basic authentication.
    • Port: Specifies the port for the MID Server, requiring security clearance from your organization’s team.
    • Transport: The protocol used is TCP, which is read-only.
    • Use Cooked Data: Enables ingestion of preprocessed data from Splunk, maintaining contextual integrity.

    Advanced Settings

    • Use SSL/TLS: Enhances data security; required for compressed log transmission.
    • Lookup Hostnames: Allows DNS resolution of IPs to hostnames, defaulting to false.
    • Use Forwarder TimeZone: Adjusts log timing based on the forwarder's time zone when using cooked data.
    • Enable Compression: Minimizes data size during transfer, applicable with cooked data and SSL/TLS.
    • Sub Sample Drop Ratio: Configures the rate of logs dropped, defaulting to no drops (-1).
    • Sub Sample Receive Ratio: Sets the receiving rate of logs, also defaulting to no limits (-1).
    • Max Length in Bytes: Limits log message size, defaulting to 32766 bytes.
    • Character Encoding: Default is UTF-8, ensuring compatibility with text data.
    • Boss Thread Count: Manages connection threads.
    • Worker Thread Count: Handles incoming data threads.
    • Read Timeout Seconds: Closes the channel after a specified timeout period.
    • Default Timezone: Sets timezone for unspecified log events, defaulting to GMT.
    • Drop If Queue is Full: Option to discard logs when the MID Server is overloaded.

    Key Outcomes

    By configuring these fields, ServiceNow customers can ensure effective and secure log ingestion from Splunk, enabling better monitoring and analytics capabilities within Health Log Analytics. Proper configuration can lead to improved performance, reduced data transfer size, and enhanced data integrity. Customers should follow these guidelines to optimize their integration setup and maintain operational efficiency.

    Description of the fields on the Splunk TCP integration configuration forms for Health Log Analytics.

    For the Splunk TCP integration setup procedure, see Set up a Splunk TCP integration for Health Log Analytics.

    Table 1. Provide details
    Field Description
    Integration Name Unique name of this integration. For example: My Splunk TCP integration. This field is required.
    Note:
    When you fill in this field, the generic name displayed on the form adjusts automatically to match the name you entered.
    MID server name MID Server to which log data from Splunk is pulled. This field is required.
    Note:
    • You can select only MID Servers that support basic authentication. MID Servers that support mTLS are not listed.
    • The default maximum number of data inputs streaming logs to a single MID Server is 10. You can modify this number in the MID Server properties.
    • If log ingestion is not enabled for the selected MID Server, Health Log Analytics enables it automatically.
    Port The port for the MID Server. This field is required.

    Make sure that your organization’s security team opens the selected port on the MID Server.
    Description Option to add a brief description of the integration to help identify it.
    Transport The protocol used for streaming log messages to your ServiceNow instance: TCP. This field is read-only.
    Use Cooked Data Option to ingest log data from Splunk in the preprocessed ("cooked") format that Splunk uses on the forwarder.

    Ingesting data into HLA in this format ensures that each log line retains the relevant contextual information that Splunk embeds into it.
    Table 2. Advanced settings
    Field Description
    Use SSL/TLS Option to use SSL/TLS, for enhanced data security and protection.
    Note:
    SSL/TLS must be enabled if you want to send logs in a compressed format.
    Lookup hostnames Option to perform DNS lookup to resolve IPs to hostnames. The default value is false.
    Use Forwarder TimeZone Option to pass information about the time zone in which the forwarder is located.

    The MID Server uses this information to adjust for the time zone from which the logs arrive.

    This option is displayed when Use Cooked Data is selected. It is relevant when using Splunk Universal Forwarders.
    Enable Compression Option to send logs in compressed format.

    Sending logs in a compressed format minimizes the size of the data being transferred, which is important when dealing with large volumes of log data.

    This option is displayed when Use Cooked Data and Use SSL/TLS are selected. It is relevant when using Splunk Universal Forwarders.
    Sub sample drop ratio The ratio of logs to drop. The default value is -1: no logs are dropped.

    For example: If you want one out of every five logs to be dropped, change the value to 5.
    Sub sample receive ratio The ratio of logs to receive. The default value is -1: no logs are received.

    For example: If you want one out of every five logs to be received, change the value to 5.
    Max length in bytes The maximum length of log messages in bytes. The default value is 32766.
    Character encoding The character encoding for this data input. Default is UTF-8.
    Boss thread count The number of threads that manage connections.
    Worker thread count The number of threads that handle incoming data.
    Read timeout seconds The timeout in seconds since the last read. When the timeout expires, the system closes the channel.
    Default timezone The time zone of events that the system will use if a log does not specify the time zone.

    By default, the system uses GMT in such cases, but you can specify a different time zone.
    Drop if queue is full Option to discard logs if there is a load on the MID Server.