Sintaxe
newrelic_add_custom_span_parameter(string $key, scalar $value)Anexa um atributo personalizado (par de valor principal) ao intervalo atual.
Requisitos
Versão do agente 9.12.0.268 ou superior.
Descrição
Adicione um atributo personalizado (um par de dados de chave e valor) ao intervalo atual. (O nome da chamada é newrelic_add_custom_span_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 intervalo. Você também pode consultar o Span para seu atributo personalizado.
Importante
Em períodos, o atributo adicionado com newrelic_add_custom_span_parameter terá precedência sobre o atributo adicionado com newrelic_add_custom_parameter.
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_span_parameter ('user_email', $user_email);}