Configuração do agente PHP

Esta opção de configuração define o nome do aplicativo sob o qual os dados são relatados no APM. É altamente recomendável substituir o nome padrão por um nome descritivo para evitar confusão e agregação involuntária de dados. Os dados de todos os aplicativos com o mesmo nome serão mesclados no New Relic, portanto, defina isso com cuidado.

Para todas as opções de nomenclatura de aplicativos, incluindo configurações por diretório, consulte Nomeie seu aplicativo PHP.

O valor da configuração é uma lista separada por ponto e vírgula de até três nomes de aplicativos. O primeiro nome na lista é o nome do aplicativo primary . Deve ser exclusivo para cada conta. O nome do aplicativo é usado como chave em um cache. Ao usar vários nomes para um aplicativo, o New Relic usa apenas o primeiro nome para armazenamento em cache. Portanto, cada nome de aplicativo só pode aparecer como o primeiro elemento once.

Se você precisar de nomes de aplicativos sobrepostos, defina o nome comum do aplicativo na segunda ou terceira posições. Por exemplo: newrelic.appname="App2;App1" e newrelic.appname="App3;App1". Isso é útil, por exemplo, quando você deseja rastrear um superconjunto de aplicativos.

Para definir esse valor programaticamente, use a função de API newrelic_capture_params() .

Se você passar informações confidenciais diretamente na URL, mantenha esta opção desativada.

Se definido como true, permitirá a gravação do parâmetro passado para um script PHP através da URL (tudo após o ? na URL) no trace da transação. Eles aparecerão no dropdown Parameters ao exibir o rastreamento da transação.

O agente PHP New Relic detecta automaticamente a estrutura que suporta, mas podem surgir problemas se você estiver usando novas versões experimentais ou se tiver personalizado a framework. Esta configuração desativa a detecção automática framework , em vez disso instrui o agente a tentar nomear a transação de acordo com o framework especificado.

Especificar "no_framework" desativará totalmente a nomenclatura de transação relacionada framework .

Use qualquer um dos seguintes valores, conforme apropriado:

• "cakephp"

• "codeigniter"

• "drupal" (para Drupal 6 e 7)

• "drupal8" (para Drupal 8 e 9)

• "joomla"

• "laravel"

• "magento"

• "magento2"

• "mediawiki"

• "slim"

• "symfony2" (para Symfony 3 - Symfony 2.x não é suportado)

• "symfony4" (para Symfony 4 e 5)

• "wordpress"

• "yii"

• "zend"

• "zend2" (para framework Zend 2 e 3)

• "no_framework" (para não forçar nenhuma framework mesmo que uma tenha sido detectada)

  Se a detecção automática framework falhar, este comando também falhará.

  Dica

  Verifique a página de compatibilidade do PHP para obter as informações mais recentes sobre estruturas suportadas.

Use a configuração newrelic.ignored_params para especificar uma lista separada por vírgula de nomes de parâmetros a serem excluídos da lista de parâmetros enviada aos servidores New Relic. Coloque os valores da string entre aspas.

Se você ativar a captura de parâmetros com newrelic.capture_params, pode haver parâmetros com dados confidenciais do usuário que você não deseja que sejam capturados pela New Relic ou visíveis no rastreamento da transação. Use isto para bloquear a gravação desses dados.

Define a New Relic chave de licençaa ser usada. Em um sistema multilocatário, isso pode ser definido por diretório.

Define o nível de detalhe das mensagens enviadas ao arquivo de log. Os valores possíveis, em ordem crescente de detalhes, incluem:

• error

• warning

• info

• verbose

• debug

• verbosedebug

  Ao relatar qualquer problema do agente ao suporte técnico da New Relic, verbosedebug é a configuração mais útil. No entanto, isso pode gerar muitas informações muito rapidamente, portanto evite manter o agente no nível verbosedebug por mais tempo do que o necessário para reproduzir o problema que você está enfrentando.

  Ao relatar qualquer problema de agente ao suporte técnico da New Relic, você pode ser solicitado a definir isso para um nível personalizado, permitindo a depuração apenas para determinados subsistemas. Os níveis personalizados estão além do escopo deste documento.

Define o nível de detalhe em um rastreamento da transação:

• Quando definido como 1, todas as chamadas do servidor são rastreadas.

• Quando definido como 0, o rastreamento inclui apenas chamadas instrumentadas internamente pela New Relic e aquelas definidas pelo usuário usando newrelic.transaction_tracer.custom.

  O nível padrão de 1 tem impacto no desempenho. Se precisar melhorar o desempenho, tente definir o nível de detalhe como 0.

  Ao não rastrear todas as chamadas do servidor, os blocos de tempo no rastreamento da transação serão rotulados como uninstrumented time, e apenas determinadas funções (definidas internamente pelo agente) serão instrumentadas. Mesmo ao reportar todas as chamadas, pode haver tempo não instrumentado no rastreamento.

Permite alta segurança para todos os aplicativos. Quando a segurança alta é definida como true, os seguintes comportamentos entram em vigor:

