C/C++ Profiling¶

At present, DataKit supports one way to collect C/C + + profiling data, namely Pyroscope.

Pyroscope¶

Pyroscope is an open source continuous profiling platform, and DataKit already supports displaying its reported profiling data in Guance。

Pyroscope uses C/S architecture, and its running modes are divided into Pyroscope Agent and Pyroscope Server, which are integrated in a binary file and displayed by different command line commands.

What you need here is the Pyroscope Agent pattern. DataKit has integrated the Pyroscope Server functionality and can receive profiling data reported by the Pyroscope Agent by exposing the HTTP interface to the outside world.

profiling data flow: Pyroscope Agent collects profiling data -> Datakit -> Guance。

Preconditions¶

1. According to Pyroscope official document eBPF Profiling, Linux kernel version is required >= 4.9 (due to BPF_PROG_TYPE_PERF_EVENT).

2. DataKit is installed and the profile collector is turned on with the following configuration references:

[[inputs.profile]]
  ## profile Agent endpoints register by version respectively.
  ## Endpoints can be skipped listen by remove them from the list.
  ## Default value set as below. DO NOT MODIFY THESE ENDPOINTS if not necessary.
  endpoints = ["/profiling/v1/input"]

  ## set true to enable election.
  election = true

  #  config
  [[inputs.profile.pyroscope]]
  # listen url
  url = "0.0.0.0:4040"

  # service name
  service = "pyroscope-demo"

  # app env
  env = "dev"

  # app version
  version = "0.0.0"

  [inputs.profile.pyroscope.tags]
  tag1 = "val1"

1. Install Pyroscope

Take the Linux AMD64 platform as an example:

wget https://dl.pyroscope.io/release/pyroscope-0.36.0-linux-amd64.tar.gz
tar -zxvf pyroscope-0.36.0-linux-amd64.tar.gz

The Pyroscope binary file obtained by the above method can be run directly or placed under PATH.

For additional platforms and architectures, see download address.

Pyroscope Agent Configures eBPF Collection Mode¶

The eBPF mode of the Pyroscope Agent supports profiling collection of C/C + + programs.

1. Set environment variables:

export PYROSCOPE_APPLICATION_NAME='my.ebpf.program{host=server-node-1,region=us-west-1,tag2=val2}'
export PYROSCOPE_SERVER_ADDRESS='http://localhost:4040/' # pyroscope listen url configured by Datakit profile.
export PYROSCOPE_SPY_NAME='ebpfspy'

1. Use different commands depending on the target you want to profile:

• profiling the running program (for example, PID 1000): sudo -E pyroscope connect --pid 1000
• profiling the running specified program (take mongod as an example): sudo -E pyroscope exec mongod
• profiling the entire system: sudo -E pyroscope ebpf

View Profile¶

After running the above profiling command, the Pyroscope Agent starts collecting the specified profiling data and reports the data to Guance. After a few minutes, you can view the corresponding data in Guance hosting application performance monitoring -> Profile.