Instrumenting Ruby code

原文:https://docs.gitlab.com/ee/development/instrumentation.html

Instrumenting Ruby code

GitLab Performance Monitoring可以检测 Ruby 代码的方法和自定义块. 方法检测是基于块的检测的主要检测形式,仅当我们想深入到方法中特定代码区域时才使用.

如果要跟踪产品使用模式,请参考遥测 .

Instrumenting Methods

使用Gitlab::Metrics::Instrumentation模块可以完成检测方法. 该模块提供了几种可用于检测代码的方法:

  • instrument_method :检测单个类方法.
  • instrument_instance_method :检测单个实例方法.
  • instrument_class_hierarchy :给定一个 Class,此方法将递归地检测所有子类(类方法和实例方法).
  • instrument_methods :检测模块的所有公共和私有类方法.
  • instrument_instance_methods :检测模块的所有公共和私有实例方法.

为了消除键入完整的Gitlab::Metrics::Instrumentation命名空间的需要,您可以使用configure类方法. 通过传递Gitlab::Metrics::Instrumentation作为其参数时,此方法仅产生提供的块. 一个例子:

  1. Gitlab::Metrics::Instrumentation.configure do |conf|
  2. conf.instrument_method(Foo, :bar)
  3. conf.instrument_method(Foo, :baz)
  4. end

通常,使用此方法优于直接调用各种检测方法.

方法检测应添加到初始化程序config/initializers/zz_metrics.rb .

Examples

检测单个方法:

  1. Gitlab::Metrics::Instrumentation.configure do |conf|
  2. conf.instrument_method(User, :find_by)
  3. end

检测整个类的层次结构:

  1. Gitlab::Metrics::Instrumentation.configure do |conf|
  2. conf.instrument_class_hierarchy(ActiveRecord::Base)
  3. end

检测所有公共类方法:

  1. Gitlab::Metrics::Instrumentation.configure do |conf|
  2. conf.instrument_methods(User)
  3. end

Checking Instrumented Methods

检查一种方法是否已被检测的最简单方法是检查其源位置. 例如:

  1. method = Banzai::Renderer.method(:render)
  2. method.source_location

如果源位置指向lib/gitlab/metrics/instrumentation.rb ,则说明该方法已经过检测.

如果使用的是 Pry,则可以使用$命令显示方法的源代码(及其源位置),这比运行上面的 Ruby 代码容易. 如果是上述片段,请运行以下代码:

  • $ Banzai::Renderer.render

这将打印出以下内容:

  1. From: /path/to/your/gitlab/lib/gitlab/metrics/instrumentation.rb @ line 148:
  2. Owner: #<Module:0x0055f0865c6d50>
  3. Visibility: public
  4. Number of lines: 21
  5. def #{name}(#{args_signature})
  6. if trans = Gitlab::Metrics::Instrumentation.transaction
  7. trans.measure_method(#{label.inspect}) { super }
  8. else
  9. super
  10. end
  11. end

Instrumenting Ruby Blocks

通过调用Gitlab::Metrics.measure并将其传递给块来完成对 Ruby 代码块的测量. 例如:

  1. Gitlab::Metrics.measure(:foo) do
  2. ...
  3. end

执行该块并将执行时间存储为当前运行的事务中的一组字段. 如果不存在事务,则不进行任何测量就产生该块.

测量一个块的三个值:

  • 经过的实时时间,存储在NAME_real_time .
  • The CPU time elapsed, stored in NAME_cpu_time.
  • 通话次数,存储在NAME_call_count .

实时和 CPU 计时均以毫秒为单位.

多次调用同一块将导致最终值是所有单个值的总和. 以下面的代码为例:

  1. 3.times do
  2. Gitlab::Metrics.measure(:sleep) do
  3. sleep 1
  4. end
  5. end

在这里, sleep_real_time的最终值为3而不是 1 .

Tracking Custom Events

除了检测代码,GitLab Performance Monitoring 还支持跟踪自定义事件. 这主要用于跟踪业务指标,例如 Git 推送数,存储库导入等.

要跟踪自定义事件,只需调用Gitlab::Metrics.add_event传递事件名称和一组自定义(可选)标签. 例如:

  1. Gitlab::Metrics.add_event(:user_login, email: current_user.email)

事件名称应为动词,例如push_repositoryremove_branch .