PHP のモニター

PHP センサーは、 Instana エージェントのインストール時に、 PHP のトレースが自動的に機能するように、適切なデフォルト設定でインストールされます。 ただし、エージェント configuration.yaml ファイルのセクション com.instana.plugin.php を通じてセンサーを設定し、お使いの PHP ランタイムに合わせてカスタマイズすることができます。

エージェント configuration.yaml ファイルにある以下の YAML のスニペットは、 PHP センサーの設定に使用できるオプションを示しています：

# PHP Tracing
#com.instana.plugin.php:
#  # Lightweight PHP Tracing. Enabled (true) by default.
#  # PHP tracing is performed by the Instana PHP Tracing extension.
#  tracing:
#    # Enabling tracing (true) will automatically download the Instana PHP Tracing extension
#    # and enable it in the PHP INI configuration.
#    # The PHP runtime will be gracefully restarted if managed by PHP-FPM or Apache
#    # and the extension will be loaded into the PHP runtime. The following PHP runtimes
#    # require a manual restart for the PHP Tracing extension to be loaded into memory:
#    #  - long-running PHP-CGI processes i.e., CGI SAPI
#    #  - pre-forked PHP worker processes
#    #
#    # Disabling tracing (false) will automatically disable the Instana Tracing extension
#    # in the PHP INI configuration. The PHP runtime will be gracefully restarted to
#    # unload the extension from the PHP runtime memory if applicable (see above).
#    # Otherwise, you need to manually restart your PHP runtime to unload the extension.
#    # Disabling tracing implicitly disables profiling.
#    # You can automate the restarts by configuring a custom script. See 'notificationScript'.
#    enabled: true
#    # Whether to install the Instana PHP Tracing extension. Default is true.
#    # When set to false, the Instana PHP Tracing extension will not be enabled in newly
#    # detected PHP runtimes. This setting does not affect the PHP runtimes where
#    # the Instana PHP Tracing extension is already enabled.
#    installExtension: true
#    # The filename to use when querying Apache or PHP-CGI installations for
#    # environment data such as version, architecture, etc. By default, this
#    # is "instana." + Math.random(). + ".php". Uncommenting the setting
#    # below will force a static filename instead.
#    phpInfoFilename: instana.php
#    # Pin the Instana PHP Tracing extension to a specific version.
#    # This can be used to rollback to previous versions of the extension or to test
#    # beta versions (when asked to do so). The version should be provided
#    # in the format major.minory.patch, e.g. 5.1.0
#    # The pinned extension version is automatically installed in the PHP runtime.
#    # See the desciption of 'enabled' flag to know if you need to manually restart
#    # your PHP runtime after pinning the extension version.
#    pinExtensionVersion: x.y.z
#    # The absolute path to an executable shell script (Linux) or powershell script (Windows)
#    # that is to be automatically executed when enabling tracing, pinning extension version
#    # or disabling tracing. You must design this script to restart your PHP runtime so that
#    # the changes made to your PHP INI configuration by the agent are loaded.
#    # Default value is empty.
#    notificationScript: <absolute_path_to_script>
#    ###################################################################################
#    #  NOTE: The following settings are only applicable for PHP 5.x version runtimes
#    ###################################################################################
#    # The number of executor threads to use for processing traces. This setting
#    # can be used to fine tune the PHP sensor for specific load environments.
#    # Defaults to the number of available logical processors or 8 (whichever is less).
#    # In general, you don't need to touch this setting unless advised to do so.
#    executorThreads: n
#    # The maximum number of traces the sensor is allowed to keep in the backlog
#    # for processing. Can be used in conjunction with executorThreads to fine tune
#    # the sensor for specific load environments. In general, you don't need to touch
#    # this setting unless advised to do so. Defaults to 1000.
#    executorQueueLimit: 1000
#    # Port on which the sensor is listening for traces. Changing this setting will
#    # not automatically update any .ini files created for the PHP Tracing extension.
#    # In general, you don't need to touch this setting unless advised to do so.
#    # Defaults to port 16816.
#    port: 16816
#    # Whether to remove values in SQL queries to prevent sensitive data from
#    # reaching our backend. This can help to improve agent performance in certain
#    # setups. In general, you don't need to touch this setting unless advised to do so.
#    sanitizeSql: true
 

