Surveillance de PHP

Le capteur PHP est configuré avec des paramètres par défaut appropriés pour que le traçage PHP fonctionne automatiquement dès l'installation de l'agent Instana. Vous pouvez toutefois configurer le capteur via la com.instana.plugin.php section du fichier de configuration.yaml l'agent afin de l'adapter à votre environnement d'exécution PHP.

L'extrait suivant du fichier configuration.yaml d'agent YAML présente les paramètres disponibles pour configurer le capteur 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
 

Une fois l'agent Instana installé, le capteur PHP -FPM est automatiquement installé et configuré avec les paramètres par défaut.

L'extrait de code YAML suivant présente les paramètres disponibles :

#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 
 

Le capteur « PHP -FPM » surveille par défaut les groupes de travailleurs FPM. Cette surveillance permet d'éviter que les processus de travail ne s'arrêtent, car le capteur envoie en arrière-plan des requêtes CGI de vérification automatique de l'état. Pour éviter ce comportement, vous pouvez désactiver la surveillance du pool de workers en définissant workerPoolMonitoring l'option dans la configuration du plug-in de capteur FPM de l' PHP sur false.

Pour consulter les indicateurs relatifs à PHP, procédez comme suit :

1. Dans la barre latérale de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ».
2. Cliquez sur un hôte surveillé spécifique.

Vous pouvez voir un tableau de bord hôte avec toutes les métriques collectées et les processus surveillés.

Comme tout autre capteur Instana, le capteur PHP ne nécessite aucune configuration. Il détecte automatiquement votre installation d' PHP et recueille les données suivantes à partir de celle-ci :

• Données de configuration
• Métriques de performance
• Signatures d'intégrité

Dans le cas d' PHP s, les données de configuration, les indicateurs de performance et les signatures d'intégrité dépendent du SAPI utilisé. Pour plus d'informations, consultez la section « SAPI d' PHP s prises en charge ».

Instana propose des solutions d'instrumentation à la fois automatiques et manuelles pour l' PHP.

Instana fournit un SDK distinct pour l' PHP, destiné au traçage avec OpenTracing. Contrairement à l'instrumentation PHP fournie par Instana, le SDK OpenTracing vous oblige à instrumenter manuellement votre code. Les traces générées via le SDK PHP OpenTracing sont distinctes de celles générées par le système de traçage propre à Instana.

Instana prend en charge l'instrumentation d' OpenTelemetry pour les applications d' PHP. L'extension OpenTelemetry PHP dispose d'une fonctionnalité d'instrumentation automatique (également appelée « instrumentation sans code ») qui génère des traces et les exporte vers des points de terminaison configurés, tels que le collecteur OpenTelemetry et le backend.

Pour importer ces portées dans l' Instana e, vous pouvez utiliser l'un des exportateurs suivants :

• L'exportateur par défaut d' OpenTelemetry Protocol s ( OTLP ) : il permet à l'agent Instana de recevoir des traces via un point de terminaison OTLP.
• Instana OpenTelemetry PHP exportateur : il convertit les segments « OpenTelemetry » en segments « Instana » avant de les exporter directement vers l'agent « Instana ».

Les traces de l' OpenTelemetry sont affichées dans l'interface utilisateur d' Instana, de la même manière que les traces de Instana et PHP. Pour plus d'informations, consultez la section « Intégration d' OpenTelemetry pour les applications PHP ».

Instana prend en charge le traçage sans serveur pour l'environnement d' AWS Fargate. Tout comme l'extension native « Instana », l'extension « serverless » active également par défaut le traçage « PHP ». Pour plus d'informations sur les détails de configuration, consultez la page AWS Fargate.

Pour activer le traçage sans serveur, assurez-vous que les conditions suivantes sont remplies :

• OpenSSL3 ou bien OpenSSL1.1 est installé dans le conteneur PHP.
• INSTANA_ENDPOINT_URL et les variables INSTANA_AGENT_KEY d'environnement sont accessibles à l' PHP Pour plus d'informations sur la configuration de ces variables, consultez la section « Configuration de la définition de tâche ».

Le profileur PHP prend en charge le profilage de l'utilisation du processeur; cette fonctionnalité n'est disponible que lorsque le traceur natif PHP est utilisé avec l'agent Instana. Le profileur « PHP » n'est pas pris en charge dans la surveillance sans serveur.

Pour plus d'informations sur son activation, voir Configuration du profilage.