<?xml version="1.0"?>
<atom:feed xmlns:atom="http://www.w3.org/2005/Atom" xmlns:html="http://www.w3.org/1999/xhtml">
  <atom:id>http://caudium.net/atom/documentation/snmp</atom:id>
  <atom:title type="text">Caudium :: Caudium SNMP Agent</atom:title>
  <atom:updated>2026-05-01T09:55:24-04:00</atom:updated>
  <atom:link href="http://caudium.net/atom/documentation/snmp" type="application/atom+xml"></atom:link>
  <atom:link href="http://caudium.net/space/documentation/snmp" type="text/html"></atom:link>
  <atom:link href="http://caudium.net/rss/documentation/snmp" type="application/rss+xml"></atom:link>
  <atom:generator uri="http://modules.gotpike.org/blahblah/Public.Syndication.ATOM" version="0.1">Public.Syndication.ATOM (Pike v8.0 release 702)</atom:generator>
  <atom:icon>http://caudium.net/favicon.ico</atom:icon>
  <atom:logo>http://caudium.net/caudium.png</atom:logo>
  <atom:subtitle type="xhtml"><html:div xmlns:html="http://www.w3.org/1999/xhtml"><html:h3 class="heading-1">Introduction&#xD;</html:h3><html:p class="paragraph"/>
Caudium 1.3 and greater ships with a SNMP agent. The MIB is currently under construction, but here are the currently implemented objects available by SNMP GET / SET / TRAP access. &#xD;
Our Webserver OIDs are based on enterprises.caudium.webserver OID (e.g. 1.3.6.1.4.1.14245.1 OID). &#xD;
Please note that currently, GET-NEXT is not supported in the Caudium SNMP agent.&#xD;
<html:h3 class="heading-1">GET OIDs&#xD;</html:h3>
All SNMP GET OIDs are under enterprise.caudium.webserver.100.<html:p class="paragraph"/>
1 : Server Version <html:br class="break"/>
Returns the server version in a string.<html:p class="paragraph"/>
2 : Server boot time <html:br class="break"/>
Returns the server time when caudium has boot in a ctime() string.<html:p class="paragraph"/>
3 : Boot length <html:br class="break"/>
Returns the boot length in time ticks.<html:p class="paragraph"/>
4 : Uptime in time ticks <html:br class="break"/>
Returns the uptime in time ticks.<html:p class="paragraph"/>
5 : Total number of http requests <html:br class="break"/>
Returns the total number of http requests (in integer 64bits format), usefull for MRTGizing the usage of Caudium.<html:p class="paragraph"/>
6 : Total bytes of data received <html:br class="break"/>
Returns the total bytes received in Caudium, usualy in http POST / GET requests.<html:p class="paragraph"/>
7 : Total bytes of data sent <html:br class="break"/>
Returns the total bytes of data sent by Caudium.<html:p class="paragraph"/>
8 : 5 minutes average of requests <html:br class="break"/>
Returns the 5 minutes average of requests received by Caudium.<html:p class="paragraph"/>
9 : 5 minutes average of bytes received <html:br class="break"/>
Returns the 5 minutes average of bytes received by Caudium.<html:p class="paragraph"/>
10 : 5 minutes average of bytes sent <html:br class="break"/>
Returns the 5 minutes average of bytes sent by Caudium.&#xD;
<html:h3 class="heading-1">SET OIDs&#xD;</html:h3><html:p class="paragraph"/>
All SNMP SET OIDs are under enterprise.caudium.webserver.101. Note that in order to use these SNMP SET OIDs,  you must specify the originator in the CIF, otherwise, the request will be ignored.<html:p class="paragraph"/>
11 : Shutdown Caudium <html:br class="break"/>
If set to "1", Caudium will shutdown itself.<html:p class="paragraph"/>
2 : Restart Caudium Server <html:br class="break"/>
If set to "1", Caudium will restart itself.<html:p class="paragraph"/>
3 : Reload all configurations <html:br class="break"/>
If set to "1", Caudium will reload the configuration from disk.&#xD;
<html:h3 class="heading-1">Traps&#xD;</html:h3><html:p class="paragraph"/>
All Caudium Webserver traps are sent with an OID of enterprises.caudium.webserver. Traps are sent using SNMPv1, and are of generic type 6.<html:p class="paragraph"/>
Specific 1: ABS Engaged <html:br class="break"/>
The trap that is generated when the Anti-Block System (ABS) is engaged.<html:p class="paragraph"/>
Specific 2: Server Restarted <html:br class="break"/>
This trap is generated when the Caudium Webserver is restarted. Note that this is not generated when a server is shutdown.<html:p class="paragraph"/>
Specific 3: Server Shutdown <html:br class="break"/>
This trap is generated when the Caudium Webserver is shut down. Note that this is not generated when a server is restarted.<html:p class="paragraph"/>
Specific 4: Server Startup <html:br class="break"/>
This trap is generated when the Caudium Webserver starts up.<html:p class="paragraph"/>
Specific 5: Backtrace <html:br class="break"/>
Not currently generated. Varlist: enterprises.caudium.webserver.103.1 - string description of backtrace generated.<html:p class="paragraph"/>
Specific 6: Generic Trap <html:br class="break"/>
Not currently generated. Varlist: enterprises.caudium.webserver.103.2 - string description of trap.</html:div></atom:subtitle>
</atom:feed>
