logstash-integration-snmp 4.0.0-java → 4.0.1-java

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: a169c08af78713fd509798ce2c094cabb6008b9bd68c674621a62e9e99909968
4
- data.tar.gz: 18f98d64c37266859d3a67699f2cfe196eb8f0690b70382fb66f6ecefc9fe9b0
3
+ metadata.gz: 2a2a3c314a8797b49f4f35a7a79779baa76ffc94b1d44bac47459d87c735ffe2
4
+ data.tar.gz: eacee8e01c540e097243465583a2701e242b4fb6c246ed5c79905b37e5037d33
5
5
  SHA512:
6
- metadata.gz: fc759f4705e32ffa83654880389f39e5a096a87d0ea62d636fb2499831644b1d249ee4c6e17ea82f0b2e949b3ceb8d268dc95b961d029df93cb51296edea5c2f
7
- data.tar.gz: '06866a07ecc529a9ce5d2b163694e9579d2b90bec623a2bb1bcbf9ff8c3e31303fb20362477b9d40f88480ffc4687b07fa05da0d0174093cefb416f2223b8172'
6
+ metadata.gz: 1712b4df3084f8869ce0cbb5f4225551cf9a515f74dd1c9eaffad9ec4f05cff962e3fd79e55699f49f629a7c4db6a1685725940a81789085c2a4645d62e9ed65
7
+ data.tar.gz: 23ead4fe9535c6395ab3f416a75e140453912f5964588837fd8a122a7d18122f6413b04ecd19f272355defcba24ad5181a4242ff60bf4e330f3f06a433077e8a
data/CHANGELOG.md CHANGED
@@ -1,3 +1,6 @@
1
+ ## 4.0.1
2
+ - [DOC] Add technical preview banner and reimplement cross-doc links [#57](https://github.com/logstash-plugins/logstash-integration-snmp/pull/57)
3
+
1
4
  ## 4.0.0
2
5
  - Initial Release of SNMP Integration Plugin, incorporating [logstash-input-snmp](https://github.com/logstash-plugins/logstash-input-snmp) and [logstash-input-snmptrap](https://github.com/logstash-plugins/logstash-input-snmptrap).
3
6
  Independent changelogs for previous versions can be found:
data/VERSION CHANGED
@@ -1 +1 @@
1
- 4.0.0
1
+ 4.0.1
data/docs/index.asciidoc CHANGED
@@ -17,18 +17,27 @@ END - GENERATED VARIABLES, DO NOT EDIT!
17
17
 
18
18
  === SNMP Integration Plugin
19
19
 
20
- // include::{include_path}/plugin_header.asciidoc[]
20
+ include::{include_path}/plugin_header.asciidoc[]
21
+
22
+ experimental[]
23
+
24
+ .Technical Preview
25
+ ****
26
+ The new `integration-snmp` plugin, and its component plugins--`input-snmp` and `input-snmptrap`--are available in _Technical Preview_ and can be installed on the latest Logstash 7.x and 8.x versions.
27
+
28
+ Current 1.x versions of the `input-snmp` plugin are bundled with {ls} by default, and will soon be replaced by the snmp input plugin contained in this integration.
29
+ (If you want to opt into the Technical Preview for the `integration-snmp` plugin, run `bin/logstash-plugin install logstash-integration-snmp`.)
30
+
31
+ Be aware of <<plugins-{type}s-{plugin}-migration,behavioral and mapping differences>> between current stand-alone plugins and the new versions included in the `integration-snmp`.
32
+ The information in this topic can help.
33
+ ****
21
34
 
22
35
  ==== Description
23
36
 
24
37
  The SNMP integration plugin includes:
25
38
 
26
- * SNMP input plugin
27
- * SNMPtrap input plugin
28
-
29
- // Uncomment and replace with above bullets after generated the initial versions of the target files
30
- // - {logstash-ref}/plugins-input-snmp.html[SNMP input plugin]
31
- // - {logstash-ref}/plugins-input-snmptrap.html[Snmptrap input plugin]
39
+ * link:{logstash-ref}/plugins-inputs-snmp.html[SNMP input plugin]
40
+ * link:{logstash-ref}/plugins-inputs-snmptrap.html[Snmptrap input plugin]
32
41
 
33
42
  The new the `logstash-integration-snmp` plugin combines the
34
43
  `logstash-input-snmp` and `logstash-input-snmptrap` plugins into one integrated plugin that encompasses
@@ -47,16 +56,6 @@ In this section, we'll cover:
47
56
  You'll retain and expand the functionality of existing stand-alone plugins, but in a more compact, integrated package.
48
57
  In this section, we'll note mapping and behavioral changes, and explain how to preserve current behavior if needed.
49
58
 
50
- [IMPORTANT]
51
- --
52
- Uninstall the `logstash-input-snmp` and `logstash-input-snmptrap` plugins _before_ you install the `logstash-integration-snmp` plugin.
53
-
54
- * `bin/logstash-plugin remove logstash-input-snmp` +
55
- * `bin/logstash-plugin remove logstash-input-snmptrap`
56
- --
57
-
58
- // ToDo: Add guidance and set expectations for when snmp integration is installed by default
59
-
60
59
  [id="plugins-{type}s-{plugin}-migration-input-snmp"]
61
60
  ===== Migration notes: `logstash-input-snmp`
62
61
 
@@ -130,9 +129,6 @@ input {
130
129
 
131
130
  // ToDo: Any considerations that we should point out?
132
131
 
133
- :no_codec!:
134
-
135
-
136
132
  [id="plugins-{type}s-{plugin}-import-mibs"]
137
133
  ==== Importing MIBs
138
134
 
@@ -198,5 +194,3 @@ $ smidump -c smi.conf -k -f python CISCO-PROCESS-MIB.mib > CISCO-PROCESS-MIB_my.
198
194
  -----
199
195
 
200
196
  :no_codec!:
201
-
202
-
@@ -18,8 +18,21 @@ END - GENERATED VARIABLES, DO NOT EDIT!
18
18
 
19
19
  === SNMP input plugin
20
20
 
21
- // Uncomment after generated the initial versions of the target file
22
- // include::{include_path}/plugin_header-integration.asciidoc[]
21
+ include::{include_path}/plugin_header-integration.asciidoc[]
22
+
23
+ experimental[]
24
+
25
+ .Technical Preview
26
+ ****
27
+ The new `integration-snmp` plugin, and its component plugins--`input-snmp` and `input-snmptrap`--are available in _Technical Preview_ and can be installed on the latest Logstash 7.x and 8.x versions.
28
+
29
+ Current 1.x versions of the `input-snmp` plugin are bundled with {ls} by default, and will soon be replaced by the snmp input plugin contained in this integration.
30
+ (If you want to opt into the Technical Preview for the `integration-snmp` plugin, run `bin/logstash-plugin install logstash-integration-snmp`.)
31
+
32
+ Be aware of behavioral and mapping differences between current stand-alone plugins and the new versions included in the `integration-snmp`.
33
+
34
+ Before you install the new integration, be aware of link:{logstash-ref}/plugins-integrations-snmp.html#plugins-integrations-snmp-migration[behavioral and mapping differences] between current stand-alone plugins and the new versions included in `integration-snmp`.
35
+ ****
23
36
 
24
37
  ==== Description
25
38
 
@@ -34,10 +47,11 @@ The `logstash-input-snmp` plugin is now a component of the `logstash-integration
34
47
  This integrated plugin package provides better alignment in snmp processing, better resource management,
35
48
  easier package maintenance, and a smaller installation footprint.
36
49
 
37
- For migration information and guidelines, check out the migration guide.
50
+ Before you install the new integration, be aware of link:{logstash-ref}/plugins-integrations-snmp.html#plugins-integrations-snmp-migration[behavioral and mapping differences] between current stand-alone plugins and the new versions included in `integration-snmp`.
38
51
  ****
39
52
 
40
- // TODO: Add link to migration topic in the integration index.
53
+ // ToDo: link:{logstash-ref}/plugins-input-snmp.html[Importing MIBs]
54
+
41
55
 
42
56
  [id="plugins-{type}s-{plugin}-ecs"]
43
57
  ==== Compatibility with the Elastic Common Schema (ECS)
@@ -59,9 +73,10 @@ Metadata fields follow a specific naming convention when <<plugins-{type}s-{plug
59
73
  ==== Importing MIBs
60
74
 
61
75
  This plugin already includes the IETF MIBs (management information bases), and you do not need to import them.
62
- If you need additional MIBs, you need to important them.
76
+ If you need additional MIBs, you need to import them.
63
77
  Check out "Importing MIBs" for instructions.
64
78
 
79
+ // link:{logstash-ref}/plugins-input-snmp.html[Importing MIBs]
65
80
  // ToDo: Add link to MIBs content after generated file exists.
66
81
 
67
82
  [id="plugins-{type}s-{plugin}-options"]
@@ -375,7 +390,7 @@ The number of threads to use for executing the hosts SNMP requests.
375
390
  * Value type is <<boolean,boolean>>
376
391
  * Default value is `true`
377
392
 
378
- This plugin provides all IETF MIBs (management information bases), publicly available in the https://www.ibr.cs.tu-bs.de/projects/libsmi[libsmi] version `0.5.0`.
393
+ This plugin provides all IETF MIBs (management information bases), publicly available in the link:https://www.ibr.cs.tu-bs.de/projects/libsmi[libsmi] version `0.5.0`.
379
394
  When enabled, it automatically loads the bundled MIBs and provides mapping of the numeric OIDs to MIB field names in the resulting event.
380
395
 
381
396
  ==== SNMPv3 Authentication Options
@@ -18,8 +18,21 @@ END - GENERATED VARIABLES, DO NOT EDIT!
18
18
 
19
19
  === SNMP trap input plugin
20
20
 
21
- //Uncomment after generated the initial versions of the target file
22
- //include::{include_path}/plugin_header-integration.asciidoc[]
21
+ include::{include_path}/plugin_header-integration.asciidoc[]
22
+
23
+ experimental[]
24
+
25
+ .Technical Preview
26
+ ****
27
+ The new `integration-snmp` plugin, and its component plugins--`input-snmp` and `input-snmptrap`--are available in _Technical Preview_ and can be installed on the latest Logstash 7.x and 8.x versions.
28
+
29
+ Current 1.x versions of the `input-snmp` plugin are bundled with {ls} by default, and will soon be replaced by the snmp input plugin contained in this integration.
30
+ (If you want to opt into the Technical Preview for the `integration-snmp` plugin, run `bin/logstash-plugin install logstash-integration-snmp`.)
31
+
32
+ Be aware of behavioral and mapping differences between current stand-alone plugins and the new versions included in the `integration-snmp`.
33
+
34
+ Before you install the new integration, be aware of link:{logstash-ref}/plugins-integrations-snmp.html#plugins-integrations-snmp-migration[behavioral and mapping differences] between current stand-alone plugins and the new versions included in `integration-snmp`.
35
+ ****
23
36
 
24
37
  ==== Description
25
38
 
@@ -35,11 +48,9 @@ The `logstash-input-snmptrap` plugin is now a component of the `logstash-integra
35
48
  This integrated plugin package provides better alignment in snmp processing, better resource management,
36
49
  easier package maintenance, and a smaller installation footprint.
37
50
 
38
- For migration information and guidelines, check out the migration guide.
51
+ Before you install the new integration, be aware of link:{logstash-ref}/plugins-integrations-snmp.html#plugins-integrations-snmp-migration[behavioral and mapping differences] between current stand-alone plugins and the new versions included in `integration-snmp`.
39
52
  ****
40
53
 
41
- // TODO: Add link to migration topic in the integration index.
42
-
43
54
  [id="plugins-{type}s-{plugin}-ecs"]
44
55
  ==== Event Metadata and the Elastic Common Schema (ECS)
45
56
 
@@ -78,12 +89,12 @@ which variable binding in the list caused the error
78
89
  ==== Importing MIBs
79
90
 
80
91
  This plugin already includes the IETF MIBs (management information bases), and you do not need to import them.
81
- If you need additional MIBs, you need to important them.
92
+ If you need additional MIBs, you need to import them.
82
93
  Check out "Importing MIBs" for instructions.
83
94
 
95
+ // link:{logstash-ref}/plugins-input-snmp.html[Importing MIBs]
84
96
  // ToDo: Add link to MIBs content after generated file exists.
85
97
 
86
-
87
98
  [id="plugins-{type}s-{plugin}-options"]
88
99
  ==== SNMP Trap Input Configuration Options
89
100
 
@@ -263,7 +274,7 @@ The supported transport protocols to listen on.
263
274
 
264
275
  SNMP was originally designed for use with UDP as transport protocol and is the official recommendation.
265
276
  TCP is an optional transport mapping and can be enabled if needed. For more details
266
- on SNMP over TCP, please refer to the https://datatracker.ietf.org/doc/html/rfc3430[RFC-3430].
277
+ on SNMP over TCP, please refer to the link:https://datatracker.ietf.org/doc/html/rfc3430[RFC-3430].
267
278
 
268
279
  [id="plugins-{type}s-{plugin}-supported_versions"]
269
280
  ===== `supported_versions`
@@ -299,7 +310,7 @@ The number of threads to use for processing the received SNMP trap messages.
299
310
  * Value type is <<boolean,boolean>>
300
311
  * Default value is `true`
301
312
 
302
- This plugin provides all IETF MIBs (management information bases), publicly available in the https://www.ibr.cs.tu-bs.de/projects/libsmi[libsmi] version `0.5.0`.
313
+ This plugin provides all IETF MIBs (management information bases), publicly available in the link:https://www.ibr.cs.tu-bs.de/projects/libsmi[libsmi] version `0.5.0`.
303
314
  When enabled, it automatically loads the bundled MIBs and provides mapping of the numeric OIDs to MIB field names in the resulting event.
304
315
 
305
316
  [id="plugins-{type}s-{plugin}-yamlmibdir"]
@@ -3,4 +3,4 @@
3
3
  require 'jar_dependencies'
4
4
  require_jar('org.snmp4j', 'snmp4j', '3.8.0')
5
5
  require_jar('org.snakeyaml', 'snakeyaml-engine', '2.7')
6
- require_jar('org.logstash.integrations', 'plugin', '4.0.0')
6
+ require_jar('org.logstash.integrations', 'plugin', '4.0.1')
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: logstash-integration-snmp
3
3
  version: !ruby/object:Gem::Version
4
- version: 4.0.0
4
+ version: 4.0.1
5
5
  platform: java
6
6
  authors:
7
7
  - Elastic
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-05-03 00:00:00.000000000 Z
11
+ date: 2024-05-17 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  requirement: !ruby/object:Gem::Requirement
@@ -483,7 +483,7 @@ files:
483
483
  - spec/unit/inputs/common_spec.rb
484
484
  - spec/unit/inputs/snmp_spec.rb
485
485
  - spec/unit/inputs/snmptrap_spec.rb
486
- - vendor/jar-dependencies/org/logstash/integrations/plugin/4.0.0/plugin-4.0.0.jar
486
+ - vendor/jar-dependencies/org/logstash/integrations/plugin/4.0.1/plugin-4.0.1.jar
487
487
  - vendor/jar-dependencies/org/snakeyaml/snakeyaml-engine/2.7/snakeyaml-engine-2.7.jar
488
488
  - vendor/jar-dependencies/org/snmp4j/snmp4j/3.8.0/snmp4j-3.8.0.jar
489
489
  homepage: http://www.elastic.co/guide/en/logstash/current/index.html