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

${ELASTIC_PORT}

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.