Antes de instalar o agente PHP, certifique-se de que seu sistema atenda aos requisitos de versão listados abaixo.
Compatibilidade do agente PHP
Versão PHP | Versão do agente | Atualmente suportado |
---|---|---|
8.3 | ≥ | Sim |
8.2 | Todas as versões de agentes suportadas | Sim |
8.1 | Todas as versões de agentes suportadas | Sim |
8,0 | Todas as versões de agentes suportadas | Sim |
7.4 | Todas as versões de agentes suportadas | Sim |
7.3 | Todas as versões de agentes suportadas | Sim |
7.2 | Todas as versões de agentes suportadas | Sim |
7.1 | ≤ | Não |
7,0 | ≤ | Não |
Consulte as notas de versão do agente PHP para obter a versão mais recente do agente PHP.
Para uma lista atualizada de todas as versões do agente PHP atualmente suportadas, consulte a Política de EOL do agente PHP.
Se você estiver usando uma versão ou plataforma PHP não suportada (como versões de SO de 32 bits, FreeBSD ou ZTS), recomendamos desabilitar os mecanismos de atualização automática para os pacotes do agente PHP. Se você não impedir as atualizações automáticas, isso poderá levar à instalação acidental de uma versão mais recente do agente. A versão mais recente pode não suportar mais recursos críticos essenciais para a coleta de dados APM, resultando em interrupções nos recursos de monitoramento.
Para desativar a atualização automática, você tem duas opções:
Adicione os pacotes do agente PHP a uma lista de exclusão para atualizações de pacotes ou
Versão fixa o pacote do agente PHP em uma versão do agente que suporta recurso(s) antigo(s) não suportado(s). Os pacotes do agente PHP afetados são:
newrelic-php5
newrelic-php5-common
newrelic-daemon
Zend Thread Safety
Compilações PHP com Zend Thread Safety (ZTS) não são suportadas.
Compilação Just-In-Time (JIT)
A compilação Just-In-Time é suportada a partir da versão 10.18.0.8 do agente. O PHP desabilita automaticamente o JIT para qualquer versão anterior do agente PHP.
Fibers
Fibers não são suportadas.
Permissões
Instalando o acesso root do agente PHP requires para:
- Acesso de leitura/gravação ao diretório de extensões PHP.
- Acesso de leitura/gravação aos dados de configuração do PHP, no diretório de configuração do PHP (preferencial) ou em
php.ini
. - Reinicie o servidor web ou o pool de processos PHP.
Executando o acesso root do agente does not require . O agente precisa de acesso de leitura/gravação aos seguintes arquivos (a localização desses arquivos pode ser personalizada nas configurações do agente PHP):
- Um arquivo que armazena o arquivo de log do agente
- Um arquivo que armazena o endpoint do soquete do agente
- Um arquivo que armazena o ID do processo do agente
chave de licença
Seu New Relic é uma string hexadecimal de 40 caracteres que o New Relic fornece quando você se inscreve em sua conta. Para obter mais informações, consulte o script de instalação do PHP ou as configurações da chave de licença no arquivo PHP ini
.
Processadores
Os seguintes processadores arquitetura são suportados:
- x86_64 (também conhecido como amd64)
- aarch64 (também conhecido como ARM64)
Importante
O suporte a aarch64 (ARM64) está disponível apenas no PHP 8.0+.
Sistema operacional
Quando os fornecedores anunciarem o fim da vida útil (como na página de suporte padrão do Ubuntu), continuaremos a oferecer suporte a essas versões mais recentes por um ano após a data de fim da vida útil do fornecedor. No entanto, se a versão do PHP que você está usando não tiver mais suporte oficial, o suporte poderá terminar antes de um ano.
É por isso que recomendamos sempre usar a versão mais recente do sistema operacional oficialmente suportada pelo fornecedor. As versões mais recentes do nosso agente podem funcionar em versões do sistema operacional que já passaram do fim da vida útil, mas não testamos mais nem oferecemos suporte oficial ao agente PHP com versões mais antigas.
Com base nas informações acima o agente PHP pode ser instalado no sistema operacional utilizando os métodos de instalação listados na tabela abaixo.
Sistema operacional | Liberar | Arquitetura CPU | Método de instalação |
---|---|---|---|
Alpino Linux | 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 | |
Fluxo CentOS | 8, 9 | x86_64 | |
Fluxo 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 | |
Qualquer distribuição Linux com:
| N/A | x86_64, aarch64 |
Servidores web
Os seguintes servidores web são suportados:
- Apache 2.2 ou 2.4 via
mod_php
- Qualquer servidor web que suporte FastCGI usando PHP-FPM
Frameworks
A seguinte framework é suportada:
Framework | Versão | Considerações |
---|---|---|
Drupal | 7.x, 8.x, 9.x, 10.x, 11.x | Funcionalidade específica do Drupal |
Joomla | ≤ 3,7 | com versão do agente ≤ |
Laminas | 3.x | |
Laravel | 6.x, 7.x, 8.x, 9.x, 10.x, 11.x | Laravel Horizon não é compatível. |
Lumen | 6.x, 7.x, 8.x, 9.x, 10.x | |
Magento | 2.x (CE e EE) | |
MediaWiki | 1,31+ | |
Slim | 2.x, 3.x, 4.x | |
Symfony | 4.x, 5.x, 6.x, 7.x | |
WordPress | 5.9+ | |
Yii | 2,0 | |
Estrutura Zend | 3.x |
Se você quiser sugerir suporte para outro framework PHP popular, visite o Fórum de Suporte e crie um Feature Idea
. Para obter mais informações, consulte Framework PHP: Integrando suporte para New Relic.
Bancos de dados e bibliotecas
Os seguintes bancos de dados e bibliotecas são suportados:
Firebird (somente driver PDO) | Oracle |
Informix | PDO Drivers |
Memcached | Postgres |
MongoDB | |
Microsoft SQL Server (somente driver PDO) | Redis |
MySQL | SQLite |
ODBC (somente driver PDO) | Sybase (somente driver PDO) |
Outro software de monitoramento de terceiros
Se o seu aplicativo usar algum software de monitoramento adicional, não podemos garantir que nosso agente funcionará corretamente e não poderemos oferecer suporte técnico. Para obter mais informações, consulte Erros ao usar outro software de monitoramento.
Detalhes da instância
New Relic coleta detalhes de instância para uma variedade de bancos de dados e drivers do banco de dados. Os seguintes bancos de dados e extensões são suportados:
Banco de dados | Extensão |
---|---|
MongoDB | |
MySQL | |
Para desativar a coleta de informações do host, configure um dos seguintes itens no arquivo newrelic.ini
:
- Desative relatórios de instância com
newrelic.datastore_tracer.instance_reporting.enabled = false
- Omita o nome do banco de dados com
newrelic.datastore_tracer.database_name_reporting.enabled = false
Para solicitar informações em nível de instância de datastores atualmente não listados para seu agente PHP, obtenha suporte em support.newrelic.com.
Enfileiramento de mensagens
O seguinte oferece suporte ao enfileiramento de mensagens:
- HTTP
- Enfileiramento do Laravel
Importante
O Laravel Horizon não é suportado.
Requisitos de segurança
Como medida de segurança padrão para coleta de dados, o servidor do seu aplicativo deve oferecer suporte a SHA-2 (256 bits). SHA-1 não é compatível.
Suporte ao New Relic
O agente PHP integra-se com outro recurso New Relic para lhe dar visibilidade ponta a ponta:
Produtos | Integração |
---|---|
O agente PHP injeta automaticamente o código JS do agente browser quando você ativa a instrumentação automática. Depois de ativar a injeção do browser, você pode visualizar os dados na página Resumo do APM e alternar rapidamente entre o APM e os dados do browser para um aplicativo específico. Para opções de configuração e instrumentação manual, consulte monitoramento de Browser e agente PHP. | |
O New Relic CodeStream traz observabilidade para o IDE para mostrar o desempenho do seu código na produção no nível do método. As versões 7.0 - 7.4 e 8.0 - 8.3 do PHP reportam o nível do código métrico (a partir da versão 10.4.0). | |
Ao instalar a infraestrutura e o agente APM no mesmo host, eles detectam um ao outro automaticamente. Você pode então visualizar uma lista de hosts na interface do APM e filtrar seus hosts por aplicativo APM na interface de infraestrutura. Para obter mais informações, consulte Dados APM no monitoramento de infraestrutura. | |
O agente PHP oferece suporte ao nosso recurso logs contextualizados para a biblioteca Monolog 2 e 3. | |
O agente PHP envia evento e atributo padrão para consulta NRQL. Você também pode gravar eventos personalizados para análise avançada. | |
Sintético trace da transação conecta solicitações do monitor Sintético à transação APM subjacente. |