Export Platform Metrics
Self-hosted Palette can export a curated set of platform metrics to your existing observability stack using an OpenTelemetry collector. You configure and manage the export from the Metrics tab under Administration in the system console, without deploying a customer-managed agent.
Export is available for Helm-based self-hosted installations, and works in both connected and airgapped environments as long as the destination endpoint is reachable.
The export sends metrics only. It never exports logs, traces, or audit events, and Palette adds no dashboards or alerts on top of what you export. Workload cluster observability is configured per cluster, not from the system console.
The Splunk HTTP Event Collector (HEC) is the supported export destination.
Prerequisites
-
The observability stack must be installed before you can configure export. Set
observability.enabledtotruein yourvalues.yamlfile at install or upgrade time. This value isfalseby default.observability:
enabled: true # false by defaultUntil the observability stack is installed, the Metrics tab shows a Metrics observability is not installed on this cluster warning, the export control reads Export unavailable, and export settings stay read-only. Install or upgrade with the stack enabled before you configure export.
-
A reachable Splunk Cloud Platform or Splunk Enterprise HTTP Event Collector (HEC) endpoint.
-
A Splunk HEC token.
-
A metrics index and an events index that already exist in Splunk. Splunk HEC separates metric-format records from event-format records, so the export requires both a Metrics index and an Events index, and the HEC token must have access to each.
-
Access to the Palette system console.
Configure Export to Splunk
When you configure export to Splunk, you provide the connection details described in the following table.
| Field | Required | Description |
|---|---|---|
| Destination | Yes | The export target. Select Splunk to use the Splunk HEC exporter, which sends metrics to a single Splunk HEC endpoint that you provide. |
| HEC endpoint | Yes | The Splunk HTTP Event Collector (HEC) URL, for example https://splunk.example.com:8088. Provide only the endpoint address, with no collector or receiver path. |
| Metrics index | Yes | The Splunk index for metric-format records. The index must already exist in Splunk, and the HEC token must have access to it. |
| Events index | Yes | The Splunk index for event-format records. The index must already exist in Splunk, and the HEC token must have access to it. |
| HEC token | Yes | The Splunk HEC authentication token. Stored encrypted and never shown again after you save. |
| Source | No | An optional Splunk source value used to tag exported data. |
| Certificate trust | No | Under Transport. Verification is always on. Keep the default System trust store when Splunk presents a publicly trusted certificate. Pin a private CA for a self-signed or internal certificate, common on air-gapped sites. |
Take the following steps to configure export to Splunk.
-
Log in to the Palette system console.
-
Select Administration, and then select the Metrics tab.
-
In the Export section, turn on the toggle. The off state reads Export is off.
-
From the Destination drop-down menu, select Splunk.
-
Provide the connection details described in the table above.
-
Select Test connection to send a single test metric to Splunk, and then select Save changes.
After you save, the section header changes to Exporting to Splunk HEC with a Connected status, and metrics begin forwarding to your destination. To change the settings later, select Edit configuration.
Validate
After you save the configuration, export starts automatically within a few seconds. No restart is required.
To confirm that the export is working, search the metrics index you configured in Splunk and verify that metric data points are arriving. On the Metrics tab, the Export section also shows a Connected status when the connection is healthy.
Pause Export
To pause export, disable the Export toggle on the Metrics tab. Your Splunk settings are retained, so when you enable the toggle again, export resumes immediately without re-entering the connection details.
Exported Metrics
Self-hosted Palette collects platform metrics through OpenTelemetry receivers and exports them to your Splunk destination. The exported set comes from the following receivers. Refer to each receiver's upstream documentation for the complete list of metrics it produces.
-
Host Metrics receiver: host-level CPU, memory, disk, filesystem, and network metrics.
-
Kubelet Stats receiver: node, pod, and container resource metrics reported by the kubelet.
-
Kubernetes Cluster receiver: cluster-level metrics for Kubernetes objects and resources.
-
MongoDB receiver: health and performance metrics for the Palette MongoDB database.
Uninstall the Observability Stack
To remove the observability stack, set observability.enabled to false and upgrade the environment.
observability:
enabled: false
When the observability stack is not installed, the backend APIs that support export return an error, and the Metrics tab is read-only.