AGENTX-MIB

MIB Reference — IPNetwork Monitor

All MIBsAGENTX-MIB

Organization: AgentX Working Group

Last Updated: 2000-01-10

Category: SNMP Framework

Description:

Defines managed objects for the AgentX protocol, which distributes SNMP agent implementation across a master agent and multiple subagents.

Imported Objects

From SNMP-FRAMEWORK-MIB

SnmpAdminString

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

MODULE-IDENTITY
OBJECT-TYPE
Unsigned32
mib-2

From SNMPv2-TC

TDomain
TEXTUAL-CONVENTION
TimeStamp
TruthValue

What Is AGENTX-MIB?

AGENTX-MIB, standardized in RFC 2742, defines the conformance requirements for implementations of the AgentX protocol, a vendor-neutral IETF mechanism that lets a single SNMP master agent aggregate management data from multiple independently running subagent processes on the same host. Rather than exposing device hardware or software counters itself, it is fundamentally an architectural/protocol-compliance module concerned with how SNMP agent implementations are structured. It therefore has no hardware/software status objects of its own -- no uptime, temperature, or interface data -- since that data would instead come from whichever MIBs the subagents themselves implement. It builds directly on the SNMPv2-SMI and SNMPv2-CONF conformance framework and effectively depends on the separately-specified AgentX wire protocol (RFC 2741) that it requires master agents to implement. It is relevant to any host running a modular, multi-process SNMP agent architecture (master agent plus subagents), a pattern common in Unix/Linux-based network devices such as those running Net-SNMP. Reviewing the AGENTX-MIB OID list mainly reveals conformance and compliance group identifiers rather than any device data objects.

IPNetwork Monitor allows you to monitor SNMP objects defined in AGENTX-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

  • vendor-neutral, standards-based MIB (IETF); applies to any host running a modular SNMP agent (master agent + subagents), e.g. Net-SNMP-based network devices

Monitoring Examples

AGENTX-MIB is essentially a conformance/compliance module for implementations of the AgentX master-agent protocol rather than a source of device data; no sample runtime objects were identified, so no concrete polling scenario can be described from this module alone -- actual monitorable device data would come from whatever MIBs the subagents register, not from AGENTX-MIB itself.

