• /
  • 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

newrelic_add_custom_parameter (API do agente PHP)

Sintaxe

newrelic_add_custom_parameter(string $key, scalar $value)

Anexa um atributo personalizado (par de valor principal) à transação atual e ao intervalo atual (se habilitado).

Requisitos

Versão do agente 4.4.5.35 ou superior.

Descrição

Adicione um atributo personalizado (um par de dados de chave e valor) à transação da web atual. (O nome da chamada é newrelic_add_custom_parameter porque "atributo personalizado" era anteriormente chamado de "parâmetro personalizado".) Por exemplo, você pode adicionar o nome completo de um cliente do seu banco de dados de clientes. Este atributo aparece em qualquer rastreamento de transação que resulte desta transação. Você também pode consultar o evento de transação para seu atributo personalizado.

Importante

Recomendação de segurança: revise a configuração do seu atributo Transaction. Qualquer configuração de inclusão ou exclusão de atributo específica para evento de Transação deve ser aplicada à sua configuração de atributo Span ou à configuração de Atributos Globais.

Importante

Caso queira usar seu atributo personalizado, evite usar algum dos termos reservados usados pelo NRQL.

Parâmetro

Parâmetro

Descrição

$key

corda

Obrigatório. O nome do atributo personalizado. Apenas os primeiros 255 caracteres são mantidos.

$value

scalar

Obrigatório. O valor a associar a este atributo personalizado.

Se o valor fornecido for float com valor NaN, Infinity, denorm ou zero negativo, o comportamento desta função é indefinido. Para outros valores de ponto flutuante, o agente pode descartar 1 ou mais bits de precisão (ULPs) do valor fornecido.

Valores de retorno

Retorna verdadeiro se o parâmetro foi adicionado com sucesso.

Exemplos

Relate uma variável como o valor

if (extension_loaded('newrelic')) { // Ensure PHP agent is available
// Record custom data about this web transaction
newrelic_add_custom_parameter('user_email', $user_email);
}

Várias chamadas

Se você chamar newrelic_add_custom_parameter diversas vezes com o mesmo valor para o parâmetro $key na mesma transação da web, o $value da última chamada terá precedência. O valor da última chamada é registrado como atributo personalizado na transação da web.

Por exemplo, se o código for assim:

if (extension_loaded('newrelic')) { // Ensure PHP agent is available
// Record custom data about this web transaction
newrelic_add_custom_parameter('user_email', billy@newrelic.com);
newrelic_add_custom_parameter('user_email', samantha@newrelic.com);
}

O valor samantha@newrelic.com é registrado como o atributo personalizado user_email na transação da web e billy@newrelic.com da chamada anterior é substituído.

Copyright © 2024 New Relic Inc.

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