プロファイルの構成

Instana ( AutoProfile™ )は、 Java、 Node.js、 Go、 Python、 Ruby、.NET Core、および PHP の各アプリケーションで設定できます。 AutoProfile の設定方法については、以下のセクションを参照してください。

Java での設定

Java アプリケーションのプロファイリングを有効または無効にすることができます。

サポートされる JVM

  • Linux では、 HotSpot および OpenJ9 を基盤とする Java 仮想マシン ( JVM ) 上で、 AutoProfile がサポートされています。
  • Windows では、JFR(JDK Flight Recorder)をサポートする Java 仮想マシン( JVM )上で、 AutoProfile がサポートされています。

HotSpot-based JVM

JVM 1.8.152 以降では、以下の HotSpot-based JVM ディストリビューションがサポートされています:

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

OpenJ9-based JVM

JVM 0.29.0 以降では、以下の OpenJ9-based JVM ディストリビューションがサポートされています:

  • IBM Semeru

対応するプラットフォーム

現在、 Java ( AutoProfile )は、 Linux ( x86_64、 arm64、 ppc64le、および s390x )および Windows ( x86_64 )でサポートされています。

サンプリング方法

Java AutoProfile 2つのサンプリング方式に対応しています:Async-Profiler( Linux のみ)とJFR( Windows および Linux )。

Linux では、デフォルトのサンプリング方式は、 HotSpot-based JVM では Async-Profiler、 OpenJ9-based JVM では JFR となります。 Linux では、環境変数を 1 INSTANA_JFR_ENABLED に設定することで、サンプリング方式を Async-Profiler から JFR に切り替えることができます。

AutoProfile の設定

AutoProfile™ を有効にするには、エージェントの設定ファイルに以下の設定を追加 <agent_install_dir>/etc/instana/configuration.yamlしてください:

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

追加構成オプション

次の表は、 AutoProfile: の追加設定オプションを示しています

パラメーター 説明
cpu-sampler-enabled true に設定すると、CPU プロファイルが有効になります。
contention-sampler-enabled true に設定すると、競合プロファイルが有効になります。
profiler-frames-enabled に設定すると true、スタックフレームにプロファイラのメソッド呼び出しが含まれます。

Java における「 AutoProfile 」のトラブルシューティング

問題 :エラーが表示される場合があります 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

解決策 : Alpine イメージで実行されているJVMの場合、プロファイラは が利用可能であることを libcmusl 想定しています。 互換性の理由で も glibc インストールされているような場合、ライブラリの バージョ musl ンのパスが上書きされたり、破損したりしないように注意してください。

Node.js での設定

AutoProfile, を有効にするには、環境変数を設定 INSTANA_AUTO_PROFILE=true するか、コレクターの初期化時にオプション autoProfile: true を追加してください。 以下の例を参照してください。

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

この機能には、@instana/collector@1.98.1 以降および Node.js 6.4.0 以上が必要です。

詳細については、 「 Node.js のコレクター設定」 を参照してください。

Go での設定

AutoProfile, を有効にするには、 instana.InitSensor(opt)にオプション EnableAutoProfile: true を追加するか、または github.com/instana/go-sensor@1.13.2 バージョン以降では INSTANA_AUTO_PROFILE=true 環境変数を設定してください。

この機能を利用するには、アプリケーションのコード内で Instana センサーを有効にする必要があります。 AutoProfile, 向けに「 Instana 」センサーを有効にする方法の詳細については、 Instana AutoProfile をご覧ください。

詳細については、 「 Go のコレクター設定」 を参照してください。

Python での設定

AutoProfile, を有効にするには、環境変数を設定してください INSTANA_AUTOPROFILE=true

この機能には、Instana Python センサーがアプリケーション・コードの内部でアクティブ化されていることが必要です。 「 AutoProfile, 」で Instana センサーを有効にする方法の詳細については、「 手動インストール」 を参照してください。

詳細については、 「 Python の設定」 を参照してください。

Ruby での設定

AutoProfile™ を有効にするには、エージェントの設定ファイルに以下の設定を追加 <agent_install_dir>/etc/instana/configuration.yamlしてください:

com.instana.plugin.rubyprofile:
  enabled: true
 

また、環境変数を INSTANA_AUTO_PROFILE に設定することで true、 AutoProfile™ を有効にすることもできます。

詳細については、 AutoProfile をご覧ください。

.NET Core での設定

.NET をご利用のお客様の場合、 AutoProfile™ は、 Linux と Windows の両方で動作する.NET Core アプリケーションでのみご利用いただけます。 詳細については、 「.NET Core の監視」 を参照してください。

AutoProfile™ を有効にするには、エージェントの設定ファイルに以下の設定を追加 <agent_install_dir>/etc/instana/configuration.yamlしてください:

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

AutoProfile™ を有効にするには、環境 INSTANA_AUTO_PROFILE 変数をtrueに設定します。これは、 Windows では必須の手順であり、 Linux では代替の手順となります。

.NET Framework での設定

.NET をご利用のお客様は、.NET Framework 4.7.2 以降を実行する .NET Framework アプリケーション向けに、 AutoProfile™ をご利用いただけます。 詳細については、 「.NET Framework の監視」 を参照してください。

AutoProfile™ を有効にするには、以下の手順を実行してください:

  1. エージェントの configuration.yml ファイルに以下の設定を追加してください:
    com.instana.plugin.clr:
      profiling:
        enabled: true
    ```2. Set the environment variable **`INSTANA_AUTO_PROFILE`** to true.
    
     

PHP での設定

PHP をご利用のお客様は、 AutoProfile をサーバーレス監視にはご利用いただけません。 詳細については、 「 PHP のプロファイリング 」を参照してください。

AutoProfile™ を有効にするには、環境変数を INSTANA_AUTO_PROFILE=true 設定するか、エージェントの設定ファイルに以下の設定を追加 <agent_install_dir>/etc/instana/configuration.yamlしてください:

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