{
    "info": {
        "author": "Chet Luther",
        "author_email": "chet.luther@gmail.com",
        "bugtrack_url": null,
        "classifiers": [
            "Development Status :: 3 - Alpha",
            "Environment :: Other Environment",
            "Intended Audience :: System Administrators",
            "License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)",
            "Natural Language :: English",
            "Operating System :: POSIX :: Linux",
            "Programming Language :: Python :: 2",
            "Topic :: System :: Monitoring"
        ],
        "description": "zenoss-snmp-module\n==================\n\nThis project provides a Net-SNMP pass_persist script for monitoring Zenoss. If\nyou aren't familiar with Net-SNMP's pass_persist option, it allows an external\nscript to provide responses for all GET and GETNEXT requires under a configured\nbase OID.\n\nCurrently zenoss-snmp-module provides support for the provided ZENOSS-PROCESS-\nMIB. See the following snmptranslate command for what the MIB provides::\n\n    $ snmptranslate -Tp ZENOSS-PROCESS-MIB::zenossProcessMIB\n    +--zenossProcessMIB(3)\n       |\n       +--zenSystemTable(1)\n       |  |\n       |  +--zenSystemEntry(1)\n       |     |  Index: zenSystemName\n       |     |\n       |     +-- -R-- String    zenSystemName(1)\n       |              Textual Convention: DisplayString\n       |              Size: 0..255\n       |\n       +--zenProcessTable(2)\n       |  |\n       |  +--zenProcessEntry(1)\n       |     |  Index: zenSystemName, zenProcessName\n       |     |\n       |     +-- -R-- String    zenProcessName(1)\n       |              Textual Convention: DisplayString\n       |              Size: 0..255\n       |\n       +--zenProcessMetricTable(3)\n          |\n          +--zenProcessMetricEntry(1)\n             |  Index: zenSystemName, zenProcessName, zenProcessMetricName\n             |\n             +-- -R-- String    zenProcessMetricName(1)\n             |        Textual Convention: DisplayString\n             |        Size: 0..255\n             +-- -R-- String    zenProcessMetricValue(2)\n             |        Textual Convention: DisplayString\n             |        Size: 0..255\n             +-- -R-- String    zenProcessMetricCyclesSinceUpdate(3)\n                      Textual Convention: DisplayString\n                      Size: 0..255\n\n    $ snmpwalk -v2c -c public localhost ZENOSS-PROCESS-MIB::zenossProcessMIB\n    ZENOSS-PROCESS-MIB::zenSystemName.\"localhost\" = STRING: localhost\n    ZENOSS-PROCESS-MIB::zenProcessName.\"localhost\".\"zenhub\" = STRING: zenhub\n    ZENOSS-PROCESS-MIB::zenProcessName.\"localhost\".\"zenwebtx\" = STRING: zenwebtx\n    ZENOSS-PROCESS-MIB::zenProcessName.\"localhost\".\"zencommand\" = STRING: zencommand\n    ZENOSS-PROCESS-MIB::zenProcessMetricName.\"localhost\".\"zenhub\".\"services\" = STRING: services\n    ZENOSS-PROCESS-MIB::zenProcessMetricName.\"localhost\".\"zenhub\".\"totalTime\" = STRING: totalTime\n    ZENOSS-PROCESS-MIB::zenProcessMetricName.\"localhost\".\"zenhub\".\"totalEvents\" = STRING: totalEvents\n    ZENOSS-PROCESS-MIB::zenProcessMetricName.\"localhost\".\"zenhub\".\"invalidations\" = STRING: invalidations\n    ZENOSS-PROCESS-MIB::zenProcessMetricName.\"localhost\".\"zenhub\".\"totalCallTime\" = STRING: totalCallTime\n    ZENOSS-PROCESS-MIB::zenProcessMetricName.\"localhost\".\"zenhub\".\"workListLength\" = STRING: workListLength\n    ZENOSS-PROCESS-MIB::zenProcessMetricName.\"localhost\".\"zenwebtx\".\"devices\" = STRING: devices\n    ZENOSS-PROCESS-MIB::zenProcessMetricName.\"localhost\".\"zenwebtx\".\"dataPoints\" = STRING: dataPoints\n    ZENOSS-PROCESS-MIB::zenProcessMetricName.\"localhost\".\"zenwebtx\".\"eventCount\" = STRING: eventCount\n    ZENOSS-PROCESS-MIB::zenProcessMetricName.\"localhost\".\"zenwebtx\".\"cyclePoints\" = STRING: cyclePoints\n    ZENOSS-PROCESS-MIB::zenProcessMetricName.\"localhost\".\"zenwebtx\".\"queuedTasks\" = STRING: queuedTasks\n    ZENOSS-PROCESS-MIB::zenProcessMetricName.\"localhost\".\"zenwebtx\".\"runningTasks\" = STRING: runningTasks\n    ZENOSS-PROCESS-MIB::zenProcessMetricName.\"localhost\".\"zenwebtx\".\"eventQueueLength\" = STRING: eventQueueLength\n    ZENOSS-PROCESS-MIB::zenProcessMetricName.\"localhost\".\"zencommand\".\"eventQueueLength\" = STRING: eventQueueLength\n    ZENOSS-PROCESS-MIB::zenProcessMetricValue.\"localhost\".\"zenwebtx\".\"devices\" = STRING: 0.0\n    ZENOSS-PROCESS-MIB::zenProcessMetricValue.\"localhost\".\"zenwebtx\".\"dataPoints\" = STRING: 0.0\n    ZENOSS-PROCESS-MIB::zenProcessMetricValue.\"localhost\".\"zenwebtx\".\"eventCount\" = STRING: 0.0\n    ZENOSS-PROCESS-MIB::zenProcessMetricValue.\"localhost\".\"zenwebtx\".\"cyclePoints\" = STRING: 0.0\n    ZENOSS-PROCESS-MIB::zenProcessMetricValue.\"localhost\".\"zenwebtx\".\"queuedTasks\" = STRING: 0.0\n    ZENOSS-PROCESS-MIB::zenProcessMetricValue.\"localhost\".\"zenwebtx\".\"runningTasks\" = STRING: 0.0\n    ZENOSS-PROCESS-MIB::zenProcessMetricValue.\"localhost\".\"zenwebtx\".\"eventQueueLength\" = STRING: 0.0\n    ZENOSS-PROCESS-MIB::zenProcessMetricCyclesSinceUpdate.\"localhost\".\"zenhub\".\"services\" = STRING: 2.35\n    ZENOSS-PROCESS-MIB::zenProcessMetricCyclesSinceUpdate.\"localhost\".\"zenhub\".\"totalTime\" = STRING: 2.35\n    ZENOSS-PROCESS-MIB::zenProcessMetricCyclesSinceUpdate.\"localhost\".\"zenhub\".\"totalEvents\" = STRING: 2.35\n    ZENOSS-PROCESS-MIB::zenProcessMetricCyclesSinceUpdate.\"localhost\".\"zenhub\".\"invalidations\" = STRING: 2.35\n    ZENOSS-PROCESS-MIB::zenProcessMetricCyclesSinceUpdate.\"localhost\".\"zenhub\".\"totalCallTime\" = STRING: 2.35\n    ZENOSS-PROCESS-MIB::zenProcessMetricCyclesSinceUpdate.\"localhost\".\"zenhub\".\"workListLength\" = STRING: 2.35\n    ZENOSS-PROCESS-MIB::zenProcessMetricCyclesSinceUpdate.\"localhost\".\"zenwebtx\".\"devices\" = STRING: 0.48\n    ZENOSS-PROCESS-MIB::zenProcessMetricCyclesSinceUpdate.\"localhost\".\"zenwebtx\".\"dataPoints\" = STRING: 0.48\n    ZENOSS-PROCESS-MIB::zenProcessMetricCyclesSinceUpdate.\"localhost\".\"zenwebtx\".\"eventCount\" = STRING: 0.48\n    ZENOSS-PROCESS-MIB::zenProcessMetricCyclesSinceUpdate.\"localhost\".\"zenwebtx\".\"cyclePoints\" = STRING: 0.48\n    ZENOSS-PROCESS-MIB::zenProcessMetricCyclesSinceUpdate.\"localhost\".\"zenwebtx\".\"queuedTasks\" = STRING: 0.48\n    ZENOSS-PROCESS-MIB::zenProcessMetricCyclesSinceUpdate.\"localhost\".\"zenwebtx\".\"runningTasks\" = STRING: 0.48\n    ZENOSS-PROCESS-MIB::zenProcessMetricCyclesSinceUpdate.\"localhost\".\"zenwebtx\".\"eventQueueLength\" = STRING: 0.45\n    ZENOSS-PROCESS-MIB::zenProcessMetricCyclesSinceUpdate.\"localhost\".\"zencommand\".\"eventQueueLength\" = STRING: 0.12\n\n\nUsage\n-----\n\nTo install zenoss-snmp-module you must run the following command::\n\n    sudo easy_install -U zenoss-snmp-module\n\nOnce installed, the ``zenoss-snmp-module`` script provides built-in support for\nhelping you configure it. See the following command examples for installing the\nassociated MIB and configuring snmpd::\n\n    # Install ZENOSS-PROCESS-MIB.\n    zenoss-snmp-module --mib | sudo tee /usr/share/snmp/mibs/ZENOSS-PROCESS-MIB.txt\n\n    # Add pass_persist line to snmpd.conf.\n    zenoss-snmp-module --snmpd | sudo tee -a /etc/snmp/snmpd.conf\n\n    # Restart snmpd service.\n    sudo service snmpd restart\n\nAfter changing snmpd.conf you must restart the snmpd service. Then you should\nbe able to test with the following command::\n\n    # Walk the entire zenossProcessMIB.\n    snmpwalk -mALL -v2c -c public localhost zenossProcessMIB\n\nTry snmpwalk commands like the following to get more specific results::\n\n    # Only show metric values for the zenwebtx proces on the localhost collector.\n    snmpwalk -mALL -v2c -c public localhost 'zenProcessMetricValue.\"localhost\".\"zenwebtx\"'\n\n    # Show how many cycles it's been since each metric was updated.\n    snmpwalk -mALL -v2c -c public localhost 'zenProcessMetricCyclesSinceUpdate.\"localhost\"'\n\nYou will need to know the OIDs for these values to poll them with Zenoss. Use a\ncommand like the following to discover the OID for a given value. Note that\nbecause these OIDs are just encoded system, process and metric names, they will\nreturn the expected data from any system and can be considered permanent::\n\n    # Translate from name to OID.\n    snmptranslate -On 'ZENOSS-PROCESS-MIB::zenProcessMetricValue.\"localhost\".\"zenwebtx\".\"queuedTasks\"'\n\n\nTroubleshooting\n---------------\n\nNormally zenoss-snmp-module is run from within snmpd. This makes it difficult\nto troubleshoot problems. To test the script outside of snmpd, you can run\n``zenoss-snmp-module`` as root. If things are working properly, this will\nappear to do nothing.\n\nSee the following session as an example::\n\n    # zenoss-snmp-module\n    PING\n    PONG\n    DUMP\n    {'1.1.1.9.108.111.99.97.108.104.111.115.116': {'type': 'STRING',\n                                                   'value': 'localhost'},\n    ... snipped ...\n\nIt can also be useful to stop the snmpd service and run it in the foreground\nwith just the useful debugging enabled::\n\n    sudo service snmpd stop\n    sudo snmpd -fV -Lo -Ducd-snmp/pass_persist -Doutput\n\nBe sure to start the snmpd service once you're done testing.",
        "description_content_type": null,
        "docs_url": null,
        "download_url": "UNKNOWN",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "http://github.com/cluther/zenoss-snmp-module",
        "keywords": "zenoss snmp net-snmp",
        "license": "GPLv2",
        "maintainer": null,
        "maintainer_email": null,
        "name": "zenoss-snmp-module",
        "package_url": "https://pypi.org/project/zenoss-snmp-module/",
        "platform": "UNKNOWN",
        "project_url": "https://pypi.org/project/zenoss-snmp-module/",
        "project_urls": {
            "Download": "UNKNOWN",
            "Homepage": "http://github.com/cluther/zenoss-snmp-module"
        },
        "release_url": "https://pypi.org/project/zenoss-snmp-module/1.0.0rc4/",
        "requires_dist": null,
        "requires_python": null,
        "summary": "Net-SNMP pass_persist script for monitoring Zenoss.",
        "version": "1.0.0rc4"
    },
    "last_serial": 743657,
    "releases": {
        "1.0.0rc3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "c79c3868d275999b76326a287604be05",
                    "sha256": "93bc71877d2ea60d025cdcdfc53f97e26d299f8a079f37737d8bda0f9d527a22"
                },
                "downloads": -1,
                "filename": "zenoss-snmp-module-1.0.0rc3.tar.gz",
                "has_sig": false,
                "md5_digest": "c79c3868d275999b76326a287604be05",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 13238,
                "upload_time": "2013-03-05T05:53:01",
                "url": "https://files.pythonhosted.org/packages/ad/47/a06871113b8d93557e2b1a7e14eaf92406bbc3639e54e02ffe40a43b7b5d/zenoss-snmp-module-1.0.0rc3.tar.gz"
            }
        ],
        "1.0.0rc4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "5b720667d7d0e0c601682390aa5eb22a",
                    "sha256": "28fa50c50b620cc72fc1267b97d5dc375c43a378e1b11ca7b4a7d98bbddbe680"
                },
                "downloads": -1,
                "filename": "zenoss-snmp-module-1.0.0rc4.tar.gz",
                "has_sig": false,
                "md5_digest": "5b720667d7d0e0c601682390aa5eb22a",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 13336,
                "upload_time": "2013-05-09T16:11:15",
                "url": "https://files.pythonhosted.org/packages/18/3c/6d9c4ee3899a40bdf8c8a56f3ac6ec7a2053e3c5dce00328e46c7a1b6fdb/zenoss-snmp-module-1.0.0rc4.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "5b720667d7d0e0c601682390aa5eb22a",
                "sha256": "28fa50c50b620cc72fc1267b97d5dc375c43a378e1b11ca7b4a7d98bbddbe680"
            },
            "downloads": -1,
            "filename": "zenoss-snmp-module-1.0.0rc4.tar.gz",
            "has_sig": false,
            "md5_digest": "5b720667d7d0e0c601682390aa5eb22a",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 13336,
            "upload_time": "2013-05-09T16:11:15",
            "url": "https://files.pythonhosted.org/packages/18/3c/6d9c4ee3899a40bdf8c8a56f3ac6ec7a2053e3c5dce00328e46c7a1b6fdb/zenoss-snmp-module-1.0.0rc4.tar.gz"
        }
    ]
}