LogScale URLs & Endpoints
Within LogScale and the documentation, we denote the base URL of your
LogScale installation as $YOUR_LOGSCALE_URL
. The tables
below list some commonly used endpoints, primarily for ingest, based on
$YOUR_LOGSCALE_URL
, as well as the URLs of our cloud
environments.
Note
The IP addresses associated with the hostname(s) used to access Logscale are not static and may be subject to change, although changes are infrequent.
Important
For ingest-related endpoints, the $HOST
portion of your
endpoint may include the word ingest
within the hostname. If
the ingest URL is different, the full ingest url will be displayed at the
top of the Ingest tokens page.
URL Template | Description |
---|---|
${HOST}:${PORT}
| Standard UI endpoint. |
${HOST}:${PORT}
| Standard Falcon LogScale Collector endpoint, including when sending LogScale logs to LogScale. |
${HOST}:${PORT}/api/v1/*
| Prefix for REST-based API queries for ingest, searching, lookup, actions, alerts and other APIs. |
${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. |
${HOST}:${PORT}/graphql
| GraphQL endpoint |
The table below explains the placeholders above. Note that
${HOST}:${PORT}
is the equivalent of
$YOUR_LOGSCALE_URL
.
Component | Default | Description |
---|---|---|
${HOST}
| - | The hostname or IP address. |
${PORT}
| 443 | This is the TCP/IP port. For LogScale cloud deployments, SSL/TLS is enabled. |
| 9200 | Port 9200 is provided for compatibility with applications supporting Elastic protocol that cannot change their port configuration. |
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; and
Configured to use least-connected round-robin to forward the traffic.
On-Prem/Self-Installed | Description |
---|---|
instance.domain.example:443
| Standard UI endpoint. |
instance.domain.com:443/api/v1/*
| Prefix for REST-based API queries for ingest, searching, lookup, actions, alerts and other APIs. |
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. |
instance.domain.example:8080/graphql
| GraphQL endpoint. |
https://instance.domain.example:8080/
| Default port before load-balancer configuration. |