• EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Configuração do agente PHP

Nosso agente PHP possui diversas configurações para ajustar os tipos e quantidades de dados relatados. Para a maioria dos usuários, os valores padrão produzem a melhor combinação possível de sobrecarga e utilidade. No entanto, você pode alterar as configurações de acordo com suas necessidades específicas.

Importante

Sempre reinicie seu servidor web após alterar as configurações INI. Caso contrário, poderão não entrar em vigor imediatamente.

Ordem de precedência de configuração

Aqui está uma ilustração simples da ordem de precedência que o agente PHP segue para configuração. A configuração no lado do servidor não é aplicável. Os únicos valores que você pode alterar na interface do usuário para aplicativos que usam o agente PHP são o alias do aplicativo e seu valor Apdex-T.

Com a API PHP da New Relic, as configurações do agente substituem as configurações de configuração por diretório. As configurações por diretório substituem as configurações do arquivo php.ini . A configuração no lado do servidor não é aplicável.

Variáveis do arquivo de configuração

Durante a instalação, o script newrelic-install fornece informações sobre os arquivos de configuração criados ou uma lista de arquivos que você precisa editar. Por padrão, ele tentará criar um arquivo de configuração denominado newrelic.ini.

Em alguns casos, você pode ser instruído a adicionar opções de configuração ao arquivo php.ini . Faça isso apenas se necessário. Exatamente qual arquivo você precisa editar depende de como sua versão (ou versões) específica do PHP foi configurada.

As duas configurações mais comuns são:

  • Use um único arquivo newrelic.ini . Este é geralmente o padrão se você mesmo instalou ou compilou o PHP sem opções especiais.
  • Varre um determinado diretório em busca de todos os .ini arquivos.

Se você não tiver certeza de qual arquivo editar:

  • Na linha de comando, revise a saída de php -i.

  • Em um browser, revise a saída de uma página que contém o script:

    <?php phpinfo(); ?>
  • Se o arquivo newrelic.ini aparecer, use-o.

Escopo variável

Cada variável do arquivo newrelic.ini tem um escopo definido. O escopo controla onde a configuração pode ser estabelecida ou modificada.

Os dois escopos suportados pelas configurações do New Relic são:

  • SYSTEM: valores definidos globalmente no arquivo newrelic.ini global.
  • PERDIR: Valores definidos por diretório .

Cada um também pode ser definido em um nível mais geral. Os locais válidos para cada um são:

Can be set for:

SISTEMA

PERDER

Definido no arquivo newrelic.ini global.

Definido por diretório.

Importante

Você não pode usar ini_set() para configurações do New Relic.

Tipo de variável

Cada variável do arquivo newrelic.ini possui um tipo definido. O tipo especifica a sintaxe do valor que você usa.

Variable type

Formatting and contents

String

Os valores de string podem conter qualquer caractere alfanumérico e pontuação. O valor é delimitado por aspas.

Boolean

Uma configuração lógica verdadeira ou falsa. Os valores válidos são:

  • Para verdadeiro ou ativado: on, true, o número 1.
  • Para falso ou desabilitado: off, false, o número 0.

Number

Os valores numéricos podem conter apenas dígitos, além de um ponto para indicar flutuação. Salvo indicação em contrário, todos os números são inteiros, não flutuantes.

Duration

Um valor de string delimitado por aspas que representam uma duração de tempo. Use sinalizadores de caracteres para delimitar componentes de tempo. Se não houver sinalizadores, o tempo será em milissegundos.

  • w\= semanas

  • d\= dias

  • h\= horas

  • m\= minutos

  • s\= segundos

  • ms\= milissegundos

  • us\= microssegundos

    Durações de exemplo:

  • "1w3d23h10m"\= 1 semana, 3 dias, 23 horas e 10 minutos

  • "5h30m"\= 5 horas e 30 minutos

  • "500"\= 500 milissegundos

Configurações gerais de configuração

Essas configurações estão disponíveis no arquivo newrelic.ini .

Se você estiver usando New Relic CodeStream para monitor o desempenho do seu IDE, talvez você também queira associar o repositório aos seus serviços e associar SHAs de compilação ou tags de lançamento aos erros.

Daemon .ini configurações

Os valores dessas configurações controlam a inicialização do daemon. Quando o agente detectar que o daemon precisa ser iniciado, ele converterá essas opções nas opções de linha de comando apropriadas para o daemon.

Todas essas configurações refletem as configurações do arquivo newrelic.cfg . Eles são repetidos aqui para manter todo o .ini configurações em um só lugar. Cada configuração em newrelic.cfg tem sua contraparte aqui, com newrelic.daemon. como prefixo. Por exemplo, a configuração ssl em newrelic.cfg é newrelic.daemon.ssl em um arquivo .ini arquivo.

