logstash-output-snmptrap-v2 0.9.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8f5c8c3efac1f786b630caca249fcee08595409a5b25ed1f44865eabc4081094
+  data.tar.gz: f2a554fa7c56fbad6017ab5896e66ac45b7ecd944519a6022c91861e60415707
+SHA512:
+  metadata.gz: f9c594258869f90e87afb7934a9f033d832e13adb818f486ee0c22911ad1013906c7c763c4b175571c4bf33c8f8a90558f54e4d80ee66631a0244fc39a804b3e
+  data.tar.gz: 27a8e6bc9af655033a01583bd6d19fdf01e8e5d5731d6c5dc144054d11499edb4bd90677727ded50f2f14b871f1fb242eaf4632fd1682c843d61bd372f026cb8

data/CONTRIBUTORS

@@ -0,0 +1,6 @@
+Contributors:
+Ryan O'Keeffe (DanielRedOak)
+Elmar Vonlanthen (Elmux)
+chrisbentz
+Pieter Baele (Fiddich)
+Marcel Vingerling

data/DEVELOPER.md

@@ -0,0 +1,2 @@
+# logstash-output-snmp
+SNMP output plugin.

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/LICENSE

@@ -0,0 +1,13 @@
+Copyright (c) 2012–2015 Elasticsearch <http://www.elastic.co>
+
+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.

data/README.md

