logstash-integration-snmp 4.0.0-java → 4.0.2-java
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +6 -0
- data/VERSION +1 -1
- data/docs/index.asciidoc +16 -22
- data/docs/input-snmp.asciidoc +21 -6
- data/docs/input-snmptrap.asciidoc +20 -9
- data/lib/logstash-integration-snmp_jars.rb +1 -1
- data/spec/integration/inputs/snmp_spec.rb +2 -2
- data/vendor/jar-dependencies/org/logstash/integrations/plugin/{4.0.0/plugin-4.0.0.jar → 4.0.2/plugin-4.0.2.jar} +0 -0
- metadata +3 -3
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: a118e564c156abe1ca3e7eee83028f8cd73610823de9eca7873db7c41196398c
|
4
|
+
data.tar.gz: 06c610f49f21d97fe75fadddbdd9aed4824ff36f34970649bdc2afd539992993
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 93fa035596764f1f4de22df4a9696c11aeaeba327c7897fb0cf40a08246f6d1624218e68161d9100bbd04f77733aa3b9b74721bd0ee677e8fd8fe85ae19f7012
|
7
|
+
data.tar.gz: 1da5fefbbc3d7ac39a244f5361ed25ade680e2656286f79491bd89202f130a66e105f12c20451bcf32d6fafd9b06d16eb2b2d0bfe8d7b9d36fdb5d96975c643f
|
data/CHANGELOG.md
CHANGED
@@ -1,3 +1,9 @@
|
|
1
|
+
## 4.0.2
|
2
|
+
- Fixed `input-snmp` `tables` event mapping to remove the "index" value from the OID field (backward compatibility) [#61](https://github.com/logstash-plugins/logstash-integration-snmp/pull/61)
|
3
|
+
|
4
|
+
## 4.0.1
|
5
|
+
- [DOC] Add technical preview banner and reimplement cross-doc links [#57](https://github.com/logstash-plugins/logstash-integration-snmp/pull/57)
|
6
|
+
|
1
7
|
## 4.0.0
|
2
8
|
- 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
9
|
Independent changelogs for previous versions can be found:
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
4.0.
|
1
|
+
4.0.2
|
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
|
-
|
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
|
-
*
|
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
|
-
|
data/docs/input-snmp.asciidoc
CHANGED
@@ -18,8 +18,21 @@ END - GENERATED VARIABLES, DO NOT EDIT!
|
|
18
18
|
|
19
19
|
=== SNMP input plugin
|
20
20
|
|
21
|
-
|
22
|
-
|
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
|
-
|
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
|
-
//
|
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
|
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
|
-
|
22
|
-
|
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
|
-
|
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
|
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"]
|
@@ -130,7 +130,7 @@ describe LogStash::Inputs::Snmp, :integration => true do
|
|
130
130
|
expect(table).to be_a(Array)
|
131
131
|
|
132
132
|
(0..9).each do |index|
|
133
|
-
expect(table[index]["iso.org.dod.internet.mgmt.mib-2.system.sysORTable.sysOREntry.sysORUpTime
|
133
|
+
expect(table[index]["iso.org.dod.internet.mgmt.mib-2.system.sysORTable.sysOREntry.sysORUpTime"]).to be_a Integer
|
134
134
|
expect(table[index]['index']).to be_a(String)
|
135
135
|
end
|
136
136
|
end
|
@@ -192,7 +192,7 @@ describe LogStash::Inputs::Snmp, :integration => true do
|
|
192
192
|
expect(table.length).to be(1)
|
193
193
|
|
194
194
|
table_oid_data = table[0]
|
195
|
-
expect(table_oid_data['iso.org.dod.internet.mgmt.mib-2.system.sysName
|
195
|
+
expect(table_oid_data['iso.org.dod.internet.mgmt.mib-2.system.sysName']).to be_a String
|
196
196
|
expect(table_oid_data['index']).to be_a String
|
197
197
|
end
|
198
198
|
end
|
Binary file
|
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.
|
4
|
+
version: 4.0.2
|
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-
|
11
|
+
date: 2024-05-20 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.
|
486
|
+
- vendor/jar-dependencies/org/logstash/integrations/plugin/4.0.2/plugin-4.0.2.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
|