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 |
|---|---|
corda | Obrigatório. O nome do atributo personalizado. Apenas os primeiros 255 caracteres são mantidos. |
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.