O agente APM, o agente browser e o agente mobile relatam um tipo de dados métricos chamados métrica de frações de tempo data. Esses agentes permitem que você relate dados personalizados de métrica de fração de tempo do seu aplicativo e os veja junto com os dados padrão do New Relic. Crie métrica personalizada para registrar dados de desempenho arbitrários através de uma chamada de API, como:
- Dados de tempo
- Dados de recursos de computador
- Dados de assinatura ou compra
Após reportar esses dados, você poderá explorá-los e consultá-los.
Nome métrica personalizada
Iniciar todos os nomes métricos personalizados com Custom/; por exemplo, Custom/MyMetric/My_label. O prefixo Custom/ é obrigatório para todas as métricas personalizadas.
Quaisquer nomes métricos personalizados que não comecem com Custom/ estão sujeitos a todas as outras regras de agrupamento. Eles podem não estar visíveis durante a consulta ou podem não aparecer conforme esperado na interface do usuário.
Um nome de métrica personalizada consiste no prefixo Custom/, no nome da categoria ou classe e em um método ou rótulo, cada um separado por uma barra.
Implementar métrica personalizada
A implementação de métrica personalizada requer chamada de API. Os detalhes exatos da chamada de API variam de acordo com o agente.
Dica
Se você estiver testando sua implementação de métrica personalizada, execute o agente por pelo menos 10 minutos para garantir que a chamada de API seja reportada à New Relic.
Agente New Relic | Implementação |
|---|---|
Agentes APM | |
Agente New Relic Mobile | |
Agente New Relic Browser | O browser não suporta métricas personalizadas. Para opções sobre como adicionar dados personalizados ao browser, consulte instrumentação do browser. |
Evite problemas de agrupamento
Coletar muitos intervalos de tempo métricos pode afetar o desempenho do seu aplicativo e do New Relic. Por exemplo, se você tiver milhares de usuários individuais, evite criar métricas para acompanhar o desempenho de seus IDs de usuário exclusivos. Isso poderia resultar em um número tão grande de métricas que se tornaria quase impossível navegar ou entender os dados. Em vez disso, use um espaço reservado, como um asterisco (*), em vez de IDs de usuário individuais.
Importante
Para evitar potenciais problemas de dados, tente manter o número total de intervalos de tempo métricos únicos introduzidos pela métrica personalizada abaixo de 2000.
Quando o número total de nomes de métricas exclusivos excede 5.000, os limites começam a ser aplicados automaticamente e afetam a forma como os dados aparecem na interface do usuário, como em gráficos e tabelas. Para mais informações, veja questões de agrupamento métrico.