logstash-integration-snmp 4.3.1-java → 4.4.0-java

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 00b54144b7fb2f7a2504757c195376ea69d30baf878855007afb969f9c6bb372
-  data.tar.gz: 6f8f31cdf110ce9a2b16d632efe00ad888e1145d4dbbce739b885f74a618149a
+  metadata.gz: 2a79607b130f6d5e1b16fa3979be1cddad462aae22e58a481888a35bebbb0c09
+  data.tar.gz: 17add7304deab345d2e8b77d58e95835749ccd4c710176aa3b89aedca27578ac
 SHA512:
-  metadata.gz: c7262768b0db4a1ccee95e57f979813652860e2ccd3cbc7bde0d3d945216a36d0c6b0a539db5d790be05f0100f9f29713106c1e9acca41be0eebdf0d2d063871
-  data.tar.gz: 94c9a90d25ccf4da3008433c9fb45e001402415a060a26d9d9bb8833bae1a8c29a9303b99eccd26854b743d9680aa8dc7c466fc4b42bc28825dc4a9a4e85d365
+  metadata.gz: 22fee9ee3c1b9bcf88682db9fe6ed721c1cb01e46adaacf98e953fe015ef1ff0848b03e0340d0cd26b2e171ace49c9f1d61853de92b41518c89a2cbb2b6a849e
+  data.tar.gz: f94e7f9442e9d3078e2bc519b37e413640081137af6911c8ca114f1b366df86054164c4ec192e924d8add40e5b0fc56f56007f8fd1ae21752729e90e29b396ca

data/CHANGELOG.md

