{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":30748,"path":"it-operations-management/health-log-analytics/hla-data-input-rest-api.md","title":"Configure a REST API data input in Health Log Analytics manually","bundle":null,"doc_type":null,"release":"australia","body":"\n# Configure a REST API data input in Health Log Analytics manually\n\nSet up a REST API data input for streaming log data to your ServiceNow instance.\n\n## Before you begin\n\n-   Verify that a MID Server is installed and configured with the Log Ingestion capability enabled. For more information, see [MID Server system requirements](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/servicenow-platform/r_MIDServerSystemRequirements.md).\n\n    \\[Omitted image \"hla-mid-log-ingestion.png\"\\] Alt text: MID Server configuration with Log Ingestion capability enabled.\n\n    **Important:** Health Log Analytics does not support IPv6. To work with the application, configure the MID Server to IPv4.\n\n    On the MID Web Server Context form, in the **Execute on** field, select Specific MID Server and not the cluster option. In the **MID Server** field, select the specific MID Server to which the log data is pulled.\n\n-   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 aren't routable over the internet. Without a public IP, external clients can't 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://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/servicenow-platform/r_MIDServerProperties.md). If the MID Server and external clients are on the same network, connections can be made using the private IP address.\n\nRole required: evt\\_mgmt\\_admin\n\n## Procedure\n\n1.  Navigate to **All** > **Health Log Analytics** > **Data Input** > **Data Inputs**.\n\n2.  On the Data Inputs page, select **New**.\n\n3.  Choose the REST API data input.\n\n4.  On the form, fill in the fields.\n\n    For a description of the fields, see [REST API data input configuration fields](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/health-log-analytics/hla-data-input-rest-api-ref.md).\n\n5.  Select **Save**.\n\n    -   Health Log Analytics adds the data input record to the **Data Inputs** table.\n    -   The system automatically generates the REST API data input URL for sending logs to the MID Server. The generated URL will be in this format: `http://(MID_SERVER_IP):(MID_WEB_SERVER_PORT)/ap1/mid/hla/raw`. HLA replaces `(MID_SERVER_IP)` and `(MID_WEB_SERVER_PORT)` with the values you configured.\n6.  Copy the generated URL.\n\n7.  Instruct your API client to send log messages to the MID Server.\n\n    1.  In the API client, configure a request with the following parameters:\n\n        -   HTTP Method: POST.\n        -   URL: The URL you copied in the previous step.\n        -   Authentication: The required authentication credentials. For example, Basic authentication \\(username and password\\).\n\n            **Note:** The authentication method must be the same as the method configured on the MID Web Server.\n\n        -   Headers: Set the `Content-Type` header to match your payload format.\n            -   For JSON: `application/json`.\n            -   For raw text: `text/plain`.\n        -   Body: The logs payload in JSON or raw text.\n    2.  Send the request.\n\n        A successful response indicates that the MID Server has received the payload. When the MID Server has processed the log messages, the data input streams them to your ServiceNow instance using the REST protocol.\n\n\n**Parent Topic:**[Configuring data inputs for Health Log Analytics manually](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/health-log-analytics/hla-data-inputs-configuring.md)\n\n"}}