Agent Check: php_apcu

Overview

This check monitors PHP APCu through the Datadog Agent.

Setup

The PHP APCu check is not included in the Datadog Agent package, so you need to install it.

Installation

For Agent v7.21+ / v6.21+, follow the instructions below to install the PHP APCu check on your host. See Use Community Integrations to install with the Docker Agent or earlier versions of the Agent.

1. Run the following command to install the Agent integration:

   datadog-agent integration install -t datadog-php_apcu==<INTEGRATION_VERSION>

2. Configure your integration similar to core integrations.

APCu

APCu does not expose metrics by default so this integration includes a metric exporter, located here:

/opt/datadog-agent/embedded/lib/python3.8/site-packages/datadog_checks/php_apcu/assets/exporter/apcu-dd-handler.php

When you configure your Agent, refer to the exporter directly by this file name, or configure an alias for it on your web server. For example, if you're using Apache, the alias in the web server configuration file would look like this:

Alias /apcu-status /opt/datadog-agent/embedded/lib/python3.8/site-packages/datadog_checks/php_apcu/assets/exporter/apcu-dd-handler.php
<Location /apcu-status>
    Require all denied
    Require local
</Location>

Configuration

1. Edit the php_apcu.d/conf.yaml file, in the conf.d/ folder at the root of your Agent's configuration directory to start collecting your php_apcu performance data. See the sample php_apcu.d/conf.yaml file for all available configuration options.

   instances
     - url: http://localhost/apcu-status
   

2. Restart the Agent.

Validation

Run the Agent's status subcommand and look for php_apcu under the Checks section.

Data Collected

Metrics

See metadata.csv for a list of metrics provided by this check.

Events

The PHP APCu integration does not include any events.

Service Checks

See service_checks.json for a list of service checks provided by this integration.

Troubleshooting

Need help? Contact Datadog support.