|
| 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 | + |
| 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[] |
0 commit comments