logstash-input-jms 3.0.5-java → 3.0.6-java

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1281f6e58680967a0df02a1bd0f9044b2dae7cab4ec64c32f257bbaa3f6e71f4
-  data.tar.gz: 8f7b6f26183b29766ce7b9abef8b02c943e6ec1b616e642bf12fe4cc5f0bd2b0
+  metadata.gz: 4e0b7da08d783aaa34842119cb780c5f52b00483b09c652d779da9c1f1ba24d0
+  data.tar.gz: 4c96668a804e020bb50c57fd6258cf4cfddb136fc0fde1ff81f8dbdc95dca74b
 SHA512:
-  metadata.gz: bf071ee72b2ad658767a79702dd40f180d5fc2e7a70c55ca8585874b406e4eb8089282fc41c44daee3de7881198c813244d819a8dc6977850037fcef446efc56
-  data.tar.gz: 80c078c0313b6bf5837789e97b82348e92941c9761b1c60caf5d2a71d9132c9cd08f51985efb90a42bae548bf8ac9456c7e1eea39d1b7ed96d4871252db95e9f
+  metadata.gz: 9261b580965f2c5f0ba2ad29966ef9a47b2302652da035c6f917c81742c02954ac05cf49a0d164a6740f704e93448b6e388f5c9004fbfd6af1ad490eff2a6929
+  data.tar.gz: 0ddc3508282986ea0ffec41e4a49b07ba6f24a7ea7b2ee67b043370442190130ed92b3f47bf3f77f89bcecea0f14c9485b8377e9a33796eaafb8b9f702d107cf

data/CHANGELOG.md

