Avant d' installer l'agent PHP, assurez-vous que votre système répond aux exigences de version répertoriées ci-dessous.
Compatibilité desagentPHP
Version PHP | Version de l'agent | Actuellement pris en charge |
---|---|---|
8.4 | ≥ | Oui |
8.3 | ≥ | Oui |
8.2 | Toutes les versions d'agent prises en charge | Oui |
8.1 | Toutes les versions d'agent prises en charge | Oui |
8.0 | Toutes les versions d'agent prises en charge | Oui |
7.4 | Toutes les versions d'agent prises en charge | Oui |
7.3 | Toutes les versions d'agent prises en charge | Oui |
7.2 | Toutes les versions d'agent prises en charge | Oui |
7.1 | ≤ | Non |
7.0 | ≤ | Non |
Consultez les notes de sortie deagent PHP pour la dernière sortie agent PHP.
Pour une liste à jour de toutes les sorties d'agent PHP actuellement prises en charge, consultez la politique EOL de l'agent PHP.
Si vous utilisez une version ou une plateforme PHP non prise en charge (comme un système d'exploitation 32 bits, FreeBSD ou des versions ZTS), nous vous recommandons de désactiver les mécanismes de mise à jour automatique pour le package PHP agent . Si vous ne parvenez pas à empêcher les mises à niveau automatiques, cela pourrait entraîner l’installation accidentelle d’une version plus récente de l’agent. La version la plus récente peut ne plus prendre en charge les fonctionnalités critiques essentielles à la collecte de données APM, ce qui entraînera des perturbations dans les capacités monitoring .
Pour désactiver la mise à jour automatique, vous avez deux options :
Ajoutez le package PHP agent à une liste d'exclusion pour les mises à niveau package, ou
Épinglez la version du agent PHP package sur une agent version qui prend en charge les anciennes fonctionnalités non prises en charge. Les packages agent PHP concernés sont :
newrelic-php5
newrelic-php5-common
newrelic-daemon
Sécurité des threads Zend
Les builds PHP compilées avec Zend Thread Safety (ZTS) ne sont pas prises en charge.
Compilation juste à temps (JIT)
La compilation juste-à-temps est prise en charge à partir de agent la version 10.18.0.8 de . PHP désactive automatiquement JIT pour toutes les versions antérieures de l'agent PHP.
Fibres
Les fibres ne sont pas prises en charge.
Autorisations
Installation de l'agent PHP requires accès root à :
- Accès en lecture/écriture au répertoire des extensions PHP.
- Accès en lecture/écriture aux données de configuration PHP, soit dans le répertoire de configuration PHP (préféré), soit dans
php.ini
. - Redémarrez le serveur Web ou le pool de processus PHP.
Exécution de l'agent does not require accès root. L'agent a besoin d'un accès en lecture/écriture aux fichiers suivants (l'emplacement de ces fichiers peut être personnalisé dans les paramètres de l'agent PHP) :
- Un fichier stockant le agent fichier de log
- Un fichier stockant le point de terminaison du socket de l'agent
- Un fichier stockant l'ID du processus de l'agent
clé de licence
Votre New Relic est une chaîne hexadécimale de 40 caractères que New Relic fournit lorsque vous créez votre compte. Pour plus d'informations, consultez le script d'installation PHP ou les paramètres de clé de licence dans le fichier PHP ini
.
Processeur
Les architectures de processeur suivantes sont prises en charge :
- x86_64 (également connu sous le nom d'amd64)
- aarch64 (également connu sous le nom d'ARM64)
Important
La prise en charge d'aarch64 (ARM64) n'est disponible que sur PHP 8.0+.
système d'exploitation
Lorsque les fournisseurs annoncent la fin de vie (comme sur la page Fin du support standard d'Ubuntu), nous continuerons à prendre en charge ces dernières versions pendant un an après la date de fin de vie du fournisseur. Cependant, si la version PHP que vous utilisez n'est plus officiellement prise en charge, le support pourrait prendre fin avant un an.
C'est pourquoi nous vous recommandons de toujours utiliser la dernière version du système d'exploitation officiellement prise en charge par le fournisseur. Les dernières versions de notre agent peuvent fonctionner sur des versions de système d'exploitation dont la fin de vie est dépassée, mais nous ne testons plus ni ne prenons officiellement en charge l'agent PHP avec les anciennes versions.
Sur la base des informations ci-dessus, l' agent PHP peut être installé sur le système d'exploitation en utilisant les méthodes d'installation répertoriées dans le tableau ci-dessous.
système d'exploitation | sortie | architecturedu processeur | Méthode d'installation |
---|---|---|---|
Linux Alpine | 3.15, 3.16, 3.17, 3.18, 3.19, 3.20 | x86_64, aarch64 | |
Amazon Linux | 2 | x86_64 | |
Amazon Linux | 2 | aarch64 | |
Amazon Linux | 2023 | x86_64, aarch64 | |
CentOS Linux | 7 | x86_64 | |
CentOS Linux | 7 | aarch64 | |
Flux CentOS | 8, 9 | x86_64 | |
Flux CentOS | 8, 9 | aarch64 | |
RedHat Enterprise Linux | 7, 8, 9 | x86_64 | |
RedHat Enterprise Linux | 7, 8, 9 | aarch64 | |
Debian | 10, 11, 12 | x86_64 | |
Debian | 10, 11, 12 | aarch64 | |
Ubuntu | 20, 22, 24 | x86_64 | |
Ubuntu | 20, 22, 24 | aarch64 | |
Toute distribution Linux avec :
| N/A | x86_64, aarch64 |
Serveurs Web
Les serveurs Web suivants sont pris en charge :
- Apache 2.2 ou 2.4 via
mod_php
- Tout serveur Web prenant en charge FastCGI à l'aide de PHP-FPM
cadre
Les frameworks suivants sont pris en charge :
Framework | Version | Considérations |
---|---|---|
CakePHP | 4.x, 5.x | |
Drupal | 7.x, 8.x, 9.x, 10.x, 11.0 | Fonctionnalités spécifiques à Drupal |
Joomla | ≤ 3,7 | avec la version de l'agent ≤ |
Laminas | 3.x | |
Laravel | 6.x, 7.x, 8.x, 9.x, 10.x, 11.x | Laravel Horizon n'est pas pris en charge. |
Lumen | 6.x, 7.x, 8.x, 9.x, 10.x | |
Magento | 2.x (CE et EE) | |
MediaWiki | 1.31+ | |
Slim | 2.x, 3.x, 4.x | |
Symfony | 4.x, 5.x, 6.x, 7.x | |
Wordpress | 5.9+ | |
Oui | 1.1, 2.0 | |
Cadre Zend | 3.x |
Si vous souhaitez suggérer du support pour d'autres frameworks PHP populaires, visitez le forum de support et créez un Feature Idea
. Pour plus d'informations, consultez Framework PHP : Intégration du support pour New Relic.
base de données et bibliothèque
Les bases de données et bibliothèques suivantes sont prises en charge :
Firebird (pilote PDO uniquement) | |
Pilotes PDO | |
Informix | PostgreSQL |
Memcached | |
MongoDB | RabbitMQ (bibliothèque php-amqplib 3.7 uniquement) |
Microsoft SQL Server (pilote PDO uniquement) | Redis |
MySQL | SQLite |
ODBC (pilote PDO uniquement) | SQS (bibliothèque aws-sdk-php 3 uniquement) |
Oracle | Sybase (pilote PDO uniquement) |
Autres logiciels monitoring tiers
Si votre application utilise un logiciel monitoring supplémentaire, nous ne pouvons pas garantir que notre agent fonctionnera correctement et ne pouvons pas offrir de support technique. Pour plus d'informations, consultez Erreurs lors de l'utilisation d'autres logiciels monitoring .
Détails de l'instance
New Relic collecte les détailsinstance pour une variété de bases de données et de pilotes de bases de données. Les bases de données et extensions suivantes sont prises en charge :
base de données | Extension |
---|---|
MongoDB | |
MySQL | |
Pour désactiver la collecte des informations sur l'hôte, configurez l'un des éléments suivants dans le fichier newrelic.ini
:
- Désactiver les rapports d'instance avec
newrelic.datastore_tracer.instance_reporting.enabled = false
- Omettez le nom de la base de données avec
newrelic.datastore_tracer.database_name_reporting.enabled = false
Pour demander des informations au niveau de l'instance à partir de magasins de données actuellement non répertoriés pour votre agent PHP, obtenez de l'aide sur support.newrelic.com.
File d'attente des messages
Les éléments suivants prennent en charge la mise en file d'attente des messages :
- HTTP
- La mise en file d'attente Laravel
Important
Laravel Horizon n'est pas pris en charge.
Exigences de sécurité
En tant que mesure de sécurité standard pour la collecte de données, votre serveur d'applications doit prendre en charge SHA-2 (256 bits). SHA-1 n'est pas pris en charge.
Prise en charge des fonctionnalités New Relic
L' agent PHP s'intègre à d'autres fonctionnalités New Relic pour vous offrir une visibilité de bout en bout :
Produit | intégration |
---|---|
L' agent PHP injecte automatiquement le code JS de l' agent de navigateur lorsque vous activez auto-instrumentation. Après avoir activé injection du navigateur, vous pouvez afficher les données dans la page RésuméAPM et basculer rapidement entre l' APM et les données du navigateur pour une application particulière. Pour les options configuration et instrumentation manuelle, voir monitoring des navigateurs et l' agent PHP. | |
New Relic CodeStream apporte l'observabilité dans l'IDE pour montrer comment votre code fonctionne en production au niveau de la méthode. Les versions PHP 7.0 - 7.4 et 8.0 - 8.3 rapportent le niveau du code métriques (à partir de la sortie 10.4.0). | |
Lorsque vous installez l' infrastructure et l'agent APM sur le même hôte, ils se détectent automatiquement. Vous pouvez ensuite afficher une liste d'hôtes dans l'UI APM et filtrer vos hôtes par APM application dans l'UI infrastructure. Pour plus d'informations, voir les données APM dans monitoring d'infrastructure. | |
L' agent PHP supporte nos fonctionnalités de logs en contexte pour la bibliothèque Monolog 2 et 3. | |
L' agent PHP envoie l'événement et l'attribut par défaut pour la requête NRQL . Vous pouvez également enregistrer un événement personnalisé pour une analyse avancée. | |
Synthétique trace de transaction connecte requests du moniteur Synthétique à la transaction APM sous-jacente. |