O agente PHP da New Relic fornece uma API para personalizar o comportamento do agente. O agente utiliza automaticamente muitos frameworks PHP populares, mas você pode usar a API PHP para instrumentar atividades que o agente ainda não utiliza por padrão.
Este guia descreve a chamada de API do PHP para diversas tarefas comuns; por exemplo:
- Observe ou ignore erros específicos.
- Dê um nome a uma transação.
- Renomeie o aplicativo que relata os dados.
Dica
Você também pode definir muitas dessas opções por diretório ou em newrelic.ini. Se a configuração for via API, a API terá precedência sobre os outros métodos.
Aviso ou erro ignorado
Normalmente, o agente detecta erros automaticamente. No entanto, você pode marcar manualmente um erro com o agente.
Se você quiser... | Fazem isto... |
|---|---|
Relatar um erro que o agente não reporta automaticamente | Consulte |
Ignorar um erro | Edite |
Aprimore os metadados de uma transação
Às vezes, o código de destino fica visível no New Relic, mas alguns detalhes do método não são úteis. Por exemplo:
- O nome padrão não é útil ou está causando um problema de agrupamento métrico.
- Você deseja adicionar um atributo personalizado à sua transação ou spans para poder filtrá-los com a consulta NRQL.
Use estes métodos quando quiser alterar a forma como o New Relic utiliza uma transação que já está visível no New Relic:
Se você quiser... | Fazem isto... |
|---|---|
Alterar o nome de uma transação | Consulte |
Adicione metadados (como o nome da conta do seu cliente ou nível de assinatura) à sua transação ou períodos | Para atributo personalizado que será adicionado à transação e spans (se habilitado), consulte Para atributo personalizado que será adicionado apenas aos spans, veja |
Marcar uma transação como um trabalho em segundo plano | Consulte |
Evite que uma transação afete sua pontuação Apdex | Consulte |
Veja o registro relacionado
Para ver o log diretamente no contexto dos erros e rastreamento do seu aplicativo, use esta chamada de API para anotar seu log:
Para obter mais informações sobre como correlacionar dados log com outros dados de telemetria, consulte nossa documentação de logs contextualizados .
Aplicativo de relatório de nomes
A interface do New Relic organiza os dados de acordo com o nome que você dá ao seu aplicativo. Cada nome aparece como um aplicativo diferente. Você pode renomear o aplicativo de relatórios para qualquer parte do seu código para melhor ajudá-lo:
Organize e analise seus dados nas páginas da interface do New Relic (por exemplo, a página
do APM, a página
, a página
consulte seus dados.
Crie uma política de alertas.
Isso é especialmente útil se você tiver um aplicativo multissite ou conjuntos distintos de código de aplicativo usando a mesma instalação do PHP.
Alternativamente, você pode definir o nome do aplicativo em um nível superior por meio do valor de configuração newrelic.appname , via Apache ou via PHP-FPM.
Se você quiser... | Fazem isto... |
|---|---|
Renomeie o aplicativo de relatórios para uma parte específica do seu código | Defina o nome do aplicativo. Consulte |
Instrumento faltando seções do seu código com transação
Para instrumentar seu aplicativo, o New Relic separa cada caminho do seu código em sua própria transação. A New Relic utiliza (ou "instrumento") o método pai nessas transações para medir o desempenho geral do seu aplicativo e coleta o rastreamento da transação de transações de longa duração para obter detalhes adicionais. Para obter mais informações sobre transações, consulte transação e rastreamento da transação.
Use estes métodos quando o New Relic não estiver instrumentado em uma parte específica do seu código:
Se você quiser... | Fazem isto... |
|---|---|
Comece a cronometrar um método que o New Relic não é instrumentado automaticamente | Inicie uma transação. Consulte |
Pare de cronometrar um método depois que seu trabalho for concluído | Pare uma transação. Consulte |
Impedir que uma transação seja reportada à New Relic | Ignore a transação. Consulte |
Métodos específicos de tempo usando segmentos
Se uma transação já estiver visível na interface do New Relic, mas você não tiver dados suficientes sobre um método específico que foi chamado durante essa transação, você poderá criar segmentos para cronometrar esses métodos individuais com mais detalhes. Por exemplo, você pode querer cronometrar um método particularmente crítico com lógica complexa.
Use estes métodos quando quiser instrumentar um método dentro de uma transação existente:
Se você quiser... | Fazem isto... |
|---|---|
Cronometrar um método específico | Consulte |
Trabalho assíncrono de instrumento
O único instrumento assíncrono de trabalho do agente PHP é o Guzzle, que é instrumentado por padrão.
Envie dados de eventos personalizados e métricos do seu aplicativo
O New Relic inclui diversas maneiras de registrar dados personalizados arbitrários. Para obter uma explicação dos tipos de dados do New Relic, consulte Coleta de dados.
Se você quiser... | Fazem isto... |
|---|---|
Envie dados sobre um evento para que você possa analisá-lo no New Relic | Crie um evento personalizado. Consulte Inserir evento personalizado via agente APM (PHP). |
Tag seu evento com metadados para filtrá-los e facetá-los | Adicionar atributo personalizado. Consulte |
Relatar dados de desempenho personalizados | Crie uma métrica personalizada. Consulte |
Instrumentar chamadas para serviços externos
Use estes métodos para coletar dados sobre as conexões do seu app com outros apps ou armazenamentos de dados:
Se você quiser... | Fazem isto... |
|---|---|
Cronometrar uma chamada para um armazenamento de dados não instrumentado por padrão | Consulte |
Veja o caminho que uma solicitação percorre ao percorrer um sistema distribuído | Para versões do agente PHP inferiores a 9.8, consulte estas chamadas de API:
|
Monitor páginas específicas do browser
Você pode instalar o agente browser adicionando-o automaticamente às suas páginas ou implantando-o em páginas específicas copiando e colando nosso trecho JavaScript. Você também pode controlar o agente usando chamadas de API do agente . Para mais informações veja monitoramento de Browser e agente PHP.