telemetry-snmp 0.1.0

data/lib/telemetry/snmp/data/default_opts.rb

@@ -0,0 +1,73 @@
+module Telemetry
+  module Snmp
+    module Data
+      module DefaultOpts
+        def default_credentials
+          {
+            adapter: adapter,
+            user: username,
+            password: password,
+            database: database,
+            host: host,
+            port: port,
+            max_connections: max_connections,
+            pool_timeout: pool_timeout,
+            preconnect: preconnect,
+            test: true
+          }
+        end
+        module_function :default_credentials
+
+        def adapter
+          ENV["#{env_key}.adapter"] == 'postgres' ? 'postgres' : 'mysql2'
+        end
+        module_function :adapter
+
+        def username
+          ENV["#{env_key}.username"] || 'root'
+        end
+        module_function :username
+
+        def password
+          ENV["#{env_key}.password"] || nil
+        end
+        module_function :password
+
+        def database
+          ENV["#{env_key}.database"] || 'telemetry_snmp'
+        end
+        module_function :database
+
+        def host
+          ENV["#{env_key}.host"] || '127.0.0.1'
+        end
+        module_function :host
+
+        def port
+          ENV.key?("#{env_key}.port") ? ENV["#{env_key}.port"].to_i : 3306
+        end
+        module_function :port
+
+        def max_connections
+          ENV.key?("#{env_key}.max_connections") ? ENV["#{env_key}.max_connections"].to_i : 16
+        end
+        module_function :max_connections
+
+        def pool_timeout
+          ENV.key?("#{env_key}.pool_timeout") ? ENV["#{env_key}.pool_timeout"].to_i : 2
+        end
+        module_function :pool_timeout
+
+        def preconnect
+          ENV["#{env_key}.preconnect"] || 'concurrently'
+        end
+        module_function :preconnect
+
+        def env_key
+          ENV['conflux.data.key'] || 'telemetry.snmp.data'
+        end
+        module_function :env_key
+      end
+    end
+  end
+end

data/lib/telemetry/snmp/data/migrations/001_device_creds.rb

@@ -0,0 +1,19 @@
+Sequel.migration do
+  change do
+    create_table(:device_creds) do
+      primary_key :id
+      Integer :port, null: false, default: 161
+      String :username, null: false, default: 'paf-tig'
+      String :auth_password
+      String :auth_protocol, null: false, default: 'sha'
+      String :priv_password
+      String :priv_protocol, null: false, default: 'aes'
+      String :security_level, null: false, default: 'auth_priv'
+
+      DateTime :created
+      DateTime :updated
+
+      index :username
+    end
+  end
+end

data/lib/telemetry/snmp/data/migrations/002_create_devices_table.rb

@@ -0,0 +1,31 @@
+Sequel.migration do
+  change do
+    create_table(:devices) do
+      primary_key :id
+      String :hostname, null: false, unique: true
+      String :ip_address, null: false, unique: true
+      TrueClass :active, null: false, default: 1
+      Integer :port, null: false, default: 161
+      Integer :snmp_version, null: false, default: 3
+      foreign_key :device_cred_id, :device_creds, null: true
+      Integer :frequency, null: false, default: 60
+
+      String :environment
+      String :datacenter
+      String :zone
+
+      DateTime :last_polled
+      DateTime :created
+      DateTime :updated
+
+      index :hostname, unique: true
+      index :ip_address, unique: true
+      index :active
+      index :last_polled
+      index :environment
+      index :datacenter
+      index :zone
+      index :snmp_version
+    end
+  end
+end

data/lib/telemetry/snmp/data/migrations/003_create_oids_tables.rb

@@ -0,0 +1,16 @@
+Sequel.migration do
+  change do
+    create_table(:oids) do
+      primary_key :id
+      String :oid, null: false, unique: true
+      String :name, null: false
+      String :description, null: true
+
+      DateTime :created
+      DateTime :updated
+
+      index :oid
+      index :name
+    end
+  end
+end

data/lib/telemetry/snmp/data/migrations/004_create_oid_groups.rb

@@ -0,0 +1,15 @@
+Sequel.migration do
+  change do
+    create_table(:oid_groups) do
+      primary_key :id
+      String :name, null: false, unique: true
+      TrueClass :active, null: false, default: 1
+
+      DateTime :created
+      DateTime :updated
+
+      index :name
+      index :active
+    end
+  end
+end