• Os dados não serão enviados para a New Relic a menos que o daemon newrelic esteja usando uma conexão segura (HTTPS). Se o processo PHP gerar um daemon newrelic, ele será configurado para usar HTTPS independentemente do valor de newrelic.daemon.ssl.

• As strings de consulta brutas nunca serão coletadas, independentemente do valor de newrelic.transaction_tracer.record_sql.

• O atributo de solicitação nunca será capturado, independentemente das definições de configuração newrelic.attributes .

• As funções de API newrelic_add_custom_parameter e newrelic_set_user_attributes não terão efeito e retornarão false.

• A função da API newrelic_record_custom_event não enviará nenhum evento ao New Relic.

• O agente remove mensagens de exceção de erros.

  Cuidado

  Se você alterar a configuração newrelic.high_security , deverá also alterar a configuração de segurança na interface do usuário do APM. Se as duas configurações não corresponderem, nenhum dado será coletado. Para obter mais informações, consulte Alta segurança.

Adiciona etiqueta.

Example tags

"Server:One;Data Center:Primary"

Define o nome do host a ser exibido na interface do APM. Se definido, substitui o nome do host padrão que o agente captura automaticamente.

Define o tempo decorrido após o qual um aplicativo será considerado inativo. Aplicativos inativos não contam para o limite máximo de 250 aplicativos. As unidades permitidas são "ns", "us", "ms", "s", "m" e "h".

Um valor 0 será interpretado como "sem tempo limite". Isso resultará em novos aplicativos sempre contando para o limite de 250 aplicativos, bem como no fato de o daemon não conseguir liberar uma pequena quantidade de memória por aplicativo de volta para o sistema operacional.

Recomendação: Não use esse valor, a menos que o suporte da New Relic solicite. Em vez disso, para transações ocasionais em segundo plano, use um valor de duas vezes o intervalo. Por exemplo, para um trabalho em segundo plano por hora, defina o tempo limite para 2 horas.

Define o tempo máximo que o agente deve aguardar até que o daemon conecte um aplicativo. Um valor "0" faz com que o agente faça apenas uma tentativa de conexão com o daemon. As unidades permitidas são "ns", "us", "ms", "s", "m" e "h".

Com esse tempo limite definido, o agente não descartará imediatamente uma transação quando o daemon ainda não estiver conectado ao backend, mas concederá tempo ao daemon para estabelecer a conexão.

Recomendação: Se definir um tempo limite, o valor recomendado é "15s". Defina este timeout somente quando instrumentadas tarefas em background de longa duração, pois em caso de problemas de conexão o agente bloqueará pelo tempo limite determinado a cada início da transação.

A configuração especifica o nome de um log de auditoria, que conterá todos os dados enviados do daemon para os servidores New Relic, incluindo o URL completo, data, hora e os dados não compactados e não codificados para cada solicitação.

Este arquivo não pode ser o mesmo arquivo que o log do daemon.

Define o nome e a porta opcional do host coletor com o qual o daemon entrará em contato para verificar seu chave de licençae enviar dados do agente.

Este é apenas o nome do host ou o nome e o número da porta no formato "hostname:port". Especificar um número de porta 0 usará a porta padrão, que é 80.

Se você preferir que o daemon seja lançado externamente antes da inicialização do agente, esse valor determina quando o agente terá permissão para iniciar o daemon:

• 0: Nenhuma restrição é colocada na inicialização do daemon e o agente pode iniciar o daemon a qualquer momento.

• 1: Agente que não seja de linha de comando (como Apache ou php-fpm) pode iniciar o daemon.

• 2: Somente o agente da linha de comando pode iniciar o daemon.

• 3: O agente nunca iniciará o daemon. Use esta configuração se estiver configurando o daemon por meio de newrelic.cfg e iniciando-o fora do agente.

  Importante

  Se /etc/newrelic/newrelic.cfg existir, o agente assumirá que o daemon deve ser iniciado por seu script de inicialização, e não por meio do agente. Esta configuração não tem significado e não aparece em newrelic.cfg.

Define o nome do executável daemon para lançamento.

Esta variável identifica o caminho completo para o arquivo executável do daemon. Se o sistema New Relic foi instalado usando os pacotes padrão, o local padrão estará correto. Se você instalou em um local personalizado usando a distribuição tar (e não tem permissão para gravar em /usr/bin), o daemon poderá residir em outro local.

Esta configuração não aparece no arquivo newrelic.cfg porque é relevante apenas para PHP.

Define o nome do arquivo de log para registrar a mensagem do log específica do daemon. Este arquivo deve ser gravável pelo daemon. O caso mais comum é que o usuário do Apache acabará iniciando o daemon quando o próprio Apache for inicializado, portanto, você deve garantir que o arquivo seja gravável por qualquer usuário que execute o processo do Apache.

Define o nível de detalhe para mensagens gravadas no arquivo de log do daemon do New Relic. Os valores possíveis, em ordem crescente de detalhe, são:

• error

• warning

• info

• healthcheck

