Présentation
Ce check permet de surveiller PHP OPcache avec l’Agent Datadog.
Configuration
Suivez les instructions ci-dessous pour installer et configurer ce check lorsque l’Agent est exécuté sur un host. Consultez la documentation relative aux modèles d’intégration Autodiscovery pour découvrir comment appliquer ces instructions à des environnements conteneurisés.
Installation
Pour installer le check php_opcache sur votre host :
Installez le kit de développement.
sur n’importe quelle machine.
Exécutez ddev release build php_opcache pour générer le package.
Téléchargez l’Agent Datadog.
Importez l’artefact du build sur tous les hosts avec un Agent et
exécutez datadog-agent integration install -w chemin/vers/php_opcache/dist/<NOM_ARTEFACT>.whl.
OPcache
Puisqu’OPcache n’expose pas les métriques par défaut, cette intégration inclut un outil d’exportation de métriques, qui se trouve à l’emplacement suivant :
/opt/datadog-agent/embedded/lib/python3.8/site-packages/datadog_checks/php_opcache/assets/exporter/opcache-dd-handler.php
Vous pouvez télécharger l’outil d’exportation depuis le référentiel integrations-extras de Datadog.
Lors de la configuration de votre Agent, appelez l’outil d’exportation en utilisant directement ce nom de fichier, ou configurez un alias pour celui-ci sur votre serveur Web. SI vous utilisez Apache, voici un exemple d’alias dans le fichier de configuration du serveur Web :
Alias /opcache-status /opt/datadog-agent/embedded/lib/python3.8/site-packages/datadog_checks/php_opcache/assets/exporter/opcache-dd-handler.php
<Location /opcache-status>
Require all denied
Require local
</Location>
Configuration
- Modifiez le fichier
php_opcache.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos données de performance php_opcache. Consultez le fichier d’exemple php_opcache.d/conf.yaml pour découvrir toutes les options de configuration disponibles.instances
- url: http://localhost/opcache-status
- Redémarrez l’Agent.
Validation
Lancez la sous-commande status de l’Agent et cherchez php_opcache dans la section Checks.
Données collectées
Métriques
php_opcache.opcache_enabled
(gauge) | opcache enable flag |
php_opcache.cache_full
(gauge) | cache full time |
php_opcache.restart_pending
(gauge) | a restart pending |
php_opcache.restart_in_progress
(gauge) | restart in progress |
php_opcache.memory_usage.used_memory
(gauge) | used memory size
Shown as byte |
php_opcache.memory_usage.free_memory
(gauge) | free memory
Shown as byte |
php_opcache.memory_usage.wasted_memory
(gauge) | wasted memory
Shown as byte |
php_opcache.memory_usage.current_wasted_percentage
(gauge) | current wasted percentage
Shown as percent |
php_opcache.interned_strings_usage.buffer_size
(gauge) | interned string buffer size
Shown as byte |
php_opcache.interned_strings_usage.used_memory
(gauge) | interned string used memory
Shown as byte |
php_opcache.interned_strings_usage.free_memory
(gauge) | interned string free memory
Shown as byte |
php_opcache.interned_strings_usage.number_of_strings
(gauge) | interned string number of string
Shown as byte |
php_opcache.opcache_statistics.num_cached_scripts
(gauge) | num cached script
Shown as item |
php_opcache.opcache_statistics.num_cached_keys
(gauge) | num cached keys
Shown as item |
php_opcache.opcache_statistics.max_cached_keys
(gauge) | max cached keys
Shown as item |
php_opcache.opcache_statistics.hits
(gauge) | cache hit
Shown as hit |
php_opcache.opcache_statistics.start_time
(gauge) | cache start time
Shown as time |
php_opcache.opcache_statistics.last_restart_time
(gauge) | last restart time
Shown as time |
php_opcache.opcache_statistics.oom_restarts
(gauge) | oom restart count
Shown as occurrence |
php_opcache.opcache_statistics.hash_restarts
(gauge) | hash restart count
Shown as occurrence |
php_opcache.opcache_statistics.manual_restarts
(gauge) | description
Shown as occurrence |
php_opcache.opcache_statistics.misses
(gauge) | number of cache miss
Shown as miss |
php_opcache.opcache_statistics.blacklist_misses
(gauge) | number of black list misses
Shown as miss |
php_opcache.opcache_statistics.blacklist_miss_ratio
(gauge) | percent of black list miss ratio
Shown as percent |
php_opcache.opcache_statistics.opcache_hit_rate
(gauge) | percent of hit ratio
Shown as percent |
Événements
L’intégration PHP OPcache n’inclut aucun événement.
Checks de service
php_opcache.can_connect
Returns CRITICAL if the Agent is unable to connect to and collect metrics from the monitored OPcache instance. Returns OK otherwise.
Statuses: ok, critical
Dépannage
Besoin d’aide ? Contactez l’assistance Datadog.
