Profilerstellung konfigurieren

Online bearbeiten

Sie können „ Instana “ unter AutoProfile™ für die Anwendungen Java, Node.js, Go, Python, Ruby, .NET Core und PHP konfigurieren. In den folgenden Abschnitten erfahren Sie, wie Sie „ AutoProfile “ konfigurieren.

Konfiguration unter Java

Online bearbeiten

Sie können die Profilerstellung für Ihre „ Java “-Anwendung aktivieren oder deaktivieren.

Unterstützte JVMs

Online bearbeiten
  • Unter Linux wird AutoProfile auf virtuellen Maschinen von Java ( JVM ) unterstützt, die auf HotSpot und OpenJ9 basieren.
  • Unter Windows wird AutoProfile auf virtuellen Maschinen von Java ( JVM ) unterstützt, die JFR (JDK Flight Recorder) unterstützen.

HotSpot-based JVMs

Online bearbeiten

Die folgenden Distributionen von HotSpot-based JVM werden ab JVM 1.8.152 und höher unterstützt:

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

OpenJ9-based JVMs

Online bearbeiten

Die folgenden Distributionen von OpenJ9-based JVM werden ab JVM 0.29.0 und höher unterstützt:

  • IBM Semeru

Unterstützte Plattformen

Online bearbeiten

Derzeit wird „ Java “ ( AutoProfile ) auf Linux ( x86_64, arm64, ppc64le und s390x ) sowie auf Windows ( x86_64 ) unterstützt.

Probenahmeverfahren

Online bearbeiten

Java AutoProfile unterstützt zwei Erfassungsmethoden: Async-Profiler (nur Linux ) und JFR ( Windows und Linux ).

Unter Linux ist die Standard-Erfassungsmethode „Async-Profiler“ für JVMs unter HotSpot-based und „JFR“ für JVMs unter OpenJ9-based. Durch Setzen der Umgebungsvariable INSTANA_JFR_ENABLED auf 1 kann die Erfassungsmethode auf Linux von Async-Profiler auf JFR umgestellt werden.

AutoProfile konfigurieren

Online bearbeiten

Um „ AutoProfile™ “ zu aktivieren, fügen Sie die folgenden Einstellungen in die Konfigurationsdatei des Agenten <agent_install_dir>/etc/instana/configuration.yaml ein:

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

Zusätzliche Konfigurationsoptionen

Online bearbeiten

Die folgende Tabelle enthält weitere Konfigurationsoptionen für „ AutoProfile: “

Parameter Beschreibung
cpu-sampler-enabled Wenn er auf true gesetzt wird, werden CPU-Profile aktiviert.
contention-sampler-enabled Wenn er auf true gesetzt wird, werden Konfliktprofile aktiviert.
profiler-frames-enabled Wenn diese Option aktiviert ist true, werden die Methodenaufrufe des Profilers in die Stack-Frames aufgenommen.

Fehlerbehebung bei „ AutoProfile “ auf Java

Online bearbeiten

Problem : Möglicherweise wird die folgende Fehlermeldung angezeigt 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.

Lösung : Bei JVMs, die in „ Alpine “-Images ausgeführt werden, erwartet der Profiler, dass musllibc verfügbar ist. In solchen Fällen, in denen aus Kompatibilitätsgründen glibc ebenfalls installiert ist, stellen Sie sicher, dass der Pfad zu den musl Versionen der Bibliotheken nicht überschrieben oder beschädigt wird.

Konfiguration unter Node.js

Online bearbeiten

Um „ AutoProfile, “ zu aktivieren, setzen Sie die Umgebungsvariable INSTANA_AUTO_PROFILE=true oder fügen Sie autoProfile: true die Option bei der Initialisierung des Collectors hinzu. Sehen Sie sich das folgende Beispiel an:

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

Für diese Funktion ist @instana/collector@1.98.1 oder höher und mindestens Node.js 6.4.0 erforderlich.