• debug

  As configurações mais detalhadas podem gerar muitas informações muito rapidamente. healthcheck registre o número exato de aplicativos conectados. Quando necessário, defina debug por curtos períodos de tempo para identificar problemas.

Define o nome do arquivo no qual o daemon registrará seu ID de processo (pid).

Este arquivo é usado pelo script de inicialização e desligamento do daemon para determinar se o daemon já está ou não em execução.

Define o endpoint do soquete para comunicações do agente com o daemon.

Isso pode ser especificado de quatro maneiras.

• Para usar um arquivo especificado como um soquete de domínio UNIX (UDS), forneça um nome de caminho absolute como uma string. Este é o padrão em sistemas não-Linux.

• Para usar uma porta TCP padrão, especifique um número no intervalo de 1 a 65534.

• Para usar um soquete abstrato, use o valor @newrelic-daemon (disponível para agente versão 5.2.0.141 ou superior). Este é o padrão em sistemas Linux.

• Para conectar-se a um daemon que está sendo executado em um host diferente (útil para ambientes de contêiner), defina esse valor como host:port, onde host denota um nome de host ou um IP e port denota um número de porta válido. Tanto IPv4 quanto IPv6 são suportados. Isto está disponível para a versão do agente 9.2.0.247 ou superior.

  Cuidado

  Os dados transmitidos do agente para o daemon não são criptografados. A única exceção a isso é a ofuscação SQL que ocorre antes do envio de dados para o daemon. Recomendamos usar apenas uma conexão de rede privada entre o agente e o daemon (isso só se aplica quando o agente e o daemon estão sendo executados em hosts diferentes).

  Se você usar números de porta, os sistemas Unix exigem que as portas no intervalo de 1 a 1023 exijam que o daemon seja executado como super-usuário. Caso o daemon utilize uma porta não padrão, esta variável também define o número da porta que o agente utilizará para se comunicar com o daemon.

  Importante

  Se você estiver usando o mecanismo de inicialização newrelic.cfg para o daemon, essa configuração e a configuração address nesse arquivo deverão corresponder.

Define as credenciais do host e do usuário para usar como proxy de saída.

Isso só será usado se o seu site exigir um proxy para acessar os servidores de coleta de dados da New Relic. Pode assumir qualquer uma das seguintes formas, dependendo da configuração do proxy:

• hostname

• hostname:port

• user@hostname

• user@hostname:port

• user:password@hostname

• user:password@hostname:port

• proxytype://user:password@hostname:port

  Um tipo de proxy HTTP é assumido, a menos que outro tipo de proxy seja especificado. Nesse caso, o proxytype pode ser http, meias4, meias4a ou meias5.

Essa configuração é ignorada nas versões 8.0 e superiores do agente PHP, e HTTPS sempre será usado para comunicação com o New Relic.

Nas versões do agente PHP inferiores a 8.0, controla se a comunicação com o coletor New Relic deve ou não utilizar uma conexão HTTP segura. O agente se comunica com o New Relic via HTTPS por padrão, e o New Relic requer HTTPS para todo o tráfego para o APM e a API REST do New Relic.

Define o local de um arquivo que contém certificados CA no formato PEM. Quando definidos, os certificados neste arquivo serão usados para autenticar o coletor New Relic. Na maioria dos casos, não será necessário configurar um pacote de CA. O agente PHP New Relic vem com os certificados CA necessários.

Se newrelic.daemon.ssl_ca_path também estiver definido, os certificados neste arquivo serão pesquisados primeiro, seguidos pelos certificados contidos no diretório newrelic.daemon.ssl_ca_path .

Esta configuração não tem efeito quando newrelic.daemon.ssl está definido como false.

Define o local de um diretório que contém certificados de CA confiáveis no formato PEM. Quando definidos, os certificados neste diretório serão usados para autenticar o coletor New Relic. Na maioria dos casos não será necessário configurar um caminho de CA. O agente PHP New Relic vem com os certificados CA necessários.

Se newrelic.daemon.ssl_ca_bundle também estiver definido, ele será pesquisado primeiro, seguido pelos certificados contidos em newrelic.daemon.ssl_ca_path.

Esta configuração não tem efeito quando newrelic.daemon.ssl está definido como false.

Define o tempo máximo que o agente deve esperar até que o daemon seja iniciado após o lançamento do daemon ter sido acionado. Um valor "0" faz com que o agente não espere. As unidades permitidas são "ns", "us", "ms", "s", "m" e "h".

O valor de tempo limite especificado será transmitido ao daemon por meio do sinalizador --wait-for-port . Isso faz com que a inicialização do daemon seja bloqueada até que um soquete seja adquirido ou até que o tempo limite termine.

Recomendação: Se definir um tempo limite, o valor recomendado será "2s" a "5s". Recomenda-se definir este timeout apenas quando forem instrumentadas tarefas em segundo plano de longa duração, pois em caso de problemas de inicialização daemon o agente bloqueará pelo tempo limite determinado a cada início da transação.

