logstash-input-syslog 3.2.0 → 3.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/Gemfile +8 -1
- data/docs/index.asciidoc +144 -0
- data/lib/logstash/inputs/syslog.rb +1 -1
- data/logstash-input-syslog.gemspec +2 -2
- metadata +3 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 5ab62b38146cd6161b27b1dde13685ab1a5c7641
|
4
|
+
data.tar.gz: 5a31a61d474921b4e59871c5cdd733933d71cde1
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 9940fbc0acbfa256364d66a129d4743a4a24a918bd851496888e641e4db80a440b5a27bdc9b3818d75b7a2623c31c57e117d5534570f3381ff9cab4984c4bc3e
|
7
|
+
data.tar.gz: a4ae33bf538290a43157ce7672cb4102c3e78cbb6797cc48155dcbe32112f8333d67968dbf05b9131bd87c90d744fbf42b3aa2be3ac07bb8ca78f0f2dceb4ed2
|
data/Gemfile
CHANGED
@@ -1,4 +1,11 @@
|
|
1
1
|
source 'https://rubygems.org'
|
2
2
|
|
3
|
-
# Specify your gem's dependencies in logstash-mass_effect.gemspec
|
4
3
|
gemspec
|
4
|
+
|
5
|
+
logstash_path = ENV["LOGSTASH_PATH"] || "../../logstash"
|
6
|
+
use_logstash_source = ENV["LOGSTASH_SOURCE"] && ENV["LOGSTASH_SOURCE"].to_s == "1"
|
7
|
+
|
8
|
+
if Dir.exist?(logstash_path) && use_logstash_source
|
9
|
+
gem 'logstash-core', :path => "#{logstash_path}/logstash-core"
|
10
|
+
gem 'logstash-core-plugin-api', :path => "#{logstash_path}/logstash-core-plugin-api"
|
11
|
+
end
|
data/docs/index.asciidoc
ADDED
@@ -0,0 +1,144 @@
|
|
1
|
+
:plugin: syslog
|
2
|
+
:type: input
|
3
|
+
|
4
|
+
///////////////////////////////////////////
|
5
|
+
START - GENERATED VARIABLES, DO NOT EDIT!
|
6
|
+
///////////////////////////////////////////
|
7
|
+
:version: %VERSION%
|
8
|
+
:release_date: %RELEASE_DATE%
|
9
|
+
:changelog_url: %CHANGELOG_URL%
|
10
|
+
:include_path: ../../../../logstash/docs/include
|
11
|
+
///////////////////////////////////////////
|
12
|
+
END - GENERATED VARIABLES, DO NOT EDIT!
|
13
|
+
///////////////////////////////////////////
|
14
|
+
|
15
|
+
[id="plugins-{type}-{plugin}"]
|
16
|
+
|
17
|
+
=== Syslog input plugin
|
18
|
+
|
19
|
+
include::{include_path}/plugin_header.asciidoc[]
|
20
|
+
|
21
|
+
==== Description
|
22
|
+
|
23
|
+
Read syslog messages as events over the network.
|
24
|
+
|
25
|
+
This input is a good choice if you already use syslog today.
|
26
|
+
It is also a good choice if you want to receive logs from
|
27
|
+
appliances and network devices where you cannot run your own
|
28
|
+
log collector.
|
29
|
+
|
30
|
+
Of course, 'syslog' is a very muddy term. This input only supports `RFC3164`
|
31
|
+
syslog with some small modifications. The date format is allowed to be
|
32
|
+
`RFC3164` style or `ISO8601`. Otherwise the rest of `RFC3164` must be obeyed.
|
33
|
+
If you do not use `RFC3164`, do not use this input.
|
34
|
+
|
35
|
+
For more information see the http://www.ietf.org/rfc/rfc3164.txt[RFC3164 page].
|
36
|
+
|
37
|
+
Note: This input will start listeners on both TCP and UDP.
|
38
|
+
|
39
|
+
|
40
|
+
[id="plugins-{type}s-{plugin}-options"]
|
41
|
+
==== Syslog Input Configuration Options
|
42
|
+
|
43
|
+
This plugin supports the following configuration options plus the <<plugins-{type}s-{plugin}-common-options>> described later.
|
44
|
+
|
45
|
+
[cols="<,<,<",options="header",]
|
46
|
+
|=======================================================================
|
47
|
+
|Setting |Input type|Required
|
48
|
+
| <<plugins-{type}s-{plugin}-facility_labels>> |<<array,array>>|No
|
49
|
+
| <<plugins-{type}s-{plugin}-host>> |<<string,string>>|No
|
50
|
+
| <<plugins-{type}s-{plugin}-locale>> |<<string,string>>|No
|
51
|
+
| <<plugins-{type}s-{plugin}-port>> |<<number,number>>|No
|
52
|
+
| <<plugins-{type}s-{plugin}-proxy_protocol>> |<<boolean,boolean>>|No
|
53
|
+
| <<plugins-{type}s-{plugin}-severity_labels>> |<<array,array>>|No
|
54
|
+
| <<plugins-{type}s-{plugin}-timezone>> |<<string,string>>|No
|
55
|
+
| <<plugins-{type}s-{plugin}-use_labels>> |<<boolean,boolean>>|No
|
56
|
+
|=======================================================================
|
57
|
+
|
58
|
+
Also see <<plugins-{type}s-{plugin}-common-options>> for a list of options supported by all
|
59
|
+
input plugins.
|
60
|
+
|
61
|
+
|
62
|
+
|
63
|
+
[id="plugins-{type}s-{plugin}-facility_labels"]
|
64
|
+
===== `facility_labels`
|
65
|
+
|
66
|
+
* Value type is <<array,array>>
|
67
|
+
* Default value is `["kernel", "user-level", "mail", "system", "security/authorization", "syslogd", "line printer", "network news", "UUCP", "clock", "security/authorization", "FTP", "NTP", "log audit", "log alert", "clock", "local0", "local1", "local2", "local3", "local4", "local5", "local6", "local7"]`
|
68
|
+
|
69
|
+
Labels for facility levels. These are defined in RFC3164.
|
70
|
+
|
71
|
+
[id="plugins-{type}s-{plugin}-host"]
|
72
|
+
===== `host`
|
73
|
+
|
74
|
+
* Value type is <<string,string>>
|
75
|
+
* Default value is `"0.0.0.0"`
|
76
|
+
|
77
|
+
The address to listen on.
|
78
|
+
|
79
|
+
[id="plugins-{type}s-{plugin}-locale"]
|
80
|
+
===== `locale`
|
81
|
+
|
82
|
+
* Value type is <<string,string>>
|
83
|
+
* There is no default value for this setting.
|
84
|
+
|
85
|
+
Specify a locale to be used for date parsing using either IETF-BCP47 or POSIX language tag.
|
86
|
+
Simple examples are `en`,`en-US` for BCP47 or `en_US` for POSIX.
|
87
|
+
If not specified, the platform default will be used.
|
88
|
+
|
89
|
+
The locale is mostly necessary to be set for parsing month names (pattern with MMM) and
|
90
|
+
weekday names (pattern with EEE).
|
91
|
+
|
92
|
+
|
93
|
+
[id="plugins-{type}s-{plugin}-port"]
|
94
|
+
===== `port`
|
95
|
+
|
96
|
+
* Value type is <<number,number>>
|
97
|
+
* Default value is `514`
|
98
|
+
|
99
|
+
The port to listen on. Remember that ports less than 1024 (privileged
|
100
|
+
ports) may require root to use.
|
101
|
+
|
102
|
+
[id="plugins-{type}s-{plugin}-proxy_protocol"]
|
103
|
+
===== `proxy_protocol`
|
104
|
+
|
105
|
+
* Value type is <<boolean,boolean>>
|
106
|
+
* Default value is `false`
|
107
|
+
|
108
|
+
Proxy protocol support, only v1 is supported at this time
|
109
|
+
http://www.haproxy.org/download/1.5/doc/proxy-protocol.txt
|
110
|
+
|
111
|
+
[id="plugins-{type}s-{plugin}-severity_labels"]
|
112
|
+
===== `severity_labels`
|
113
|
+
|
114
|
+
* Value type is <<array,array>>
|
115
|
+
* Default value is `["Emergency", "Alert", "Critical", "Error", "Warning", "Notice", "Informational", "Debug"]`
|
116
|
+
|
117
|
+
Labels for severity levels. These are defined in RFC3164.
|
118
|
+
|
119
|
+
[id="plugins-{type}s-{plugin}-timezone"]
|
120
|
+
===== `timezone`
|
121
|
+
|
122
|
+
* Value type is <<string,string>>
|
123
|
+
* There is no default value for this setting.
|
124
|
+
|
125
|
+
Specify a time zone canonical ID to be used for date parsing.
|
126
|
+
The valid IDs are listed on the [Joda.org available time zones page](http://joda-time.sourceforge.net/timezones.html).
|
127
|
+
This is useful in case the time zone cannot be extracted from the value,
|
128
|
+
and is not the platform default.
|
129
|
+
If this is not specified the platform default will be used.
|
130
|
+
Canonical ID is good as it takes care of daylight saving time for you
|
131
|
+
For example, `America/Los_Angeles` or `Europe/France` are valid IDs.
|
132
|
+
|
133
|
+
[id="plugins-{type}s-{plugin}-use_labels"]
|
134
|
+
===== `use_labels`
|
135
|
+
|
136
|
+
* Value type is <<boolean,boolean>>
|
137
|
+
* Default value is `true`
|
138
|
+
|
139
|
+
Use label parsing for severity and facility levels.
|
140
|
+
|
141
|
+
|
142
|
+
|
143
|
+
[id="plugins-{type}s-{plugin}-common-options"]
|
144
|
+
include::{include_path}/{type}.asciidoc[]
|
@@ -141,7 +141,7 @@ class LogStash::Inputs::Syslog < LogStash::Inputs::Base
|
|
141
141
|
@udp.bind(@host, @port)
|
142
142
|
|
143
143
|
while !stop?
|
144
|
-
payload, client = @udp.recvfrom(
|
144
|
+
payload, client = @udp.recvfrom(65507)
|
145
145
|
metric.increment(:messages_received)
|
146
146
|
decode(client[3], output_queue, payload)
|
147
147
|
end
|
@@ -1,7 +1,7 @@
|
|
1
1
|
Gem::Specification.new do |s|
|
2
2
|
|
3
3
|
s.name = 'logstash-input-syslog'
|
4
|
-
s.version = '3.2.
|
4
|
+
s.version = '3.2.1'
|
5
5
|
s.licenses = ['Apache License (2.0)']
|
6
6
|
s.summary = "Read syslog messages as events over the network."
|
7
7
|
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"
|
@@ -11,7 +11,7 @@ Gem::Specification.new do |s|
|
|
11
11
|
s.require_paths = ["lib"]
|
12
12
|
|
13
13
|
# Files
|
14
|
-
s.files = Dir[
|
14
|
+
s.files = Dir["lib/**/*","spec/**/*","*.gemspec","*.md","CONTRIBUTORS","Gemfile","LICENSE","NOTICE.TXT", "vendor/jar-dependencies/**/*.jar", "vendor/jar-dependencies/**/*.rb", "VERSION", "docs/**/*"]
|
15
15
|
|
16
16
|
# Tests
|
17
17
|
s.test_files = s.files.grep(%r{^(test|spec|features)/})
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: logstash-input-syslog
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 3.2.
|
4
|
+
version: 3.2.1
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Elastic
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date:
|
11
|
+
date: 2017-06-23 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
requirement: !ruby/object:Gem::Requirement
|
@@ -146,6 +146,7 @@ files:
|
|
146
146
|
- LICENSE
|
147
147
|
- NOTICE.TXT
|
148
148
|
- README.md
|
149
|
+
- docs/index.asciidoc
|
149
150
|
- lib/logstash/inputs/syslog.rb
|
150
151
|
- logstash-input-syslog.gemspec
|
151
152
|
- spec/inputs/syslog_spec.rb
|