<NME> drop.rb
<BEF> ADDFILE
<MSG> - The wonderful new drop filter. Together with the new conditionals
  feature, this filter should completely replace the 'grep' filter.

<DFF> @@ -0,0 +1,31 @@
+require "logstash/filters/base"
+require "logstash/namespace"
+
+# Drop filter.
+#
+# Drops everything that gets to this filter.
+#
+# This is best used in combination with conditionals, for example:
+#
+#     filter {
+#       if [loglevel] == "debug" { 
+#         drop { } 
+#       }
+#     }
+#
+# The above will only pass events to the drop filter if the loglevel field is
+# "debug". This will cause all events matching to be dropped.
+class LogStash::Filters::Drop < LogStash::Filters::Base
+  config_name "drop"
+  plugin_status "experimental"
+
+  public
+  def register
+    # nothing to do.
+  end
+
+  public
+  def filter(event)
+    event.cancel
+  end # def filter
+end # class LogStash::Filters::Drop

- The wonderful new drop filter. Together with the new conditionals   feature, this filter should completely replace the 'grep' filter.