Este check monitoriza OPcache de PHP a través del Datadog Agent.
Configuración
Sigue las instrucciones de abajo para instalar y configurar este check para un Agent que se ejecuta en un host. En el caso de entornos en contenedores, consulta las Plantillas de integración de Autodiscovery para obtener orientación sobre la aplicación de estas instrucciones.
Instalación
Para instalar el check php_opcache en tu host:
Instala el kit de herramientas para desarrolladores
en cualquier máquina.
Ejecuta ddev -e release build php_opcache para compilar el paquete.
Descarga el Datadog Agent.
Carga el artefacto de compilación a cualquier host con un Agent y
ejecuta datadog-agent integration install -w path/to/php_opcache/dist/<ARTIFACT_NAME>.whl.
OPcache
OPcache no expone métricas de forma predeterminada, por lo que esta integración incluye un exportador de métricas, ubicado aquí:
/opt/datadog-agent/embedded/lib/python3.8/site-packages/datadog_checks/php_opcache/assets/exporter/opcache-dd-handler.php
Puedes descargar el exportador desde el repositorio integraciones-extras de Datadog.
Cuando configures tu Agent, haz referencia al exportador directamente por este nombre de archivo o configura un alias para él en tu servidor web. Por ejemplo, si utilizas Apache, el alias en el archivo de configuración del servidor web sería el siguiente:
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>
Configuración
- Edita el archivo
snowflake.d/conf.yaml, en la carpeta conf.d/ en la raíz del directorio de configuración de tu Agent para comenzar a recopilar los datos de rendimiento de php_opcache. Consulta el archivo php_opcache.d/conf.yaml de ejemplo para conocer todas las opciones de configuración disponibles.instances
- url: http://localhost/opcache-status
- Reinicia el Agent.
Validación
Ejecuta el subcomando de estado del Agent y busca php_opcache en la sección Checks.
Datos recopilados
Métricas
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 |
Eventos
La integración OPcache de PHP no incluye eventos.
Checks de servicio
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
Solucionar problemas
¿Necesitas ayuda? Contacta con el equipo de asistencia de Datadog.