@@ -0,0 +1,94 @@
+# Logstash Plugin
+
+This is a plugin for [Logstash](https://github.com/elasticsearch/logstash).
+
+It is fully free and fully open source. The license is Apache 2.0, meaning you are pretty much free to use it however you want in whatever way.
+
+# Documentation #
+## logstash-output-snmptrap ##
+
+SNMP Trap v2c Output for Logstash
+
+#Synopsis
+```
+output {
+  snmptrap {
+    codec => ... # codec (optional), default: "line"
+    host => ... # string (optional), default: "0.0.0.0"
+    port => ... # number (optional), default: "162"
+    community => ... # string (optional), default: "public"
+    oid => ... # string (required)
+    yamlmibdir => ... # string (optional)
+  }
+}
+```
+
+## Developing
+
+### 1. Plugin Developement and Testing
+
+#### Code
+- To get started, you'll need JRuby with the Bundler gem installed.
+
+- Create a new plugin or clone and existing from the GitHub [logstash-plugins](https://github.com/logstash-plugins) organization. We also provide [example plugins](https://github.com/logstash-plugins?query=example).
+
+- Install dependencies
+```sh
+bundle install
+```
+
+#### Test
+
+- Update your dependencies
+
+```sh
+bundle install
+```
+
+- Run tests
+
+```sh
+bundle exec rspec
+```
+
+### 2. Running your unpublished Plugin in Logstash
+
+#### 2.1 Run in a local Logstash clone
+
+- Edit Logstash `Gemfile` and add the local plugin path, for example:
+```ruby
+gem "logstash-filter-awesome", :path => "/your/local/logstash-filter-awesome"
+```
+- Install plugin
+```sh
+bin/plugin install --no-verify
+```
+- Run Logstash with your plugin
+```sh
+bin/logstash -e 'filter {awesome {}}'
+```
+At this point any modifications to the plugin code will be applied to this local Logstash setup. After modifying the plugin, simply rerun Logstash.
+
+#### 2.2 Run in an installed Logstash
+
+You can use the same **2.1** method to run your plugin in an installed Logstash by editing its `Gemfile` and pointing the `:path` to your local plugin development directory or you can build the gem and install it using:
+
+- Build your plugin gem
+```sh
+gem build logstash-filter-awesome.gemspec
+```
+- Install the plugin from the Logstash home
+```sh
+bin/plugin install /your/local/plugin/logstash-filter-awesome.gem
+```
+- Start Logstash and proceed to test the plugin
+
+## Contributing
+
+All contributions are welcome: ideas, patches, documentation, bug reports, complaints, and even something you drew up on a napkin.
+
+Programming is not a required skill. Whatever you've seen about open source and maintainers or community members  saying "send patches or die" - you will not see that here.
+
+It is more important to the community that you are able to contribute.
+
+For more information about contributing, see the [CONTRIBUTING](https://github.com/elasticsearch/logstash/blob/master/CONTRIBUTING.md) file.

data/lib/logstash/outputs/snmptrap.rb

@@ -0,0 +1,74 @@
+# encoding: utf-8
+require "logstash/outputs/base"
+require "logstash/namespace"
+
+# An example output that does nothing.
+class LogStash::Outputs::Snmptrap < LogStash::Outputs::Base
+  config_name "snmptrap"
+
+  default :codec, "line"
+
+  #address of the host to send the trap/notification to
+  config :host, :validate => :string, :default => "127.0.0.1"
+
+  #the port to send the trap on
+  config :port, :validate => :number, :default => 162
+
+  #the community string to include
+  config :community, :validate => :string, :default => "public"
+
+  #the OID that specifies the event generating the trap message
+  config :oid, :validate => :string, :required => true
+
+  # varbind configuration
+  config :varbinds, :default => {"@oid" => "!event.to_s"}
+
+  def initialize(*args)
+    super(*args)
+  end
+
+  public
+  def register
+    require "snmp"
+
+    @codec.on_event do |event|
+
+      #set some variables for the trap sender
+      trapsender_opts = {:trap_port => @port, :host => @host, :community => @community }
+
+      #prep and do the full send
+      SNMP::Manager.open(trapsender_opts) do |snmp|
+        #set it up and send the whole event using the user specified codec
+        varbinds = []
+        @varbinds.each do |key, value|
+          if value.start_with?("!") 
+            value.delete_prefix!("!")
+            value = eval(value)
+          elsif value.start_with?("@") 
+            value.delete_prefix!("@")
+            value = event.get(value)
+          end
+          if value.is_a? String
+            varbinds << SNMP::VarBind.new(key, SNMP::OctetString.new(value.force_encoding('ASCII-8BIT')))
+          elsif value.is_a? Integer
+            varbinds << SNMP::VarBind.new(key, SNMP::Integer.new(value))
+          end
+        end
+
+        #we dont actually care about the sys_up_time...do we.
+        snmp.trap_v2(0, @oid, varbinds)
+        end
+    end
+  end
+
+  public
+  def receive(event)
+    return unless output?(event)
+    if event == LogStash::SHUTDOWN
+      finished
+      return
+    end
+    @oid = event.sprintf(@oid)
+    @codec.encode(event)
+  end
+end

data/logstash-output-snmptrap.gemspec

@@ -0,0 +1,24 @@
+Gem::Specification.new do |s|
+  s.name          = 'logstash-output-snmptrap-v2'
+  s.version       = '0.9.3'
+  s.licenses      = ['Apache-2.0']
+  s.summary       = 'SNMP Output for Logstash'
+  s.description   = 'This gem is a logstash plugin required to be installed on top of the Logstash core pipeline using $LS_HOME/bin/plugin install gemname. This gem is not a stand-alone program'
+  s.homepage      = 'https://github.com/sjaek/logstash-output-snmptrap'
+  s.authors       = ['Marcel Vingerling']
+  s.email         = 'marcel.vingerling@gmail.com'
+  s.require_paths = ['lib']
+
+  # Files
+  s.files = Dir['lib/**/*','spec/**/*','vendor/**/*','*.gemspec','*.md','CONTRIBUTORS','Gemfile','LICENSE','NOTICE.TXT']
+   # Tests
+  s.test_files = s.files.grep(%r{^(test|spec|features)/})
+
+  # Special flag to let us know this is actually a logstash plugin
+  s.metadata = { "logstash_plugin" => "true", "logstash_group" => "output" }
+
+  # Gem dependencies
+  s.add_runtime_dependency "logstash-core-plugin-api", "~> 2.0"
+  s.add_runtime_dependency "logstash-codec-plain"
+  s.add_development_dependency "logstash-devutils"
+end

data/spec/outputs/snmptrap_spec.rb

@@ -0,0 +1,21 @@
+require "logstash/devutils/rspec/spec_helper"
+require "logstash/outputs/example"
+require "logstash/codecs/plain"
+require "logstash/event"
+
+describe LogStash::Outputs::Example do
+  let(:sample_event) { LogStash::Event.new }
+  let(:output) { LogStash::Outputs::Example.new }
+
+  before do
+    output.register
+  end
+
+  describe "receive message" do
+    subject { output.receive(sample_event) }
+
+    it "returns a string" do
+      expect(subject).to eq("Event received")
+    end
+  end
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification
+name: logstash-output-snmptrap-v2
+version: !ruby/object:Gem::Version
+  version: 0.9.3
+platform: ruby
+authors:
+- Marcel Vingerling
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-08-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: logstash-core-plugin-api
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: logstash-codec-plain
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: logstash-devutils
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: This gem is a logstash plugin required to be installed on top of the
+  Logstash core pipeline using $LS_HOME/bin/plugin install gemname. This gem is not
+  a stand-alone program
+email: marcel.vingerling@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CONTRIBUTORS
+- DEVELOPER.md
+- Gemfile
+- LICENSE
+- README.md
+- lib/logstash/outputs/snmptrap.rb
+- logstash-output-snmptrap.gemspec
+- spec/outputs/snmptrap_spec.rb
+homepage: https://github.com/sjaek/logstash-output-snmptrap
+licenses:
+- Apache-2.0
+metadata:
+  logstash_plugin: 'true'
+  logstash_group: output
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.6
+signing_key: 
+specification_version: 4
+summary: SNMP Output for Logstash
+test_files:
+- spec/outputs/snmptrap_spec.rb