SNMP 陷阱守护程序。
项目描述
TrapperKeeper
=============
说明
-----------
TrapperKeeper 是一套用于摄取和显示 SNMP
陷阱的工具。这旨在替代 snmptrapd 并补充
现有的状态监控解决方案。通常陷阱本质上是无状态的,这使得使用像 nagios 这样需要轮询源的系统
很难监控。TrapperKeeper 将在过期前将陷阱存储在活动状态一段配置的时间。这使得可以轮询服务以查找活动陷阱并警告这些陷阱。一个例子可能是湿度警报。如果你越过湿气
阈值,它会立即清除您可能不想在
凌晨 3 点被寻呼。但是,如果它在超过该阈值时继续每 5 分钟发送一次陷阱,则只要该陷阱的到期持续时间超过 5 分钟
,(主机、oid、严重性)的组合将保持活动状态。这允许像 nagios 这样的东西在单个陷阱保持活动超过一段时间时发出警报。另一个好处是允许页面聚合。以前,每个陷阱我们只向寻呼机发送一封电子邮件,但现在我们只根据警报间隔进行寻呼,而不管我们收到多少陷阱。这也使我们能够在定期维护期间为设备安排停机时间,以避免陷阱风暴。
要求
------------
Ubuntu
~~~~~~
.. code:: bash
$ sudo apt-get install libmysqlclient-dev libsnmp-dev
安装
----------- -
新版本会定期更新到 PyPI,所以它应该很
简单:
.. code:: bash
$ pip install trapperkeeper
一旦你用你的数据库信息创建了一个配置文件,
你可以运行以下命令来创建数据库模式.
.. code:: bash
$ python -m trapperkeeper.cmds.sync_db -c /path/to/trapperkeeper.yaml
工具
-----
trapperkeeper
~~~~~~~~~~~~~
trapperkeeper命令接收SNMP陷阱和处理电子邮件和
写入数据库。
此处提供了带有文档的示例配置文件。<conf/trapperkeeper.yaml>`__
trapdoor
~~~~~~~~
trapdoor 是一个网络服务器,它提供对现有陷阱的视图
以及用于查看陷阱状态的 API。
此处提供了带有文档的示例配置文件。<conf/trapdoor.yaml>`__
.. 图:: https://raw.githubusercontent.com/dropbox/trapperkeeper/master/images/trapdoor.png
:alt: Screenshot
Screenshot
API
^^^
/api/activetraps
'' ''''''''''''''
**可选参数:** \* 主机 \* oid \* 严重性
**返回:**
.. 代码::
您可以通过运行net-snmp-config --default-mibdirs查看系统的默认路径。您可以使用以下
环境变量通常记录在``snmpcmd`` 手册页
MIBS - 要加载的 MIB 列表。默认为
SNMPv2-TC:SNMPv2-MIB:IF-MIB:IP-MIB:TCP-MIB:UDP-MIB:SNMP-VACM-MIB。
MIBDIRS - 搜索 MIB 的目录列表。默认为
/usr/share/snmp/mibs。
例如,我
在以下环境中运行 ``trapperkeeper`` 和 ``trapdoor`` 命令以将目录添加到路径并加载
所有 mib。
``MIBS=ALL MIBDIRS=+/usr/share/mibs/local/``
TODO
----
- 允许 TrapperKeeper 的自定义电子邮件模板
- 本地 cdnjs 镜像的 cdnjs 前缀
- 用于解析的用户 ACL
- 记录解析用户
已知问题
------------
- 当前不支持 SNMPv3
- 当前不支持通知
- 已知某些设备会发送负 TimeTicks。pyasn1
无法处理此问题。
=============
说明
-----------
TrapperKeeper 是一套用于摄取和显示 SNMP
陷阱的工具。这旨在替代 snmptrapd 并补充
现有的状态监控解决方案。通常陷阱本质上是无状态的,这使得使用像 nagios 这样需要轮询源的系统
很难监控。TrapperKeeper 将在过期前将陷阱存储在活动状态一段配置的时间。这使得可以轮询服务以查找活动陷阱并警告这些陷阱。一个例子可能是湿度警报。如果你越过湿气
阈值,它会立即清除您可能不想在
凌晨 3 点被寻呼。但是,如果它在超过该阈值时继续每 5 分钟发送一次陷阱,则只要该陷阱的到期持续时间超过 5 分钟
,(主机、oid、严重性)的组合将保持活动状态。这允许像 nagios 这样的东西在单个陷阱保持活动超过一段时间时发出警报。另一个好处是允许页面聚合。以前,每个陷阱我们只向寻呼机发送一封电子邮件,但现在我们只根据警报间隔进行寻呼,而不管我们收到多少陷阱。这也使我们能够在定期维护期间为设备安排停机时间,以避免陷阱风暴。
要求
------------
Ubuntu
~~~~~~
.. code:: bash
$ sudo apt-get install libmysqlclient-dev libsnmp-dev
安装
----------- -
新版本会定期更新到 PyPI,所以它应该很
简单:
.. code:: bash
$ pip install trapperkeeper
一旦你用你的数据库信息创建了一个配置文件,
你可以运行以下命令来创建数据库模式.
.. code:: bash
$ python -m trapperkeeper.cmds.sync_db -c /path/to/trapperkeeper.yaml
工具
-----
trapperkeeper
~~~~~~~~~~~~~
trapperkeeper命令接收SNMP陷阱和处理电子邮件和
写入数据库。
此处提供了带有文档的示例配置文件。<conf/trapperkeeper.yaml>`__
trapdoor
~~~~~~~~
trapdoor 是一个网络服务器,它提供对现有陷阱的视图
以及用于查看陷阱状态的 API。
此处提供了带有文档的示例配置文件。<conf/trapdoor.yaml>`__
.. 图:: https://raw.githubusercontent.com/dropbox/trapperkeeper/master/images/trapdoor.png
:alt: Screenshot
Screenshot
API
^^^
/api/activetraps
'' ''''''''''''''
**可选参数:** \* 主机 \* oid \* 严重性
**返回:**
.. 代码::
您可以通过运行net-snmp-config --default-mibdirs查看系统的默认路径。您可以使用以下
环境变量通常记录在``snmpcmd`` 手册页
MIBS - 要加载的 MIB 列表。默认为
SNMPv2-TC:SNMPv2-MIB:IF-MIB:IP-MIB:TCP-MIB:UDP-MIB:SNMP-VACM-MIB。
MIBDIRS - 搜索 MIB 的目录列表。默认为
/usr/share/snmp/mibs。
例如,我
在以下环境中运行 ``trapperkeeper`` 和 ``trapdoor`` 命令以将目录添加到路径并加载
所有 mib。
``MIBS=ALL MIBDIRS=+/usr/share/mibs/local/``
TODO
----
- 允许 TrapperKeeper 的自定义电子邮件模板
- 本地 cdnjs 镜像的 cdnjs 前缀
- 用于解析的用户 ACL
- 记录解析用户
已知问题
------------
- 当前不支持 SNMPv3
- 当前不支持通知
- 已知某些设备会发送负 TimeTicks。pyasn1
无法处理此问题。
项目详情
关
trapperkeeper -0.6.1.tar.gz 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 2103c80e1c943b632d1925cbc4df1cf623c1d6d37bf088aac58ead6b03202d37 |
|
MD5 | afbe96f912c9a6126d82fadba86641a6 |
|
布莱克2-256 | d6559e0a1ba4a79487937c74d55f5e3897353ffd72ecd327eecbcde037104ba0 |