@@ -1,3 +1,6 @@
+## 3.0.6
+  - Fixed formatting issues in documentation [#32](https://github.com/logstash-plugins/logstash-input-jms/pull/32) and [#33](https://github.com/logstash-plugins/logstash-input-jms/pull/33]
+
 ## 3.0.5
   - Docs: Set the default_codec doc attribute.
 

data/docs/index.asciidoc

@@ -23,9 +23,12 @@ include::{include_path}/plugin_header.asciidoc[]
 
 Read events from a Jms Broker. Supports both Jms Queues and Topics.
 
-For more information about Jms, see <http://docs.oracle.com/javaee/6/tutorial/doc/bncdq.html>
-For more information about the Ruby Gem used, see <http://github.com/reidmorrison/jruby-jms>
+For more information about Jms, see <http://docs.oracle.com/javaee/6/tutorial/doc/bncdq.html>.
+For more information about the Ruby Gem used, see <http://github.com/reidmorrison/jruby-jms>.
 Here is a config example to pull from a queue:
+
+[source,ruby]
+----
  jms {
     include_header => false
     include_properties => false
@@ -37,7 +40,7 @@ Here is a config example to pull from a queue:
     yaml_file => "~/jms.yml"
     yaml_section => "mybroker"
   }
-
+----
 
 
 [id="plugins-{type}s-{plugin}-options"]
@@ -57,6 +60,7 @@ This plugin supports the following configuration options plus the <<plugins-{typ
 | <<plugins-{type}s-{plugin}-interval>> |<<number,number>>|No
 | <<plugins-{type}s-{plugin}-jndi_context>> |<<hash,hash>>|No
 | <<plugins-{type}s-{plugin}-jndi_name>> |<<string,string>>|No
+| <<plugins-{type}s-{plugin}-oracle_aq_buffered_messages>> |<<boolean,boolean>>|No
 | <<plugins-{type}s-{plugin}-password>> |<<string,string>>|No
 | <<plugins-{type}s-{plugin}-pub_sub>> |<<boolean,boolean>>|No
 | <<plugins-{type}s-{plugin}-require_jars>> |<<array,array>>|No
@@ -81,7 +85,7 @@ input plugins.
   * Value type is <<string,string>>
   * There is no default value for this setting.
 
-Url to use when connecting to the JMS provider
+Url to use when connecting to the JMS provider.
 
 [id="plugins-{type}s-{plugin}-destination"]
 ===== `destination` 
@@ -98,7 +102,7 @@ Name of the destination queue or topic to use.
   * Value type is <<string,string>>
   * There is no default value for this setting.
 
-Name of JMS Provider Factory class
+Name of JMS Provider Factory class.
 
 [id="plugins-{type}s-{plugin}-include_body"]
 ===== `include_body` 
@@ -106,11 +110,14 @@ Name of JMS Provider Factory class
   * Value type is <<boolean,boolean>>
   * Default value is `true`
 
-Include JMS Message Body in the event
-Supports TextMessage, MapMessage and ByteMessage
-If the JMS Message is a TextMessage or ByteMessage, then the value will be in the "message" field of the event
-If the JMS Message is a MapMessage, then all the key/value pairs will be added in the Hashmap of the event
-StreamMessage and ObjectMessage are not supported
+Include JMS Message Body in the event.
+Supports TextMessage, MapMessage and ByteMessage.
+
+If the JMS Message is a TextMessage or ByteMessage, then the value will be in
+the "message" field of the event. If the JMS Message is a MapMessage, then all
+the key/value pairs will be added in the Hashmap of the event.
+
+StreamMessage and ObjectMessage are not supported.
 
 [id="plugins-{type}s-{plugin}-include_header"]
 ===== `include_header` 
@@ -118,13 +125,15 @@ StreamMessage and ObjectMessage are not supported
   * Value type is <<boolean,boolean>>
   * Default value is `true`
 
-A JMS message has three parts :
- Message Headers (required)
- Message Properties (optional)
- Message Bodies (optional)
-You can tell the input plugin which parts should be included in the event produced by Logstash
+A JMS message has three parts:
 
-Include JMS Message Header Field values in the event
+* Message Headers (required)
+* Message Properties (optional)
+* Message Bodies (optional)
+
+You can tell the input plugin which parts should be included in the event produced by Logstash.
+
+Include JMS Message Header Field values in the event.
 
 [id="plugins-{type}s-{plugin}-include_properties"]
 ===== `include_properties` 
@@ -132,7 +141,7 @@ Include JMS Message Header Field values in the event
   * Value type is <<boolean,boolean>>
   * Default value is `true`
 
-Include JMS Message Properties Field values in the event
+Include JMS Message Properties Field values in the event.
 
 [id="plugins-{type}s-{plugin}-interval"]
 ===== `interval` 
@@ -150,8 +159,8 @@ This parameter has non influence in the case of a subcribed Topic.
   * Value type is <<hash,hash>>
   * There is no default value for this setting.
 
-Mandatory if jndi lookup is being used,
-contains details on how to connect to JNDI server
+Mandatory if jndi lookup is being used.
+Contains details on how to connect to JNDI server.
 
 [id="plugins-{type}s-{plugin}-jndi_name"]
 ===== `jndi_name` 
@@ -159,7 +168,16 @@ contains details on how to connect to JNDI server
   * Value type is <<string,string>>
   * There is no default value for this setting.
 
-Name of JNDI entry at which the Factory can be found
+Name of JNDI entry at which the Factory can be found.
+
+[id="plugins-{type}s-{plugin}-oracle_aq_buffered_messages"]
+===== `oracle_aq_buffered_messages` 
+
+  * Value type is <<boolean,boolean>>
+  * Default value is `false`
+
+Receive Oracle AQ buffered messages.
+In this mode persistent Oracle AQ JMS messages will not be received.
 
 [id="plugins-{type}s-{plugin}-password"]
 ===== `password` 
@@ -167,7 +185,7 @@ Name of JNDI entry at which the Factory can be found
   * Value type is <<string,string>>
   * There is no default value for this setting.
 
-Password to use when connecting to the JMS provider
+Password to use when connecting to the JMS provider.
 
 [id="plugins-{type}s-{plugin}-pub_sub"]
 ===== `pub_sub` 
@@ -195,7 +213,7 @@ java CLASSPATH prior to starting Logstash.
   * Value can be any of: `consumer`, `async`, `thread`
   * Default value is `"consumer"`
 
-Choose an implementation of the run block. Value can be either consumer, async or thread
+Choose an implementation of the run block. Value can be `consumer`, `async` or `thread`.
 
 [id="plugins-{type}s-{plugin}-selector"]
 ===== `selector` 
@@ -203,7 +221,7 @@ Choose an implementation of the run block. Value can be either consumer, async o
   * Value type is <<string,string>>
   * There is no default value for this setting.
 
-Set the selector to use to get messages off the queue or topic
+Set the selector to use to get messages off the queue or topic.
 
 [id="plugins-{type}s-{plugin}-threads"]
 ===== `threads` 
@@ -211,8 +229,6 @@ Set the selector to use to get messages off the queue or topic
   * Value type is <<number,number>>
   * Default value is `1`
 
-
-
 [id="plugins-{type}s-{plugin}-timeout"]
 ===== `timeout` 
 
@@ -227,7 +243,7 @@ Initial connection timeout in seconds.
   * Value type is <<boolean,boolean>>
   * Default value is `false`
 
-Convert the JMSTimestamp header field to the @timestamp value of the event
+Convert the JMSTimestamp header field to the @timestamp value of the event.
 
 [id="plugins-{type}s-{plugin}-username"]
 ===== `username` 
@@ -235,7 +251,7 @@ Convert the JMSTimestamp header field to the @timestamp value of the event
   * Value type is <<string,string>>
   * There is no default value for this setting.
 
-Username to connect to JMS provider with
+Username to use for connecting to JMS provider.
 
 [id="plugins-{type}s-{plugin}-yaml_file"]
 ===== `yaml_file` 
@@ -252,11 +268,11 @@ Yaml config file
   * There is no default value for this setting.
 
 Yaml config file section name
-For some known examples, see: [Example jms.yml](https://github.com/reidmorrison/jruby-jms/blob/master/examples/jms.yml)
+For some known examples, see https://github.com/reidmorrison/jruby-jms/blob/master/examples/jms.yml[jms.yml examples].
 
 
 
 [id="plugins-{type}s-{plugin}-common-options"]
 include::{include_path}/{type}.asciidoc[]
 
-:default_codec!:
+:default_codec!:

data/lib/logstash/inputs/jms.rb

@@ -39,6 +39,11 @@ class LogStash::Inputs::Jms < LogStash::Inputs::Threadable
   # If the JMS Message is a TextMessage or ByteMessage, then the value will be in the "message" field of the event
   # If the JMS Message is a MapMessage, then all the key/value pairs will be added in the Hashmap of the event
   # StreamMessage and ObjectMessage are not supported
+
+  # Receive Oracle AQ buffered messages. 
+  # In this mode persistent Oracle AQ JMS messages will not be received.
+  config :oracle_aq_buffered_messages, :validate => :boolean, :default => false
+
   config :include_body, :validate => :boolean, :default => true
   
   # Convert the JMSTimestamp header field to the @timestamp value of the event
@@ -186,7 +191,7 @@ class LogStash::Inputs::Jms < LogStash::Inputs::Threadable
     JMS::Connection.session(@jms_config) do |session|
       destination_key = @pub_sub ? :topic_name : :queue_name
       while !stop?
-        session.consume(destination_key => @destination, :timeout=>@timeout, :selector => @selector) do |message|
+        session.consume(destination_key => @destination, :timeout=>@timeout, :selector => @selector, :buffered_message => @oracle_aq_buffered_messages) do |message|
           queue_event message, output_queue
           break if stop?
         end

data/logstash-input-jms.gemspec

@@ -1,7 +1,7 @@
 Gem::Specification.new do |s|
 
   s.name            = 'logstash-input-jms'
-  s.version         = '3.0.5'
+  s.version         = '3.0.6'
   s.licenses        = ['Apache License (2.0)']
   s.summary         = "Reads events from a Jms Broker"
   s.description     = "This gem is a Logstash plugin required to be installed on top of the Logstash core pipeline using $LS_HOME/bin/logstash-plugin install gemname. This gem is not a stand-alone program"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: logstash-input-jms
 version: !ruby/object:Gem::Version
-  version: 3.0.5
+  version: 3.0.6
 platform: java
 authors:
 - Elasticsearch
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2018-04-06 00:00:00.000000000 Z
+date: 2019-05-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
@@ -139,7 +139,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project:
-rubygems_version: 2.6.11
+rubygems_version: 2.6.13
 signing_key:
 specification_version: 4
 summary: Reads events from a Jms Broker