# HTTP Check

### Supported Platforms

Bindplane Collector: `v1.40.0`+

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

#### Configuration

<table><thead><tr><th width="128.48046875">Field</th><th>Description</th></tr></thead><tbody><tr><td>Hostname</td><td>Specifies the hostname or IP address of the endpoint you want to check.</td></tr><tr><td>HTTP Port</td><td>Specifies what port to listen on.</td></tr><tr><td>Path</td><td>Specifies a path on the URL to perform the check on.</td></tr><tr><td>Method</td><td>Option to configure the HTTP request method to use on the check.</td></tr><tr><td>Headers</td><td>Option to configure the HTTP request headers to be used on the check.</td></tr><tr><td>Enable TLS</td><td>Option to configure the receiver's HTTP server to use TLS.</td></tr><tr><td>Mutual TLS</td><td>Option to enable TLS mutual authentication.</td></tr><tr><td>Skip TlS Certificate Verification</td><td>Option to skip TLS certificate verification.</td></tr><tr><td>Mutual TLS</td><td>Option to enable TLS mutual authentication.</td></tr><tr><td>TLS Certificate Authority File</td><td>Local path to the TLS certificate authority file.</td></tr><tr><td>TLS Client Certificate File</td><td>Local path to the TLS cert file.</td></tr><tr><td>TLS Client Private Key File</td><td>Local path to the TLS key file.</td></tr><tr><td>Initial Delay</td><td>Specifies how long the source should wait (seconds) before conducting the check.</td></tr><tr><td>Collection Interval</td><td>Specifies how often (seconds) to scrape for metrics.</td></tr></tbody></table>

### Example Configuration

#### Basic Configuration

For basic configuration, only the `hostname` and `port` parameters are needed.

**Web Interface**

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

<figure><img src="/files/vkhUYvdPFZRxvGkIp7aL" alt="Bindplane docs - HTTP Check - image 2"><figcaption></figcaption></figure>

**Standalone Source**

```yaml
apiVersion: bindplane.observiq.com/v1
kind: Source
metadata:
  id: http
  name: http
spec:
  type: http
  parameters:
    - name: hostname
      value: 'localhost'
    - name: port
      value: '8080'
    - name: path
      value: 'metrics'
    - name: method
      value: 'GET'
    - name: enable_tls
      value: 'false'
    - name: initial_delay
      value: '1'
    - name: collection_interval
      value: '60'
```


---

# 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-check.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.
