Coletar atributo personalizado

Quando se trata de relatar dados personalizados não relatados por padrão pelas soluções New Relic, duas das soluções mais populares são atributo personalizado e evento personalizado. Este documento entrará em mais detalhes sobre por que você usaria atributo personalizado.

Para algumas soluções New Relic, uma maneira de relatar dados personalizados para a New Relic é usar atributo personalizado . Ao adicionar atributo personalizado aos seus dados, você pode fazer análises mais aprofundadas e personalizadas do seu negócio. Por exemplo, para monitoramento de browser do New Relic, você pode criar um atributo personalizado para rastrear o nome de usuário associado a uma solicitação lenta ou com falha.

Importante

Atributo personalizado contam para GB ingeridos e são dados faturáveis.

Requisitos

Atributo personalizado estão disponíveis para estas soluções New Relic:

APM
Monitoramento de browser
Monitoramento de Mobile
Monitoramento de infraestrutura
Monitor Sintético

Entraremos em mais detalhes sobre essas opções abaixo.

Recomendações para criação e uso de atributo personalizado

Na New Relic, atributo são pares de valores principais que fornecem metadados sobre o evento ao qual estão vinculados.

Um padrão comum na criação de um atributo personalizado é capturar informações do usuário, como nome, ID, email e muito mais. Isso permite que você crie uma associação entre seus dados operacionais e seus dados comerciais. Por exemplo, se você tiver as informações do usuário, você vinculará os dados da central de atendimento e do CRM aos dados operacionais do New Relic.

Outros tipos de contexto de negócios podem incluir:

Token de clientes
Segmento de mercado de clientes
Classificação de valor dos clientes
Valores de controle de fluxo de trabalho não óbvios no URIStem
Contexto de privilégio de usuário/produto/conta

O contexto operacional pode incluir:

Quais flags de recurso foram utilizadas
Qual armazenamento de dados foi acessado
Qual cache foi acessado
Quais erros foram detectados e ignorados (particionamento de falhas)

Depois de adicionar um atributo personalizado, você pode consultá-lo no New Relic e criar gráficos personalizados a partir desses dados. Por exemplo, se você usou a API do agente Java para adicionar um atributo userId ao evento Transaction e TransactionError , poderá criar uma consulta NRQL usando esse atributo, como:

SELECT count(*) FROM TransactionError 
  WHERE userId = '1401961100' FACET dateOf(timestamp), `error.message` 
  SINCE 1 week ago

APM: Gravar atributo personalizado

Importante

Review the list of reserved terms used by NRQL. Using reserved terms can cause issues.

Para ativar e usar o atributo personalizado para APM, siga o procedimento para seu agente :

A coleção atributo personalizado está habilitada por padrão em Java. Você pode coletar atributo personalizado usando XML e a API Java do agente. Esses dois métodos podem ser usados em conjunto. Observe que coletar atributo personalizado requer que o jar da API Java New Relic esteja no classpath da aplicação.

Método	How to do it
Especifique o atributo em XML	XML permite que você especifique um atributo personalizado sem alterar nenhum código-fonte. Você pode ter vários arquivos XML para atributo personalizado agrupados por alguma faceta lógica. Para definir um atributo personalizado para seu aplicativo Java via XML: Revise a documentação do agente Java da New Relic sobre formato de arquivo XML, métodos e classes, além de exemplos. No diretório `Extensions` do agente Java New Relic, crie um único arquivo XML. Defina os métodos que você deseja que o New Relic monitor editando seu arquivo XML diretamente. Defina um arquivo de instrumentação XML usando a interface do New Relic. Isso pode exigir configuração adicional no bloco `common:` do seu newrelic.yml . Consulte Report custom attributes em Opções de instrumentação para obter mais detalhes.
Chame a API do agente	Example 1: Adding custom attributes to transactions Para coletar atributo personalizado usando a chamada de API do agente, utilize os métodos relevantes: Para cada método para o qual você deseja registrar um atributo, chame `NewRelic.addCustomParameter(...)`. Opcional: inclua ou exclua determinado atributo com `attributes.include` e `attributes.exclude`. Por exemplo, para registrar uma variável chamada `userId`, inclua este código no método pai: `NewRelic.addCustomParameter("userId", userId);` Example 2: Adding custom attributes to spans in distributed traces Para coletar atributo personalizado usando a chamada de API do agente, utilize os métodos relevantes: Para cada período (método atualmente em execução) para o qual você deseja registrar um atributo, chame `NewRelic.getAgent().getTracedMethod().addCustomAttribute(...)`. Opcional: inclua ou exclua determinado atributo com `span_events.attributes.include` e `span_events.attributes.exclude`. Por exemplo, para registrar uma variável chamada `userId` no intervalo atual, inclua este código no método associado: `NewRelic.getAgent().getTracedMethod().addCustomAttribute("userId", userId);`
Coletar atributos do usuário	O agente Java também inclui um mecanismo integrado para ativar o atributo do usuário e coletar informações do usuário de `HttpServletRequest.getUserPrincipal()` como atributo personalizado.

Método

How to do it

Especifique o atributo em XML

XML permite que você especifique um atributo personalizado sem alterar nenhum código-fonte. Você pode ter vários arquivos XML para atributo personalizado agrupados por alguma faceta lógica.

Para definir um atributo personalizado para seu aplicativo Java via XML:

Revise a documentação do agente Java da New Relic sobre formato de arquivo XML, métodos e classes, além de exemplos.
No diretório Extensions do agente Java New Relic, crie um único arquivo XML.
Defina os métodos que você deseja que o New Relic monitor editando seu arquivo XML diretamente.
Defina um arquivo de instrumentação XML usando a interface do New Relic. Isso pode exigir configuração adicional no bloco common: do seu
newrelic.yml
. Consulte
Report custom attributes
em Opções de instrumentação para obter mais detalhes.

