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/vi/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

Elastic Port. Port 9200 is provided for compatibility with applications supporting the 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/vi/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/vi/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/vi/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.

Note

Humio recommends using a load-balancer in front of your Humio cluster; use of port 8080 to connect to your instance is not recommended for production deployments.

Humio Community Edition

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/vi/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.