---
sourceDocument: Yokohama IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/it-operations-management

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Configure Vector Agent data inputs

# Configure Vector Agent data inputs {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

Configure a Vector Agent data input to enable Health Log Analytics to process log messages that are streaming into your ServiceNow instance via a Vector Agent.

## Before you begin

* Verify that a MID Server is installed and configured with the Log Ingestion capability enabled. For more information, see [MID Server system requirements](https://www.servicenow.com/docs/access?context=r_MIDServerSystemRequirements&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).

  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](https://www.servicenow.com/docs/access?context=r_MIDServerProperties&version=yokohama&pubname=yokohama-servicenow-platform&section=t_SetMIDServerProperties&ft:locale=en-US). If the MID Server and external clients are on the same network, connections can be made using the private IP address.

{#hla-data-input-vector-agent__ul_xyp_q3q_12c}  
* Ensure that you have a `vector.yaml` file on your system, or create one.
{#hla-data-input-vector-agent__ul_qms_j3q_12c}

Role required: evt_mgmt_admin

## About this task

If your organization uses Vector by Datadog to handle log data from multiple sources before sending it to HLA, the log format HLA receives is distinct from other types. The Vector Agent 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.

## Procedure

1. Navigate to AllHealth Log AnalyticsData InputData Inputs.
2. On the Data Inputs page, select New.
3. Choose Vector - Stream logs from Vector Agent.
4. On the Getting Started tab, fill in the form and then select Next.  
   For a detailed description of the fields, see [Vector Agent data input configuration fields](https://servicenow-prod.fluidtopics.net/bSbP4x4tFpm2mMGJzj97CQ "Description of the fields on the Vector Agent data input configuration form.").
5. On the vector.yaml tab, update the code with the relevant values as needed.  
   For example, you can specify the sources or source file from which the logs will be streamed.  
   Note:  
   Code that you should not modify is preceded by a commented note.

   For more information, consult [the Vector documentation](https://vector.dev/docs/).
6. Copy the updated code and paste it into the `vector.yaml` file on your system.
7. Select Next.  
   The Finish tab displays a message confirming that the data input configuration process is complete.
8. Start streaming log data by running Vector with the configuration file.  
   Run the following command:`vector --config /path/to/your/vector.yaml`, where `/path/to/your/` is the actual path to your YAML file.
9. **Optional:** Use the other commands displayed on the Finish tab as needed.
10. Select Save to save the data input.

## Result

Health Log Analytics adds the data input record to the Data Inputs table. The data input starts streaming log data to your ServiceNow instance.  
Note:  
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.

## What to do next

[Make sure that the data input is streaming data.](https://servicenow-prod.fluidtopics.net/xKLHpaqO7y8J5FCQaVbyMw "Identify and address log streaming issues to ensure that the data inputs you have configured for Health Log Analytics are streaming data properly to your ServiceNow instance.")

*[\>]: and then