Chame a API do agente

Example 1: Adding custom attributes to transactions

Para coletar atributo personalizado usando a chamada de API do agente, utilize os métodos relevantes:

Para cada método para o qual você deseja registrar um atributo, chame NewRelic.addCustomParameter(...).
Opcional: inclua ou exclua determinado atributo com attributes.include e attributes.exclude.
Por exemplo, para registrar uma variável chamada userId, inclua este código no método pai:
```
NewRelic.addCustomParameter("userId", userId);
```
Example 2: Adding custom attributes to spans in distributed traces
Para coletar atributo personalizado usando a chamada de API do agente, utilize os métodos relevantes:
Para cada período (método atualmente em execução) para o qual você deseja registrar um atributo, chame NewRelic.getAgent().getTracedMethod().addCustomAttribute(...).
Opcional: inclua ou exclua determinado atributo com span_events.attributes.include e span_events.attributes.exclude.
Por exemplo, para registrar uma variável chamada userId no intervalo atual, inclua este código no método associado:
```
NewRelic.getAgent().getTracedMethod().addCustomAttribute("userId", userId);
```

Coletar atributos do usuário

O agente Java também inclui um mecanismo integrado para ativar o atributo do usuário e coletar informações do usuário de HttpServletRequest.getUserPrincipal() como atributo personalizado.

A coleção atributo personalizado está habilitada por padrão no .NET. Para coletar atributo personalizado, chame os métodos API relevantes:

Para cada método para o qual você deseja registrar um atributo, chame AddCustomAttribute.
Opcional: inclua ou exclua atributo com as opções de configuração include e exclude .
Por exemplo, para registrar um atributo para um código de cupom (string) e um código de ID de item (número), você pode incluir este código no método pai:
```
IAgent agent = NewRelic.Api.Agent.NewRelic.GetAgent();
ITransaction transaction = agent.CurrentTransaction;

transaction
    .AddCustomAttribute("Discount Code", "Summer Super Sale")
    .AddCustomAttribute("Item Code", 31456);
```

A coleção atributo personalizado está habilitada por padrão no Node.js. Para coletar atributo personalizado, chame o método API relevante:

Para cada atributo que você deseja registrar, chame newrelic.addCustomAttribute.
Para gravar vários atributos usando uma única chamada, use newrelic.addCustomAttributes.
Por exemplo, para registrar um atributo para um código de cupom e um código de ID de item, você pode incluir isto no método pai:
```
newrelic.addCustomAttributes({
  "Discount Code": "Summer Super Sale",
  "Item Code": 31456
});
```

A coleção atributo personalizado está habilitada por padrão no PHP. Para coletar um atributo personalizado, chame o método API relevante para cada método que deseja registrar um atributo;

newrelic_add_custom_parameter para eventos e períodos de transação
newrelic_add_custom_span_parameter apenas para períodos
Por exemplo, para registrar uma variável chamada $userId, inclua este código no método pai:
```
newrelic_add_custom_parameter ('userID', $userId)
```

A coleção atributo personalizado está habilitada por padrão em Python. Para coletar um atributo personalizado, chame add_custom_attribute para cada método que deseja registrar um atributo.

Por exemplo, para registrar uma variável chamada user_id, inclua este código no método pai:

newrelic.agent.add_custom_attribute('user_id', user_id)

A coleção atributo personalizado está habilitada por padrão em Ruby. Para coletar um atributo personalizado, chame o método add_custom_attributes . Por exemplo, para registrar uma variável chamada @user_id, inclua este código no método pai:

::NewRelic::Agent.add_custom_attributes({ user_id: @user.id })

Monitoramento de Browser: Record atributo personalizado

O agente browser fornece uma API para especificar detalhes extras associados a uma visualização de página ou interação do browser, seja encaminhando um atributo do APM para o monitoramento do browser ou especificando um atributo personalizado por meio de JavaScript. Os valores encaminhados do agente APM são codificados e injetados no atributo do browser pelo nosso agente browser.

Monitoramento de infraestrutura: Registro de atributo personalizado

Nosso monitoramento de infraestrutura permite criar atributos personalizados que servem para anotar os dados do agente de infraestrutura. Você pode usar esses metadados para filtrar sua entidade, agrupar seus resultados e anotar seus dados.

Monitoramento de Mobile: Record atributo personalizado

Agente mobile inclui chamada de API para registrar atributo personalizado:

Para uma visão geral de
dados personalizados, consulte Inserir evento personalizado e atributo
Método Android: setAttribute
Método iOS: setAttribute

Monitor Sintético: Record atributo personalizado

Veja Sintético monitor atributo personalizado.

Esta tradução de máquina é fornecida para sua comodidade.

Importante

Requisitos

Recomendações para criação e uso de atributo personalizado

APM: Gravar atributo personalizado

Importante

Go

Java

.NET

Node.js

PHP

Python

Ruby

Monitoramento de Browser: Record atributo personalizado

Monitoramento de infraestrutura: Registro de atributo personalizado

Monitoramento de Mobile: Record atributo personalizado

Monitor Sintético: Record atributo personalizado

Esta tradução de máquina é fornecida para sua comodidade.

Coletar atributo personalizado

Importante

Requisitos .css-21sua1{background:none;border:none;width:0;padding:0;}

Recomendações para criação e uso de atributo personalizado

APM: Gravar atributo personalizado

Importante

Java

.NET

Node.js

PHP

Python

Ruby

Monitoramento de Browser: Record atributo personalizado

Monitoramento de infraestrutura: Registro de atributo personalizado

Monitoramento de Mobile: Record atributo personalizado

Monitor Sintético: Record atributo personalizado

Requisitos