• Defina como true para ativar o recurso principal de logs contextualizados. Quando habilitado, a instrumentação adicional framework de log é habilitada, independentemente de os logs serem enviados ou não para o New Relic.

• Defina como false para desativar completamente esse recurso, incluindo a coleta de métricas log e encaminhamento de logs.

• Logs contextualizados agora está habilitado por padrão. Se você desativou esse recurso, reinicie o aplicativo ou as alterações não terão efeito imediato.

  Um exemplo de arquivo de configuração:

  newrelic.application_logging.enabled = true
  newrelic.application_logging.metrics.enabled = true
  newrelic.application_logging.forwarding.enabled = true

  Copiar

Habilita o envio de log do aplicativo para New Relic.

• Defina como true para que seu registro seja enviado para a New Relic. Isso encaminha o log diretamente do agente PHP com metadados de vinculação que permitem que nosso recurso log-in-context funcione. O agente PHP não grava nenhum metadado na saída do log do aplicativo.

• Defina como false se não quiser que seu registro seja enviado para a New Relic. Quando enabled é definido como false, nenhum dado de log é enviado para o New Relic e a saída do log do aplicativo permanece inalterada.

  Exemplo de arquivo de configuração (newrelic.ini):

  newrelic.application_logging.enabled = true

  Copiar

  Se você tiver uma solução de encaminhamento de logs existente e estiver atualizando seu agente para usar o logs contextualizados automáticos, certifique-se de disable your old log forwarder. Caso contrário, seu aplicativo enviará linhas de log duplas. Dependendo da sua conta, isso pode resultar em cobrança dupla. Para obter mais informações, siga os procedimentos para desabilitar seu direcionador de logs específico.

  Importante

  Usar o recurso de encaminhamento de logs aumenta a ingestão de dados, o que pode afetar seu faturamento. Para obter mais informações, consulte nossa documentação sobre como rastrear a ingestão de dados.

• Configure o valor como um número inteiro positivo para especificar o número máximo de linhas de log por minuto a serem enviadas.

• Defina como 0 para desativar efetivamente o envio de log.

• Defina um valor mais baixo para reduzir a quantidade de linhas de log enviadas. Isso pode causar amostragem de log.

• Defina um valor mais alto para enviar mais linhas de log.

  Cada log recebe a mesma prioridade que sua transação associada. Alguns registros podem não ser incluídos porque estão limitados por max_samples_stored. Por exemplo, se o registro em log max_samples_stored estiver definido como 10.000 e uma transação 1 tiver 10.000 entradas de log, somente as entradas de log da transação 1 serão registradas. Se a transação 1 tiver menos de 10.000 logs, você receberá todos os logs da transação 1. Se ainda houver espaço, você receberá todo o log da transação 2 e assim por diante. As entradas de log com prioridades mais altas são mantidas em detrimento daquelas com prioridades mais baixas.

  Dica

  Refere-se ao número de logs enviados por minuto. Definir max_samples_stored com um valor menor que 12 fará com que nenhum registro seja enviado. Qualquer número inteiro não negativo é válido, mas atualmente o valor máximo suportado é 20.000.

  Exemplo de arquivo de configuração (newrelic.ini):

  newrelic.application_logging.forwarding.max_samples_stored = 10000

  Copiar

É possível controlar o nível de log das mensagens encaminhadas pelo agente. O nível de log reconhecido segue a especificação PSR-3 e é o seguinte (da maior para a menor gravidade):

• EMERGENCY

• ALERT

• CRITICAL

• ERROR

• WARNING

• NOTICE

• INFO

• DEBUG

  Quando um nível de log for especificado para o agente, todas as mensagens desse nível de log e superiores serão relatadas. Por exemplo, se você definir seu nível de log como ALERT, você receberá o log para a gravidade ALERT e EMERGENCY . O nível de log padrão é WARNING.

  Exemplo de arquivo de configuração (newrelic.ini):

  newrelic.application_logging.forwarding.log_level = "INFO"

  Copiar

• Defina como true para adicionar dados de contexto como atributo de registro.
• Defina como false se não desejar que dados de contexto sejam adicionados como atributo ao seu registro.

Quando você aplica regras de atributo para log atributo de contexto, a regra include descarta todos os atributo não definidos no conjunto de regras. Este é um comportamento diferente de outros tipos de atributo de agente.

• Se os atributos do contexto log não aparecerem conforme o esperado, revise o conjunto de regras newrelic.attributes.include para confirmar se os atributos ausentes fazem parte da exclusão. Recomendamos que você defina newrelic.loglevel=verbosedebug para ativar também a mensagem detalhada do log do agente. Depois de atualizado, procure mensagens do agente sobre atributo excluído. Isso pode lhe dar uma dica sobre como ajustar as regras de inclusão/exclusão.
• Se context_data estiver habilitado para encaminhamento de logs, todas as chaves de atributo encontradas nesta lista aparecerão nos registros de log. Uma lista vazia enviará todas as chaves de atributo como padrão.
• Se todas as listas include estiverem vazias, todos os atributos de contexto de log serão encaminhados.