data/lib/telemetry/snmp/data/migrations/005_create_oids_oid_groups.rb

@@ -0,0 +1,17 @@
+Sequel.migration do
+  change do
+    create_table(:oids_oid_groups) do
+      primary_key :id
+      String :name, null: false, unique: true
+      TrueClass :active, null: false, default: 1
+      foreign_key :oid_id, :oids, null: true
+      foreign_key :oid_group_id, :oid_groups, null: true
+
+      DateTime :created
+      DateTime :updated
+
+      index :name
+      index :active
+    end
+  end
+end

data/lib/telemetry/snmp/data/migrations/006_device_to_oid_group.rb

@@ -0,0 +1,15 @@
+Sequel.migration do
+  change do
+    create_table(:oid_groups_device) do
+      primary_key :id
+      foreign_key :device_id, :devices, null: false
+      foreign_key :oid_group_id, :oid_groups, null: false
+
+      DateTime :created
+      DateTime :updated
+
+      index :device_id
+      index :oid_group_id
+    end
+  end
+end

data/lib/telemetry/snmp/data/migrations/007_create_users.rb

@@ -0,0 +1,20 @@
+Sequel.migration do
+  change do
+    create_table(:users) do
+      primary_key :id
+      String :username, required: true, null: false, unique: true
+      String :email, required: true, null: false, unique: true
+
+      TrueClass :active, null: false, default: 1
+      TrueClass :admin, null: false, default: 0
+
+      DateTime :created
+      DateTime :updated
+
+      unique :username
+      unique :email
+      index :active
+      index :admin
+    end
+  end
+end

data/lib/telemetry/snmp/data/migrations/008_create_walks_table.rb

@@ -0,0 +1,14 @@
+Sequel.migration do
+  change do
+    create_table(:oid_walks) do
+      primary_key :id
+      String :oid_index
+      String :oid_walk
+      TrueClass :active, null: false, default: 1
+      String :measurement_name, null: false, default: 'snmp'
+
+      DateTime :created
+      DateTime :updated
+    end
+  end
+end

data/lib/telemetry/snmp/data/migrations/009_create_tag_name_column.rb

@@ -0,0 +1,7 @@
+Sequel.migration do
+  change do
+    alter_table(:oid_walks) do
+      add_column :tag_name, String
+    end
+  end
+end

data/lib/telemetry/snmp/data/migrations/010_create_user_audit_table.rb

@@ -0,0 +1,18 @@
+Sequel.migration do
+  change do
+    create_table(:user_audit_logs) do
+      primary_key :id
+      TrueClass :success, null: false, default: 1
+      foreign_key :user_id, :users, null: false
+      foreign_key :device_id, :devices, null: true
+      foreign_key :device_cred_id, :device_creds, null: true
+      foreign_key :oid_walk_id, :oid_walks, null: true
+      foreign_key :oid_id, :oids, null: true
+
+      String :entry, text: true
+
+      DateTime :created
+      DateTime :updated
+    end
+  end
+end

data/lib/telemetry/snmp/data/models/device.rb

@@ -0,0 +1,11 @@
+module Telemetry
+  module Snmp
+    module Data
+      module Model
+        class Device < Sequel::Model
+          many_to_one :device_cred
+        end
+      end
+    end
+  end
+end

data/lib/telemetry/snmp/data/models/device_cred.rb

@@ -0,0 +1,11 @@
+module Telemetry
+  module Snmp
+    module Data
+      module Model
+        class DeviceCred < Sequel::Model
+          one_to_many :devices
+        end
+      end
+    end
+  end
+end

data/lib/telemetry/snmp/data/models/oid.rb

@@ -0,0 +1,10 @@
+module Telemetry
+  module Snmp
+    module Data
+      module Model
+        class OID < Sequel::Model
+        end
+      end
+    end
+  end
+end

data/lib/telemetry/snmp/data/models/oid_group.rb

@@ -0,0 +1,10 @@
+module Telemetry
+  module Snmp
+    module Data
+      module Model
+        class OIDGroup < Sequel::Model
+        end
+      end
+    end
+  end
+end

data/lib/telemetry/snmp/data/models/oid_oid_groups.rb

@@ -0,0 +1,10 @@
+module Telemetry
+  module Snmp
+    module Data
+      module Model
+        class OIDToGroup < Sequel::Model(:oids_oid_groups)
+        end
+      end
+    end
+  end
+end

