Ruby métrica personalizada

A métrica personalizada permite registrar dados de desempenho arbitrários por meio de uma chamada de API (por exemplo, tempo ou dados de recursos do computador). Em seguida, use o criador de consulta para criar gráficos e acompanhar essa métrica. Você pode utilizar métrica personalizada para unificar seu monitoramento dentro do New Relic.

Nomenclatura métrica

Nomes de métricas identificam valores de dados específicos rastreados pela New Relic. Ao usar a API do agente New Relic Ruby para rastrear métricas personalizadas, é importante considerar a nomenclatura da métrica e como os valores serão agregados.

Um nome de métrica personalizada consiste no prefixo Custom/, no nome da classe ou categoria e em um rótulo, cada um separado por uma barra /: Custom/<class>/<method> ou Custom/<category>/<name> (por exemplo, Custom/MyClass/My_method).

<category>/<class>/<method>

class MetricSpec
  attr_accessor :name    # String - metric name
  attr_accessor :scope   # String - current controller action
end

class Stats
  attr_accessor :call_count           # Integer - method invocation count
  attr_accessor :total_call_time      # Float - total method call time (in seconds)
  attr_accessor :total_exclusive_time # Float - total time spent in the traced method minus any child time (in seconds)
  attr_accessor :min_call_time        # Float - the smallest method invocation time (in seconds)
  attr_accessor :max_call_time        # Float - the largest method invocation time (in seconds)
  attr_accessor :sum_of_squares       # Float - the sum of squares of response times - used for standard deviation computation
  attr_accessor :begin_time           # Time - the start of the time window for this data
  attr_accessor :end_time             # Time - end of the time window for this data
end

Registro métrico personalizado

A API pública para registro de dados métricos consiste em dois métodos em NewRelic::Agent, record_metric e increment_metric.

record_metric(metric_name, value)

record_metric deve ser usado para registrar uma métrica baseada em evento, geralmente associada a uma duração específica. metric_name deve ser uma string seguindo regras de nomenclatura de métrica padrão. value geralmente será um numérico, mas também pode ser um hash de aplicação.

Quando value for um valor numérico, ele deverá representar a magnitude de uma medida associada a um evento, como a duração de uma chamada de método específica.

Quando value é um hash de aplicação, ele deve conter chaves :count, :total, :min, :max e :sum_of_squares , todas com valores numéricos. Este formulário é útil se você deseja agregar métricas por conta própria e relatá-las periodicamente (por exemplo, a partir de um tópico em segundo plano). As estatísticas fornecidas serão agregadas a quaisquer valores coletados anteriormente para a mesma métrica. Os nomes das chaves hash Aplicar foram escolhidos para corresponder aos nomes das chaves usadas pela API da plataforma.

increment_metric(metric_name, amount=1)

increment_metric deve ser usado para atualizar uma métrica que atua como um contador simples. A contagem da métrica selecionada será incrementada no valor especificado.

Exemplo de métrica personalizada

Aqui está um exemplo que mostra como você pode usar métricas para rastrear o fluxo de moeda em um site:

class Cart

  def checkout()
    amount = compute_cart_total    # computes the amount to charge the customer

    ::NewRelic::Agent.record_metric('Custom/Cart/charge_amount', amount)

    charge_customer(amount)
    ...
  end
end

Para obter mais informações sobre como os dados são agregados ao longo do tempo, consulte Política de agregação de estatísticas.

Ver métrica personalizada

Para visualizar essas métricas personalizadas, use o criador de consulta para pesquisar métricas, criar gráficos personalizáveis e adicionar esses gráficos ao painel.