fluent-plugin-websocket 0.1.2 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,17 +1,18 @@
1
- # Fluent::Plugin::Websocket
1
+ = Fluent::Plugin::Websocket
2
2
 
3
3
  Fluentd websocket output plugin.
4
4
 
5
- ## Installation
5
+ This plugin works as websocket server which can output JSON string or {MessagePack}[http://msgpack.org/] binary.
6
6
 
7
- Copy __out_websocket.rb__ into your fluentd plugin directory.
7
+ In the current version, emitted data will be broadcasted to the all connected clients.
8
8
 
9
- Default plugin directory is _/etc/fluent/plugin_. You can specify additional location by _-p_ option. (Please see _fluentd -h_)
9
+ == Installation
10
10
 
11
- This plugin depends on [__em-websocket__](https://github.com/igrigorik/em-websocket) module. You can install it by _gem install em-websocket_.
11
+ gem install fluent-plugin-websocket
12
12
 
13
+ This plugin depends on {*em-websocket*}[https://github.com/igrigorik/em-websocket].
13
14
 
14
- ## Configuration
15
+ == Configuration
15
16
  <match foo.**>
16
17
  type websocket
17
18
  host 192.168.1.1 # default: 0.0.0.0 (ANY)
@@ -21,13 +22,13 @@ This plugin depends on [__em-websocket__](https://github.com/igrigorik/em-websoc
21
22
  add_tag true # default: true
22
23
  </match>
23
24
 
24
- - __host__: WebSocket server IP address.
25
- - __port__: WebSocket server port.
26
- - __use\_msgpack__: Send [MessagePack](http://msgpack.org/) format binary. Otherwise, you send JSON format text.
27
- - __add\_time__: Add timestamp to the data.
28
- - __add\_tag__: Add fluentd tag to the data.
25
+ * *host*: WebSocket server IP address.
26
+ * *port*: WebSocket server port.
27
+ * <b>use_msgpack</b>: Send {MessagePack}[http://msgpack.org/] format binary. Otherwise, you send JSON format text.
28
+ * <b>add_time</b>: Add timestamp to the data.
29
+ * <b>add_tag</b>: Add fluentd tag to the data.
29
30
 
30
- If there are no websocket connections, this plugin silently discards data. You may use _out\_copy_ plugin like this:
31
+ If there are no websocket connections, this plugin silently discards data. You may use <em>out_copy</em> plugin like this:
31
32
 
32
33
  <match foo.**>
33
34
  type copy
@@ -41,26 +42,26 @@ If there are no websocket connections, this plugin silently discards data. You m
41
42
  </store>
42
43
  </match>
43
44
 
44
- ## Data format
45
+ == Data format
45
46
  [tag, timestamp, data_object]
46
47
 
47
- - tag is appended when _add\_tag_ option is true.
48
- - timespamp is appended when _add\_time_ option is true.
48
+ * tag is appended when <em>add_tag</em> option is true.
49
+ * timespamp is appended when <em>add_time</em> option is true.
49
50
 
50
- ### Example
51
+ === Example
51
52
  curl -X POST -d 'json={"action":"login","user":6}' http://localhost:8888/foo/bar
52
53
 
53
54
  ["foo.bar",1364699026,{"action":"login","user":6}]
54
55
 
55
- ## Client sample
56
- ### JSON format (use_msgpack: false)
56
+ == Client sample
57
+ === JSON format (use_msgpack: false)
57
58
  function onMessage(evt) {
58
59
  data = JSON.parse(evt.data);
59
60
  ...
60
61
  }
61
62
 
62
- ### Msgpack format binary (use_msgpack: true)
63
- Extract data by [msgpack.js](https://github.com/msgpack/msgpack-javascript).
63
+ === Msgpack format binary (use_msgpack: true)
64
+ Extract data by {msgpack.js}[https://github.com/msgpack/msgpack-javascript].
64
65
 
65
66
  websocket.binaryType = "arraybuffer"
66
67
  ...
@@ -69,7 +70,7 @@ Extract data by [msgpack.js](https://github.com/msgpack/msgpack-javascript).
69
70
  ...
70
71
  }
71
72
 
72
- ## Contributing
73
+ == Contributing
73
74
 
74
75
  1. Fork it
75
76
  2. Create your feature branch (`git checkout -b my-new-feature`)
@@ -77,3 +78,7 @@ Extract data by [msgpack.js](https://github.com/msgpack/msgpack-javascript).
77
78
  4. Push to the branch (`git push origin my-new-feature`)
78
79
  5. Create new Pull Request
79
80
 
81
+ == Copyright
82
+
83
+ Copyright:: Copyright (c) 2013 IZAWA Tetsu (@moccos)
84
+ License:: Apache License, Version 2.0
@@ -3,12 +3,12 @@ lib = File.expand_path('../lib', __FILE__)
3
3
 
4
4
  Gem::Specification.new do |gem|
5
5
  gem.name = "fluent-plugin-websocket"
6
- gem.version = "0.1.2"
6
+ gem.version = "0.1.3"
7
7
  gem.authors = ["IZAWA Tetsu (@moccos)"]
8
8
  gem.email = ["tt.izawa@gmail.com"]
9
9
  gem.homepage = "https://github.com/moccos/fluent-plugin-websocket"
10
10
  gem.summary = %q{Fluentd websocket output plugin}
11
- gem.description = %q{Fluentd websocket output plugin}
11
+ gem.description = %q{Fluentd websocket output plugin which can output JSON string or MessagePack binary to the clients.}
12
12
  gem.required_ruby_version = ">= 1.9.2"
13
13
 
14
14
  gem.files = `git ls-files`.split($/)
@@ -18,7 +18,7 @@ Gem::Specification.new do |gem|
18
18
 
19
19
  gem.add_development_dependency "rake"
20
20
  gem.add_development_dependency "fluentd"
21
- gem.add_development_dependency "websocket-ocket-eventmachine-client"
21
+ gem.add_development_dependency "websocket-eventmachine-client"
22
22
  gem.add_development_dependency "msgpack"
23
23
  gem.add_runtime_dependency "fluentd"
24
24
  gem.add_runtime_dependency "em-websocket"
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: fluent-plugin-websocket
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.1.2
4
+ version: 0.1.3
5
5
  prerelease:
6
6
  platform: ruby
7
7
  authors:
@@ -44,7 +44,7 @@ dependencies:
44
44
  - !ruby/object:Gem::Version
45
45
  version: '0'
46
46
  - !ruby/object:Gem::Dependency
47
- name: websocket-ocket-eventmachine-client
47
+ name: websocket-eventmachine-client
48
48
  requirement: !ruby/object:Gem::Requirement
49
49
  none: false
50
50
  requirements:
@@ -107,7 +107,8 @@ dependencies:
107
107
  - - ! '>='
108
108
  - !ruby/object:Gem::Version
109
109
  version: '0'
110
- description: Fluentd websocket output plugin
110
+ description: Fluentd websocket output plugin which can output JSON string or MessagePack
111
+ binary to the clients.
111
112
  email:
112
113
  - tt.izawa@gmail.com
113
114
  executables: []
@@ -117,7 +118,7 @@ files:
117
118
  - .gitignore
118
119
  - Gemfile
119
120
  - LICENSE.txt
120
- - README.md
121
+ - README.rdoc
121
122
  - Rakefile
122
123
  - fluent-plugin-websocket.gemspec
123
124
  - lib/fluent/plugin/out_websocket.rb