logstash-output-sumologic 1.1.1 → 1.1.2
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 +5 -5
- data/README.md +9 -9
- data/logstash-output-sumologic.gemspec +2 -2
- metadata +8 -6
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
|
-
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
2
|
+
SHA256:
|
3
|
+
metadata.gz: ba5807e120c5eda6d21c3bb9a424a6ac8bb3fed2c183d88cb261f282e63199e5
|
4
|
+
data.tar.gz: 44b192d5ad18f126deb26da88d1a1e4a063df4fbf4a8acc09704ced09b39b87d
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 4a863488145756c41cdfb8570fc44cceefa9d3f1457a03516805cd431eba1b3892548fdc90a95902c74159d239fe55f39eddba43e22594692070e583da5d87bb
|
7
|
+
data.tar.gz: c5218fa63f2f21bf2376d5555d8f7a4e7ac9cb3db532ef659aafa63ee4f2f1312d6d6be47947c5455fd48728f31437348eba66ead7c1259cbb538551a1fdfcda
|
data/README.md
CHANGED
@@ -4,7 +4,7 @@ This is an output plugin for [Logstash](https://github.com/elastic/logstash).
|
|
4
4
|
It is fully free and fully open source. The license is Apache 2.0, meaning you are pretty much free to use it however you want in whatever way.
|
5
5
|
|
6
6
|
## Getting Started
|
7
|
-
This guide is for the users just want download the binary and make the plugin work. For the developer, please refer to the [Developer Guide](DEVELOPER.md)
|
7
|
+
This guide is for the users just want to download the binary and make the plugin work. For the developer, please refer to the [Developer Guide](DEVELOPER.md)
|
8
8
|
|
9
9
|
### 1. Create a Sumo Logic HTTP source
|
10
10
|
Create a [Sumo Logic](https://www.sumologic.com/) free account if you currently don't have one.
|
@@ -24,7 +24,7 @@ bin/logstash-plugin install logstash-output-sumologic
|
|
24
24
|
### 4. Start Logstash and send log
|
25
25
|
In the Logstash home, running:
|
26
26
|
```sh
|
27
|
-
bin/logstash -e
|
27
|
+
bin/logstash -e "input{stdin{}}output{sumologic{url=>'<URL from step 1>'}}"
|
28
28
|
```
|
29
29
|
This will send any input from console to Sumo Logic cloud service.
|
30
30
|
|
@@ -47,7 +47,7 @@ bin/logstash -f samples/metrics.conf
|
|
47
47
|
A mocked event will be sent to Sumo Logic cloud service as 1 minute and 15 minutes rate metrics.
|
48
48
|
|
49
49
|
### 6. Get result from Sumo Logic web app
|
50
|
-
Logon to Sumo Logic [web app](https://
|
50
|
+
Logon to Sumo Logic [web app](https://service.sumologic.com/) and run
|
51
51
|
- [Log Search](http://help.sumologic.com/Search)
|
52
52
|
- [Live Tail](http://help.sumologic.com/Search/Live_Tail)
|
53
53
|
- [Metrics Search](https://help.sumologic.com/Metrics)
|
@@ -59,20 +59,20 @@ Logon to Sumo Logic [web app](https://prod-www.sumologic.net/ui/) and run
|
|
59
59
|
|
60
60
|
## Parameters of Plugin
|
61
61
|
| Parameter | Type | Required? | Default value | Decription |
|
62
|
-
| ------------------- | ------- | --------- |
|
62
|
+
| ------------------- | ------- | --------- | :---------------: | --------------------- |
|
63
63
|
| `url` | string | Yes | | HTTP Source URL
|
64
64
|
| `source_category` | string | No | | Source category to appear when searching in Sumo Logic by `_sourceCategory`. If not specified, the source category of the HTTP source will be used.
|
65
65
|
| `source_name` | string | No | | Source name to appear when searching in Sumo Logic by `_sourceName`.
|
66
66
|
| `source_host` | string | No | | Source host to appear when searching in Sumo Logic by `_sourceHost`. If not specified, it will be the machine host name.
|
67
67
|
| `extra_headers` | hash | No | | Extra fields need to be send in HTTP header.
|
68
68
|
| `compress` | boolean | No | `false` | Enable or disable compression.
|
69
|
-
| `compress_encoding` | string | No | `
|
70
|
-
| `interval` | number | No | `0` | The maximum time for waiting before send in batch, in
|
69
|
+
| `compress_encoding` | string | No | `"deflate"` | Encoding method of comressing, can only be `"deflate"` or `"gzip"`.
|
70
|
+
| `interval` | number | No | `0` | The maximum time for waiting before send in batch, in seconds.
|
71
71
|
| `format` | string | No | `"%{@timestamp} %{host} %{message}"` | For log only, the formatter of log lines. Use `%{@json}` as the placeholder for whole event json.
|
72
|
-
| `json_mapping` | hash | No | | Override the structure of `{@json}` tag with the given key value pairs.
|
72
|
+
| `json_mapping` | hash | No | | Override the structure of `{@json}` tag with the given key value pairs. <br />For example:<br />`json_mapping => { "foo" => "%{@timestamp}" "bar" => "%{message}" }`<br />will create messages as:<br />`{"foo":"2016-07-27T18:37:59.460Z","bar":"hello world"}`<br />`{"foo":"2016-07-27T18:38:01.222Z","bar":"bye!"}`
|
73
73
|
| `metrics` | hash | No | | If defined, the event will be sent as metrics. Keys will be the metrics name and values will be the metrics value.
|
74
|
-
| `metrics_format` | string | No | `
|
75
|
-
| `metrics_name` | string | No |
|
74
|
+
| `metrics_format` | string | No | `"cabon2"` | Metrics format, can only be `"graphite"` or `"carbon2"`.
|
75
|
+
| `metrics_name` | string | No | `"*"` | Define the metric name looking, the placeholder "*" will be replaced with the actual metric name.
|
76
76
|
| `intrinsic_tags` | hash | No | | For carbon2 format only, send extra intrinsic key-value pairs other than `metric` (which is the metric name).
|
77
77
|
| `meta_tags` | hash | No | | For carbon2 format only, send metadata key-value pairs.
|
78
78
|
| `fields_as_metrics` | boolean | No | `false` | If `true`, all fields in logstash event with number value will be sent as a metrics (with filtering by `fields_include` and `fields_exclude` ; the `metics` parameter is ignored.
|
@@ -1,6 +1,6 @@
|
|
1
1
|
Gem::Specification.new do |s|
|
2
2
|
s.name = "logstash-output-sumologic"
|
3
|
-
s.version = "1.1.
|
3
|
+
s.version = "1.1.2"
|
4
4
|
s.licenses = ["Apache-2.0"]
|
5
5
|
s.summary = "Deliever the log to Sumo Logic cloud service."
|
6
6
|
s.description = "This gem is a Logstash output plugin to deliver the log or metrics to Sumo Logic cloud service. Go to https://github.com/SumoLogic/logstash-output-sumologic for getting help, reporting issues, etc."
|
@@ -19,6 +19,6 @@ Gem::Specification.new do |s|
|
|
19
19
|
|
20
20
|
# Gem dependencies
|
21
21
|
s.add_runtime_dependency "logstash-core-plugin-api", "~> 2.0"
|
22
|
-
s.add_runtime_dependency "logstash-codec-plain", "
|
22
|
+
s.add_runtime_dependency "logstash-codec-plain", ">= 0"
|
23
23
|
s.add_development_dependency "logstash-devutils", "~> 0"
|
24
24
|
end
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: logstash-output-sumologic
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 1.1.
|
4
|
+
version: 1.1.2
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Sumo Logic
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date:
|
11
|
+
date: 2018-02-09 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
requirement: !ruby/object:Gem::Requirement
|
@@ -27,7 +27,7 @@ dependencies:
|
|
27
27
|
- !ruby/object:Gem::Dependency
|
28
28
|
requirement: !ruby/object:Gem::Requirement
|
29
29
|
requirements:
|
30
|
-
- - "
|
30
|
+
- - ">="
|
31
31
|
- !ruby/object:Gem::Version
|
32
32
|
version: '0'
|
33
33
|
name: logstash-codec-plain
|
@@ -35,7 +35,7 @@ dependencies:
|
|
35
35
|
type: :runtime
|
36
36
|
version_requirements: !ruby/object:Gem::Requirement
|
37
37
|
requirements:
|
38
|
-
- - "
|
38
|
+
- - ">="
|
39
39
|
- !ruby/object:Gem::Version
|
40
40
|
version: '0'
|
41
41
|
- !ruby/object:Gem::Dependency
|
@@ -52,7 +52,9 @@ dependencies:
|
|
52
52
|
- - "~>"
|
53
53
|
- !ruby/object:Gem::Version
|
54
54
|
version: '0'
|
55
|
-
description: This gem is a Logstash output plugin to deliver the log or metrics to
|
55
|
+
description: This gem is a Logstash output plugin to deliver the log or metrics to
|
56
|
+
Sumo Logic cloud service. Go to https://github.com/SumoLogic/logstash-output-sumologic
|
57
|
+
for getting help, reporting issues, etc.
|
56
58
|
email: 'collection@sumologic.com '
|
57
59
|
executables: []
|
58
60
|
extensions: []
|
@@ -91,7 +93,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
91
93
|
version: '0'
|
92
94
|
requirements: []
|
93
95
|
rubyforge_project:
|
94
|
-
rubygems_version: 2.6.
|
96
|
+
rubygems_version: 2.6.13
|
95
97
|
signing_key:
|
96
98
|
specification_version: 4
|
97
99
|
summary: Deliever the log to Sumo Logic cloud service.
|