Advanced configuration for Elastic Universal Profiling
Elastic Cloud Serverless projects are autoscaled environments, fully managed by Elastic and available on Elastic Cloud. Availability This functionality is not available in Elastic Cloud Serverless. The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats. Availability This functionality is generally available and ready for production usage. Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments. This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.
Serverless
Unavailable
Unavailable
Stack
Generally available
After completing the steps in the Get started documentation, you may need to continue to more advanced configuration for your deployment. See the following sections for more information:
- Tag data for querying: Tag data collected by the Universal Profiling Agent into multiple logical groups so they can be queried in Kibana.
- Add symbols for native frames: Push symbols to your cluster so you can see function names and line numbers in traces of applications written in programming languages that compile to native code (C, C++, Rust, Go, etc.).
- Use a proxy: Set up an HTTP proxy if your infrastructure Universal Profiling Agent installation needs one to reach Elastic Cloud.
- Override kernel version check : Configure the Universal Profiling Agent to bypass the kernel version compatibility check.
- Environment variables for the Universal Profiling Agent : Configure the Universal Profiling Agent using the environment.
Command line arguments to the Universal Profiling Agent take precedence over environment variables, and environment variables take precedence over the configuration file.
The Universal Profiling Agent accepts the following CLI arguments:
| CLI argument | Type | Example | Description |
|---|---|---|---|
-v |
bool |
-v |
Run the Universal Profiling Agent in verbose mode. |
-no-kernel-version-check |
bool |
-no-kernel-version-check |
Disable the kernel version check. See Override kernel version check for more details. |
-tags |
string |
-tags='cloud_region:us-central1;env:staging' |
Set specific tags. See Tag data for querying for more details. |
-project-id |
uint |
-project-id 73 |
Splits profiling data into logical groups that you control. You can assign any non-zero, unsigned integer ⇐ 4095. |
-secret-token |
string |
-secret-token=abc123 |
Set the secret token for communicating with the Universal Profiling Collector to abc123. |
-collection-agent |
string |
-collection-agent=example.com:443 |
Set the destination for reporting profiling information to example.com:443. |
-probabilistic-interval |
duration |
-probabilistic-interval=2m30s |
Set the probabilistic interval to 2m30s. See Probabilistic profiling for more details. |
-probabilistic-threshold |
uint |
-probabilistic-threshold=50 |
Set the probabilistic threshold to 50. See Probabilistic profiling for more details. |
-config |
string |
-config=/etc/Elastic/universal-profiling/pf-host-agent.conf |
Set the path for the configuration file of the Universal Profiling Agent. See Configuration file of the Universal Profiling Agent for more details. |