58 lines
2.0 KiB
Markdown
58 lines
2.0 KiB
Markdown
# logstash-jdbc
|
|
JDBC output plugin for Logstash.
|
|
This plugin is provided as an external plugin and is not part of the Logstash project.
|
|
|
|
## Warning
|
|
This has not yet been extensively tested with all JDBC drivers and may not yet work for you.
|
|
|
|
## Installation
|
|
- Copy lib directory contents into your logstash installation.
|
|
- Create the directory vendor/jar/jdbc in your logstash installation (`mkdir -p vendor/jar/jdbc/`)
|
|
- Add JDBC jar files to vendor/jar/jdbc in your logstash installation
|
|
- Configure
|
|
|
|
## Configuration options
|
|
* driver_class, string, JDBC driver class to load
|
|
* connection_string, string, JDBC connection string
|
|
* 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). See example configurations below.
|
|
* flush_size, number, default = 1000, number of entries to buffer before sending to SQL
|
|
* idle_flush_time, number, default = 1, number of idle seconds before sending data to SQL, even if the flush_size has not been reached
|
|
|
|
## Example configurations
|
|
### SQLite3
|
|
* Tested using https://bitbucket.org/xerial/sqlite-jdbc
|
|
* SQLite setup - `echo "CREATE table log (host text, timestamp datetime, message text);" | sqlite3 test.db`
|
|
```
|
|
input
|
|
{
|
|
stdin { }
|
|
}
|
|
output {
|
|
stdout { }
|
|
|
|
jdbc {
|
|
driver_class => 'org.sqlite.JDBC'
|
|
connection_string => 'jdbc:sqlite:test.db'
|
|
statement => [ "INSERT INTO log (host, timestamp, message) VALUES(?, ?, ?)", "%{host}", "%{@timestamp}", "%{message}" ]
|
|
}
|
|
}
|
|
```
|
|
|
|
### SQL Server
|
|
* Tested using http://msdn.microsoft.com/en-gb/sqlserver/aa937724.aspx
|
|
```
|
|
input
|
|
{
|
|
stdin { }
|
|
}
|
|
output {
|
|
jdbc {
|
|
driver_class => 'com.microsoft.sqlserver.jdbc.SQLServerDriver'
|
|
connection_string => "jdbc:sqlserver://server:1433;databaseName=databasename;user=username;password=password;autoReconnect=true;"
|
|
statement => [ "INSERT INTO log (host, timestamp, message) VALUES(?, ?, ?)", "%{host}", "%{@timestamp}", "%{message}" ]
|
|
}
|
|
}
|
|
```
|
|
|
|
/* vim: set ts=4 sw=4 tw=0 :*/
|