Instana エージェントをインストールすると、 PHP -FPMセンサーが自動的にインストールされ、デフォルト設定で構成されます。

以下の YAML のスニペットには、利用可能な設定が表示されています：

#PHP-FPM monitoring
 #com.instana.plugin.phpfpm:
 #  # Enabled (true) by default. Update it to 'false' to disable PHP-FPM discovery and sensor.
 #  enabled: true
 #  monitoring:
 #    # Enabling PHP-FPM worker pool monitoring collects worker pool process metrics like CPU and memory
 #    # usage every second. Enabled (true) by default.
 #    workerPoolMonitoring: true 
 

PHP の-FPMセンサーは、デフォルトでFPMワーカープールを監視します。 この監視機能により、センサーがバックグラウンドで自動ステータスチェックのCGIリクエストを送信することで、ワーカープロセスが終了してしまうのを防ぐことができます。 この動作を回避するには、 PHPworkerPoolMonitoringfalse の-FPMセンサープラグインの設定でオプションをに設定し、ワーカープールの監視を無効にしてください。

PHP のメトリクスを表示するには、以下の手順を実行してください：

1. Instana のUIのサイドバーで、 「インフラストラクチャ」 を選択します。
2. 特定のモニター対象ホストをクリックします。

収集されたすべてのメトリックとモニター対象プロセスを含むホスト・ダッシュボードを表示できます。

他の Instana センサーと同様、 PHP センサーも設定は不要です。 PHP のインストール環境を自動的に検出し、インストール環境から以下のデータを収集します：

• 構成データ
• パフォーマンス・メトリック
• 正常性シグニチャー

PHP では、構成データ、パフォーマンス指標、およびヘルスシグネチャは、使用される SAPI に依存します。 詳細については、 「サポートされている PHP SAPI」 を参照してください。

Instana PHP 向けに、自動および手動の両方の計測機能を提供します。

Instana OpenTracing を使用したトレース用に、専用の PHP SDKを提供しています。 Instana 独自の PHP による計測機能とは異なり、 OpenTracing SDKでは、コードを手動で計測対象として設定する必要があります。 PHP （ OpenTracing ）SDKを通じて生成されるトレースは、 Instana 独自のトレース機能によって生成されるトレースとは別物です。

Instana PHP アプリケーション向けの OpenTelemetry インストルメンテーションに対応しています。 OpenTelemetry の PHP 拡張機能には、トレースを生成し、 OpenTelemetry Collectorやバックエンドなどの設定済みのエンドポイントにエクスポートする自動インスツルメンテーション機能（ゼロコード・インスツルメンテーションとも呼ばれる）が備わっています。

これらのスパンを Instana に取り込むには、以下のエクスポーターのいずれかを使用できます：

• デフォルトの OpenTelemetry Protocol （ OTLP ） エクスポーター：これにより、 Instana エージェントは OTLP エンドポイントを通じてトレースを受信できるようになります。
• Instana OpenTelemetry PHP エクスポーター ： OpenTelemetry のスパンを、 Instana エージェントに直接エクスポートする前に、 Instana のスパンに変換します。

OpenTelemetry のトレースは、 Instana PHP のトレースと同様に、 Instana のUI上で可視化されます。 詳細については、 「 PHP アプリケーション向けの OpenTelemetry 統合」 を参照してください。

Instana AWS Fargate 環境向けのサーバーレストレース機能をサポートしています。 Instana のネイティブ拡張機能と同様に、serverless拡張機能でもデフォルトで PHP のトレースが有効になっています。 設定の詳細については、 「 AWS Fargate の監視」 を参照してください。

サーバーレストレースを有効にするには、以下の要件が満たされていることを確認してください：

• OpenSSL3 または、 OpenSSL1.1 が PHP コンテナにインストールされています。
• INSTANA_ENDPOINT_URL また、 INSTANA_AGENT_KEYPHP では環境変数を利用できます。 これらの変数の設定方法の詳細については、 「タスク定義の設定」 を参照してください。

PHP プロファイラはCPU使用率プロファイルタイプをサポートしており、これはネイティブの PHP トレーサーを Instana エージェントと組み合わせて使用する場合にのみ利用可能です。 PHP プロファイラは、サーバーレス監視ではサポートされていません。

これを使用可能にする方法について詳しくは、「 プロファイルの構成」を参照してください。