{ "content": [ { "type": "text", "text": "# SNMPDELTA (man)\n\n## NAME\n\nsnmpdelta - Monitor delta differences in SNMP Counter values\n\n## SYNOPSIS\n\nsnmpdelta [ COMMON OPTIONS ] [-Cf] [ -Ct ] [ -Cs ] [ -CS ] [ -Cm ] [ -CF configfile ] [ -Cl ]\n[ -Cp period ] [ -CP Peaks ] [ -Ck ] [ -CT ] AGENT OID [ OID ... ]\n\n## DESCRIPTION\n\nsnmpdelta will monitor the specified integer valued OIDs, and report changes over time.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **OPTIONS** (12 subsections)\n- **EXAMPLES**\n- **SEE ALSO**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "SNMPDELTA", "section": "", "mode": "man", "summary": "snmpdelta - Monitor delta differences in SNMP Counter values", "synopsis": "snmpdelta [ COMMON OPTIONS ] [-Cf] [ -Ct ] [ -Cs ] [ -CS ] [ -Cm ] [ -CF configfile ] [ -Cl ]\n[ -Cp period ] [ -CP Peaks ] [ -Ck ] [ -CT ] AGENT OID [ OID ... ]", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [ { "flag": "", "long": null, "arg": null, "description": "been specified for a single request and if the request for one or more of the oids fails, snmpdelta will retry the request so that data for oids apart from the ones that failed will still be returned. Specifying -Cf tells snmpdelta not to retry a request, even if there are multiple oids specified." }, { "flag": "", "long": null, "arg": null, "description": "" }, { "flag": "", "long": null, "arg": null, "description": "" }, { "flag": "", "long": null, "arg": null, "description": "count\" is the total of all the individual deltas for each time period." }, { "flag": "", "long": null, "arg": null, "description": "" }, { "flag": "", "long": null, "arg": null, "description": "Tells snmpdelta to read it's configuration from the specified file. This options al‐ lows the input to be set up in advance rather than having to be specified on the com‐ mand line." }, { "flag": "", "long": null, "arg": null, "description": "MIB instances monitored. For example, snmpdelta -Cl localhost ifInOctets.1 will cre‐ ate a file \"localhost-ifInOctets.1\"." }, { "flag": "", "long": null, "arg": null, "description": "a request to the agent. The default polling period is one second." }, { "flag": "", "long": null, "arg": null, "description": "Specifies the reporting period in number of polling periods. If this option is spec‐ ified, snmpdelta polls the agent peaks number of times before reporting the results. The result reported includes the average value over the reporting period. In addi‐ tion, the highest polled value within the reporting period is shown." }, { "flag": "", "long": null, "arg": null, "description": "played in the output (-Cs), then the default display shows the timestamp in the for‐ mat hh:mm mm/dd. This option causes the timestamp format to be hh:mm:ss mm/dd." }, { "flag": "", "long": null, "arg": null, "description": "" }, { "flag": "", "long": null, "arg": null, "description": "Specifies the maximum number of oids allowed to be packaged in a single PDU. Multiple PDUs can be created in a single request. The default value of variables per packet is 60. This option is useful if a request response results in an error because the packet is too big. Note that snmpdelta REQUIRES an argument specifying the agent to query and at least one OID argument, as described in the snmpcmd(1) manual page." } ], "examples": [ "$ snmpdelta -c public -v 1 -Cs localhost IF-MIB::ifInUcastPkts.3 IF-MIB::ifOutUcastPkts.3", "[20:15:43 6/14] ifInUcastPkts.3 /1 sec: 158", "[20:15:43 6/14] ifOutUcastPkts.3 /1 sec: 158", "[20:15:44 6/14] ifInUcastPkts.3 /1 sec: 184", "[20:15:44 6/14] ifOutUcastPkts.3 /1 sec: 184", "[20:15:45 6/14] ifInUcastPkts.3 /1 sec: 184", "[20:15:45 6/14] ifOutUcastPkts.3 /1 sec: 184", "[20:15:46 6/14] ifInUcastPkts.3 /1 sec: 158", "[20:15:46 6/14] ifOutUcastPkts.3 /1 sec: 158", "[20:15:47 6/14] ifInUcastPkts.3 /1 sec: 184", "[20:15:47 6/14] ifOutUcastPkts.3 /1 sec: 184", "[20:15:48 6/14] ifInUcastPkts.3 /1 sec: 184", "[20:15:48 6/14] ifOutUcastPkts.3 /1 sec: 184", "[20:15:49 6/14] ifInUcastPkts.3 /1 sec: 158", "[20:15:49 6/14] ifOutUcastPkts.3 /1 sec: 158", "^C", "$ snmpdelta -c public -v 1 -Cs -CT localhost IF-MIB:ifInUcastPkts.3 IF-MIB:ifOutcastPkts.3", "localhost ifInUcastPkts.3 ifOutUcastPkts.3", "[20:15:59 6/14] 184.00 184.00", "[20:16:00 6/14] 158.00 158.00", "[20:16:01 6/14] 184.00 184.00", "[20:16:02 6/14] 184.00 184.00", "[20:16:03 6/14] 158.00 158.00", "[20:16:04 6/14] 184.00 184.00", "[20:16:05 6/14] 184.00 184.00", "[20:16:06 6/14] 158.00 158.00", "^C", "The following example uses a number of options. Since the Cl option is specified, the output", "is sent to a file and not to the screen.", "$ snmpdelta -c public -v 1 -Ct -Cs -CS -Cm -Cl -Cp 60 -CP 60", "interlink.sw.net.cmu.edu .1.3.6.1.2.1.2.2.1.16.3 .1.3.6.1.2.1.2.2.1.16.4" ], "see_also": [ { "name": "snmpcmd", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/snmpcmd/1/json" }, { "name": "variables", "section": "5", "url": "https://www.chedong.com/phpMan.php/man/variables/5/json" } ], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 3, "subsections": [] }, { "name": "DESCRIPTION", "lines": 10, "subsections": [] }, { "name": "OPTIONS", "lines": 4, "subsections": [ { "name": "-Cf", "lines": 5 }, { "name": "-Ct", "lines": 1 }, { "name": "-Cs", "lines": 1 }, { "name": "-CS", "lines": 2 }, { "name": "-Cm", "lines": 1 }, { "name": "-CF configfile", "lines": 4 }, { "name": "-Cl", "lines": 3 }, { "name": "-Cp", "lines": 2 }, { "name": "-CP peaks", "lines": 5 }, { "name": "-Ck", "lines": 3 }, { "name": "-CT", "lines": 1 }, { "name": "-Cv vars/pkt", "lines": 8 } ] }, { "name": "EXAMPLES", "lines": 34, "subsections": [] }, { "name": "SEE ALSO", "lines": 5, "subsections": [] } ], "sections": { "NAME": { "content": "snmpdelta - Monitor delta differences in SNMP Counter values\n", "subsections": [] }, "SYNOPSIS": { "content": "snmpdelta [ COMMON OPTIONS ] [-Cf] [ -Ct ] [ -Cs ] [ -CS ] [ -Cm ] [ -CF configfile ] [ -Cl ]\n[ -Cp period ] [ -CP Peaks ] [ -Ck ] [ -CT ] AGENT OID [ OID ... ]\n", "subsections": [] }, "DESCRIPTION": { "content": "snmpdelta will monitor the specified integer valued OIDs, and report changes over time.\n\nAGENT identifies a target SNMP agent, which is instrumented to monitor the given objects. At\nits simplest, the AGENT specification will consist of a hostname or an IPv4 address. In this\nsituation, the command will attempt communication with the agent, using UDP/IPv4 to port 161\nof the given target host. See snmpcmd(1) for a full list of the possible formats for AGENT.\n\nOID is an object identifier which uniquely identifies the object type within a MIB. Multiple\nOIDs can be specified on a single snmpdelta command.\n", "subsections": [] }, "OPTIONS": { "content": "COMMON OPTIONS\nPlease see snmpcmd(1) for a list of possible values for COMMON OPTIONS as well as\ntheir descriptions.\n", "subsections": [ { "name": "-Cf", "content": "been specified for a single request and if the request for one or more of the oids\nfails, snmpdelta will retry the request so that data for oids apart from the ones\nthat failed will still be returned. Specifying -Cf tells snmpdelta not to retry a\nrequest, even if there are multiple oids specified.\n" }, { "name": "-Ct", "content": "" }, { "name": "-Cs", "content": "" }, { "name": "-CS", "content": "count\" is the total of all the individual deltas for each time period.\n" }, { "name": "-Cm", "content": "" }, { "name": "-CF configfile", "content": "Tells snmpdelta to read it's configuration from the specified file. This options al‐\nlows the input to be set up in advance rather than having to be specified on the com‐\nmand line.\n" }, { "name": "-Cl", "content": "MIB instances monitored. For example, snmpdelta -Cl localhost ifInOctets.1 will cre‐\nate a file \"localhost-ifInOctets.1\".\n" }, { "name": "-Cp", "content": "a request to the agent. The default polling period is one second.\n" }, { "name": "-CP peaks", "content": "Specifies the reporting period in number of polling periods. If this option is spec‐\nified, snmpdelta polls the agent peaks number of times before reporting the results.\nThe result reported includes the average value over the reporting period. In addi‐\ntion, the highest polled value within the reporting period is shown.\n" }, { "name": "-Ck", "content": "played in the output (-Cs), then the default display shows the timestamp in the for‐\nmat hh:mm mm/dd. This option causes the timestamp format to be hh:mm:ss mm/dd.\n" }, { "name": "-CT", "content": "" }, { "name": "-Cv vars/pkt", "content": "Specifies the maximum number of oids allowed to be packaged in a single PDU. Multiple\nPDUs can be created in a single request. The default value of variables per packet is\n60. This option is useful if a request response results in an error because the\npacket is too big.\n\nNote that snmpdelta REQUIRES an argument specifying the agent to query and at least one OID\nargument, as described in the snmpcmd(1) manual page.\n" } ] }, "EXAMPLES": { "content": "$ snmpdelta -c public -v 1 -Cs localhost IF-MIB::ifInUcastPkts.3 IF-MIB::ifOutUcastPkts.3\n[20:15:43 6/14] ifInUcastPkts.3 /1 sec: 158\n[20:15:43 6/14] ifOutUcastPkts.3 /1 sec: 158\n[20:15:44 6/14] ifInUcastPkts.3 /1 sec: 184\n[20:15:44 6/14] ifOutUcastPkts.3 /1 sec: 184\n[20:15:45 6/14] ifInUcastPkts.3 /1 sec: 184\n[20:15:45 6/14] ifOutUcastPkts.3 /1 sec: 184\n[20:15:46 6/14] ifInUcastPkts.3 /1 sec: 158\n[20:15:46 6/14] ifOutUcastPkts.3 /1 sec: 158\n[20:15:47 6/14] ifInUcastPkts.3 /1 sec: 184\n[20:15:47 6/14] ifOutUcastPkts.3 /1 sec: 184\n[20:15:48 6/14] ifInUcastPkts.3 /1 sec: 184\n[20:15:48 6/14] ifOutUcastPkts.3 /1 sec: 184\n[20:15:49 6/14] ifInUcastPkts.3 /1 sec: 158\n[20:15:49 6/14] ifOutUcastPkts.3 /1 sec: 158\n^C\n$ snmpdelta -c public -v 1 -Cs -CT localhost IF-MIB:ifInUcastPkts.3 IF-MIB:ifOutcastPkts.3\nlocalhost ifInUcastPkts.3 ifOutUcastPkts.3\n[20:15:59 6/14] 184.00 184.00\n[20:16:00 6/14] 158.00 158.00\n[20:16:01 6/14] 184.00 184.00\n[20:16:02 6/14] 184.00 184.00\n[20:16:03 6/14] 158.00 158.00\n[20:16:04 6/14] 184.00 184.00\n[20:16:05 6/14] 184.00 184.00\n[20:16:06 6/14] 158.00 158.00\n^C\n\nThe following example uses a number of options. Since the Cl option is specified, the output\nis sent to a file and not to the screen.\n\n$ snmpdelta -c public -v 1 -Ct -Cs -CS -Cm -Cl -Cp 60 -CP 60\ninterlink.sw.net.cmu.edu .1.3.6.1.2.1.2.2.1.16.3 .1.3.6.1.2.1.2.2.1.16.4\n", "subsections": [] }, "SEE ALSO": { "content": "snmpcmd(1), variables(5).\n\n\n\nV5.9.1 25 Jul 2003 SNMPDELTA(1)", "subsections": [] } } } }