This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.
When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
snmptrapalert input plugin for fluentd. This plugin is developed specifically to work on all versions of SNMP traps. Plugin is specifically designed for snmp traps that are generated by devices. With this plugin installed, SNMP traps that are generated by devices can be recieved by fluentd listener. The traps recieved by fluentd are formatted into a json output.
@type ===> type of input plugin (required) ===> 'snmptrapalert' tag ===> tag that needs to be attached in front of each alert recieved ==> default value is "SNMPTrap.Alert" host ===> Host from which traps are recieved ===> default value is "0.0.0.0" (listens on all interfaces) port ===> Port (optional) ===> default set to 162 community ===> Trap Community String which is used by the trap receiver to determine which traps are accepted from a device (Optional), by default all devices has community string set to "public" by default, also useful to avoid unwanted floods of traps from a malicious source ===> default value set is "pubic" trap_format ===> format of the output string
$ docker run -it --rm -v $PWD:/code ubuntu:16.04 bash
$ apt-get update && apt-get install -y --no-install-recommends ruby-dev git gcc make libc6-dev smitools
$ cd code
$ gem install bundler:2.2.10
$ bundle config set --local path 'vendor/bundle'
$ bundle install
$ bundle exec rake test
$ gem install fluent-plugin-snmptrapalert
Add following line to your Gemfile:
gem "fluent-plugin-snmptrapalert"
And then execute:
$ bundle
You can generate configuration template:
$ fluent-plugin-config-format input snmptrapalert
You can copy and paste generated documents here.
- Copyright(c) 2018 - Microsoft Corp
This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.