• Se context_data estiver habilitado para encaminhamento de logs, todas as chaves de atributo encontradas nesta lista serão excluídas dos registros de log.
• Deixar este campo vazio resulta em comportamento padrão. atributo ainda poderá ser excluído se existir uma regrainclude .
• A lista include e exclude seguem as regras definidas em Habilitando e desabilitando atributo.

Isso permite a adição de vinculação de metadados aos registros de log do Monolog. Defina como true para ativar esse recurso. Deixe definido como false se estiver usando o recurso de encaminhamento de logs do APM para encaminhar seus logs para o New Relic.

Possibilita a captura de informações métricas sobre seu log e nível de log, que são exibidas em gráfico na página Summary do APM.

Deixe definido como verdadeiro para permitir que o agente capture informações métricas sobre seu log.

Defina como false para desativar esse recurso.

Defina isto como uma lista separada por vírgulas de funções ou métodos definidos pelo usuário para o instrumento:

"myfunction,myclass::method,otherfunction"

Funções internas do PHP não podem ter rastreamento personalizado.

Você pode adicionar funções personalizadas à lista com cada arquivo PERDIR, mas não pode remover uma função ou método que já tenha sido adicionado. Se você quiser adicionar funções ou métodos programaticamente a serem instrumentados, use a chamada de função da API newrelic_add_custom_tracer() .

Habilita ou desabilita o tracer de transação.

O tracer cria um rastreamento detalhado da transação para transações que levam mais tempo que o limite, conforme definido pelo valor newrelic.transaction_tracer.threshold. Apenas um rastreamento da transação por aplicação por ciclo de colheita é armazenado e é sempre a transação mais lenta durante esse ciclo.

trace da transação são úteis para diagnosticar porque uma determinada transação foi lenta. A menos que a memória e o desempenho sejam críticos, eles quase nunca devem ser desativados. Ativar isso tem um impacto muito leve no desempenho e usa mais memória.

Para obter mais informações, consulte newrelic.transaction_tracer.detail.

Habilita ou desabilita a solicitação de planos explicativos do MySQLi e da biblioteca PDO MySQL para chamadas de consulta lenta. Os planos Explicar só estarão disponíveis quando newrelic.transaction_tracer.slow_sql estiver definido como true e newrelic.transaction_tracer.record_sql não estiver definido como "off".

Define o limite além das consultas que são consideradas "lentas" e, portanto, candidatas à página Slow Queries . Especifique a duração como um valor absoluto com unidades. A unidade padrão é milissegundos se nenhuma for especificada.

Example durations

• "200ms"
• "1s250ms"
• "1h30m"
• "750us"

Ativa ou desativa o suporte para rastreamento de funções internas (ou seja, funções escritas em C e fornecidas por meio da biblioteca padrão PHP ou de extensões PECL). Quando habilitadas, as funções internas aparecem no trace da transação como funções escritas em PHP.

Habilitar esta opção pode resultar em uma transação mais lenta, especialmente ao coletar muitos rastros do PHP 5.x. A ativação desta opção só é recomendada ao depurar especificamente problemas de desempenho em que há suspeita de lentidão de uma função interna.

Define como as consultas são registradas (se forem).

Ao registrar internamente o trace da transação, é gravada a consulta completa das chamadas de consulta lenta. Enviar esta consulta para o New Relic pode ter sérias implicações de segurança; portanto, por padrão, todas as instruções do banco de dados são ofuscadas antes de serem enviadas para o New Relic. A ofuscação não é reversível, pois substitui strings e números em qualquer consulta por pontos de interrogação. As únicas coisas que sobrevivem intactas são os nomes dos campos, e não qualquer um dos seus valores.

• Se você estiver testando com dados que não são confidenciais e precisar ver a consulta bruta no trace da transação, defina como "raw".

• Se você não quiser que a consulta seja gravada, defina como "off".

  Importante

  Sempre defina como "obfuscated" ou "off" em qualquer ambiente de produção.

Use esta configuração para ativar ou desativar o recurso de consulta lenta. Quando ativado, ele irá:

• Registre as 10 consultas ao banco de dados mais lentas por aplicação por minuto.

• Crie um stack trace que leva à consulta.

  Se esta variável estiver definida como false ou a gravação SQL estiver desativada, o agente New Relic não coletará dados de consulta lenta.

Isso define o limite acima do qual o agente registrará a stack PHP completa para o rastreamento da transação para a qual as consultas estão sendo registradas.

Especifique a duração como um valor absoluto com unidades. A unidade padrão é milissegundos se nenhuma for especificada.

Example durations

• "200ms"

• "1s250ms"

• "1h30m"

• "750us"

  O rastreamento de pilha pode consumir memória, portanto, tome cuidado para não definir esse valor muito baixo. Esta variável não tem significado se newrelic.transaction_tracer.record_sql estiver definido como "off".

Use esta variável para definir o limite além do qual as transações são elegíveis para rastreamento. Os valores disponíveis incluem:

• Use "apdex_f" para definir o limite como 4 vezes o valor apdex_t do aplicativo. Para obter mais informações, consulte Apdex: Medindo a satisfação do usuário.

• Use qualquer outra sequência de duração para definir um limite de tempo específico. Especifique a duração como um valor absoluto e a unidade de medida. Se nenhum for especificado, a unidade será padronizada em milissegundos.

  Example durations

• "200ms"

• "1s250ms"

• "1h30m"

• "750us"

Use esta configuração para ativar ou desativar a coleta de consulta de entrada DQL com consulta lenta e rastreamento da transação. Quando habilitados, aparecerão junto com consulta lenta e rastreamento da transação.

Especifica o número máximo de segmentos que o agente PHP deverá registrar para transação da web. Quando esse máximo for atingido, a amostragem ocorrerá.

O agente PHP relata o rastreamento da transação e o rastreamento distribuído como uma coleção de segmentos. Cada segmento representa um método ou uma chamada de função em um rastreamento da transação. O valor padrão para esta configuração é 0, indicando que o agente PHP deverá capturar todos os segmentos durante uma transação da web. Ao final de uma transação, ele reúne os segmentos de maior prioridade para reportar em um rastreamento da transação.

Para processos PHP de longa execução com centenas de milhares ou milhões de chamadas de função, definir um valor maior que 1 evita que o agente PHP esgote a memória do sistema ao gravar segmentos.

O tamanho do segmento pode variar com base no comprimento do nome do método correspondente, no comprimento do nome da classe e no número de chamadas subsequentes feitas pelo método. Dito isto, uma estimativa conservadora é de 400 bytes por segmento. Para limitar o agente PHP a 40 MB para captura de segmento, configure esse valor como 100000. Se esse valor for definido abaixo de 2000, limitará ainda mais o número total de segmentos relatados para rastreamento da transação.

Esta definição de configuração é apenas para processos web PHP; isso não afetará os processos PHP CLI. Para definir um limite para processos CLI, use newrelic.transaction_tracer.max_segments_cli.

Especifica o número máximo de segmentos que o agente PHP deve registrar para transação CLI. Quando esse máximo for atingido, a amostragem ocorrerá.

O agente PHP relata o rastreamento da transação e o rastreamento distribuído como uma coleção de segmentos. Cada segmento representa um método ou uma chamada de função em um rastreamento da transação. O valor padrão para esta configuração é 100000, indicando que o agente PHP deverá capturar todos os segmentos durante uma transação da web. Ao final de uma transação, ele reúne os segmentos de maior prioridade para reportar em um rastreamento da transação.

Para processos PHP de longa execução com centenas de milhares ou milhões de chamadas de função, definir um valor maior que 1 evita que o agente PHP esgote a memória do sistema ao gravar segmentos.

O tamanho do segmento pode variar com base no comprimento do nome do método correspondente, no comprimento do nome da classe e no número de chamadas subsequentes feitas pelo método. Dito isto, uma estimativa conservadora é de 400 bytes por segmento. Para limitar o agente PHP a 40 MB para captura de segmento, configure esse valor como 100000. Se esse valor for definido abaixo de 2000, limitará ainda mais o número total de segmentos relatados para rastreamento da transação.

Esta definição de configuração é apenas para processos PHP CLI; isso não afetará os processos web PHP. Para definir um limite para processos da web, use newrelic.transaction_tracer.max_segments_web.

Habilite ou desabilite o tracer multiaplicativo. O tracer multiaplicativo insere cabeçalhos HTTP nas solicitações de saída e na resposta para vincular a transação da web métrica e o rastreamento da transação entre aplicativos.

Distributed tracing e o rastreamento multiaplicativo não podem ser usados simultaneamente. A configuração padrão do agente PHP habilita distributed tracing e desabilita o rastreamento multiaplicativo.

Habilite ou desabilite o distributed tracing. Ele está ativado por padrão no agente PHP 9.21.0 e superior. Quando o tracer de transação e o recurso distributed tracing do agente estão habilitados, o agente inserirá cabeçalhos nas solicitações de saída e verificará as solicitações recebidas em busca de cabeçalhos distributed tracing .

newrelic.transaction_tracer.enabled = true
newrelic.distributed_tracing_enabled = true

Para obter mais informações, consulte distributed tracing para seus serviços PHP.

Defina isso como verdadeiro para excluir o cabeçalho distributed tracing New Relic que está anexado às solicitações de saída e, em vez disso, confiar apenas nos cabeçalhos W3C Trace Context para distributed tracing. Se for falso, ambos os tipos de cabeçalhos serão anexados às solicitações de saída.

O cabeçalho distributed tracing New Relic permite interoperabilidade com agentes mais antigos que não suportam cabeçalhos W3C Trace Context . As versões do agente que suportam cabeçalhos W3C Trace Context os priorizarão em relação aos cabeçalhos New Relic para distributed tracing.

Os eventos Span são relatados para distributed tracing. O relatório de eventos de extensão requer que distributed tracing esteja habilitado. Esta opção habilita/desabilita o reporte do evento span.