data/lib/telemetry/snmp/data/models/oid_walk.rb

@@ -0,0 +1,10 @@
+module Telemetry
+  module Snmp
+    module Data
+      module Model
+        class OIDWalks < Sequel::Model(:oid_walks)
+        end
+      end
+    end
+  end
+end

data/lib/telemetry/snmp/data/models/user.rb

@@ -0,0 +1,10 @@
+module Telemetry
+  module Snmp
+    module Data
+      module Model
+        class User < Sequel::Model
+        end
+      end
+    end
+  end
+end

data/lib/telemetry/snmp/data/models/user_audit_log.rb

@@ -0,0 +1,19 @@
+module Telemetry
+  module Snmp
+    module Data
+      module Model
+        class UserAuditLog < Sequel::Model
+          plugin :serialization
+          serialize_attributes :json, :entry
+
+          many_to_one :user
+
+          many_to_one :device
+          many_to_one :device_cred
+          many_to_one :oid
+          many_to_one :oid_walk
+        end
+      end
+    end
+  end
+end

data/lib/telemetry/snmp/mibs/AGENTX-MIB.txt

@@ -0,0 +1,527 @@
+AGENTX-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+ MODULE-IDENTITY, OBJECT-TYPE, Unsigned32, mib-2
+    FROM SNMPv2-SMI
+ SnmpAdminString
+    FROM SNMP-FRAMEWORK-MIB
+ MODULE-COMPLIANCE, OBJECT-GROUP
+    FROM SNMPv2-CONF
+ TEXTUAL-CONVENTION, TimeStamp, TruthValue, TDomain
+    FROM SNMPv2-TC;
+agentxMIB MODULE-IDENTITY
+ LAST-UPDATED "200001100000Z" -- Midnight 10 January 2000
+ ORGANIZATION "AgentX Working Group"
+ CONTACT-INFO "WG-email:   agentx@dorothy.bmc.com
+               Subscribe:  agentx-request@dorothy.bmc.com
+               WG-email Archive:  ftp://ftp.peer.com/pub/agentx/archives
+               FTP repository:  ftp://ftp.peer.com/pub/agentx
+               http://www.ietf.org/html.charters/agentx-charter.html
+
+               Chair:      Bob Natale
+                           ACE*COMM Corporation
+               Email:      bnatale@acecomm.com
+
+               WG editor:  Mark Ellison
+                           Ellison Software Consulting, Inc.
+               Email:      ellison@world.std.com
+
+               Co-author:  Lauren Heintz
+                           Cisco Systems,
+               EMail:      lheintz@cisco.com
+
+               Co-author:  Smitha Gudur
+                           Independent Consultant
+               Email:      sgudur@hotmail.com
+              "
+ DESCRIPTION    "This is the MIB module for the SNMP Agent Extensibility
+     Protocol (AgentX).  This MIB module will be implemented by
+     the master agent.
+    "
+
+  REVISION     "200001100000Z" -- Midnight 10 January 2000
+ DESCRIPTION
+    "Initial version published as RFC 2742."
+  ::= { mib-2  74 }
+
+ -- Textual Conventions
+
+ AgentxTAddress ::= TEXTUAL-CONVENTION
+   STATUS       current
+   DESCRIPTION
+     "Denotes a transport service address.  This is identical to
+      the TAddress textual convention (SNMPv2-SMI) except that
+      zero-length values are permitted.
+     "
+   SYNTAX       OCTET STRING (SIZE (0..255))
+
+ -- Administrative assignments
+
+ agentxObjects OBJECT IDENTIFIER      ::= { agentxMIB 1 }
+ agentxGeneral OBJECT IDENTIFIER      ::= { agentxObjects 1 }
+ agentxConnection OBJECT IDENTIFIER   ::= { agentxObjects 2 }
+ agentxSession OBJECT IDENTIFIER      ::= { agentxObjects 3 }
+ agentxRegistration OBJECT IDENTIFIER ::= { agentxObjects 4 }
+
+ agentxDefaultTimeout OBJECT-TYPE
+  SYNTAX      INTEGER (0..255)
+  UNITS       "seconds"
+  MAX-ACCESS  read-only
+  STATUS      current
+  DESCRIPTION
+     "The 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.
+     "
+  DEFVAL      { 5 }
+  ::= { agentxGeneral 1 }
+
+ agentxMasterAgentXVer OBJECT-TYPE
+  SYNTAX      INTEGER (1..255)
+  MAX-ACCESS  read-only
+  STATUS      current
+  DESCRIPTION
+     "The 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.
+     "
+  ::= { agentxGeneral 2 }
+
+ --      The AgentX Subagent Connection Group
+
+ agentxConnTableLastChange OBJECT-TYPE
+  SYNTAX      TimeStamp
+  MAX-ACCESS  read-only
+  STATUS      current
+  DESCRIPTION
+     "The value of sysUpTime when the last row creation or deletion
+      occurred in the agentxConnectionTable.
+     "
+  ::= { agentxConnection 1 }
+
+ agentxConnectionTable OBJECT-TYPE
+   SYNTAX      SEQUENCE OF AgentxConnectionEntry
+   MAX-ACCESS  not-accessible
+   STATUS      current
+   DESCRIPTION
+     "The agentxConnectionTable tracks all current AgentX transport
+      connections.  There may be zero, one, or more AgentX sessions
+      carried on a given AgentX connection.
+     "
+   ::= { agentxConnection 2 }
+
+ agentxConnectionEntry OBJECT-TYPE
+   SYNTAX      AgentxConnectionEntry
+   MAX-ACCESS  not-accessible
+   STATUS      current
+   DESCRIPTION
+     "An 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.
+     "
+   INDEX { agentxConnIndex }
+   ::= { agentxConnectionTable 1 }
+
+ AgentxConnectionEntry ::= SEQUENCE {
+          agentxConnIndex            Unsigned32,
+          agentxConnOpenTime         TimeStamp,
+          agentxConnTransportDomain  TDomain,
+          agentxConnTransportAddress AgentxTAddress }
+
+ agentxConnIndex OBJECT-TYPE
+   SYNTAX       Unsigned32 (1..4294967295)
+   MAX-ACCESS   not-accessible
+   STATUS       current
+   DESCRIPTION
+     "agentxConnIndex 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.
+     "
+   ::= { agentxConnectionEntry 1 }
+
+ agentxConnOpenTime OBJECT-TYPE
+   SYNTAX       TimeStamp
+   MAX-ACCESS   read-only
+   STATUS       current
+   DESCRIPTION
+     "The value of sysUpTime when this connection was established
+      and, therefore, its value when this entry was added to the table.
+     "
+   ::= { agentxConnectionEntry 2 }
+
+ agentxConnTransportDomain OBJECT-TYPE
+   SYNTAX       TDomain
+   MAX-ACCESS   read-only
+   STATUS       current
+   DESCRIPTION
+     "The transport protocol in use for this connection to the
+      subagent.
+     "
+   ::= { agentxConnectionEntry 3 }
+
+ agentxConnTransportAddress OBJECT-TYPE
+   SYNTAX       AgentxTAddress
+   MAX-ACCESS   read-only
+   STATUS       current
+   DESCRIPTION
+     "The 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.
+     "
+   ::= { agentxConnectionEntry 4 }
+
+ -- The AgentX Subagent Session Group
+
+ agentxSessionTableLastChange OBJECT-TYPE
+  SYNTAX      TimeStamp
+  MAX-ACCESS  read-only
+  STATUS      current
+  DESCRIPTION
+     "The value of sysUpTime when the last row creation or deletion
+      occurred in the agentxSessionTable.
+     "
+  ::= { agentxSession 1 }
+
+ agentxSessionTable OBJECT-TYPE
+  SYNTAX      SEQUENCE OF AgentxSessionEntry
+  MAX-ACCESS  not-accessible
+  STATUS      current
+  DESCRIPTION
+     "A table of AgentX subagent sessions currently in effect.
+     "
+  ::= { agentxSession 2 }
+
+ agentxSessionEntry OBJECT-TYPE
+  SYNTAX      AgentxSessionEntry
+  MAX-ACCESS  not-accessible
+  STATUS      current
+  DESCRIPTION
+     "Information 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.
+     "
+  INDEX       { agentxConnIndex, agentxSessionIndex }
+  ::= { agentxSessionTable 1 }
+
+ AgentxSessionEntry ::= SEQUENCE {
+  agentxSessionIndex         Unsigned32,
+  agentxSessionObjectID      OBJECT IDENTIFIER,
+  agentxSessionDescr         SnmpAdminString,
+  agentxSessionAdminStatus   INTEGER,
+  agentxSessionOpenTime      TimeStamp,
+  agentxSessionAgentXVer     INTEGER,
+  agentxSessionTimeout       INTEGER
+ }
+
+ agentxSessionIndex OBJECT-TYPE
+  SYNTAX      Unsigned32 (0..4294967295)
+  MAX-ACCESS  not-accessible
+  STATUS      current
+  DESCRIPTION
+     "A 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.
+     "
+  ::= { agentxSessionEntry 1 }
+
+ agentxSessionObjectID OBJECT-TYPE
+  SYNTAX      OBJECT IDENTIFIER
+  MAX-ACCESS  read-only
+  STATUS      current
+  DESCRIPTION
+     "This 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.
+     "
+  ::= { agentxSessionEntry 2 }
+
+ agentxSessionDescr OBJECT-TYPE
+  SYNTAX      SnmpAdminString
+  MAX-ACCESS  read-only
+  STATUS      current
+  DESCRIPTION
+     "A 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.
+     "
+  ::= { agentxSessionEntry 3 }
+
+ agentxSessionAdminStatus OBJECT-TYPE
+  SYNTAX      INTEGER {
+                 up(1),
+                 down(2)
+              }
+  MAX-ACCESS  read-write
+  STATUS      current
+  DESCRIPTION
+     "The administrative (desired) status of the session.  Setting
+      the value to 'down(2)' closes the subagent session (with c.reason
+      set to 'reasonByManager').
+     "
+  ::= { agentxSessionEntry 4 }
+
+ agentxSessionOpenTime OBJECT-TYPE
+  SYNTAX      TimeStamp
+  MAX-ACCESS  read-only
+  STATUS      current
+  DESCRIPTION
+     "The value of sysUpTime when this session was opened and,
+      therefore, its value when this entry was added to the table.
+     "
+  ::= { agentxSessionEntry 5 }
+
+ agentxSessionAgentXVer OBJECT-TYPE
+  SYNTAX      INTEGER (1..255)
+  MAX-ACCESS  read-only
+  STATUS      current
+  DESCRIPTION
+     "The version of the AgentX protocol supported by the
+      session.  This must be less than or equal to the value of
+      agentxMasterAgentXVer.
+     "
+  ::= { agentxSessionEntry 6 }
+
+ agentxSessionTimeout OBJECT-TYPE
+  SYNTAX     INTEGER (0..255)
+  UNITS      "seconds"
+  MAX-ACCESS read-only
+  STATUS     current
+  DESCRIPTION
+     "The 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).
+     "
+  ::= { agentxSessionEntry 7 }
+
+ -- The AgentX Registration Group
+
+ agentxRegistrationTableLastChange OBJECT-TYPE
+  SYNTAX      TimeStamp
+  MAX-ACCESS  read-only
+  STATUS      current
+  DESCRIPTION
+     "The value of sysUpTime when the last row creation or deletion
+      occurred in the agentxRegistrationTable.
+     "
+  ::= { agentxRegistration 1 }
+
+ agentxRegistrationTable OBJECT-TYPE
+  SYNTAX      SEQUENCE OF AgentxRegistrationEntry
+  MAX-ACCESS  not-accessible
+  STATUS      current
+  DESCRIPTION
+     "A table of registered regions.
+     "
+  ::= { agentxRegistration 2 }
+
+ agentxRegistrationEntry OBJECT-TYPE
+  SYNTAX      AgentxRegistrationEntry
+  MAX-ACCESS  not-accessible
+  STATUS      current
+  DESCRIPTION
+     "Contains 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.
+     "
+  INDEX       { agentxConnIndex, agentxSessionIndex, agentxRegIndex }
+  ::= { agentxRegistrationTable 1 }
+
+ AgentxRegistrationEntry ::= SEQUENCE {
+  agentxRegIndex           Unsigned32,
+  agentxRegContext         OCTET STRING,
+  agentxRegStart           OBJECT IDENTIFIER,
+  agentxRegRangeSubId      Unsigned32,
+  agentxRegUpperBound      Unsigned32,
+  agentxRegPriority        Unsigned32,
+  agentxRegTimeout         INTEGER,
+  agentxRegInstance        TruthValue }
+
+ agentxRegIndex OBJECT-TYPE
+  SYNTAX      Unsigned32 (1..4294967295)
+  MAX-ACCESS  not-accessible
+  STATUS      current
+  DESCRIPTION
+     "agentxRegIndex uniquely identifies a registration entry.
+      This value is constant for the lifetime of an entry.
+     "
+  ::= { agentxRegistrationEntry 1 }
+
+ agentxRegContext OBJECT-TYPE
+  SYNTAX      OCTET STRING
+  MAX-ACCESS  read-only
+  STATUS      current
+  DESCRIPTION
+     "The context in which the session supports the objects in this
+      region.  A zero-length context indicates the default context.
+     "
+  ::= { agentxRegistrationEntry 2 }
+
+ agentxRegStart OBJECT-TYPE
+  SYNTAX      OBJECT IDENTIFIER
+  MAX-ACCESS  read-only
+  STATUS      current
+  DESCRIPTION
+     "The 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.
+     "
+  ::= { agentxRegistrationEntry 3 }
+
+ agentxRegRangeSubId OBJECT-TYPE
+  SYNTAX      Unsigned32
+  MAX-ACCESS  read-only
+  STATUS      current
+  DESCRIPTION
+     "agentxRegRangeSubId 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.
+     "
+  ::= { agentxRegistrationEntry 4 }
+
+ agentxRegUpperBound OBJECT-TYPE
+  SYNTAX      Unsigned32
+  MAX-ACCESS  read-only
+  STATUS      current
+  DESCRIPTION
+    "agentxRegUpperBound 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.
+    "
+  ::= { agentxRegistrationEntry 5 }
+
+ agentxRegPriority OBJECT-TYPE
+  SYNTAX      Unsigned32
+  MAX-ACCESS  read-only
+  STATUS      current
+  DESCRIPTION
+     "The 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.
+     "
+  ::= { agentxRegistrationEntry 6 }
+
+ agentxRegTimeout OBJECT-TYPE
+  SYNTAX      INTEGER (0..255)
+  UNITS       "seconds"
+  MAX-ACCESS  read-only
+  STATUS      current
+  DESCRIPTION
+     "The 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.
+     "
+  ::= { agentxRegistrationEntry 7 }
+
+ agentxRegInstance OBJECT-TYPE
+  SYNTAX      TruthValue
+  MAX-ACCESS  read-only
+  STATUS      current
+  DESCRIPTION
+     "The value of agentxRegInstance is `true' for
+      registrations for which the INSTANCE_REGISTRATION
+      was set, and is `false' for all other registrations.
+     "
+  ::= { agentxRegistrationEntry 8 }
+
+ -- Conformance Statements for AgentX
+
+ agentxConformance     OBJECT IDENTIFIER ::= { agentxMIB 2 }
+ agentxMIBGroups       OBJECT IDENTIFIER ::= { agentxConformance 1 }
+ agentxMIBCompliances  OBJECT IDENTIFIER ::= { agentxConformance 2 }
+
+ -- Compliance Statements for AgentX
+
+ agentxMIBCompliance MODULE-COMPLIANCE
+  STATUS      current
+  DESCRIPTION
+     "The 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.
+     "
+  MODULE -- this module
+     MANDATORY-GROUPS  { agentxMIBGroup }
+
+     OBJECT agentxSessionAdminStatus
+        MIN-ACCESS read-only
+        DESCRIPTION
+           "Write access is not required.
+           "
+  ::= { agentxMIBCompliances 1 }
+
+ agentxMIBGroup OBJECT-GROUP
+  OBJECTS {
+     agentxDefaultTimeout,
+     agentxMasterAgentXVer,
+     agentxConnTableLastChange,
+     agentxConnOpenTime,
+     agentxConnTransportDomain,
+     agentxConnTransportAddress,
+     agentxSessionTableLastChange,
+     agentxSessionTimeout,
+     agentxSessionObjectID,
+     agentxSessionDescr,
+     agentxSessionAdminStatus,
+     agentxSessionOpenTime,
+     agentxSessionAgentXVer,
+     agentxRegistrationTableLastChange,
+     agentxRegContext,
+     agentxRegStart,
+     agentxRegRangeSubId,
+     agentxRegUpperBound,
+     agentxRegPriority,
+     agentxRegTimeout,
+     agentxRegInstance
+    }
+  STATUS      current
+  DESCRIPTION
+     "All accessible objects in the AgentX MIB.
+     "
+  ::= { agentxMIBGroups 1 }
+
+ END