@@ -1,3 +1,6 @@
+## 4.4.0
+  - Expose `max_repetitions` config option to the SNMP input plugin, allowing users to control the max-repetitions field in GETBULK PDUs used by walk and table operations. [#97](https://github.com/logstash-plugins/logstash-integration-snmp/pull/97)
+
 ## 4.3.1
   - Fix: generate error events with _snmpfailure tag when all SNMP operations fail and the response data is empty (e.g., timeout) [#92](https://github.com/logstash-plugins/logstash-integration-snmp/pull/92)
 

data/VERSION

@@ -1 +1 @@
-4.3.1
+4.4.0

data/docs/input-snmp.asciidoc

@@ -78,6 +78,7 @@ This plugin supports the following configuration options plus the <<plugins-{typ
 | <<plugins-{type}s-{plugin}-allow_partial_response>> |<<boolean,boolean>>|No
 | <<plugins-{type}s-{plugin}-interval>> |<<number,number>>|No
 | <<plugins-{type}s-{plugin}-local_engine_id>> |<<string,string>>|No
+| <<plugins-{type}s-{plugin}-max_repetitions>> |<<number,number>>|No
 | <<plugins-{type}s-{plugin}-mib_paths>> |<<path,path>>|No
 | <<plugins-{type}s-{plugin}-oid_mapping_format>> |<<string,string>>, one of `["default", "ruby_snmp", "dotted_string"]`|No
 | <<plugins-{type}s-{plugin}-oid_map_field_values>> |<<boolean,boolean>>|No
@@ -217,6 +218,32 @@ If polling all configured hosts takes longer than this interval, a warning will
 The SNMPv3 local engine ID. Its length must be greater or equal than 5 and less or equal than 32.
 If not provided, a default ID is generated based on the local IP address and additional four random bytes.
 
+[id="plugins-{type}s-{plugin}-max_repetitions"]
+===== `max_repetitions`
+
+  * Value type is <<number,number>>
+  * Default value is `10`
+
+The `max_repetitions` option sets the max-repetitions field in GETBULK PDUs used by `walk` and `table` operations.
+This value controls how many OID rows are returned in each GETBULK response from the SNMP agent.
+
+A smaller value may help avoid timeouts when polling devices with large tables or limited resources.
+A larger value can improve performance by reducing the number of round trips needed to retrieve a full table.
+
+If not set, the SNMP4J library default of `10` is used.
+
+Example
+[source,ruby]
+-----
+input {
+  snmp {
+    walk => ["1.3.6.1.2.1.2.2"]
+    hosts => [{host => "udp:127.0.0.1/161" community => "public"}]
+    max_repetitions => 5
+  }
+}
+-----
+
 [id="plugins-{type}s-{plugin}-mib_paths"]
 ===== `mib_paths`
 

data/lib/logstash/inputs/snmp.rb

@@ -67,6 +67,11 @@ class LogStash::Inputs::Snmp < LogStash::Inputs::Base
   # Timeout in milliseconds to execute all hosts configured operations (get, walk, table).
   config :poll_hosts_timeout, :validate => :number
 
+  # Sets the maximum number of repetitions for GETBULK requests used in `walk` and `table` operations.
+  # This controls how many rows are returned per PDU in SNMPv2c/v3 GETBULK requests.
+  # Lowering this value may help avoid timeouts when polling devices with large tables.
+  config :max_repetitions, :validate => :number, :default => 10
+
   # Append values to the `tags` field when one or more SNMP operations fail
   config :tag_on_failure, :validate => :array, :default => ['_snmpfailure']
 
@@ -263,6 +268,7 @@ class LogStash::Inputs::Snmp < LogStash::Inputs::Base
     validate_hosts!
     validate_tables!
     validate_local_engine_id!
+    validate_max_repetitions!
   end
 
   def validate_oids!
@@ -328,6 +334,12 @@ class LogStash::Inputs::Snmp < LogStash::Inputs::Base
     end
   end
 
+  def validate_max_repetitions!
+    if @max_repetitions <= 0
+      raise(LogStash::ConfigurationError, '`max_repetitions` must be a positive integer')
+    end
+  end
+
   def create_request_aggregator
     SnmpClientRequestAggregator.new(@threads, 'SnmpRequestWorker')
   end
@@ -335,6 +347,7 @@ class LogStash::Inputs::Snmp < LogStash::Inputs::Base
   def build_client!(mib_manager, supported_transports, hosts_versions)
     client_builder = org.logstash.snmp.SnmpClient.builder(mib_manager, supported_transports)
     client_builder.setLocalEngineId(@local_engine_id) unless @local_engine_id.nil?
+    client_builder.setMaxRepetitions(@max_repetitions)
 
     build_snmp_client!(client_builder, validate_usm_user: hosts_versions.include?('3'))
   end

data/lib/logstash-integration-snmp_jars.rb

@@ -4,4 +4,4 @@ require 'jar_dependencies'
 require_jar('org.snmp4j', 'snmp4j-log4j', '2.8.11')
 require_jar('org.snmp4j', 'snmp4j', '3.8.0')
 require_jar('org.snakeyaml', 'snakeyaml-engine', '2.7')
-require_jar('org.logstash.integrations', 'plugin', '4.3.1')
+require_jar('org.logstash.integrations', 'plugin', '4.4.0')

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: logstash-integration-snmp
 version: !ruby/object:Gem::Version
-  version: 4.3.1
+  version: 4.4.0
 platform: java
 authors:
 - Elastic
 bindir: bin
 cert_chain: []
-date: 2026-05-20 00:00:00.000000000 Z
+date: 2026-08-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: logstash-core-plugin-api
@@ -468,7 +468,7 @@ files:
 - spec/unit/inputs/common_spec.rb
 - spec/unit/inputs/snmp_spec.rb
 - spec/unit/inputs/snmptrap_spec.rb
-- vendor/jar-dependencies/org/logstash/integrations/plugin/4.3.1/plugin-4.3.1.jar
+- vendor/jar-dependencies/org/logstash/integrations/plugin/4.4.0/plugin-4.4.0.jar
 - vendor/jar-dependencies/org/snakeyaml/snakeyaml-engine/2.7/snakeyaml-engine-2.7.jar
 - vendor/jar-dependencies/org/snmp4j/snmp4j-log4j/2.8.11/snmp4j-log4j-2.8.11.jar
 - vendor/jar-dependencies/org/snmp4j/snmp4j/3.8.0/snmp4j-3.8.0.jar