Os eventos Span são relatados para distributed tracing. Este valor define o número máximo de eventos de span enviados ao coletor por ciclo de coleta. Um valor 0 usará o padrão do agente 2000. A configuração máxima é 10000.

Configura o observador trace usado para rastreamento infinito. Se estiver vazio, o suporte ao Rastreamento Infinito será desativado. Isso requer que distributed tracing e o evento span estejam habilitados.

Configura a porta TCP/IP usada para comunicação com o Observador trace do Infinite Tracing. Esta configuração será ignorada se newrelic.infinite_tracing.trace_observer.host estiver vazio. Geralmente, essa configuração não precisará ser alterada.

Configura o número de eventos de span que podem ser enfileirados para transmissão para o Observador trace de rastreamento infinito. O agente gerencia internamente o evento span para rastreamento infinito em lotes span. Esses lotes de span podem conter no máximo 1.000 spans. Portanto, o tamanho da fila de eventos span não pode ser inferior a 1000, caso contrário, nem mesmo um único lote span poderá ser enfileirado. Se um tamanho de fila inferior a 1.000 for especificado, o tamanho mínimo de 1000 será usado.

Ative ou desative o coletor de erros. Quando ativado, o agente coleta e relata erros de PHP para a interface do New Relic.

O agente registra apenas o erro mais grave para cada transação e até 20 erros por ciclo de coleta.

Quando habilitado, o agente coleta erros retornados pelas funções do MySQL como se fossem erros de PHP.

Defina como true para atribuir a prioridade mais alta aos erros identificados por meio da função de API newrelic_notice_error() .

Observação: quaisquer erros não detectados receberão uma prioridade ainda maior, de modo que terão precedência sobre os erros relatados pela função newrelic_notice_error() da API.

Uma lista separada por vírgulas de nomes de classes de exceção totalmente qualificados que o agente deve ignorar. Quando ocorrer uma exceção não tratada, o agente executará o equivalente a $exception instanceof Class para cada uma das classes listadas. Se alguma dessas verificações retornar verdadeiro, o agente não registrará uma exceção.

Dependendo da versão do PHP suportada, estes valores são equivalentes a disabling relatórios de exceção:

• Versões do PHP 5 suportadas: newrelic.error_collector.ignore_exceptions = Exceptions
• Versões do PHP 7 suportadas: newrelic.error_collector.ignore_exceptions = Throwable

Define os níveis de erro do agente PHP como ignore. O valor desta configuração usa sintaxe semelhante à opção error_reporting do PHP. Por exemplo, para configurar o agente PHP para ignorar erros de nível E_WARNING e E_ERROR , use:

newrelic.error_collector.ignore_errors = E_WARNING | E_ERROR

ou

newrelic.error_collector.ignore_errors = 3

Para configurar o agente PHP para ignorar tudo, exceto E_WARNING, use:

newrelic.error_collector.ignore_errors = E_ALL & ~E_WARNING

Para ativar o rastreamento do módulo Drupal, defina como true. Esta opção tem o mesmo impacto no desempenho que newrelic.transaction_tracer.detail. Ele permitirá a gravação das funções do módulo Drupal e contagens de chamadas, e elas serão exibidas na guia Modules , assim como a transação da web.

Para ativar o rastreamento de gancho do WordPress, defina como true. Ele permitirá a gravação de ganchos, plug-ins e temas do WordPress, e eles serão exibidos na guia WordPress na interface do New Relic.

Define as opções de como os hooks do WordPress são instrumentados. O agente New Relic pode fornecer diferentes níveis de insights sobre ganchos do WordPress. Por padrão, apenas plug-in/tema de retorno de chamada são instrumentados ("plugin_callbacks"). Ao custo do aumento da sobrecarga do agente, é possível estender a instrumentação para todas as funções de retorno de chamada de gancho ("all_callbacks"). A terceira opção é monitor hooks sem retorno de chamada instrumentado ("threshold"). Esta opção não fornece insights sobre plug-ins/temas. Leia mais sobre a instrumentação específica do WordPress aqui.

Define o limite acima do qual o agente New Relic registrará a execução do gancho do WordPress. Usado quando newrelic.framework.wordpress.hooks.options está definido como "limite".

É o mesmo que newrelic.webtransaction.name.functions, exceto que usa nomes de arquivo para nomear a transação da web. Os nomes dos arquivos podem ser expressões regulares POSIX padrão para serem usadas com PCRE; por exemplo, "controllers/actions/.*".

A menos que o agente New Relic detecte um framework específico, como Drupal ou Wordpress, as transações da web recebem o nome do arquivo PHP inicial; por exemplo, article.php.

Quando o arquivo inicial é um despachante, esse esquema de nomenclatura produz dados menos que úteis. Utilize esta variável para especificar uma lista de funções que são as "ações" geradas pelo despachante. O nome da transação da web será a primeira função de ação executada.

Example dispatch function naming

Se index.php for despachado para funções nomeadas:

