Skip to content

Commit 97019e1

Browse files
committed
Initial doc move
1 parent 304a48c commit 97019e1

File tree

2 files changed

+139
-1
lines changed

2 files changed

+139
-1
lines changed

docs/index.asciidoc

Lines changed: 138 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,138 @@
1+
:plugin: redis
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+
=== Redis
18+
19+
include::{include_path}/plugin_header.asciidoc[]
20+
21+
==== Description
22+
23+
This input will read events from a Redis instance; it supports both Redis channels and lists.
24+
The list command (BLPOP) used by Logstash is supported in Redis v1.3.1+, and
25+
the channel commands used by Logstash are found in Redis v1.3.8+.
26+
While you may be able to make these Redis versions work, the best performance
27+
and stability will be found in more recent stable versions. Versions 2.6.0+
28+
are recommended.
29+
30+
For more information about Redis, see <http://redis.io/>
31+
32+
`batch_count` note: If you use the `batch_count` setting, you *must* use a Redis version 2.6.0 or
33+
newer. Anything older does not support the operations used by batching.
34+
35+
36+
[id="plugins-{type}s-{plugin}-options"]
37+
==== Redis Input Configuration Options
38+
39+
This plugin supports the following configuration options plus the <<plugins-{type}s-common-options>> described later.
40+
41+
[cols="<,<,<",options="header",]
42+
|=======================================================================
43+
|Setting |Input type|Required
44+
| <<plugins-{type}s-{plugin}-batch_count>> |<<number,number>>|No
45+
| <<plugins-{type}s-{plugin}-data_type>> |<<string,string>>, one of `["list", "channel", "pattern_channel"]`|Yes
46+
| <<plugins-{type}s-{plugin}-db>> |<<number,number>>|No
47+
| <<plugins-{type}s-{plugin}-host>> |<<string,string>>|No
48+
| <<plugins-{type}s-{plugin}-key>> |<<string,string>>|Yes
49+
| <<plugins-{type}s-{plugin}-password>> |<<password,password>>|No
50+
| <<plugins-{type}s-{plugin}-port>> |<<number,number>>|No
51+
| <<plugins-{type}s-{plugin}-threads>> |<<number,number>>|No
52+
| <<plugins-{type}s-{plugin}-timeout>> |<<number,number>>|No
53+
|=======================================================================
54+
55+
Also see <<plugins-{type}s-common-options>> for a list of options supported by all
56+
input plugins.
57+
58+
&nbsp;
59+
60+
[id="plugins-{type}s-{plugin}-batch_count"]
61+
===== `batch_count`
62+
63+
* Value type is <<number,number>>
64+
* Default value is `125`
65+
66+
The number of events to return from Redis using EVAL.
67+
68+
[id="plugins-{type}s-{plugin}-data_type"]
69+
===== `data_type`
70+
71+
* This is a required setting.
72+
* Value can be any of: `list`, `channel`, `pattern_channel`
73+
* There is no default value for this setting.
74+
75+
Specify either list or channel. If `redis\_type` is `list`, then we will BLPOP the
76+
key. If `redis\_type` is `channel`, then we will SUBSCRIBE to the key.
77+
If `redis\_type` is `pattern_channel`, then we will PSUBSCRIBE to the key.
78+
79+
[id="plugins-{type}s-{plugin}-db"]
80+
===== `db`
81+
82+
* Value type is <<number,number>>
83+
* Default value is `0`
84+
85+
The Redis database number.
86+
87+
[id="plugins-{type}s-{plugin}-host"]
88+
===== `host`
89+
90+
* Value type is <<string,string>>
91+
* Default value is `"127.0.0.1"`
92+
93+
The hostname of your Redis server.
94+
95+
[id="plugins-{type}s-{plugin}-key"]
96+
===== `key`
97+
98+
* This is a required setting.
99+
* Value type is <<string,string>>
100+
* There is no default value for this setting.
101+
102+
The name of a Redis list or channel.
103+
104+
[id="plugins-{type}s-{plugin}-password"]
105+
===== `password`
106+
107+
* Value type is <<password,password>>
108+
* There is no default value for this setting.
109+
110+
Password to authenticate with. There is no authentication by default.
111+
112+
[id="plugins-{type}s-{plugin}-port"]
113+
===== `port`
114+
115+
* Value type is <<number,number>>
116+
* Default value is `6379`
117+
118+
The port to connect on.
119+
120+
[id="plugins-{type}s-{plugin}-threads"]
121+
===== `threads`
122+
123+
* Value type is <<number,number>>
124+
* Default value is `1`
125+
126+
127+
128+
[id="plugins-{type}s-{plugin}-timeout"]
129+
===== `timeout`
130+
131+
* Value type is <<number,number>>
132+
* Default value is `5`
133+
134+
Initial connection timeout in seconds.
135+
136+
137+
138+
include::{include_path}/{type}.asciidoc[]

logstash-input-redis.gemspec

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Gem::Specification.new do |s|
1111
s.require_paths = ["lib"]
1212

1313
# Files
14-
s.files = Dir['lib/**/*','spec/**/*','vendor/**/*','*.gemspec','*.md','CONTRIBUTORS','Gemfile','LICENSE','NOTICE.TXT']
14+
s.files = Dir["lib/**/*","spec/**/*","*.gemspec","*.md","CONTRIBUTORS","Gemfile","LICENSE","NOTICE.TXT", "vendor/jar-dependencies/**/*.jar", "vendor/jar-dependencies/**/*.rb", "VERSION", "docs/**/*"]
1515

1616
# Tests
1717
s.test_files = s.files.grep(%r{^(test|spec|features)/})

0 commit comments

Comments
 (0)