Configure Profiling

This section explains how to configure Instana AutoProfile™.

Java

Supported JVMs

  • Amazon Corretto
  • Azul Zulu
  • OpenJDK
  • AdoptOpenJDK
  • Oracle HotSpot
  • Sun HotSpot

Supported HotSpot JVM version: 1.8.152 and higher. Supported Operating System: Currently only supported on 64bit Linux.

Configuration

To enable profiling, edit the agent configuration file <agent_install_dir>/etc/instana/configuration.yaml:

com.instana.plugin.profiling.java:
  enabled: true

Additional configuration options

Parameter Description
cpu-sampler-enabled When set to true, enables CPU profiles.
contention-sampler-enabled When set to true, enables contention profiles.

Troubleshooting

  • Cannot load JVM TI agent library: /tmp/libprofsensor-X.X.X-linux-x64-28c63c.so: libc.musl-x86_64.so.1: cannot open shared object file: No such file or directory. For JVMs running in Apline images, the profiler expects musl libc to be available. For cases, where glibc is also installed for compatibility reasons, please make sure the path to the musl versions of the libraries is not overwritten or broken.

Node.js

To enable AutoProfile™, add autoProfile: true option when initializing the collector (or set the environment variable INSTANA_AUTO_PROFILE=true). This feature requires @instana/[email protected] or later and at least Node.js 6.4.0.

require('@instana/collector')({
  autoProfile: true
});

See Node.js Collector Configuration for more information.

Go

To enable AutoProfile™ add EnableAutoProfile: true option to instana.InitSensor(opt) (or set the environment variable INSTANA_AUTO_PROFILE=true for github.com/instana/[email protected] and above). This feature requires Instana sensor to be activated inside the app code. Please refer to the minimal instrumentation guide to learn how this can be done.

See Go Configuration for more information.