theintz / flume-ng-redis

Redis extension for Flume NG

Redis Extension for Flume NG

Redis extension for Flume NG (http://flume.apache.org). Tested with Apache Flume 1.5.0.1 and Redis 2.8.17.

Current Version

• Development: 0.3.0-SNAPSHOT
• Stable: 0.2.0

Current Supported Features

• Source using Redis SUBSCRIBE command (multiple channels)
• Sink using Redis PUBLISH command (only for single channel)

Usage

1. Build or Download jar.
   • Checkout and build this repository.
     1. Stable release (currently version 0.2) is recommended.
     2. Build this library with mvn package -DskipTests command.
   • Or download built jar in release page. (https://github.com/chiwanpark/flume-ng-redis/releases)
2. Copy flume-ng-redis-[VERSION].jar or flume-ng-redis-[VERSION]-jar-with-dependencies.jar into your flume library path.
   • If you use flume-ng-redis-[VERSION].jar, you have to download Jedis (https://github.com/xetorthio/jedis) and copy it to flume library path.
3. Copy configuration sample file or create your own configuration.
4. Run Flume.

   • Following command is sample for RedisSubscribeDrivenSource.

       bin/flume-ng agent -n agent -c conf -f conf/example-SubscribeDrivenSource.properties -Dflume.root.logger=DEBUG,console
     

   • Following commend is sample for RedisPublishDrivenSink

       bin/flume-ng agent -n agent -c conf -f conf/example-PublishDrivenSink.properties
     

Dependencies

• Jedis 2.5.2 (https://github.com/xetorthio/jedis)

License

Copyright 2013-2015 Chiwan Park

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.