• login,

• logout,

• admin,

• show, e

• edit

  Você definiria esse valor como "login,logout,admin,show,edit".

  A transação da web será nomeada login, logout, etc. em vez de /index.php (o nome inicial do arquivo).

Quando ativado, remove qualquer conteúdo do URI da solicitação após o nome do script. Por exemplo, isso removeria o /xyz/zy final de /path/to/foo.php/xyz/zy.

Se false, o agente não reportará métrica da instância do datastore, nem adicionará parâmetro host ou port_path_or_id à operação ou rastreamento sql lento.

Se false, o agente não adicionará o parâmetro database_name à transação ou ao rastreamento SQL lento.

Habilite ou desabilite a coleta de atributo gerado pelo agente PHP ou gerado pelo usuário através de newrelic_add_custom_parameter(). Esta configuração terá precedência sobre todas as outras configurações do atributo.

Para obter mais informações, consulte Habilitando e desabilitando atributo.

Controle quais destinos recebem atributo. Essas definições de configuração substituirão as configurações .include e .exclude .

Para mais informações sobre os destinos disponíveis, consulte Habilitando e desabilitando atributo.

Esta é uma família de opções de configuração que permite um controle preciso sobre os destinos do atributo. Para obter mais informações, consulte Habilitando e desabilitando atributo.

Habilite ou desabilite a coleta de eventos gerados pelo usuário por meio de newrelic_record_custom_event(). Esta configuração terá precedência sobre todas as outras configurações do atributo.

Para obter mais informações, consulte Relatório de evento personalizado e atributo.

Um número inteiro positivo que especifica o número máximo de eventos personalizados por minuto a serem enviados.

Definir como 0 desativará efetivamente o envio de evento personalizado. A configuração newrelic.custom_insights_events.enabled é a forma preferida de ativar ou desativar a geração de eventos personalizados.

Defina um valor mais baixo para reduzir a quantidade de eventos personalizados enviados (pode causar amostragem de eventos personalizados). Defina um valor mais alto para enviar mais linhas de eventos personalizados.

Habilite ou desabilite a coleta do nível do código métrico.

O commit sha. O sha inteiro pode ser usado ou apenas os primeiros sete caracteres (por exemplo, 734713b).

Uma tag de lançamento (como v0.1.209 ou release-209).

Quando definido como true, o agente enviará informações de detecção de pacotes que podem ser visualizadas na página do ambiente.

Quando definido como true, o agente tentará usar a API de tempo de execução do Composer para detecção de pacotes.

Ative ou desative o agente New Relic. Por padrão, o agente PHP New Relic está habilitado para todos os diretórios.

Se você possui vários sites em seu servidor web, mas deseja que o agente PHP monitor apenas sites específicos:

1. Certifique-se de que newrelic.enabled esteja definido como true no nível global (SYSTEM) em seu arquivo newrelic.ini .

2. Defina newrelic.enabled como false para um ou mais sites específicos por diretório (PERDIR).

   Se precisar desativar o agente globalmente, defina o valor newrelic.enabled como false no arquivo newrelic.ini .

   Quando o agente está desativado globalmente, ele não é inicializado completamente. Ele pressupõe que você o está desativando globalmente por um motivo crítico e que o agente tentará ter o impacto mais próximo possível de zero no PHP.

   Importante

   Você não pode desativar globalmente o agente e depois ativá-lo seletivamente por diretório usando .htaccess.

Isso identifica o nome do arquivo para registrar mensagens. Isso é útil para depurar quaisquer problemas com o agente. Independentemente do que você definir, certifique-se de que:

• As permissões para o diretório que contém e o próprio arquivo estão corretas.
• O usuário que executa o PHP pode gravar no arquivo. Geralmente este é o mesmo usuário do servidor web.

Quando definido como true, o agente coletará e reportará dados de eventos analíticos. Os dados do evento permitem que a interface do New Relic mostre informações adicionais como histograma e percentil.

Quando definido como true, o agente coletará e reportará dados de eventos de erro. Os dados do evento permitem que a interface do New Relic mostre análises de erros.

Esta configuração habilita recursos novos e experimentais dentro do agente PHP. Esses flags são usados para habilitar seletivamente recursos que devem ser habilitados por padrão em versões posteriores do agente PHP.

Isso permite a inserção automática dos fragmentos JavaScript para monitoramento de browser. Quando habilitado fará com que o agente insira um cabeçalho e um rodapé na saída HTML que irá gerar métricas no tempo de carregamento da página para a experiência do usuário final. Para obter mais informações, consulte Tempo de carregamento da página em PHP.

Ativa ou desativa o suporte para a biblioteca Guzzle quando usada com New Relic.

• Agente PHP versão 6.4 ou superior: esta configuração é definida como true por padrão.

Permite a detecção de framework e biblioteca quando o pré-carregamento está habilitado. O pré-carregamento foi introduzido no PHP versão 7.4. newrelic.preload_framework_library_detection só terá efeito quando opcache.preload for definido no arquivo php.ini .