Docker et autres environnements conteneurs : Installer agent PHP

Vous pouvez installer l' agent PHP sur un conteneur Docker ou autre conteneur pour monitorer une ou plusieurs de vos applications PHP. Ceci est pris en charge pour les conteneurs qui répondent aux exigences et à la compatibilité standard de l' agent PHP.

Options de conteneur

L'agent PHP nécessite deux composants pour fonctionner : l'agent PHP (un pour chaque application) et un daemon, qui regroupe les données envoyées par un ou plusieurs agents et les envoie à New Relic. Pour cette raison, il existe deux options pour activer l' agent PHP pour les environnements conteneurisés :

• Installez l'agent et le daemon sur différents conteneurs. Cela peut être utile si vous avez un conteneur à courte durée de vie.
• Installez l'agent et le daemon sur le même conteneur. Il s'agit de la configuration recommandée.

Installer agent et le daemon dans différents conteneurs

L'installation de l'agent et du daemon dans différents conteneurs est prise en charge à partir de l'agent PHP New Relic version 9.2.0 .

Pour voir un exemple d'application, accédez au forum d'assistance de New Relic. Si vous utilisez un conteneur application de courte durée, nous vous recommandons d'utiliser un conteneur séparé pour le daemon de l' agent PHP.

Configurer le conteneur de daemon

Si vous utilisez Docker, vous pouvez extraire notre image de daemon depuis Docker Hub:

1. Exécutez cette commande : docker pull newrelic/php-daemon.
2. Pour personnaliser l'image, suivez les étapes sur Docker Hub.

Vous pouvez également créer votre propre image de daemon :

1. Pour installer le daemon, téléchargez le package de l'agent PHP à partir du site de téléchargement du fichier tar de New Relic et exécutez le script newrelic-install avec l'argument install_daemon .
2. Démarrez le daemon en utilisant les arguments --address et --watchdog-foreground .

L'argument --address définit un port pour que le daemon accepte les connexions. L'argument --watchdog-foreground garantit que le daemon s'exécute au premier plan.

Configurer le conteneur d'agent PHP

Pour configurer le conteneur d’agent PHP pour Docker :

1. Assurez-vous qu'une installation PHP est disponible dans le conteneur. Par exemple, utilisez une « image officielle » Docker pour php comme php:fpm ou php:cli.
2. Pour installer l'agent, téléchargez le package de l'agent PHP à partir du site de téléchargement de New Relic et exécutez le script newrelic-install avec l'argument install .
3. Dans le fichier newrelic.ini, définissez le nom de l'application et clé de licenceavec les entrées newrelic.appname et newrelic.license .
4. Dirigez l'agent vers le daemon en définissant l'option newrelic.daemon.address dans le fichier newrelic.ini . Assurez-vous que la valeur de cette option est HOST:PORT, où HOST est le nom ou l'adresse IP de l'hôte sur lequel le daemon s'exécute et PORT est le numéro de port sur lequel le daemon écoute

Installer l'agent et le daemon dans le même conteneur

Pour configurer l' agent PHP et le daemon dans le même conteneur Docker :

1. Assurez-vous qu'une installation PHP est disponible dans le conteneur. Par exemple, utilisez une « image officielle » Docker pour php comme php:fpm ou php:cli.
2. Pour installer l'agent, téléchargez le package de l'agent PHP à partir du site de téléchargement de New Relic et exécutez le script newrelic-install avec l'argument install .
3. Définissez le nom de l'application et clé de licencevia les entrées newrelic.license et newrelic.appname dans le fichier newrelic.ini .

FROM php:fpm

# Install the latest New Relic PHP Agent
RUN \
    cd /tmp \
    # Discover the latest released version:
    && export NEW_RELIC_AGENT_VERSION=$(curl -s https://download.newrelic.com/php_agent/release/ | grep -o '[1-9][0-9]\?\(\.[0-9]\+\)\{3\}' | head -n1) \
    # Discover libc provider
    && export NR_INSTALL_PLATFORM=$(ldd --version 2>&1 | grep -q musl && echo "linux-musl" || echo "linux") \
    # Download the discovered version:
    && curl -o newrelic-php-agent.tar.gz https://download.newrelic.com/php_agent/release/newrelic-php5-${NEW_RELIC_AGENT_VERSION}-${NR_INSTALL_PLATFORM}.tar.gz \
    # Install the downloaded agent:
    && tar xzf newrelic-php-agent.tar.gz \
    && NR_INSTALL_USE_CP_NOT_LN=1 NR_INSTALL_SILENT=0 ./*/newrelic-install install \
    # Configure the agent to use license key from NEW_RELIC_LICENSE_KEY env var:
    && sed -ie 's/[ ;]*newrelic.license[[:space:]]=.*/newrelic.license=${NEW_RELIC_LICENSE_KEY}/' $(php-config --ini-dir)/newrelic.ini \
    # Configure the agent to use app name from NEW_RELIC_APP_NAME env var:
    && sed -ie 's/[ ;]*newrelic.appname[[:space:]]=.*/newrelic.appname=${NEW_RELIC_APP_NAME}/' $(php-config --ini-dir)/newrelic.ini \
    # Cleanup temporary files:
    && rm newrelic-php-agent.tar.gz && rm -rf newrelic-php5-*-linux