Importante

Se o arquivo /etc/newrelic/newrelic.cfg existir, o agente ignorará essas configurações e não iniciará o daemon automaticamente.

Para obter mais informações sobre maneiras de iniciar o daemon e quando usar um arquivo de configuração externo, consulte Modos de inicialização do daemon PHP.

Logs contextualizados

Agente PHP versão 10.1.0 permite encaminhar seu log PHP com logs contextualizados APM. A partir da versão 10.3.0, a métrica de registro e o recurso de encaminhamento de logs do agente estão habilitados por padrão. O valor newrelic.application_logging.enabled controla se o recurso de logs contextualizados está ativo ou inativo.

Lembre-se de que a alteração das configurações no arquivo de configuração do agente local (newrelic.ini) requer a reinicialização do servidor Web para que entrem em vigor. Caso contrário, as alterações poderão não entrar em vigor imediatamente.

Encaminhamento de log

Se você estiver usando uma framework de registro em log compatível, poderá instruir o agente a encaminhar os logs do seu aplicativo para o New Relic.

  • newrelic.application_logging.forward.enabled ativa ou desativa o encaminhamento de logs
  • newrelic.application_logging.forwarding.max_samples_stored limita quantos registros seu aplicativo encaminha para o New Relic
  • newrelic.application_logging.forwarding.log_level permite escolher quais tipos de log seu aplicativo encaminha para o New Relic

Log dados de contexto

O agente PHP captura dados de contexto para a biblioteca Monolog e adiciona esse contexto como atributo ao seu log encaminhado. Você pode controlar qual contexto seu agente adiciona por meio das configurações na seção context_data , dentro da seção forwarding .

  • newrelic.application_logging.forwarding.context_data.enabled adiciona dados de contexto do Monolog ao seu atributo de logs
  • newrelic.application_logging.forwarding.context_data.include define quais chaves de atributo são encontradas no seu log encaminhado
  • newrelic.application_logging.forwarding.context_data.exclude define quais chaves de atributo serão excluídas do seu log encaminhado

Importante

O agente PHP encaminha apenas dados de contexto de log que possuem uma chave de string e um valor, que é uma string ou escalar (int, double, boolean).

Decoração log

O agente PHP pode coletar e adicionar metadados de vinculação aos registros log do Monolog para permitir que os logs contextualizados funcionem com dados log encaminhados por um terceiro direcionador de logs. Para ativar esse recurso use a opção newrelic.application_logging.local_decorating.enable :

Log métrico

O agente PHP pode coletar métricas relacionadas ao evento de log para a estrutura de log suportada. A criação destas métricas é controlada pela opção newrelic.application_logging.metrics.enable :

Importante

Se você tiver uma solução de encaminhamento de logs existente e estiver atualizando seu agente para usar o logs contextualizados automático, certifique-se de disable your manual log forwarder. Caso contrário, seu aplicativo enviará o dobro dos dados de log. 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.

tracer de transação .ini configurações

Os valores dessas configurações são utilizados para controlar o rastreamento da transação.

Outro tracer .ini configurações

Os valores dessas configurações são usados para controlar vários recursos tracer .

Configurações de atributo

Esta seção lista as configurações que afetam a coleta e os relatórios de atributos.

Evento personalizado

Esta seção lista as configurações que afetam os relatórios de eventos personalizados.

Métrica al nível do código

Esta seção lista as configurações que afetam o relatório do nível do código métrico.

Configuração Errors Inbox

Definir uma das tags a seguir ajudará você a identificar quais versões do seu software estão produzindo erros.

  • NEW_RELIC_METADATA_SERVICE_VERSION irá criar tag.service.version nos dados do evento contendo a versão do seu código que está implantada, em muitos casos uma versão semântica como 1.2.3, mas nem sempre.
  • NEW_RELIC_METADATA_RELEASE_TAG criará tags.releaseTag nos dados do evento contendo a tag de lançamento (como v0.1.209 ou release-209).
  • NEW_RELIC_METADATA_COMMIT criará tag.commit nos dados do evento contendo o commit sha. O sha inteiro pode ser usado ou apenas os primeiros sete caracteres (por exemplo, 734713b).

Uma próxima versão da Errors Inbox rastreará automaticamente quais versões do seu software estão produzindo erros. Quaisquer dados de versão também serão exibidos no CodeStream.

Outro .ini configurações

Esta seção lista as configurações restantes do newrelic.ini.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.