|
|
|
|
@@ -2,6 +2,8 @@
|
|
|
|
|
|
|
|
|
|
[](https://travis-ci.org/theangryangel/logstash-output-jdbc)
|
|
|
|
|
|
|
|
|
|
⚠️ The logstash v2 version of the plugin does not contain all fixes covered by the v5 version. If you find an issue is resolved under v5, but require the same issue fixed under v2, please raise an issue and I will do my best to find the time to backport the fix. At this time I recommend Logstash v5 where possible.
|
|
|
|
|
|
|
|
|
|
This plugin is provided as an external plugin and is not part of the Logstash project.
|
|
|
|
|
|
|
|
|
|
This plugin allows you to output to SQL databases, using JDBC adapters.
|
|
|
|
|
@@ -21,7 +23,7 @@ See CHANGELOG.md
|
|
|
|
|
Released versions are available via rubygems, and typically tagged.
|
|
|
|
|
|
|
|
|
|
For development:
|
|
|
|
|
- See master branch for logstash v5 (currently **development only**)
|
|
|
|
|
- See master branch for logstash v5
|
|
|
|
|
- See v2.x branch for logstash v2
|
|
|
|
|
- See v1.5 branch for logstash v1.5
|
|
|
|
|
- See v1.4 branch for logstash 1.4
|
|
|
|
|
@@ -47,7 +49,7 @@ For development:
|
|
|
|
|
| username | String | JDBC username - this is optional as it may be included in the connection string, for many drivers | No | |
|
|
|
|
|
| password | String | JDBC password - this is optional as it may be included in the connection string, for many drivers | No | |
|
|
|
|
|
| statement | Array | An array of strings representing the SQL statement to run. Index 0 is the SQL statement that is prepared, all other array entries are passed in as parameters (in order). A parameter may either be a property of the event (i.e. "@timestamp", or "host") or a formatted string (i.e. "%{host} - %{message}" or "%{message}"). If a key is passed then it will be automatically converted as required for insertion into SQL. If it's a formatted string then it will be passed in verbatim. | Yes | |
|
|
|
|
|
| unsafe_statement | Boolean | If yes, the statement is evaluated for event fields - this allows you to use dynamic table names, etc. **This is highly dangerous** and you should **not** use this unless you are 100% sure that the field(s) you are passing in are 100% safe. Failure to do so will result in possible SQL injections. Please be aware that there is also a potential performance penalty as each event must be evaluated and inserted into SQL one at a time, where as when this is false multiple events are inserted at once. Example statement: [ "insert into %{table_name_field} (column) values(?)", "fieldname" ] | No | False |
|
|
|
|
|
| unsafe_statement | Boolean | If yes, the statement is evaluated for event fields - this allows you to use dynamic table names, etc. **This is highly dangerous** and you should **not** use this unless you are 100% sure that the field(s) you are passing in are 100% safe. Failure to do so will result in possible SQL injections. Example statement: [ "insert into %{table_name_field} (column) values(?)", "fieldname" ] | No | False |
|
|
|
|
|
| max_pool_size | Number | Maximum number of connections to open to the SQL server at any 1 time. Default set to same as Logstash default number of workers | No | 24 |
|
|
|
|
|
| connection_timeout | Number | Number of seconds before a SQL connection is closed | No | 2800 |
|
|
|
|
|
| flush_size | Number | Maximum number of entries to buffer before sending to SQL - if this is reached before idle_flush_time | No | 1000 |
|
|
|
|
|
|