Endpoints
Throughout Humio and the documentation the URL endpoint for working with
your Humio instance. The term used is $YOUR_HUMIO_URL
The actual URL you use will depend on the Humio service you are using.
| URL Template | Description |
|---|---|
${HOST}:${PORT}
| Standard Endpoint, including UI, REST, GraphQL |
${HOST}:${PORT}/api/v1/ingest/humio-structured
| Humio structured data ingest endpoint |
${HOST}:${PORT}/api/v1/ingest/humio-unstructured
| Humio Unstructured data ingest endpoint |
${HOST}:${PORT}/api/v1/ingest/raw
| Humio Raw data ingest endpoint |
${HOST}:${PORT}/api/v1/ingest/elastic-bulk
| Elastic Bulk Endpoint |
${HOST}:${PORT}/_bulk
| Elastic Bulk Endpoint |
${HOST}:${ELASTIC_PORT}/
| Elastic Bulk Endpoint (by port) |
${HOST}:${PORT}/api/v1/ingest/hec
| Humio Event Collector API Endpoint |
${HOST}:${PORT}/api/v1/ingest/hec/raw
| Raw Humio Event Collector API Endpoint |
${HOST}:${PORT}/services/collector
| Humio Event Collector API Endpoint |
${HOST}:${PORT}/services/collector/raw
| Raw Humio Event Collector API Endpoint |
Where:
| Component | Default | Description |
|---|---|---|
${HOST}
| - | Hostname or IP address |
${PORT}
| 443 | TCP/IP port. For Humio cloud deployments, SSL/TLS is enabled and 443 is the default |
|
| 9200 Port 9200 is provided for compatibility with applications supporting Elastic protocol that cannot change their port configuration |
EU Cloud Endpoints
| EU Cloud | Description |
|---|---|
cloud.humio.com:443
| Standard Endpoint, including UI, REST, GraphQL |
cloud.humio.com:443/api/v1/ingest/humio-structured
| Humio Structured data ingest endpoint |
cloud.humio.com:443/api/v1/ingest/humio-unstructured
| Humio Unstructured data ingest endpoint |
cloud.humio.com:443/api/v1/ingest/raw
| Humio Raw data ingest endpoint |
cloud.humio.com:443/api/v1/ingest/elastic-bulk
| Elastic Bulk Endpoint |
cloud.humio.com:443/_bulk
| Elastic Bulk Endpoint |
cloud.humio.com:9200/
| Elastic Bulk Endpoint (by port) |
cloud.humio.com:443/api/v1/ingest/hec
| Humio Event Collector API Endpoint |
cloud.humio.com:443/api/v1/ingest/hec/raw
| Raw Humio Event Collector API Endpoint |
cloud.humio.com:443/services/collector
| Humio Event Collector API Endpoint |
cloud.humio.com:443/services/collector/raw
| Raw Humio Event Collector API Endpoint |
US Cloud
| US Cloud | Description |
|---|---|
cloud.us.humio.com:443
| Standard Endpoint, including UI, REST, GraphQL |
cloud.us.humio.com:443/api/v1/ingest/humio-structured
| Humio Structured data ingest endpoint |
cloud.us.humio.com:443/api/v1/ingest/humio-unstructured
| Humio Unstructured data ingest endpoint |
cloud.us.humio.com:443/api/v1/ingest/raw
| Humio Raw data ingest endpoint |
cloud.us.humio.com:443/api/v1/ingest/elastic-bulk
| Elastic Bulk Endpoint |
cloud.us.humio.com:443/_bulk
| Elastic Bulk Endpoint |
cloud.us.humio.com:9200/
| Elastic Bulk Endpoint (by port) |
cloud.us.humio.com:443/api/v1/ingest/hec
| Humio Event Collector API Endpoint |
cloud.us.humio.com:443/api/v1/ingest/hec/raw
| Raw Humio Event Collector API Endpoint |
cloud.us.humio.com:443/services/collector
| Humio Event Collector API Endpoint |
cloud.us.humio.com:443/services/collector/raw
| Raw Humio Event Collector API Endpoint |
Humio Community Edition (HCE)
| Humio Community Edition | Description |
|---|---|
cloud.community.humio.com:443
| Standard Endpoint, including UI, REST, GraphQL |
cloud.community.humio.com:443/api/v1/ingest/humio-structured
| Humio Structured data ingest endpoint |
cloud.community.humio.com:443/api/v1/ingest/humio-unstructured
| Humio Unstructured data ingest endpoint |
cloud.community.humio.com:443/api/v1/ingest/raw
| Humio Raw data ingest endpoint |
cloud.community.humio.com:443/api/v1/ingest/elastic-bulk
| Elastic Bulk Endpoint |
cloud.community.humio.com:443/_bulk
| Elastic Bulk Endpoint |
cloud.community.humio.com:9200/
| Elastic Bulk Endpoint (by port) |
cloud.community.humio.com:443/api/v1/ingest/hec
| Humio Event Collector API Endpoint |
cloud.community.humio.com:443/api/v1/ingest/hec/raw
| Raw Humio Event Collector API Endpoint |
cloud.community.humio.com:443/services/collector
| Humio Event Collector API Endpoint |
cloud.community.humio.com:443/services/collector/raw
| Raw Humio Event Collector API Endpoint |
On-Prem/Self-Installed
The exact configuration for self-installed deployments of Humio will depend on your configuration. The following table outlines the recommended settings, although the precise ports used will depend on your configuration.
| On-Prem/Self-Installed | Description |
|---|---|
localhost:443
| Standard Endpoint, including UI, REST, GraphQL |
localhost:443/api/v1/ingest/humio-structured
| Humio Structured data ingest endpoint |
localhost:443/api/v1/ingest/humio-unstructured
| Humio Unstructured data ingest endpoint |
localhost:443/api/v1/ingest/raw
| Humio Raw data ingest endpoint |
localhost:443/api/v1/ingest/elastic-bulk
| Elastic Bulk Endpoint |
localhost:443/_bulk
| Elastic Bulk Endpoint |
localhost:9200/
| Elastic Bulk Endpoint (by port) |
localhost:443/api/v1/ingest/hec
| Humio Event Collector API Endpoint |
localhost:443/api/v1/ingest/hec/raw
| Raw Humio Event Collector API Endpoint |
localhost:443/services/collector
| Humio Event Collector API Endpoint |
https://localhost:8080/
| Default port before load-balancer configuration |
Important
Port 8080 should not be used for production deployments. Humio recommends configuring a load balancer in front of your production cluster.