Plugin Helper: Timer

Search…

The timer plugin helper manages event timers.
Here is an example:
1
require 'fluent/plugin/input'
2
​
3
module Fluent::Plugin
4
  class ExampleInput < Input
5
    Fluent::Plugin.register_input('example', self)
6
​
7
    # 1. Load timer helper
8
    helpers :timer
9
​
10
    # Omit `configure`, `shutdown` and other plugin APIs
11
​
12
    def start
13
      super
14
​
15
      # 2. Execute timer with unique name and second unit interval
16
      timer_execute(:example_timer, 10) {
17
        # ...
18
      }
19
    end
20
  end
21
end
Copied!
The launched timer is managed by the plugin helper. No need of timer shutdown code in plugin's shutdown method. The plugin shutdowns the launched timers automatically.
Methods
timer_execute(title, interval, repeat: true, &block)
This method executes the timer with the given parameters and routine.
title: unique symbol value
interval: second unit integer/float value.
repeat: true/false (default: true). If false, timer is one-shot.
Code examples:
1
# Pass block directly. block is executed in 10 second interval.
2
timer_execute(:example_timer, 10) {
3
  # ...
4
}
5
​
6
# Pass block with existing method. block is executed in 5 second and one-shot.
7
timer_execute(:example_timer_run, 5s, repeat: false, &method(:run))
8
def run
9
  # ...
10
end
Copied!
Plugins using timer
​out_forward​
​in_monitor_agent​
​in_sample​
If this article is incorrect or outdated, or omits critical information, please let us know. Fluentd is an open-source project under Cloud Native Computing Foundation (CNCF). All components are available under the Apache 2 License.

Plugin Helper: Thread

Plugin Helper: Http Server

Last modified 4mo ago

Copy link

Contents

Methods

timer_execute(title, interval, repeat: true, &block)

Plugins using timer

Methods

`timer_execute(title, interval, repeat: true, &block)`

Plugins using `timer`