[docs] Add example for payload filtering

Added an example using a callback for filtering to showcase how to use a filter to ignore some payloads completely.

docs

Author: ammaar8

docs/api.asciidoc

@@ -409,8 +409,9 @@ Return the altered payload.
 
 If `nil` is returned all subsequent filters will be skipped and the post request cancelled.
 
-Example:
+Examples:
 
+Altering payload
 [source,ruby]
 ----
 ElasticAPM.add_filter(:filter_pings) do |payload|
@@ -421,6 +422,17 @@ ElasticAPM.add_filter(:filter_pings) do |payload|
 end
 ----
 
+Filtering payload
+[source,ruby]
+----
+ElasticAPM.add_filter(
+  :remove_redis_spans,
+  Proc.new do |payload|
+    payload.dig(:span, :type) == 'db.redis' ? nil : payload
+  end
+)
+----
+
 [float]
 [[api-transaction]]
 === Transaction