OIDs
OID symbolicOID numericTypeAccessDescription
agentxMIB1.3.6.1.2.1.74This is the MIB module for the SNMP Agent Extensibility Protocol (AgentX). This MIB module will be implemented by the master agent.
agentxObjects1.3.6.1.2.1.74.1
agentxGeneral1.3.6.1.2.1.74.1.1
INT agentxDefaultTimeout1.3.6.1.2.1.74.1.1.1INTEGERread-onlyThe default length of time, in seconds, that the master agent should allow to elapse after dispatching a message to a session before it regards the subagent as not responding. This is a system-wide value that may override the timeout value associated with a particular session (agentxSessionTimeout) or a particular registered MIB region (agentxRegTimeout). If the associated value of agentxSessionTimeout and agentxRegTimeout are zero, or impractical in accordance with implementation-specific procedure of the master agent, the value represented by this object will be the effective timeout value for the master agent to await a response to a dispatch from a given subagent.
INT agentxMasterAgentXVer1.3.6.1.2.1.74.1.1.2INTEGERread-onlyThe AgentX protocol version supported by this master agent. The current protocol version is 1. Note that the master agent must also allow interaction with earlier version subagents.
agentxConnection1.3.6.1.2.1.74.1.2
TIM agentxConnTableLastChange1.3.6.1.2.1.74.1.2.1TimeStampread-onlyThe value of sysUpTime when the last row creation or deletion occurred in the agentxConnectionTable.
agentxConnectionTable1.3.6.1.2.1.74.1.2.2not-accessibleThe agentxConnectionTable tracks all current AgentX transport connections. There may be zero, one, or more AgentX sessions carried on a given AgentX connection.
agentxConnectionEntry1.3.6.1.2.1.74.1.2.2.1not-accessibleAn agentxConnectionEntry contains information describing a single AgentX transport connection. A connection may be used to support zero or more AgentX sessions. An entry is created when a new transport connection is established, and is destroyed when the transport connection is terminated.
U32 agentxConnIndex1.3.6.1.2.1.74.1.2.2.1.1Unsigned32not-accessibleagentxConnIndex contains the value that uniquely identifies an open transport connection used by this master agent to provide AgentX service. Values of this index should not be re-used. The value assigned to a given transport connection is constant for the lifetime of that connection.
TIM agentxConnOpenTime1.3.6.1.2.1.74.1.2.2.1.2TimeStampread-onlyThe value of sysUpTime when this connection was established and, therefore, its value when this entry was added to the table.
TDO agentxConnTransportDomain1.3.6.1.2.1.74.1.2.2.1.3TDomainread-onlyThe transport protocol in use for this connection to the subagent.
ADR agentxConnTransportAddress1.3.6.1.2.1.74.1.2.2.1.4AgentxTAddressread-onlyThe transport address of the remote (subagent) end of this connection to the master agent. This object may be zero-length for unix-domain sockets (and possibly other types of transport addresses) since the subagent need not bind a filename to its local socket.
agentxSession1.3.6.1.2.1.74.1.3
TIM agentxSessionTableLastChange1.3.6.1.2.1.74.1.3.1TimeStampread-onlyThe value of sysUpTime when the last row creation or deletion occurred in the agentxSessionTable.
agentxSessionTable1.3.6.1.2.1.74.1.3.2not-accessibleA table of AgentX subagent sessions currently in effect.
agentxSessionEntry1.3.6.1.2.1.74.1.3.2.1not-accessibleInformation about a single open session between the AgentX master agent and a subagent is contained in this entry. An entry is created when a new session is successfully established and is destroyed either when the subagent transport connection has terminated or when the subagent session is closed.
U32 agentxSessionIndex1.3.6.1.2.1.74.1.3.2.1.1Unsigned32not-accessibleA unique index for the subagent session. It is the same as h.sessionID defined in the agentx header. Note that if a subagent's session with the master agent is closed for any reason its index should not be re-used. A value of zero(0) is specifically allowed in order to be compatible with the definition of h.sessionId.
OID agentxSessionObjectID1.3.6.1.2.1.74.1.3.2.1.2OBJECT IDENTIFIERread-onlyThis is taken from the o.id field of the agentx-Open-PDU. This attribute will report a value of '0.0' for subagents not supporting the notion of an AgentX session object identifier.
STR agentxSessionDescr1.3.6.1.2.1.74.1.3.2.1.3SnmpAdminStringread-onlyA textual description of the session. This is analogous to sysDescr defined in the SNMPv2-MIB in RFC 1907 [19] and is taken from the o.descr field of the agentx-Open-PDU. This attribute will report a zero-length string value for subagents not supporting the notion of a session description.
INT agentxSessionAdminStatus1.3.6.1.2.1.74.1.3.2.1.4INTEGERread-writeThe administrative (desired) status of the session. Setting the value to 'down(2)' closes the subagent session (with c.reason set to 'reasonByManager').
TIM agentxSessionOpenTime1.3.6.1.2.1.74.1.3.2.1.5TimeStampread-onlyThe value of sysUpTime when this session was opened and, therefore, its value when this entry was added to the table.
INT agentxSessionAgentXVer1.3.6.1.2.1.74.1.3.2.1.6INTEGERread-onlyThe version of the AgentX protocol supported by the session. This must be less than or equal to the value of agentxMasterAgentXVer.
INT agentxSessionTimeout1.3.6.1.2.1.74.1.3.2.1.7INTEGERread-onlyThe length of time, in seconds, that a master agent should allow to elapse after dispatching a message to this session before it regards the subagent as not responding. This value is taken from the o.timeout field of the agentx-Open-PDU. This is a session-specific value that may be overridden by values associated with the specific registered MIB regions (see agentxRegTimeout). A value of zero(0) indicates that the master agent's default timeout value should be used (see agentxDefaultTimeout).
agentxRegistration1.3.6.1.2.1.74.1.4
TIM agentxRegistrationTableLastChange1.3.6.1.2.1.74.1.4.1TimeStampread-onlyThe value of sysUpTime when the last row creation or deletion occurred in the agentxRegistrationTable.
agentxRegistrationTable1.3.6.1.2.1.74.1.4.2not-accessibleA table of registered regions.
agentxRegistrationEntry1.3.6.1.2.1.74.1.4.2.1not-accessibleContains information for a single registered region. An entry is created when a session successfully registers a region and is destroyed for any of three reasons: this region is unregistered by the session, the session is closed, or the subagent connection is closed.
U32 agentxRegIndex1.3.6.1.2.1.74.1.4.2.1.1Unsigned32not-accessibleagentxRegIndex uniquely identifies a registration entry. This value is constant for the lifetime of an entry.
OCT agentxRegContext1.3.6.1.2.1.74.1.4.2.1.2OCTET STRINGread-onlyThe context in which the session supports the objects in this region. A zero-length context indicates the default context.
OID agentxRegStart1.3.6.1.2.1.74.1.4.2.1.3OBJECT IDENTIFIERread-onlyThe starting OBJECT IDENTIFIER of this registration entry. The session identified by agentxSessionIndex implements objects starting at this value (inclusive). Note that this value could identify an object type, an object instance, or a partial object instance.
U32 agentxRegRangeSubId1.3.6.1.2.1.74.1.4.2.1.4Unsigned32read-onlyagentxRegRangeSubId is used to specify the range. This is taken from r.region_subid in the registration PDU. If the value of this object is zero, no range is specified. If it is non-zero, it identifies the `nth' sub-identifier in r.region for which this entry's agentxRegUpperBound value is substituted in the OID for purposes of defining the region's upper bound.
U32 agentxRegUpperBound1.3.6.1.2.1.74.1.4.2.1.5Unsigned32read-onlyagentxRegUpperBound represents the upper-bound sub-identifier in a registration. This is taken from the r.upper_bound in the registration PDU. If agentxRegRangeSubid (r.region_subid) is zero, this value is also zero and is not used to define an upper bound for this registration.
U32 agentxRegPriority1.3.6.1.2.1.74.1.4.2.1.6Unsigned32read-onlyThe registration priority. Lower values have higher priority. This value is taken from r.priority in the register PDU. Sessions should use the value of 127 for r.priority if a default value is desired.
INT agentxRegTimeout1.3.6.1.2.1.74.1.4.2.1.7INTEGERread-onlyThe timeout value, in seconds, for responses to requests associated with this registered MIB region. A value of zero(0) indicates the default value (indicated by by agentxSessionTimeout or agentxDefaultTimeout) is to be used. This value is taken from the r.timeout field of the agentx-Register-PDU.
T/F agentxRegInstance1.3.6.1.2.1.74.1.4.2.1.8TruthValueread-onlyThe value of agentxRegInstance is `true' for registrations for which the INSTANCE_REGISTRATION was set, and is `false' for all other registrations.
agentxConformance1.3.6.1.2.1.74.2
agentxMIBGroups1.3.6.1.2.1.74.2.1
agentxMIBGroup1.3.6.1.2.1.74.2.1.1All accessible objects in the AgentX MIB.
agentxMIBCompliances1.3.6.1.2.1.74.2.2
agentxMIBCompliance1.3.6.1.2.1.74.2.2.1The compliance statement for SNMP entities that implement the AgentX protocol. Note that a compliant agent can implement all objects in this MIB module as read-only.

RFC description

Agent Extensibility (AgentX) Protocol Version 1 management MIB (RFC 2741) defining master agent and subagent interaction.

Start monitoring SNMP-managed network devices (AgentX master/subagent) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download AGENTX-MIB