NAME

monm_snmp - SNMP checker for App::MonM

VERSION

Version 1.01

SYNOPSIS

    monm_snmp [-ST] [-v VERSION-SNMP] [ --mibs=ALL ] [-t MICROSECS]
              [-s HOST] [-c COMMUNITY] OBJECT

    monm_snmp -s 192.168.1.1 -c test .1.3.6.1.2.1.1.1

    monm_snmp -s 192.168.1.1 -c test -S .1.3.6.1.2.1.1.1.0

    monm_snmp -s 192.168.1.1 -c test -M IF-MIB -T ifTable

    monm_snmp -s 192.168.1.1 -c test -T IF-MIB::ifTable

OPTIONS

-c COMMUNITY, --community=COMMUNITY

Community name

Default: public

-h, --help

Show short help information and quit

-H, --longhelp

Show long help information and quit

-M MIBS, --mibs=MIBS

Set MIBS value

-s HOST, --host=HOST

Host of SNMP

Default: localhost

-S, --strict

Enable strict mode. All OIDs must be only as is long-format strings

    monm_snmp -S .1.3.6.1.2.1.1.1.0

-t MICROSECS, --timeout=MICROSECS

Timeout of SNMP requests in microseconds

Default: 1000000

-T, --table

Enable table mode

    monm_snmp -T ifTable
    monm_snmp -T IF-MIB::ifTable

-v VERSION-SNMP, --version=VERSION-SNMP

Version of SNMP (default = 2c)

DESCRIPTION

SNMP checker for App::MonM

STANDARD COUNTERS

UCD-SNMP-MIB::memTotalReal.0

Returns memory size

UCD-SNMP-MIB::memAvailReal.0

Returns memory free

UCD-SNMP-MIB::memTotalSwap.0

Returns swap size

UCD-SNMP-MIB::memAvailSwap.0

Returns swap free

UCD-SNMP-MIB::ssCpuUser.0

Returns cpu user usage

UCD-SNMP-MIB::ssCpuSystem.0

Returns cpu system usage

STANDARD TABLES

IF-MIB::ifTable

    {
      '1' => {
        'ifAdminStatus' => 'up',
        'ifDescr' => 'lo',
        'ifInDiscards' => '0',
        'ifInErrors' => '0',
        'ifInNUcastPkts' => '0',
        'ifInOctets' => '131152886',
        'ifInUcastPkts' => '9442417',
        'ifInUnknownProtos' => '0',
        'ifIndex' => '1',
        'ifLastChange' => '0:0:00:00.00',
        'ifMtu' => '65536',
        'ifOperStatus' => 'up',
        'ifOutDiscards' => '0',
        'ifOutErrors' => '0',
        'ifOutNUcastPkts' => '0',
        'ifOutOctets' => '131152886',
        'ifOutQLen' => '0',
        'ifOutUcastPkts' => '9442417',
        'ifPhysAddress' => '',
        'ifSpecific' => '.0.0',
        'ifSpeed' => '10000000',
        'ifType' => 'softwareLoopback'
      },
    }

Returns interface list

HOST-RESOURCES-MIB::hrStorageTable

    {
      '1' => {
        'hrStorageAllocationUnits' => '1024 Bytes',
        'hrStorageDescr' => 'Physical memory',
        'hrStorageIndex' => '1',
        'hrStorageSize' => '1015016',
        'hrStorageType' => '.1.3.6.1.2.1.25.2.1.2',
        'hrStorageUsed' => '618296'
      },
    }

Returns storage table

DEPENDENCES

SNMP as Net-SNMP (see down)

REQUIREMENTS

Net-SNMP

To use this module, you must have Net-SNMP installed on your system. More specifically you need the Perl modules that come with it.

DO NOT INSTALL SNMP or Net::SNMP from CPAN!

The SNMP module is matched to an install of net-snmp, and must be installed from the net-snmp source tree.

The Perl module SNMP is found inside the net-snmp distribution. Go to the perl/ directory of the distribution to install it, or run ./configure --with-perl-modules from the top directory of the net-snmp distribution.

Net-SNMP can be found at http://net-snmp.sourceforge.net

Version 5.3.2 or greater is recommended.

Redhat Users: Some versions that come with certain versions of Redhat/Fedora don't have the Perl library installed. Uninstall the RPM and install by hand.

Ubuntu Users: sudo apt-get install snmp snmp-mibs-downloader libsnmp-perl

AUTHOR

Serż Minus (Sergey Lepenkov) https://www.serzik.com <abalama@cpan.org>

COPYRIGHT

Copyright (C) 1998-2022 D&D Corporation. All Rights Reserved

LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See https://dev.perl.org/licenses/