• 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

Guia para usar a API do agente PHP

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:

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 newrelic_notice_error().

Ignorar um erro

Edite error_collector.ignore_exceptions ou error_collector.ignore_errors no arquivonewrelic.ini .

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:

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 newrelic_name_transaction().

Adicione metadados (como o nome da conta do seu cliente ou nível de assinatura) à sua transação ou períodos

Use atributo personalizado.

Para atributo personalizado que será adicionado à transação e spans (se habilitado), consulte newrelic_add_custom_parameter().

Para atributo personalizado que será adicionado apenas aos spans, veja newrelic_add_custom_span_parameter().

Marcar uma transação como um trabalho em segundo plano

Consulte newrelic_background_job().

Evite que uma transação afete sua pontuação Apdex

Consulte newrelic_ignore_apdex().

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:

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 newrelic_set_appname().

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 newrelic_start_transaction().

Pare de cronometrar um método depois que seu trabalho for concluído

Pare uma transação. Consulte newrelic_end_transaction().

Impedir que uma transação seja reportada à New Relic

Ignore a transação. Consulte newrelic_ignore_transaction().

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 newrelic_add_custom_tracer().

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 newrelic_add_custom_parameter().

Relatar dados de desempenho personalizados

Crie uma métrica personalizada. Consulte newrelic_custom_metric().

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 newrelic_record_datastore_segment().

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.

Copyright © 2024 New Relic Inc.

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