Crie métricas personalizadas em Go

métrica personalizada permite reportar qualquer métrica que passe pelo seu código. Por exemplo, com o monitoramento Go da New Relic, você pode criar métricas personalizadas para cronometrar um componente do seu aplicativo que pode não ser capturado por padrão. Depois de capturar uma métrica personalizada, você pode:

• Unifique seu monitoramento dentro do New Relic através da métrica e do explorador de eventos.
• Utilize nossa API REST para recuperar e utilizar programaticamente dados métricos personalizados fora da interface.
• Crie uma métrica personalizada condição do alerta para notificar você ou sua equipe quando sua métrica personalizada exceder valores específicos.

Crie uma métrica personalizada

1. Instancie seu aplicativo executando o seguinte:

   app, err := newrelic.NewApplication(
     newrelic.ConfigAppName("Your Application Name"),
     newrelic.ConfigLicense("NEW_RELIC_LICENSE_KEY"),
     newrelic.ConfigDebugLogger(os.Stdout),
   )

   Copiar

2. Após instanciar seu aplicativo, crie uma métrica personalizada com o seguinte código:

   app.RecordCustomMetric(
       "CustomMetricName",         //name of your metric
       132,                         //time in ms
   );

   Copiar

   • RecordCustomMetricO primeiro parâmetro de é uma string que nomeia sua métrica personalizada.

   • O método RecordCustomMetric acrescentará automaticamente a string Custom/ ao nome da sua métrica. Isso significa que o código acima irá gerar uma métrica chamada Custom/CustomMetricName.

   • RecordCustomMetricO segundo parâmetro é o tempo, em milissegundos, que você deseja registrar para sua transação personalizada. Isso significa que o código acima produzirá uma métrica de 0,132 segundos nos sistemas da New Relic.

   • Para usar uma métrica personalizada como contador, ela pode ser incrementada fazendo a chamada conforme descrito acima, e o valor count dessa métrica será incrementado em 1. O valor usado para o segundo parâmetro (tempo em ms) é irrelevante se você estiver usando a métrica apenas como contador e, portanto, poderá usar um número estático, como 0 ou 1.

     • Para incrementar um contador em um número maior que 1, chame app.RecordCustomMetric diversas vezes. Cada chamada incrementará a métrica apenas em 1, independentemente do valor do segundo parâmetro.

Nomeie uma métrica personalizada

Considere cuidadosamente como você nomeia sua métrica personalizada. Se o seu programa criar muitas métricas com nomes exclusivos, você poderá acabar com um problema de agrupamento métrico (MGI).

MGIs ocorrem quando a granularidade dos nomes de métricas é muito fina, resultando em centenas ou milhares de nomes de métricas diferentes. Uma causa comum de MGIs é confiar no nome completo da URL para nomenclatura métrica na transação da web. Alguns caminhos de código principais podem gerar muitos caminhos de URL completos diferentes para documentos, artigos, páginas exclusivos, etc.

Se o elemento exclusivo do caminho da URL estiver incluído no nome da métrica, cada um desses caminhos comuns terá seu próprio nome de métrica exclusivo. Caso ocorram problemas de agrupamento métrico, siga os procedimentos de resolução de problemas.