Weitere Informationen finden Sie unter „ Node.js -Collector-Konfiguration “.

Konfiguration unter Go

Online bearbeiten

Um „ AutoProfile, “ zu aktivieren, fügen Sie EnableAutoProfile: true die Option zu instana.InitSensor(opt)hinzu oder setzen Sie die Umgebungsvariable INSTANA_AUTO_PROFILE=true für github.com/instana/go-sensor@1.13.2 und spätere Versionen.

Für diese Funktion muss der Sensor „ Instana “ im Anwendungscode aktiviert sein. Weitere Informationen zur Aktivierung des „ Instana “-Sensors für „ AutoProfile, “ finden Sie unter InstanaAutoProfile.

Weitere Informationen finden Sie unter „ Go -Collector-Konfiguration “.

Konfiguration unter Python

Online bearbeiten

Um „ AutoProfile, “ zu aktivieren, setzen Sie die Umgebungsvariable INSTANA_AUTOPROFILE=true.

Für diese Funktion muss der Instana-Python-Sensor im App-Code aktiviert werden. Weitere Informationen zur Aktivierung des „ Instana “-Sensors für „ AutoProfile, “ finden Sie unter „Manuelle Installation “.

Weitere Informationen finden Sie unter „ Python -Konfiguration “.

Konfiguration unter Ruby

Online bearbeiten

Um „ AutoProfile™ “ zu aktivieren, fügen Sie die folgenden Einstellungen in die Konfigurationsdatei des Agenten <agent_install_dir>/etc/instana/configuration.yaml ein:

com.instana.plugin.rubyprofile:
  enabled: true

Sie können „ AutoProfile™ “ auch aktivieren, indem Sie die Umgebungsvariable INSTANA_AUTO_PROFILE auf setzen true.

Weitere Informationen finden Sie unter AutoProfile.

Konfiguration unter .NET Core

Online bearbeiten

Für Nutzer von „.NET “ ist „ AutoProfile™ “ nur für „.NET Core “-Anwendungen verfügbar, die sowohl auf „ Linux “ als auch auf „ Windows “ laufen. Weitere Informationen finden Sie unter „Überwachung“ .NET Core.

Um „ AutoProfile™ “ zu aktivieren, fügen Sie die folgenden Einstellungen in die Konfigurationsdatei des Agenten <agent_install_dir>/etc/instana/configuration.yaml ein:

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

Sie können „ AutoProfile™ “ aktivieren, indem Sie die Umgebungsvariable INSTANA_AUTO_PROFILE auf „true“ setzen. Dies ist ein erforderlicher Schritt für „ Windows “ und ein optionaler Schritt für „ Linux “.

Konfiguration unter .NET Framework

Online bearbeiten

Für Nutzer von „.NET “ steht „ AutoProfile™ “ für „.NET Framework “-Anwendungen zur Verfügung, die unter „.NET Framework “ 4.7.2 oder höher laufen. Weitere Informationen finden Sie unter „Überwachung“ .NET Framework.

Führen Sie die folgenden Schritte aus, um „ AutoProfile™ “ zu aktivieren:

  1. Fügen Sie die folgenden Einstellungen in die Datei Ihres configuration.yml Agenten ein:
    com.instana.plugin.clr:
  profiling:
    enabled: true
```2. Set the environment variable **`INSTANA_AUTO_PROFILE`** to true.

Konfiguration unter PHP

Online bearbeiten

Für Nutzer von „ PHP “ steht „ AutoProfile “ nicht für die serverlose Überwachung zur Verfügung. Weitere Informationen finden Sie unter „Profiling“ PHP.

Um „ AutoProfile™ “ zu aktivieren, setzen Sie die Umgebungsvariable INSTANA_AUTO_PROFILE=true oder fügen Sie die folgenden Einstellungen in die Konfigurationsdatei des Agenten <agent_install_dir>/etc/instana/configuration.yaml ein:

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