Configure Additional Destinations for Telemetry data¶
Introduction¶
OpenTelemetry (OTEL) allows exporting telemetry data — Metrics, Logs, and Traces — to remote backends like Prometheus, Loki, and Tempo.
This guide explains how to configure custom export targets in the vars.monitoring.custom.targets.yml
file within the Privacera monitoring stack.
Warning
Custom TLS certificates are currently not supported. Only use http
or https
endpoints that do not require custom certificate validation
Note
You can define multiple custom endpoints for each data category. However, each endpoint must have a unique name.
Exporting Metrics (Only for Prometheus-Compatible Datasources)¶
Procedure¶
-
SSH into the instance where Privacera Manager is installed.
-
Navigate to the configuration directory:
Bash -
Copy the monitoring vars file if not already copied:
If this file already exists in
custom-vars
folder then you can skip this step.Bash -
Open the configuration file:
Bash -
Uncomment and configure the
OTEL_METRICS_EXPORT_TARGETS
block: -
Save the file and exit the editor.
Supported Properties¶
Property | Description |
---|---|
endpoint | Remote write URL |
resource_to_telemetry_conversion_enabled | Converts resource info into telemetry metadata |
remote_write_queue_enabled | Enables queueing for remote write |
remote_write_queue_size | Size of the write queue |
max_batch_size | Max size per batch in bytes |
timeout | Timeout duration (e.g., 30s ) |
Exporting Logs (for Loki-Compatible Data Sources)¶
Prerequisite¶
Note
Log export is supported only if Loki is enabled. Ensure Loki is configured and running by following the Loki Enablement Guide
Procedure¶
-
Open the same configuration file:
Bash -
Uncomment and configure the
OTEL_LOGS_EXPORT_TARGETS
block: -
Save and exit the file.
Supported Properties¶
Property | Description |
---|---|
endpoint | URL to push logs to Loki |
Exporting Traces (Compatible with Tempo Trace Format)¶
Prerequisite¶
Note
Traces export is supported only if Tempo is enabled. Ensure Tempo is configured and running by following the Tempo Enablement Guide
Important
gRPC-based endpoints are currently not supported. Use OTLP over HTTP (http://
or https://
) for successful trace export
Procedure¶
-
Open the same configuration file:
Bash -
Uncomment and configure the
OTEL_TRACES_EXPORT_TARGETS
block: -
Save and exit the file.
Supported Properties¶
Property | Description |
---|---|
endpoint | http endpoint for Tempo traces |
Redeploy Monitoring Components¶
Once you've added all desired custom endpoints in vars.monitoring.custom.targets.yml
, apply the configuration by redeploying the monitoring stack:
a. Go to privacera-manager
directory.
Bash | |
---|---|
setup
to generate the required files. Bash | |
---|---|
Bash | |
---|---|
post-install
. Bash | |
---|---|
Troubleshooting¶
If telemetry data is not exporting as expected, check the following:
-
Endpoint Accessibility: Ensure all configured endpoint URLs are reachable from within the OTEL Receiver, Scraper, or Agent pod/container.
-
Unique Target Names:Confirm that each export target has a unique name to avoid conflicts.
-
YAML Syntax: Validate the YAML file for correct indentation and syntax. Improper formatting can prevent configuration from loading.
-
Check Logs: Review the logs of the OTEL Receiver, Scraper, or Agent for any error messages related to export failures.
Summary¶
By enabling and configuring custom export targets for Metrics, Logs, and Traces, you can forward telemetry data to any supported remote backend system without changing the core OTEL configuration — just update the vars.monitoring.custom.targets.yml
file.