Monitoring PHP

支援的資訊

配置 PHP 感應器

安裝 Instana 代理程式之後， PHP 感應器會自動安裝並配置合理的預設值。 通常，您不需要在 Instana 代理程式的 configuration.yaml 檔案中修改這些設定: <agent_install_dir>/etc/instana/configuration.yaml。

下列 YAML Snippet 顯示可用的設定:

# PHP Tracing
#com.instana.plugin.php:
#  # Lightweight PHP Tracing. Requires the Instana Tracing extension. Enabled by default.
#  tracing:
#    # Enabling tracing will automatically download the Instana Tracing
#    # extension and enable it in your php.ini. If you are using preforked
#    # PHP workers, like PHP-FPM, you will need to restart them. Disabling
#    # tracing again will not remove the extension. It will only disable the
#    # tracing sensor.
#    enabled: true
#    # Whether to install the PHP Tracing extension. Default is true. Disabling
#    # the installation will still create the TraceAcceptor daemon though.
#    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
#    # as follows will force a static filename instead.
#    phpInfoFilename: instana.php
#    # Pins the PHP Tracing extension to download and install 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). Expects
#    # the version to be given as major.minory.patch, e.g. 0.3.7
#    pinExtensionVersion: x.y.z
#    # The absolute path to the script to trigger whenever the sensor installed
#    # a different version of the PHP tracing extension than is currently
#    # installed. Works for upgrades and downgrades. Default is empty.
#    notificationScript: /path/to/restart_php.sh
#    # 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

# PHP Tracing
com.instana.plugin.php:
tracing:
    enabled: true
    pinExtensionVersion: 1.20.0

SetHandler application/x-httpd-php

> "PHP Sensor is failing because of "NO Version found"

檢視度量值

若要檢視 PHP 的度量值，請完成下列步驟:

1. 在 Instana 使用者介面的資訊看板中，選取 基礎架構。
2. 按一下特定的受監視主機。

您可以查看包含所有已收集度量及受監視處理程序的主機儀表板。

如同任何其他 Instana 感應器， PHP 感應器不需要任何配置。 它會自動偵測 PHP 安裝，並從安裝中收集下列資料:

• 配置資料
• 績效度量值
• 性能簽章

對於 PHP ，配置資料、效能度量及性能簽章取決於所使用的 SAPI。 如需相關資訊，請參閱 支援的 PHP SAPI。

追蹤

Instana 提供 PHP 的自動及手動設備測試。

與 OpenTracing

Instana 提供個別 PHP SDK ，可使用 OpenTracing進行追蹤。 與 Instana 自己的 PHP 檢測不同， OpenTracing SDK 需要您手動檢測程式碼。 透過 PHP OpenTracing SDK 產生的追蹤資料與 Instana 自己的追蹤所產生的追蹤資料是分開的。

服務命名

如需服務命名的相關資訊，請參閱 廣域設定服務名稱。

「PHP 追蹤器」會在 PHP 的 $_SERVER 和 $_ENV 陣列中搜尋索引鍵 INSTANA_SERVICE_NAME ，並使用索引鍵值作為服務名稱。

設定程序名稱

您可以使用環境變數 INSTANA_PROCESS_NAME ，為代表 PHP 程序的基礎架構實體設定自訂標籤。