Antes de instalar o agente PHP, certifique-se de que seu sistema atenda aos requisitos de versão listados abaixo.
Lançamentos PHP
As seguintes versões do PHP são suportadas:
Versão | Notas de compatibilidade |
---|---|
7.0 - 7.4 | O suporte para as versões 7.0 e 7.1 do PHP será EOL em 1º de junho de 2024. |
8.0 - 8.3 | A compilação Just-In-Time é suportada a partir da versão 10.18.0.8 do agente. O PHP desativa automaticamente o JIT para qualquer versão anterior do agente PHP. PHP 8.1 e posterior não suporta Fibers. |
Compatibilidade do agente PHP
Consulte as notas de versão do agente PHP para obter a versão mais recente do agente PHP.
Para compilações PHP compiladas com Zend Thread Safety (ZTS), apenas o agente PHP 9.19 e anteriores suportam essas compilações.
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
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 são suportados:
- Plataforma Intel (e compatível)
- ARM64
Sistema operacional
Quando os fornecedores anunciarem o fim da vida útil (como na página Fim do suporte padrão do Ubuntu), continuaremos a oferecer suporte a essas versões mais recentes por um ano. 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.
O agente PHP suporta o sistema operacional listado na tabela abaixo.
Sistema operacional | Fornecedores suportados | Notas de compatibilidade |
---|---|---|
Linux (x86_64) |
| |
Linux (ARM64) |
|
|
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:
Magento 2.x, CE e EE | |
Joomla 3.x ImportanteJoomla 3.x não é compatível com PHP 8.x. | MediaWiki |
Laminas 3.x | Slim 2.x, 3.x e 4.x |
Laravel 6.x, 7.x, 8.x, 9.x e 10.x | Symfony 4.x e 5.x |
Lumen 6.x, 7.x, 8.x, 9.x e 10.x | |
Framework Zend 3.x |
A lista de frameworks do agente PHP continua a crescer. Mesmo que a framework que você está usando não esteja listada aqui, o agente PHP poderá fornecer informações úteis sobre seu aplicativo.
Se você quiser sugerir suporte para outra framework PHP popular, visite o Fórum de suporte e crie um Feature Idea
. Para obter mais informações, consulte Frameworks 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
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. |