Advanced configuration

edit

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.

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.