aboutsummaryrefslogtreecommitdiffstats
path: root/guides/source
diff options
context:
space:
mode:
authorAli Ibrahim <aibrahim2k2@gmail.com>2019-03-22 13:20:32 -0400
committerAli Ibrahim <aibrahim2k2@gmail.com>2019-03-22 13:20:32 -0400
commit7237c7be74b09cd951ff000afb4087313e5c0025 (patch)
tree25de7f6604622c82d66d5016a510a96fc769ef2a /guides/source
parentaaf89cdea7105ae7789483cec2d786cfa1cef7f9 (diff)
downloadrails-7237c7be74b09cd951ff000afb4087313e5c0025.tar.gz
rails-7237c7be74b09cd951ff000afb4087313e5c0025.tar.bz2
rails-7237c7be74b09cd951ff000afb4087313e5c0025.zip
Update instrumentation guides w/optional block
Diffstat (limited to 'guides/source')
-rw-r--r--guides/source/active_support_instrumentation.md11
1 files changed, 11 insertions, 0 deletions
diff --git a/guides/source/active_support_instrumentation.md b/guides/source/active_support_instrumentation.md
index 89e0e3afa8..d7dbc5cea8 100644
--- a/guides/source/active_support_instrumentation.md
+++ b/guides/source/active_support_instrumentation.md
@@ -692,5 +692,16 @@ ActiveSupport::Notifications.subscribe "my.custom.event" do |name, started, fini
end
```
+You also have the option to call instrument without passing a block. This lets you leverage the
+instrumentation infrastructure for other messaging uses.
+
+```ruby
+ActiveSupport::Notifications.instrument "my.custom.event", this: :data
+
+ActiveSupport::Notifications.subscribe "my.custom.event" do |name, started, finished, unique_id, data|
+ puts data.inspect # {:this=>:data}
+end
+```
+
You should follow Rails conventions when defining your own events. The format is: `event.library`.
If your application is sending Tweets, you should create an event named `tweet.twitter`.