RFC 1697
Relational Database Management System (RDBMS) Management Information Base (MIB) using SMIv2
Part 1 of 7 🎀
RFC 1697: Relational Database Management System (RDBMS) Management Information Base (MIB) using SMIv2 ✨
Okay bestie, let's get you the vibes first 💅 This is a Standards Track doc from the Network Working Group, dated August 1994. D. Brower is the editor, repping The ASK Group (INGRES DBMS Development). The rest of the squad is B. Purvy (RDBMSMIB Working Group Chair, Oracle Corporation), A. Daniel (Informix Software, Inc.), and M. Sinykin and J. Smith (both Oracle Corporation) 🫶. It doesn't obsolete or update any other RFC, so no drama there 🙈
Status of this Memo
This document specifies an Internet standards track protocol for the Internet community, and it's asking for discussion and suggestions for improvements 💜. For the standardization state and status of this protocol, check the current edition of "Internet Official Protocol Standards" (STD 1). Distribution of this memo is unlimited 🌸.
Table of Contents 🦋
1. Introduction .............................................. 1
2. The SNMPv2 Network Management Framework ................... 2
2.1 Object Definitions ....................................... 2
3. Overview .................................................. 2
3.1 Terminology .............................................. 3
3.2 Structure and Features ................................... 4
3.2.1 Tables ................................................. 4
3.2.2 Writable objects ....................................... 5
3.2.3 Traps .................................................. 5
4. Definitions ............................................... 6
5. Acknowledgements .......................................... 35
6. References ................................................ 36
7. Security Considerations ................................... 37
8. Authors' Addresses ........................................ 371. Introduction ✨
Okay so this memo defines a piece of the Management Information Base (MIB) that network management protocols use across the Internet 🌐. The main point is that it describes managed objects for managing relational database (RDBMS) implementations. Main character energy 👑.
2. The SNMPv2 Network Management Framework 💅
The SNMPv2 Network Management Framework is made up of four major components. Well, it's giving five bullets, so let's see:
RFC 1442 [1]defines the SMI, which is the mechanism for describing and naming objects for management purposes 🧚.STD 17, RFC 1213 [2]defines MIB-II, the core set of managed objects for the Internet suite of protocols 🌈.RFC 1445 [3]defines the administrative and other architectural aspects of the framework 📋.RFC 1448 [4]defines the protocol used for network access to managed objects 🔥.RFC 1443 [5]describes textual conventions for the framework 💖.
The framework lets people define new objects for experimentation and evaluation. The RDBMS-MIB can be seen as an extension of the following:
RFC 1565 [6]defines the MIB for monitoring network service applications 🦋.
2.1. Object Definitions
Managed objects get accessed through a virtual information store called the Management Information Base, or MIB 🗄️. Objects in the MIB are defined using the subset of Abstract Syntax Notation One (ASN.1) that the SMI defines. Each object type is named by an OBJECT IDENTIFIER, which is an administratively assigned name 🏷️. The object type plus an object instance uniquely identifies one specific instantiation of the object. For human convenience, we often use a textual string called the descriptor to refer to the object type 🫶.
3. Overview 🌸
The RDBMS-MIB has objects you can use to manage relational database implementations. Specifically, it holds info on installed databases and servers, plus how databases and servers relate to each other 💜. Here are the terms used in this database, lowkey important so read up 👀.
3.1. Terminology
Vendors and Products Vendors and products are providers of database systems on a host. A vendor can have more than one database product that you can manage through this MIB 🏬. On a host, you might have systems from multiple vendors, multiple systems from a single vendor, or any other combination. Each vendor may have its own private MIB, and you can find it using the PrivateMibOID objects in some of the tables 🔍.
Databases Databases are collections of interrelated data, organized according to a schema, to serve one or more applications 📚. For the purposes of this MIB, a database is a collection of tables whose organization is based on the relational model. Each system on the host can have one or more databases available from each product 🍓. In the MIB, data about databases is captured in the rdbmsDbTable and the rdbmsDbInfoTable, each with one row per database ✨.
Relational Database Management System (RDBMS) An RDBMS is a collection of integrated services that support database management and together support and control the creation, use, and maintenance of relational databases 🎀. Servers as defined in this MIB provide the functions of the RDBMS 💅.
Servers Servers are entities that provide access to databases 🖥️. For this MIB, servers are entities that may exist independently of other servers. A server may or may not be a single process, depending on how independent it is from other processes 🧩. In this MIB, info about servers is captured in the rdbmsSvrTable and the rdbmsSvrInfoTable, each with one row per server. Each one extends the applTable from the APPLICATION-MIB of RFC 1565. Both the rdbmsSvrTable and the rdbmsSvrInfoTable are indexed by the applIndex of that MIB 🦋.
Associations Inbound associations are local or remote conversations, usually instances of the SQL CONNECT statement, as they show up in servers 💬. The MIB doesn't currently reveal individual associations. Instead, there are association counters in the dbmsSvrInfoTable and the applTable 🙈.
There are also relationships between servers and databases, and all the obvious ones are possible and supported 💖:
1 database : 1 server1 database : many serversmany databases : 1 servermany databases : many servers
3.2. Structure and Features
The info in this MIB module is organized into nine tables, twelve potentially writable objects, and two traps 🎀. Here's the breakdown.
3.2.1. Tables
- databases installed on a host/system (
rdbmsDbTable) - actively opened databases (
rdbmsDbInfoTable) - database configuration parameters (
rdbmsDbParamTable) - database limited resources (
rdbmsDbLimitedResourceTable) - database servers installed on a system (
rdbmsSrvTable) - active database servers (
rdbmsSrvInfoTable) - configuration parameters for a server (
rdbmsSrvParamTable) - server limited resources (
rdbmsSrvLimitedResourceTable) - relation of servers and databases on a host (
rdbmsRelTable)
These entities are broadly applicable across database systems and are enough for lots of monitoring tasks 📊. They're not nearly enough for detailed management or performance monitoring of specific database products 😭. The plan is to fill that gap with vendor and product specific MIBs that cover the entities not codified here 🧚.
3.2.2. Writable objects
The MIB needs no writable objects for conformance. There's no expectation that RDBMS systems get actively managed through this MIB 🙅♀️. That said, the RDBMS-MIB supports the ability to modify the following objects if the implementor chooses to 💅:
rdbmsDbContactrdbmsDbInfoSizeAllocatedrdbmsDbParamCurrValuerdbmsDbParamComment rdbmsDbLimitedResourceLimitrdbmsDbLimitedResourceDescriptionrdbmsSrvContactrdbmsSrvInfoMaxInboundAssociationsrdbmsSrvParamCurrValuerdbmsSrvParamCommentrdbmsSrvLimitedResourceLimitrdbmsSrvLimitedResourceDescription
3.2.3. Traps
The RDBMS-MIB has two traps 🔔:
rdbmsStateChangerdbmsOutOfSpace
4. Definitions 📜
Here's the actual MIB module, copied exactly as written because implementers rely on every single character 🫶.
RDBMS-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
Counter32, Gauge32, Integer32
FROM SNMPv2-SMI
DisplayString, DateAndTime, AutonomousType
FROM SNMPv2-TC
applIndex, applGroup
FROM APPLICATION-MIB
mib-2
FROM RFC1213-MIB;
rdbmsMIB MODULE-IDENTITY
LAST-UPDATED "9406150655Z"
ORGANIZATION "IETF RDBMSMIB Working Group"
CONTACT-INFO
" David Brower
Postal: The ASK Group, INGRES DBMS Development
1080 Marina Village Parkway
Alameda, CA 94501
US
Tel: +1 510 748 3418
Fax: +1 510 748 2770
E-mail: daveb@ingres.com"
DESCRIPTION
"The MIB module to describe objects for generic relational
databases."
::= { mib-2 39 }
rdbmsObjects OBJECT IDENTIFIER ::= { rdbmsMIB 1 }
----------------------------------------------------------------
rdbmsDbTable OBJECT-TYPE
SYNTAX SEQUENCE OF RdbmsDbEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table of databases installed on a system."
::= { rdbmsObjects 1 }
rdbmsDbEntry OBJECT-TYPE
SYNTAX RdbmsDbEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry for a single database on the host. Whether a
particular database is represented by a row in rdbmsDbTable
may be dependent on the activity level of that database,
according to the product's implementation. An instance of
rdbmsRelState having the value active, other, or restricted
implies that an entry, corresponding to that instance, will
be present."
INDEX { rdbmsDbIndex }
::= { rdbmsDbTable 1 }
RdbmsDbEntry ::=
SEQUENCE {
rdbmsDbIndex INTEGER,
rdbmsDbPrivateMibOID OBJECT IDENTIFIER,
rdbmsDbVendorName DisplayString,
rdbmsDbName DisplayString,
rdbmsDbContact DisplayString
}
rdbmsDbIndex OBJECT-TYPE
SYNTAX INTEGER (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A numeric index, unique among all the databases from all
products on this host. This value is a surrogate for the
conceptually unique key, which is {PrivateMibOID,
databasename}"
::= { rdbmsDbEntry 1 }More of the MIB module is coming in part 2, so stay tuned 🦋💖
Okay so bestie, we're picking up right in the middle of the definitions section 💖 The first thing on the list is the private MIB identifier for each database, which is basically the vendor's own little address tag 🎀
rdbmsDbPrivateMibOID OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The authoritative identification for the private MIB for
this database, presumably based on the vendor, e.g., {
enterprises 111 <optional subidentifiers>} for Oracle
databases, {enterprises 757 <optional subidentifiers>} for
Ingres databases, { enterprises 897 <optional
subidentifiers>} for Sybase databases, etc.
If no OBJECT IDENTIFIER exists for the private MIB, attempts
to access this object will return noSuchName (SNMPv1)
or noSuchInstance (SNMPv2)."
::= { rdbmsDbEntry 2 }So the vendor-specific one is rdbmsDbPrivateMibOID 🦋 It's read-only, and it's an OBJECT IDENTIFIER, which the description says is presumably based on the vendor. Examples in there are enterprises 111 for Oracle, enterprises 757 for Ingres, and enterprises 897 for Sybase, plus some optional subidentifiers after each 💅 If there's no OBJECT IDENTIFIER for the private MIB, reading it gives back noSuchName in SNMPv1 or noSuchInstance in SNMPv2, which is giving "nothing here, bestie" 🙈
rdbmsDbVendorName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The name of the vendor whose RDBMS manages this database,
for informational purposes."
::= { rdbmsDbEntry 3 }
rdbmsDbName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The name of this database, in a product specific format. The
product may need to qualify the name in some way to resolve
conflicts if it is possible for a database name to be
duplicated on a host. It might be necessary to construct a
hierarchical name embedding the RDBMS instance/installation
on the host, and/or the owner of the database. For instance,
'/test-installation/database-owner/database-name'."
::= { rdbmsDbEntry 4 }
rdbmsDbContact OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The textual identification of the contact person for this
managed database, together with information on how to contact
this person.
Note: if there is no server associated with this database, an
agent may need to keep this in other persistent storage,
e.g., a configuration file.
Note that a compliant agent does not need to
allow write access to this object."
::= { rdbmsDbEntry 5 }Next up is rdbmsDbVendorName, which is just a read-only string saying who made the RDBMS, and it's there for info only ✨ Then there's rdbmsDbName, a read-only string for the database name. The name is product specific, and the product might need to qualify it so two databases on the same host don't clash 🌸 It could even be a hierarchical name that includes the RDBMS installation and/or the database owner, and the example given is '/test-installation/database-owner/database-name' 🧚
rdbmsDbContact is the contact person object 📞 It's read-write, and the description says it should hold the textual identity of the person to reach, plus how to reach them. If there's no server tied to the database, the agent may need to keep this in some other persistent storage, like a config file 💜 And a compliant agent doesn't have to allow writes to it, so don't be shocked if it's read-only in practice 🙈
----------------------------------------------------------------
rdbmsDbInfoTable OBJECT-TYPE
SYNTAX SEQUENCE OF RdbmsDbInfoEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table of additional information about databases present
on the host."
::= { rdbmsObjects 2 }
rdbmsDbInfoEntry OBJECT-TYPE
SYNTAX RdbmsDbInfoEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Information that must be present if the database is actively
opened. If the database is not actively opened, then
attempts to access corresponding instances in this table may
result in either noSuchName (SNMPv1) or noSuchInstance
(SNMPv2). 'Actively opened' means at least one of the
rdbmsRelState entries for this database in the rdbmsRelTable
is active(2)."
INDEX { rdbmsDbIndex }
::= { rdbmsDbInfoTable 1 }
RdbmsDbInfoEntry ::=
SEQUENCE {
rdbmsDbInfoProductName DisplayString,
rdbmsDbInfoVersion DisplayString,
rdbmsDbInfoSizeUnits INTEGER,
rdbmsDbInfoSizeAllocated INTEGER,
rdbmsDbInfoSizeUsed INTEGER,
rdbmsDbInfoLastBackup DateAndTime
}
rdbmsDbInfoProductName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The textual product name of the server that created or last
restructured this database. The format is product specific."
::= { rdbmsDbInfoEntry 1 }
rdbmsDbInfoVersion OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The version number of the server that created or last
restructured this database. The format is product specific."
::= { rdbmsDbInfoEntry 2 }
rdbmsDbInfoSizeUnits OBJECT-TYPE
SYNTAX INTEGER {
bytes(1),
kbytes(2),
mbytes(3),
gbytes(4),
tbytes(5)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Identification of the units used to measure the size of this
database in rdbmsDbInfoSizeAllocated and rdbmsDbInfoSizeUsed.
bytes(1) indicates individual bytes, kbytes(2) indicates
units of kilobytes, mbytes(3) indicates units of megabytes,
gbytes(4) indicates units of gigabytes, and tbytes(5)
indicates units of terabytes. All are binary multiples -- 1K
= 1024. If writable, changes here are reflected in the get
values of the associated objects."
::= { rdbmsDbInfoEntry 3 }
rdbmsDbInfoSizeAllocated OBJECT-TYPE
SYNTAX INTEGER (1..2147483647)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The estimated size of this database (in
rdbmsDbInfoSizeUnits), which is the disk space that has been
allocated to it and is no longer available to users on this
host. rdbmsDbInfoSize does not necessarily indicate the
amount of space actually in use for database data. Some
databases may support extending allocated size, and others
may not.
Note that a compliant agent does not need to
allow write access to this object."
-- Note: computing SizeAllocated may be expensive, and SNMP
-- agents might cache the value to increase performance.
::= { rdbmsDbInfoEntry 4 }
rdbmsDbInfoSizeUsed OBJECT-TYPE
SYNTAX INTEGER (1..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The estimated size of this database, in rdbmsDbInfoSizeUnits,
which is actually in use for database data."
-- Note: computing SizeUsed may be expensive, and SNMP
-- agents might cache the value to increase performance.
::= { rdbmsDbInfoEntry 5 }
rdbmsDbInfoLastBackup OBJECT-TYPE
SYNTAX DateAndTime
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The date and time that the latest complete or partial backup
of the database was taken. If a database has never been
backed up, then attempts to access this object will
result in either noSuchName (SNMPv1) or noSuchInstance
(SNMPv2)."
::= { rdbmsDbInfoEntry 6 }Now we're in the info table era 🍓 rdbmsDbInfoTable is the table of extra info about databases on the host, and it's indexed by rdbmsDbIndex through rdbmsDbInfoEntry 🧚 The entry is only guaranteed to be there if the database is actively opened, meaning at least one rdbmsRelState entry for that database in rdbmsRelTable is active(2) 👑 If it isn't actively opened, asking for those instances can give back noSuchName in SNMPv1 or noSuchInstance in SNMPv2, so no drama, just not there yet 🙈
The entry has six columns. rdbmsDbInfoProductName and rdbmsDbInfoVersion are both read-only strings for the product and version of the server that created or last restructured the database, and the format is product specific ✨ rdbmsDbInfoSizeUnits is read-only and uses an INTEGER enum: bytes(1), kbytes(2), mbytes(3), gbytes(4), and tbytes(5). They're all binary multiples, so 1K = 1024 🦋 The description also says that if it's writable, changes here show up in the get values of the associated objects.
rdbmsDbInfoSizeAllocated is read-write and holds the estimated size in rdbmsDbInfoSizeUnits, meaning the disk space that's been allocated and is no longer available to users on the host 💅 It doesn't have to match the space actually used for data, and some databases can extend their allocation while others can't. A compliant agent doesn't need to allow writes to it. There's also a note that working out the allocated size can be expensive, so agents might cache the value for performance 🫶
rdbmsDbInfoSizeUsed is the read-only one for the estimated size actually in use for data, in those same units 🌈 It has the same expensive-to-compute note, and the same caching idea applies 🙈
rdbmsDbInfoLastBackup is a read-only DateAndTime for when the latest complete or partial backup was taken. If a database has never been backed up, then asking for it gives noSuchName in SNMPv1 or noSuchInstance in SNMPv2 😭
----------------------------------------------------------------
rdbmsDbParamTable OBJECT-TYPE
SYNTAX SEQUENCE OF RdbmsDbParamEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table of configuration parameters for a database.
Entries should be populated according to the following
guidelines:
(1) The value should be specified through administrative
(human) intervention.
(2) It should be configured on a per-database basis.
(3) One of the following is true:
(a) The parameter has a non-numeric value;
(b) The current value is numeric, but it only changes due
to human intervention;
(c) The current value is numeric and dynamic, but the
RDBMS does not track access/allocation failures
related to the parameter;
(d) The current value is numeric and dynamic, the
RDBMS tracks changes in access/allocation failures
related to the parameter, but the failure has no
significant impact on RDBMS performance or
availability;
(e) The current value is numeric and dynamic, the
RDBMS tracks changes in access/allocation failures
related to the parameter, the failure has
significant impact on RDBMS performance or
availability, and is shown in the
rdbmsDbLimitedResource table."
::= { rdbmsObjects 3 }
rdbmsDbParamEntry OBJECT-TYPE
SYNTAX RdbmsDbParamEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry for a single configuration parameter for a database.
Parameters with single values have a subindex value of one.
If the parameter is naturally considered to contain a
variable number of members of a class, e.g. members of the
DBA user group, or files which are part of the database, then
it must be presented as a set of rows. If, on the other
hand, the parameter represents a set of choices from a class,
e.g. the permissions on a file or the options chosen out of
the set of all options allowed, AND is guaranteed to always
fit in the 255 character length of a DisplayString, then it
may be presented as a comma separated list with a subindex
value of one. Zero may not be used as a subindex value.
If the database is not actively opened, then attempts
to access corresponding instances in this table may result in
either noSuchName (SNMPv1) or noSuchInstance (SNMPv2).
'Actively opened' means at least one of the
rdbmsRelState entries for this database in the rdbmsRelTable
is active(2)."
INDEX { rdbmsDbIndex, rdbmsDbParamName, rdbmsDbParamSubIndex }
::= { rdbmsDbParamTable 1 }
RdbmsDbParamEntry ::=
SEQUENCE {
rdbmsDbParamName DisplayString,
rdbmsDbParamSubIndex INTEGER,
rdbmsDbParamID AutonomousType,
rdbmsDbParamCurrValue DisplayString,
rdbmsDbParamComment DisplayString
}
rdbmsDbParamName OBJECT-TYPE
SYNTAX DisplayString (SIZE (1..64))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The name of a configuration parameter for a database. This
name is product-specific. The length is limited to 64
characters to constrain the number of sub-identifiers needed
for instance identification (and to minimize network
traffic)."
::= { rdbmsDbParamEntry 1 }Last stop for this part is the config parameter table 🎀 rdbmsDbParamTable is where the database's configuration parameters live, and the description lays out some guidelines for what goes in there 💜 Parameters should be set by a human admin, configured per database, and then one of five cases applies: (a) non-numeric value, (b) numeric but only changes by human hand, (c) numeric and dynamic but the RDBMS doesn't track access or allocation failures for it, (d) numeric and dynamic with tracked failures that don't really hurt performance or availability, or (e) numeric and dynamic with tracked failures that do hurt performance or availability, which then show up in the rdbmsDbLimitedResource table 😭 Iykyk, it's a whole thing 👑
rdbmsDbParamEntry is one row per parameter, indexed by rdbmsDbIndex, rdbmsDbParamName, and rdbmsDbParamSubIndex 🧚 Single-value parameters get a subindex of one. If a parameter has a variable number of members, like DBA group users or database files, it has to be a set of rows. If it's a set of choices that's guaranteed to fit in 255 characters of a DisplayString, it can be a comma-separated list with subindex one instead. Zero can't be used as a subindex. Same deal as before with the actively opened thing: if it isn't actively opened, lookups can give noSuchName or noSuchInstance 🙈
rdbmsDbParamName is the not-accessible name of the parameter, product specific, and it's limited to 64 characters so the instance identifiers stay small and the network traffic stays low 🌸
Okay bestie, this part is all MIB definitions 💖 Everything below is copied exactly, so the code is still correct.
rdbmsDbParamSubIndex OBJECT-TYPE
SYNTAX INTEGER (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The subindex value for this parameter. If the parameter is
naturally considered to contain a variable number of members
of a class, e.g. members of the DBA user group, or files
which are part of the database, then it must be presented as
a set of rows. If, on the other hand, the parameter
represents a set of choices from a class, e.g. the
permissions on a file or the options chosen out of the set of
all options allowed, AND is guaranteed to always fit in the
255 character length of a DisplayString, then it may be
presented as a comma separated list with a subindex value of
one. Zero may not be used as a value."
::= { rdbmsDbParamEntry 2 }
rdbmsDbParamID OBJECT-TYPE
SYNTAX AutonomousType
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The ID of the parameter which may be described in some other
MIB (e.g., an enterprise-specific MIB module). If there is
no ID for this rdbmsDbParamName, attempts to access this
object will return noSuchName (SNMPv1) or noSuchInstance
(SNMPv2)."
::= { rdbmsDbParamEntry 3 }
rdbmsDbParamCurrValue OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The value for a configuration parameter now in effect, the
actual setting for the database. While there may multiple
values in the temporal domain of interest (for instance, the
value to take effect at the next restart), this is the
current setting.
Note that a compliant agent does not need to
allow write access to this object."
::= { rdbmsDbParamEntry 4 }
rdbmsDbParamComment OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Annotation which describes the purpose of a configuration
parameter or the reason for a particular parameter's
setting.
Note that a compliant agent does not need to
allow write access to this object."
::= { rdbmsDbParamEntry 5 }
----------------------------------------------------------------
rdbmsDbLimitedResourceTable OBJECT-TYPE
SYNTAX SEQUENCE OF RdbmsDbLimitedResourceEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table of limited resources that are kept per-database."
::= { rdbmsObjects 4 }
rdbmsDbLimitedResourceEntry OBJECT-TYPE
SYNTAX RdbmsDbLimitedResourceEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry for a single limited resource kept per-database.
A limited resource has maximum use determined by a parameter
that might or might not be changeable at run time, or visible
in the rdbmsDbParamTable. Examples would be the number of
available locks, or disk space on a partition. Arrays of
resources are supported through an integer sub index, which
should have the value of one for single-instance names.
Limited resources that are shared across databases, are best
put in the rdbmsSvrLimitedResourceTable instead of this one.
If the database is not actively opened, then attempts to
access corresponding instances in this table may result in
either noSuchName (SNMPv1) or noSuchInstance (SNMPv2).
'Actively opened' means at least one of the rdbmsRelState
entries for this database in the rdbmsRelTable is active(2)."
INDEX { rdbmsDbIndex, rdbmsDbLimitedResourceName }
::= { rdbmsDbLimitedResourceTable 1 }
RdbmsDbLimitedResourceEntry ::=
SEQUENCE {
rdbmsDbLimitedResourceName DisplayString,
rdbmsDbLimitedResourceID AutonomousType,
rdbmsDbLimitedResourceLimit INTEGER,
rdbmsDbLimitedResourceCurrent INTEGER,
rdbmsDbLimitedResourceHighwater INTEGER,
rdbmsDbLimitedResourceFailures Counter32,
rdbmsDbLimitedResourceDescription DisplayString
}
rdbmsDbLimitedResourceName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The name of the resource, for instance 'global locks' or
'locks for the FOO database', or 'data space on /dev/rdsk/5s0
for FOO'. The length is limited to 64 characters to constrain
the number of sub-identifiers needed for instance
identification (and to minimize network traffic)."
::= { rdbmsDbLimitedResourceEntry 1 }
rdbmsDbLimitedResourceID OBJECT-TYPE
SYNTAX AutonomousType
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The ID of the resource which may be described in some other
MIB (e.g., an enterprise-specific MIB module). If there is
no ID for this rdbmsDbLimitedResourceName, attempts to access
this object will return noSuchName (SNMPv1) or noSuchInstance
(SNMPv2)."
::= { rdbmsDbLimitedResourceEntry 2 }
rdbmsDbLimitedResourceLimit OBJECT-TYPE
SYNTAX INTEGER (1..2147483647)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The maximum value the resource use may attain.
Note that a compliant agent does not need to
allow write access to this object."
::= { rdbmsDbLimitedResourceEntry 3 }
rdbmsDbLimitedResourceCurrent OBJECT-TYPE
SYNTAX INTEGER (1..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The current value for the resource."
::= { rdbmsDbLimitedResourceEntry 4 }
rdbmsDbLimitedResourceHighwater OBJECT-TYPE
SYNTAX INTEGER (1..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The maximum value of the resource seen since applUpTime
was reset for the earliest server which has the database
actively opened.
If there are two servers with the database open, and the
oldest one dies, the proper way to invalidate the value is by
resetting sysUpTime."
::= { rdbmsDbLimitedResourceEntry 5 }
rdbmsDbLimitedResourceFailures OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times the system wanted to exceed the limit of
the resource since applUpTime was reset for the earliest
server which has the database actively opened.
If there are two servers with the DB open, and the
oldest one dies, the proper way to invalidate the value is by
resetting sysUpTime."
::= { rdbmsDbLimitedResourceEntry 6 }
rdbmsDbLimitedResourceDescription OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"A description of the resource and the meaning of the integer
units used for Limit, Current, and Highwater.
Note that a compliant agent does not need to
allow write access to this object."
::= { rdbmsDbLimitedResourceEntry 7 }
----------------------------------------------------------------
rdbmsSrvTable OBJECT-TYPE
SYNTAX SEQUENCE OF RdbmsSrvEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table of database servers running or installed
on a system."
::= { rdbmsObjects 5 }
rdbmsSrvEntry OBJECT-TYPE
SYNTAX RdbmsSrvEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry for a single database server. A server is an
independent entity that provides access to one or more
databases. Failure of one does not affect access to
databases through any other servers. There might be one or
more servers providing access to a database. A server may be
a 'process' or collection of 'processes', as interpreted by
the product."
INDEX { applIndex }
::= { rdbmsSrvTable 1 }
RdbmsSrvEntry ::=
SEQUENCE {
rdbmsSrvPrivateMibOID OBJECT IDENTIFIER,
rdbmsSrvVendorName DisplayString,
rdbmsSrvProductName DisplayString,
rdbmsSrvContact DisplayString
}
rdbmsSrvPrivateMibOID OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The authoritative identification for the private MIB for this
server, presumably based on the vendor, e.g., { enterprises
111 <optional subidentifiers>} for Oracle servers, {
enterprises 757 <optional subidentifiers>} for Ingres
servers, { enterprises 897 <optional subidentifiers>} for
Sybase servers, etc.
If no OBJECT IDENTIFIER exists for the private MIB, attempts
to access this object will return noSuchName (SNMPv1)
or noSuchInstance (SNMPv2)."
::= { rdbmsSrvEntry 1 }
rdbmsSrvVendorName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The name of the vendor whose RDBMS manages this database,
for informational purposes."
::= { rdbmsSrvEntry 2 }
rdbmsSrvProductName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The product name of this server. This is normally the
vendor's formal name for the product, in product specific
format."
::= { rdbmsSrvEntry 3 }
rdbmsSrvContact OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The textual identification of the contact person for this
managed server, together with information on how to contact
this person.
Note: if there is no active server associated with this
object, an agent may need to keep this in other persistent
storage, e.g., a configuration file.
Note that a compliant agent does not need to
allow write access to this object."
::= { rdbmsSrvEntry 4 }
----------------------------------------------------------------
rdbmsSrvInfoTable OBJECT-TYPE
SYNTAX SEQUENCE OF RdbmsSrvInfoEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table of additional information about database servers.
Entries in this table correspond to applications in the
APPLICATION-MIB applTable. Some objects in that table are
application-specific. When they are associated with an RDBMS
server in this table, the objects have the following
meanings.
applName - The name of this server, i.e., the process or
group of processes providing access to this database. The
exact format will be product and host specific." applVersion - The version number of this server, in product
specific format.
applOperStatus - up(1) means operational and available for
general use. down(2) means the server is not available for
use, but is known to the agent. The other states have broad
meaning, and may need to be supplemented by the vendor
private MIB. Halted(3) implies an administrative state of
unavailability. Congested(4) implies a resource or or
administrative limit is prohibiting new inbound associations.
The 'available soon' description of restarting(5) may include
an indeterminate amount of recovery.
applLastChange is the time the agent noticed the most recent
change to applOperStatus.
applInboundAssociation is the number of currently active
local and remote conversations (usually SQL connects).
applOutboundAssociations is not provided by this MIB.
applAccumulatedInboundAssociations is the total number of
local and remote conversations started since the server came
up.
applAccumulatedOutbound associations is not provided by this
MIB.
applLastInboundActivity is the time the most recent local or
remote conversation was attempted or disconnected.
applLastOutboundActivity is not provided by this MIB.
applRejectedInboundAssociations is the number of local or
remote conversations rejected by the server for
administrative reasons or because of resource limitations.
applFailedOutboundAssociations is not provided by this MIB."
::= { rdbmsObjects 6 }okay so this is the part where the MIB spills all the tea on the server's status 💅 applVersion tells you the version, and applOperStatus is the big one 🔥 up(1) means it's living its best life and available, down(2) means it's out but the agent still knows it exists, and halted(3), congested(4) and restarting(5) each have their own vibe 🫶
Also the association counters are giving main character energy ✨ applInboundAssociation is the currently active stuff, applAccumulatedInboundAssociations is the running total since the server came up, and the rejected ones are the ones that got turned away 🙈 Outbound stuff is marked as not provided by this MIB, so that's a hard pass 💀
rdbmsSrvInfoEntry OBJECT-TYPE
SYNTAX RdbmsSrvInfoEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Information that must be present for a single 'up' database
server, with visibility determined by the value of the
corresponding applOperStatus object. If an instance of
applOperStatus is not up(1), then attempts to access
corresponding instances in this table may result in either
noSuchName (SNMPv1) or noSuchInstance (SNMPv2) being returned
by the agent."
INDEX { applIndex }
::= { rdbmsSrvInfoTable 1 }
RdbmsSrvInfoEntry ::=
SEQUENCE {
rdbmsSrvInfoStartupTime DateAndTime,
rdbmsSrvInfoFinishedTransactions Gauge32,
rdbmsSrvInfoDiskReads Counter32,
rdbmsSrvInfoDiskWrites Counter32,
rdbmsSrvInfoLogicalReads Counter32,
rdbmsSrvInfoLogicalWrites Counter32,
rdbmsSrvInfoPageWrites Counter32,
rdbmsSrvInfoPageReads Counter32,
rdbmsSrvInfoDiskOutOfSpaces Counter32,
rdbmsSrvInfoHandledRequests Counter32,
rdbmsSrvInfoRequestRecvs Counter32,
rdbmsSrvInfoRequestSends Counter32,
rdbmsSrvInfoHighwaterInboundAssociations Gauge32,
rdbmsSrvInfoMaxInboundAssociations Gauge32
}rdbmsSrvInfoEntry is the row, and it only shows up for a server that's 'up' 🧚 It's indexed by applIndex, and if applOperStatus isn't up(1), poking at these rows can get you a noSuchName (SNMPv1) or noSuchInstance (SNMPv2) back, which is the MIB basically saying "not right now, bestie" 🙈
Then the SEQUENCE lists every column, from the startup time (DateAndTime) to the counters (Counter32) and the highwater and max association numbers (Gauge32) 🎀
rdbmsSrvInfoStartupTime OBJECT-TYPE
SYNTAX DateAndTime
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The date and time at which this server was last started."
::= { rdbmsSrvInfoEntry 1 }
rdbmsSrvInfoFinishedTransactions OBJECT-TYPE
SYNTAX Gauge32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of transactions visible to this server that have
been completed by either commit or abort. Some database
operations, such as read-only queries, may not result in the
creation of a transaction."
::= { rdbmsSrvInfoEntry 2 }
rdbmsSrvInfoDiskReads OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number of reads of database files issued to the
operating system by this server since startup. Numbers are
not comparable between products. What constitutes a
readand how it is accounted is product-specific."
::= { rdbmsSrvInfoEntry 3 }
rdbmsSrvInfoLogicalReads OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number of logical reads of database files made
internally by this server since startup. The values of this
object and those of rdbmsSrvInfoDiskReads reveal the effect
of caching on read operation. Numbers are not comparable
between products, and may only be meaningful when aggregated
across all servers sharing a common cache."
::= { rdbmsSrvInfoEntry 4 }
rdbmsSrvInfoDiskWrites OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number of writes to database files issued to the
operating system by this server since startup. Numbers are
not comparable between products."
::= { rdbmsSrvInfoEntry 5 }
rdbmsSrvInfoLogicalWrites OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number of times parts of the database files have
been marked 'dirty' and in need of writing to the disk. This
value and rdbmsSrvInfoDiskWrites give some indication of the
effect of 'write-behind' strategies in reducing the number of
disk writes compared to database operations. Because the
writes may be done by servers other than those marking the
parts of the database files dirty, these values may only be
meaningful when aggregated across all servers sharing a
common cache. Numbers are not comparable between products."
::= { rdbmsSrvInfoEntry 6 }
rdbmsSrvInfoPageReads OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number of pages in database files read by this
server since startup. 'Pages' are product specific units of
disk i/o operations. This value, along with
rdbmsSrvInfoDiskReads, reveals the effect of any grouping
read-ahead that may be used to enhance performance of some
queries, such as scans."
::= { rdbmsSrvInfoEntry 7}
rdbmsSrvInfoPageWrites OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number of pages in database files written by this
server since startup. Pages are product-specific units of
disk I/O. This value, with rdbmsSrvInfoDiskWrites, shows the
effect of write strategies that collapse logical writes of
contiguous pages into single calls to the operating system."
::= { rdbmsSrvInfoEntry 8 }ngl the disk and page counters are where the drama is 💅 Disk reads and writes count what the server asks the operating system for, and the logical ones count the internal stuff, so you can see how much caching is doing its thing ✨ Numbers aren't comparable between products, so don't go comparing your friend's database to yours 🙈
Pages are product-specific units of disk I/O, and the MIB even calls out read-ahead and write collapsing as things these counters can reveal 🧚
rdbmsSrvInfoDiskOutOfSpaces OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number of times the server has been unable to
obtain disk space that it wanted, since server startup. This
would be inspected by an agent on receipt of an
rdbmsOutOfSpace trap."
::= { rdbmsSrvInfoEntry 9 }
rdbmsSrvInfoHandledRequests OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number of requests made to the server on inbound
associations. The meaning of 'requests' is product specific,
and is not comparable between products.
This is intended to encapsulate high level semantic
operations between clients and servers, or between peers.
For instance, one request might correspond to a 'select' or
an 'insert' statement. It is not intended to capture disk
i/o described in rdbmsSrvInfoDiskReads and
rdbmsSrvInfoDiskWrites."
::= { rdbmsSrvInfoEntry 10 }
rdbmsSrvInfoRequestRecvs OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of receive operations made processing any requests
on inbound associations. The meaning of operations is product
specific, and is not comparable between products.
This is intended to capture lower-level i/o operations than
shown by HandledRequests, between clients and servers, or
between peers. For instance, it might roughly correspond to
the amount of data given with an 'insert' statement. It is
not intended to capture disk i/o described in
rdbmsSrvInfoDiskReads and rdbmsSrvInfoDiskWrites."
::= { rdbmsSrvInfoEntry 11 }
rdbmsSrvInfoRequestSends OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of send operations made processing requests
handled on inbound associations. The meaning of operations
is product specific, and is not comparable between products.
This is intended to capture lower-level i/o operations than
shown by HandledRequests, between between clients and
servers, or between peers. It might roughly correspond to
the number of rows returned by a 'select' statement. It is
not intended to capture disk i/o described in DiskReads."
::= { rdbmsSrvInfoEntry 12 }
rdbmsSrvInfoHighwaterInboundAssociations OBJECT-TYPE
SYNTAX Gauge32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The greatest number of inbound associations that have been
simultaneously open to this server since startup."
::= { rdbmsSrvInfoEntry 13 }
rdbmsSrvInfoMaxInboundAssociations OBJECT-TYPE
SYNTAX Gauge32
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The greatest number of inbound associations that can be
simultaneously open with this server. If there is no limit,
then the value should be zero.
Note that a compliant agent does not need to
allow write access to this object."
::= { rdbmsSrvInfoEntry 14 }
----------------------------------------------------------------okay so the server configuration parameters table is up next 💅 it's a whole guidelines situation, and the description text is literally a checklist for when a parameter belongs in here 🎀
rdbmsSrvParamTable OBJECT-TYPE
SYNTAX SEQUENCE OF RdbmsSrvParamEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table of configuration parameters for a server. Entries
should be populated according to the following guidelines:
(1) The value should be specified through administrative
(human) intervention.
(2) It should be configured on a per-server or a more global
basis, with duplicate entries for each server sharing
use of the parameter.
(3) One of the following is true:
(a) The parameter has a non-numeric value;
(b) The current value is numeric, but it only changes due
to human intervention;
(c) The current value is numeric and dynamic, but the
RDBMS does not track access/allocation failures
related to the parameter;
(d) The current value is numeric and dynamic, the
RDBMS tracks changes in access/allocation failures
related to the parameter, but the failure has no
significant impact on RDBMS performance or
availability.
(e) The current value is numeric and dynamic, the
RDBMS tracks changes in access/allocation failures
related to the parameter, the failure has
significant impact on RDBMS performance or
availability, and is shown in the
rdbmsSrvLimitedResource table."
::= { rdbmsObjects 7 }
rdbmsSrvParamEntry OBJECT-TYPE
SYNTAX RdbmsSrvParamEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry for a single configuration parameter for a server.
Parameters with single values have a subindex value of one.
If the parameter is naturally considered to contain a
variable number of members of a class, e.g. members of the
DBA user group, or tracepoints active in the server, then it
must be presented as a set of rows. If, on the other hand,
the parameter represents a set of choices from a class,
e.g. the permissions on a file or the options chosen out of
the set of all options allowed, AND is guaranteed to always
fit in the 255 character length of a DisplayString, then it
may be presented as a comma separated list with a subindex
value of one. Zero may not be used as a subindex value.
Entries for a server must be present if the value of the
corresponding applOperStatus object is up(1). If an instance
of applOperStatus is not up(1), then attempts to access
corresponding instances in this table may result in either
noSuchName (SNMPv1) or noSuchInstance (SNMPv2) being returned
by the agent."
INDEX { applIndex, rdbmsSrvParamName, rdbmsSrvParamSubIndex }
::= { rdbmsSrvParamTable 1 }
RdbmsSrvParamEntry ::=
SEQUENCE {
rdbmsSrvParamName DisplayString,
rdbmsSrvParamSubIndex INTEGER,
rdbmsSrvParamID AutonomousType,
rdbmsSrvParamCurrValue DisplayString,
rdbmsSrvParamComment DisplayString
}
rdbmsSrvParamName OBJECT-TYPE
SYNTAX DisplayString (SIZE (1..64))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The name of a configuration parameter for a server. This
name is product-specific. The length is limited to 64
characters to constrain the number of sub-identifiers needed
for instance identification (and to minimize network
traffic)."
::= { rdbmsSrvParamEntry 1 }
rdbmsSrvParamSubIndex OBJECT-TYPE
SYNTAX INTEGER (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The subindex value for this parameter. If the parameter is
naturally considered to contain a variable number of members
of a class, e.g. members of the DBA user group, or files
which are part of the database, then it must be presented as
a set of rows. If, on the other hand, the parameter
represents a set of choices from a class, e.g. the
permissions on a file or the options chosen out of the set of
all options allowed, AND is guaranteed to always fit in the
255 character length of a DisplayString, then it may be
presented as a comma separated list with a subindex value of
one. Zero may not be used as a value."
::= { rdbmsSrvParamEntry 2 }
rdbmsSrvParamID OBJECT-TYPE
SYNTAX AutonomousType
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The ID of the parameter which may be described in some
other MIB. If there is no ID for this rdbmsSrvParamName,
attempts to access this object will return noSuchName
(SNMPv1) or noSuchInstance (SNMPv2)."
::= { rdbmsSrvParamEntry 3 }
rdbmsSrvParamCurrValue OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The value for a configuration parameter now in effect, the
actual setting for the server. While there may multiple
values in the temporal domain of interest (for instance, the
value to take effect at the next restart), this is the
current setting.
Note that a compliant agent does not need to
allow write access to this object."
::= { rdbmsSrvParamEntry 4 }
rdbmsSrvParamComment OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Annotation which describes the purpose of a configuration
parameter or the reason for a particular parameter's
setting.
Note that a compliant agent does not need to
allow write access to this object."
::= { rdbmsSrvParamEntry 5 }
----------------------------------------------------------------
rdbmsSrvLimitedResourceTable OBJECT-TYPE
SYNTAX SEQUENCE OF RdbmsSrvLimitedResourceEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table of limited resources relevant to a server."
::= { rdbmsObjects 8 }
rdbmsSrvLimitedResourceEntry OBJECT-TYPE
SYNTAX RdbmsSrvLimitedResourceEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry for a single limited resource kept by the server.
A limited resource has maximum use determined by a parameter
that might or might not changeable at run time, or visible in
the rbmsSrvParamTable. Examples would be the number of
available locks, or number of concurrent executions allowed
in a server. Arrays of resources are supported through an
integer subindex, which should have the value of one for
single-instance names.
Limited resources that are shared across servers or databases
are best duplicated in this table across
all servers accessing the resource."
INDEX { applIndex, rdbmsSrvLimitedResourceName }
::= { rdbmsSrvLimitedResourceTable 1 }
RdbmsSrvLimitedResourceEntry ::=
SEQUENCE {
rdbmsSrvLimitedResourceName DisplayString,
rdbmsSrvLimitedResourceID AutonomousType,
rdbmsSrvLimitedResourceLimit INTEGER,
rdbmsSrvLimitedResourceCurrent INTEGER,
rdbmsSrvLimitedResourceHighwater INTEGER,
rdbmsSrvLimitedResourceFailures Counter32,
rdbmsSrvLimitedResourceDescription DisplayString
}
rdbmsSrvLimitedResourceName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The name of the resource, for instance 'threads' or
'semaphores', or 'buffer pages'"
::= { rdbmsSrvLimitedResourceEntry 1 }
rdbmsSrvLimitedResourceID OBJECT-TYPE
SYNTAX AutonomousType
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The ID of the resource which may be described in some other
MIB. If there is no ID for this rdbmsSrvLimitedResourceName,
attempts to access this object will return noSuchName
(SNMPv1) or noSuchInstance (SNMPv2)."
::= { rdbmsSrvLimitedResourceEntry 2 }
rdbmsSrvLimitedResourceLimit OBJECT-TYPE
SYNTAX INTEGER (1..2147483647)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The maximum value the resource use may attain.
Note that a compliant agent does not need to
allow write access to this object."
::= { rdbmsSrvLimitedResourceEntry 3 }
rdbmsSrvLimitedResourceCurrent OBJECT-TYPE
SYNTAX INTEGER (1..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The current value for the resource."
::= { rdbmsSrvLimitedResourceEntry 4 }
rdbmsSrvLimitedResourceHighwater OBJECT-TYPE
SYNTAX INTEGER (1..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The maximum value of the resource seen since applUpTime
was reset."
::= { rdbmsSrvLimitedResourceEntry 5 }
rdbmsSrvLimitedResourceFailures OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times the system wanted to exceed the limit of
the resource since applUpTime was reset."
::= { rdbmsSrvLimitedResourceEntry 6 }
rdbmsSrvLimitedResourceDescription OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"A description of the resource and the meaning of the integer
units used for Limit, Current, and Highwater.
Note that a compliant agent does not need to
allow write access to this object."
::= { rdbmsSrvLimitedResourceEntry 7 }
----------------------------------------------------------------
rdbmsRelTable OBJECT-TYPE
SYNTAX SEQUENCE OF RdbmsRelEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table relating databases and servers present on a host."
::= { rdbmsObjects 9 } rdbmsRelEntry OBJECT-TYPE
SYNTAX RdbmsRelEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry relating a single database server to a single
database to which it may provide access. The table is
indexed first by the index of rdbmsDbTable, and then
rdbmsSrvTable, so that all servers capable of providing
access to a given database may be found by SNMP traversal
operations (get-next and get-bulk). The makeup of this table
depends on the product's architecture, e.g. if it is one
server - many databases, then each server will appear n
times, where n is the number of databases it may access, and
each database will appear once. If the architecture is one
database - many servers, then each server will appear once
and each database will appear n times, where n is the number
of servers that may be accessing it."
INDEX { rdbmsDbIndex, applIndex }
::= { rdbmsRelTable 1 }
RdbmsRelEntry ::=
SEQUENCE {
rdbmsRelState INTEGER,
rdbmsRelActiveTime DateAndTime
}
rdbmsRelState OBJECT-TYPE
SYNTAX INTEGER{
other(1),
active(2),
available(3),
restricted(4),
unavailable(5)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The state of this server's access to this database.
Active(2) means the server is actively using the database.
Available(3) means the server could use the database if
necessary. Restricted(4) means the database is in some
administratively determined state of less-than-complete
availability. Unavailable(5) means the database is not
available through this server. Other(1) means the
database/server is in some other condition, possibly
described in the vendor private MIB."
::= { rdbmsRelEntry 1 }
rdbmsRelActiveTime OBJECT-TYPE
SYNTAX DateAndTime
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The time the database was made active by the server. If an
instance of rdbmsRelState is not active(1), then attempts to
access the corresponding instance of this object may result
in either noSuchName (SNMPv1) or noSuchInstance (SNMPv2)
being returned by the agent."
::= { rdbmsRelEntry 2 }Okay so this next bit is the well-known resources section, and it's giving organised 💅 These are the resources whose limits, high water marks, access or allocation failures, and current levels of use might be sitting in either the rdbmsDbLimitedResources or the rdbmsSrvLimitedResources tables 🧚
----------------------------------------------------------------
-- Well known resources for which limits, high water marks,
-- access or allocation failures, and current levels of use
-- are possibly available in either the rdbmsDbLimitedResources
-- or the rdbmsSrvLimitedResources tables.
rdbmsWellKnownLimitedResources OBJECT IDENTIFIER
::= { rdbmsObjects 10 }
rdbmsLogSpace OBJECT-IDENTITY
STATUS current
DESCRIPTION
"Storage allocated for redo and undo logs."
::= { rdbmsWellKnownLimitedResources 1}
----------------------------------------------------------------Now the traps, which are literally the main character moment of this whole MIB 📣 🦋
rdbmsTraps OBJECT IDENTIFIER ::= { rdbmsMIB 2 }
rdbmsStateChange NOTIFICATION-TYPE
OBJECTS { rdbmsRelState }
STATUS current
DESCRIPTION
"An rdbmsStateChange trap signifies that one of the database
server/databases managed by this agent has changed its
rdbmsRelState in a way that makes it less accessible for use.
For these purposes, both active(2) and available(3) are
considered fully accessible. The state sent with the trap is
the new, less accessible state."
::= { rdbmsTraps 1 }
rdbmsOutOfSpace NOTIFICATION-TYPE
OBJECTS { rdbmsSrvInfoDiskOutOfSpaces }
STATUS current
DESCRIPTION
"An rdbmsOutOfSpace trap signifies that one of the database
servers managed by this agent has been unable to allocate
space for one of the databases managed by this agent. Care
should be taken to avoid flooding the network with these
traps."
::= { rdbmsTraps 2 }
----------------------------------------------------------------Next up is the compliance information. Bestie, this is where the spec tells you what a system has to implement to count as a proper RDBMS MIB citizen 🎀
-- compliance information
rdbmsConformance OBJECT IDENTIFIER ::= { rdbmsMIB 3 }
rdbmsCompliances OBJECT IDENTIFIER ::= { rdbmsConformance 1 }
rdbmsGroups OBJECT IDENTIFIER ::= { rdbmsConformance 2 }
-- compliance statements
rdbmsCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statement for SNMP entities which
implement the RDBMS MIB"
MODULE HOST-RESOURCES-MIB
MANDATORY-GROUPS { hrSystem }
MODULE APPLICATION-MIB
MANDATORY-GROUPS { applGroup }
MODULE RDBMS-MIB
MANDATORY-GROUPS { rdbmsGroup }
GROUP rdbmsGroup
DESCRIPTION
"The rdbmsGroup is mandatory, but no write access
to objects is required for compliance."
OBJECT rdbmsDbContact
MIN-ACCESS read-only
DESCRIPTION
"A compliant system need not allow write-access to this
object."
OBJECT rdbmsDbParamCurrValue
MIN-ACCESS read-only
DESCRIPTION
"A compliant system need not allow write-access to this
object."
OBJECT rdbmsDbParamComment
MIN-ACCESS read-only
DESCRIPTION
"A compliant system need not allow write-access to this
object."
OBJECT rdbmsDbLimitedResourceLimit
MIN-ACCESS read-only
DESCRIPTION
"A compliant system need not allow write-access to this
object."
OBJECT rdbmsDbLimitedResourceDescription
MIN-ACCESS read-only
DESCRIPTION
"A compliant system need not allow write-access to this
object."
OBJECT rdbmsSrvContact
MIN-ACCESS read-only
DESCRIPTION
"A compliant system need not allow write-access to this
object."
OBJECT rdbmsSrvInfoMaxInboundAssociations
MIN-ACCESS read-only
DESCRIPTION
"A compliant system need not allow write-access to this
object."
OBJECT rdbmsSrvParamCurrValue
MIN-ACCESS read-only
DESCRIPTION
"A compliant system need not allow write-access to this
object."
OBJECT rdbmsSrvParamComment
MIN-ACCESS read-only
DESCRIPTION
"A compliant system need not allow write-access to this
object."
OBJECT rdbmsSrvLimitedResourceLimit
MIN-ACCESS read-only
DESCRIPTION
"A compliant system need not allow write-access to this
object."
OBJECT rdbmsSrvLimitedResourceDescription
MIN-ACCESS read-only
DESCRIPTION
"A compliant system need not allow write-access to this
object."
::= { rdbmsCompliances 1 }
-- units of conformance
-- rdbmsStateChange and rdbmsOutOfSpace traps are omitted
-- intentionally. They are not required or part of any
-- conformance group.
rdbmsGroup OBJECT-GROUP
OBJECTS {
rdbmsDbPrivateMibOID, rdbmsDbVendorName,
rdbmsDbName, rdbmsDbContact,
rdbmsDbInfoProductName, rdbmsDbInfoVersion,
rdbmsDbInfoSizeUnits, rdbmsDbInfoSizeAllocated,
rdbmsDbInfoSizeUsed, rdbmsDbInfoLastBackup,
rdbmsDbParamCurrValue, rdbmsDbParamComment,
rdbmsDbLimitedResourceLimit,
rdbmsDbLimitedResourceCurrent,
rdbmsDbLimitedResourceHighwater,
rdbmsDbLimitedResourceFailures,
rdbmsDbLimitedResourceDescription,
rdbmsSrvPrivateMibOID, rdbmsSrvVendorName,
rdbmsSrvProductName, rdbmsSrvContact,
rdbmsSrvInfoStartupTime,
rdbmsSrvInfoFinishedTransactions,
rdbmsSrvInfoDiskReads, rdbmsSrvInfoDiskWrites,
rdbmsSrvInfoLogicalReads, rdbmsSrvInfoLogicalWrites,
rdbmsSrvInfoPageReads, rdbmsSrvInfoPageWrites,
rdbmsSrvInfoHandledRequests,
rdbmsSrvInfoRequestRecvs, rdbmsSrvInfoRequestSends,
rdbmsSrvInfoHighwaterInboundAssociations,
rdbmsSrvInfoMaxInboundAssociations,
rdbmsSrvParamCurrValue, rdbmsSrvParamComment,
rdbmsSrvLimitedResourceLimit,
rdbmsSrvLimitedResourceCurrent,
rdbmsSrvLimitedResourceHighwater,
rdbmsSrvLimitedResourceFailures,
rdbmsSrvLimitedResourceDescription,
rdbmsRelState, rdbmsRelActiveTime }
STATUS current
DESCRIPTION
"A collection of objects providing basic instrumentation of an
RDBMS entity."
::= { rdbmsGroups 1 }
----------------------------------------------------------------
END5. Acknowledgements ✨
This document was produced by the IETF RDBMSMIB working group, and honestly the squad list is iconic 🫶 Everybody here helped make it happen, so give them all the flowers 🌸
Mark Allyn, Boeing
Virinder Batra, IBM
Jonathan Bauer DEC
Janice Befu, Network General
Gerard Berthet, Independence Technologies
Dave Brower, Ingres
Barry Bruins, Network General
David Campbell, Digital Equipment Corporation
Stephen Campbell, European Database Consulting
Jeff Case SNMP Research
Dave Crocker Silicon Graphics
Tony Daniel, Informix
Craig DeNoce, Sybase
Howard Dernehl, Ingres/Data General
Mike Hartstein, Oracle
Vijay Iyer, Independence Technologies
Britt Johnston, Progress
Bill Kehoe, Sybase
Deirdre Kostick, Bellcore
Cheryl Krupczak, Empire Technologies
Damien Lindauer, Microsoft
Ivan Lui, Informix
John McCormack, Tandem Computers Inc.
David Meldrum, Sybase
David Morandi, Red Brick Systems
Bob Natale, American Computer
Diana Parr, Gupta
David Perkins, Synoptics
Randy Presuhn, Peer Networks
Brian Promes, Novell
Bob Purvy, Oracle
Roger Reinsch, IBM
Marshall T. Rose, Dover Beach Consulting
Jon Saperia, DEC
Marc Sinykin, Oracle
Jay Smith, Oracle
Mike Sorsen, Edward D. Jones & Co.
Bob Taylor, Tandem
Maria Valls, IBM
Bert Wijnen, IBM
Stan Wong, IBM6. References 📚
Okay bestie, here's where the receipts live. Every reference the spec leans on, with all the details, so you can go check them yourself 🔍
- [1] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Structure of Management Information for version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1442, SNMP Research, Inc., Hughes LAN Systems, Dover Beach Consulting, Inc., Carnegie Mellon University, April 1993. 💜
- [2] McCloghrie, K., and M. Rose, "Management Information Base for Network Management of TCP/IP-based internets - MIB-II", STD 17, RFC 1213, Hughes LAN Systems, Performance Systems International, March 1991. 🌸
- [3] Galvin, J., and K. McCloghrie, "Administrative Model for version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1445, Trusted Information Systems, Hughes LAN Systems, April 1993. 🎀
- [4] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol Operations for version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1448, SNMP Research, Inc., Hughes LAN Systems, Dover Beach Consulting, Inc., Carnegie Mellon University, April 1993. 🦋
- [5] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Textual Conventions for version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1443, SNMP Research, Inc., Hughes LAN Systems, Dover Beach Consulting, Inc., Carnegie Mellon University, April 1993. ✨
- [6] Kille, S., WG Chair, and N. Freed, Editor, "The Network Services Monitoring MIB", RFC 1565, ISODE Consortium, Innosoft, January 1994. 🧚
7. Security Considerations 🔐
Okay so the tea here is short and sweet: security issues are not discussed in this memo. 🙈 That's it, that's the whole drama. If you're building on this, you'll need to look for security guidance somewhere else, bestie 💅
8. Authors' Addresses 💌
Meet the crew who made this happen 🫶
David Brower
The ASK Group, INGRES DBMS Development
1080 Marina Village Parkway
Alameda, CA, 94501
US
Phone: +1 510 748 3418
EMail: daveb@ingres.com
Bob Purvy
Oracle Corporation
500 Oracle Parkway
Redwood Shores, CA 94065
US
Phone: +1 415 506 2972
EMail: bpurvy@us.oracle.com
Anthony Daniel
Informix Software, Inc.
921 S.W. Washington Street
Portland, OR 97205
US
Phone: +1 503 221 2638
EMail: anthony@informix.com
Marc Sinykin
Oracle Corporation
400 Oracle Parkway
Redwood Shores, CA 94065
US
Phone: +1 415 506 2477
EMail: msinykin@us.oracle.com
Jay Smith
Oracle Corporation
400 Oracle Parkway
Redwood Shores, CA 94065
US
Phone: +1 415 506 6239
EMail: jaysmith@us.oracle.comThat's a wrap on RFC 1697! 🌈👑 Five authors, one SNMPv2 MIB, and a whole lot of slay ✨
📦 where this page comes from
- ietf: rfc1697 1994-08
- 💖 girlified by claude-haiku-5-5 on : a language model's rewrite of the original, under its terms