Endpoints

Throughout LogScale and the documentation the URL endpoint for working with your LogScale instance. The term used is $YOUR_LOGSCALE_URL.

The actual URL you use will depend on the LogScale service you are using.

URL Template Description
${HOST}:${PORT} Standard Endpoint, including UI, REST, GraphQL
${HOST}:${PORT}/api/v1/ingest/humio-structured LogScale structured data ingest endpoint
${HOST}:${PORT}/api/v1/ingest/humio-unstructured LogScale Unstructured data ingest endpoint
${HOST}:${PORT}/api/v1/ingest/raw LogScale 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/otlp OpenTelemetry Endpoint
${HOST}:${PORT}/api/v1/ingest/hec LogScale Event Collector API Endpoint
${HOST}:${PORT}/api/v1/ingest/hec/raw Raw LogScale Event Collector API Endpoint
${HOST}:${PORT}/services/collector LogScale Event Collector API Endpoint
${HOST}:${PORT}/services/collector/raw Raw LogScale Event Collector API Endpoint

Where:

Component Default Description
${HOST} - Hostname or IP address
${PORT} 443 TCP/IP port. For LogScale 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 LogScale Structured data ingest endpoint
cloud.humio.com:443/api/v1/ingest/humio-unstructured LogScale Unstructured data ingest endpoint
cloud.humio.com:443/api/v1/ingest/raw LogScale 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/otlp OpenTelemetry Endpoint
cloud.humio.com:443/api/v1/ingest/hec LogScale Event Collector API Endpoint
cloud.humio.com:443/api/v1/ingest/hec/raw Raw LogScale Event Collector API Endpoint
cloud.humio.com:443/services/collector LogScale Event Collector API Endpoint
cloud.humio.com:443/services/collector/raw Raw LogScale 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 LogScale Structured data ingest endpoint
cloud.us.humio.com:443/api/v1/ingest/humio-unstructured LogScale Unstructured data ingest endpoint
cloud.us.humio.com:443/api/v1/ingest/raw LogScale 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/otlp OpenTelemetry Endpoint
cloud.us.humio.com:443/api/v1/ingest/hec LogScale Event Collector API Endpoint
cloud.us.humio.com:443/api/v1/ingest/hec/raw Raw LogScale Event Collector API Endpoint
cloud.us.humio.com:443/services/collector LogScale Event Collector API Endpoint
cloud.us.humio.com:443/services/collector/raw Raw LogScale Event Collector API Endpoint

LogScale Community Edition (HCE)

LogScale Community Edition Description
cloud.community.humio.com:443 Standard Endpoint, including UI, REST, GraphQL
cloud.community.humio.com:443/api/v1/ingest/humio-structured LogScale Structured data ingest endpoint
cloud.community.humio.com:443/api/v1/ingest/humio-unstructured LogScale Unstructured data ingest endpoint
cloud.community.humio.com:443/api/v1/ingest/raw LogScale 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/otlp OpenTelemetry Endpoint
cloud.community.humio.com:443/api/v1/ingest/hec LogScale Event Collector API Endpoint
cloud.community.humio.com:443/api/v1/ingest/hec/raw Raw LogScale Event Collector API Endpoint
cloud.community.humio.com:443/services/collector LogScale Event Collector API Endpoint
cloud.community.humio.com:443/services/collector/raw Raw LogScale Event Collector API Endpoint

On-Prem/Self-Installed

The exact configuration for self-installed deployments of LogScale will depend on your configuration. The following table outlines the recommended settings, although the precise ports used will depend on your configuration.

Important

Port 8080 should not be used for production deployments. LogScale recommends configuring a load balancer in front of your production cluster.

The load balancer should be configured to:

  • Publish an IP/Virtual IP using TLS communication with a signed certificate

  • Configured to use least-connected round-robin to forward the traffic

On-Prem/Self-Installed Description
instance.domain.example:443 Standard Endpoint, including UI, REST, GraphQL
instance.domain.example:8080/api/v1/ingest/humio-structured LogScale Structured data ingest endpoint
instance.domain.example:8080/api/v1/ingest/humio-unstructured LogScale Unstructured data ingest endpoint
instance.domain.example:8080/api/v1/ingest/raw LogScale Raw data ingest endpoint
instance.domain.example:8080/api/v1/ingest/elastic-bulk Elastic Bulk Endpoint
instance.domain.example:8080/_bulk Elastic Bulk Endpoint
instance.domain.example:9200/ Elastic Bulk Endpoint (by port)
instance.domain.example:8080/api/v1/ingest/otlp OpenTelemetry Endpoint
instance.domain.example:8080/api/v1/ingest/hec LogScale Event Collector API Endpoint
instance.domain.example:8080/api/v1/ingest/hec/raw Raw LogScale Event Collector API Endpoint
instance.domain.example:8080/services/collector LogScale Event Collector API Endpoint
https://instance.domain.example:8080/ Default port before load-balancer configuration