# HTTP Log

### Prerequisites

The log source should be able to send its logs to an endpoint, commonly called "LogPush". The log source should also be able to reach the collector over the network, so any firewall rules must be adjusted to allow TCP and HTTP traffic to flow to the configured IP address and port.

### Request Format

The request body should be JSON for requests made to the HTTP log receiver.

### Supported Platforms

Bindplane Collector: `v1.39.0`+

| Platform | Metrics | Logs | Traces |
| -------- | ------- | ---- | ------ |
| Linux    |         | ✓    |        |
| Windows  |         | ✓    |        |
| macOS    |         | ✓    |        |

#### Configuration

<table data-full-width="false"><thead><tr><th>Field</th><th>Description</th></tr></thead><tbody><tr><td>Listen Address</td><td>Specifies what IP address the receiver should listen on for logs being sent as POST requests.</td></tr><tr><td>HTTP Port</td><td>Specifies what port the receiver should use for listening for logs.</td></tr><tr><td>Path</td><td>Specifies a path the receiver should be listening to for logs. Useful when the log source also sends other data to the endpoint, such as metrics.</td></tr><tr><td>Enable TLS</td><td>Option to configure the receiver's HTTP server to use TLS.</td></tr><tr><td>Cert File Location</td><td>Local path to the TLS cert file.</td></tr><tr><td>Key File Location</td><td>Local path to the TLS key file.</td></tr><tr><td>Raw Logs</td><td>Toggle to not try to parse the sent body of the payload into a structured object and ingest as raw text.</td></tr></tbody></table>

### Example Configuration

#### Basic Configuration

For basic configuration, only the `listen_address` and `http_port` parameters are needed.

**Web Interface**

<figure><img src="/files/VQoA7oaRMvYP6zpgOudE" alt="Bindplane docs - HTTP Log - image 1"><figcaption></figcaption></figure>

**Standalone Source**

```yaml
apiVersion: bindplane.observiq.com/v1
kind: Source
metadata:
  id: http
  name: http
spec:
  type: http
  parameters:
    - name: listen_address
      value: '0.0.0.0'
    - name: http_port
      value: '12345'
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bindplane.com/integrations/sources/http-log.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.