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 요청을 전송함으로써 작업자 프로세스가 종료되는 것을 방지할 수 있습니다. 이러한 현상을 방지하려면, PHP -FPM 센서 플러그인 구성에서 옵션을 workerPoolMonitoring 로 설정하여 워커 풀 false모니터링을 비활성화할 수 있습니다.

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 계측 기능을 지원합니다. OpenTelemetryPHP 확장 기능은 트레이스를 생성하여 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 네이티브 확장 프로그램과 마찬가지로, 서버리스 확장 프로그램도 기본적으로 PHP 추적을 지원합니다. 구성에 대한 자세한 내용은 AWS Fargate 의 ‘모니터링’ 섹션을 참조하십시오.

서버리스 추적을 사용하려면 다음 요구 사항이 충족되는지 확인하십시오:

• OpenSSL3 또는 OpenSSL1.1 가 PHP 컨테이너에 설치되어 있습니다.
• INSTANA_ENDPOINT_URL PHP 에서는 INSTANA_AGENT_KEY 환경 변수를 사용할 수 있습니다. 이러한 변수를 구성하는 방법에 대한 자세한 내용은 ‘작업 정의 구성’을 참조하십시오.

PHP 프로파일러는 CPU 사용량 프로파일 유형을 지원하며, 이는 Instana 에이전트와 함께 네이티브 PHP 트레이서를 사용할 때만 사용할 수 있습니다. 서버리스 모니터링에서는 PHP 프로파일러를 지원하지 않습니다.

이를 사용으로 설정하는 방법에 대한 자세한 정보는 프로파일링 구성을 참조하십시오.