Atributo são pares de valores principais contendo informações que determinam as propriedades de um evento ou transação. Você pode visualizar esses pares de valores principais em alguns locais da interface ou consultando esses dados usando NRQL. O New Relic dá ao usuário a possibilidade de personalizar exatamente qual atributo será enviado para cada um desses destinos.
Você também pode coletar atributo personalizado para enviar dados adicionais à New Relic.
Fluxo de destino do atributo
Este diagrama ilustra como um agente decide enviar um atributo para cada destino.
Agent attribute collection: Um agente toma três decisões diferentes ao enviar um atributo para qualquer destino New Relic com base nas configurações de propriedade relevantes. Os nomes das propriedades e a sintaxe variam de acordo com o agente. (As propriedades neste diagrama são específicas do agente PHP, mas o fluxo geral é o mesmo para todos os agentes. Os nomes das propriedades e a sintaxe variam de acordo com o agente.)
Tipos de atributo
Atributo pode ser coletado de diversas maneiras:
Message property attributes:
Estas são as propriedades definidas em uma mensagem recebida de uma fila ou tópico.
HTTP request attributes:
Estes são os parâmetros para uma solicitação HTTP.
User attributes:
São atributos fornecidos pelo usuário através da API de cada agente.
Agent attributes:
São atributos captados pelo agente; por exemplo,
http.statusCodeehttpResponseMessage.
Destinos para atributo
Os atributos coletados aparecem nestes locais:
Collected attributes | Location |
|---|---|
Cada minuto de rastreamento da transação coleta dados para suas solicitações HTTP individuais mais lentas. Esses rastreamentos reportarão o atributo coletado durante a transação. | |
Se uma transação resultar em erro, esses erros de rastreamento serão relatados ao APM. Um erro de rastreamento conterá atributo coletado durante a transação. | |
As transações de APM conterão atributo arrecadado durante a transação. | |
O evento de monitoramento do Browser conterá atributo arrecadado durante a transação. Porém, o atributo arrecadado ao final de uma transação poderá não aparecer no evento | |
O evento de período coletado para distributed tracing conterá um atributo coletado durante o período. O seguinte agente suporta a adição de atributo de usuário personalizado ao evento span: | |
Cada segmento em um rastreamento da transação conterá um atributo registrado para esse segmento. |
Visualizando atributo de solicitação
Os atributos de solicitação estão associados a rastreamento específico da transação, rastreamento do browser e erros no APM e no dashboard. Você pode ver o atributo registrado com uma solicitação ao visualizar o trace ou erro individual. atributo personalizado pode ser consultado via NRQL exatamente como qualquer outro atributo.
one.newrelic.com > All capabilities > APM & services > (select an app) > Monitoring > Transactions > (select a transaction) > (select a trace): Aqui está um exemplo do agente Ruby do Request attributes e Custom attributes para um rastreamento da transação. Os atributos exatos dependem do seu agente e da configuração do seu atributo.
Limites
Atributo do usuário, atributo de solicitação e parâmetro da fila de mensagens são limitados por contagem e tamanho.
Parameter | Limitations |
|---|---|
Transação | Limitado a 64 atributos de usuários |
Chave de atributo | Limitado a 256 bytes cada Se a chave tiver mais de 256 bytes, o atributo não será registrado. |
Valor do atributo | Limitado a 256 bytes cada Se o valor for maior que 256 bytes, o valor do atributo será truncado. |
Atributo específico do agente
Cada agente APM coleta um atributo personalizado. Os atributos suportados dependem do agente específico: