cartographer The Krupczak Organization, LLC. MIB objects contained in the Cartographer plugin. These MIB objects implement the dependency tracking tables and algorithms used by the Cartographer agent for distributed root cause analysis and network/system/application management. Schemas for the protocol and SMI can be found at http://xmlns.krupczak.org/ Bobby Krupczak, rdk@krupczak.org, http://www.krupczak.org/cartographer/ Fri May 3 17:28:52 EDT 2013 Wed May 1 11:08:36 EDT 2013 Sat Oct 13 20:11:33 EDT 2012 pluginVersion floatingPoint Version of this Cartographer plugin. Versions are typically floatingPoint values. get connectionDataVersion integer Cartographer project configuration files are encoded in XML and have a version number and, unless they are local-only, are distributed among peer agents using Cartographer's software updating facility. That way, configuration changes can be made globally across all agents. This MIB object tracks the version number of the connectiondata.xml config file. The agent periodically examines the config file and if a newer version is available, it is re-read by the agent. The agent also periodically compares this version number with its peers and downloads newer versions when available. get applicationDataVersion integer Cartographer project configuration files are encoded in XML and have a version number and, unless they are local-only, are distributed among peer agents using Cartographer's software updating facility. That way, configuration changes can be made globally across all agents. This MIB object tracks the version number of the appdata.xml config file. The agent periodically examines the config file and if a newer version is available, it is re-read by the agent. The agent also periodically compares this version number with its peers and downloads newer versions when available. get dependencyAgeOutInterval integer The interval, in seconds, after which dependencies will age out if they have not been re-validated. A dependency is re-validated if it is found, discovered, or observed again. get set peerAgeOutInterval integer The interval, in seconds, after which peers will age out if they have not been re-validated. A peer is re-validated if it has been determined to continue to utilize the same service or services from the same server as the agent implementing this MIB. get set cartographerConfigVersion integer Cartographer project configuration files are encoded in XML and have a version number and, unless they are local-only, are distributed among peer agents using Cartographer's software updating facility. That way, configuration changes can be made globally across all agents. This MIB object tracks the version number of the cartographer.xml config file. The agent periodically examines the config file and if a newer version is available, it is re-read by the agent. The agent also periodically compares this version number with its peers and downloads newer versions when available. get cartographerLocalConfigVersion integer Cartographer project configuration files are encoded in XML and have a version number and, unless they are local-only, are distributed among peer agents using Cartographer's software updating facility. This MIB object tracks the version number of the cartographer-local.xml config file. The agent periodically examines the config file and if a newer version is available, it is re-read by the agent. Since this configuration file is local-only, it is not automatically updated nor re-distributed. get subGraph displayString Each agent tracks/views a sub-graph of the global, distributed dependency graph. This object represents this agent's view or sub-graph and is base64 encoded graphML format. get numGraphNodes integer Number of nodes in this agent's sub-graph. get numGraphEdges integer Number of edges in thsi agent's sub-graph. get subGraphLastChange dateTime The date/time of the last change (add/remove) to this agent's sub-graph. get subGraphLastUpdate dateTime The date/time of the last update (add/remove/update) to this agent's sub-graph. get dependencyScanInterval integer The interval, in seconds, between iterations of the dependency discovery algorithm. get dependencyTable Table containing one entry per dependency that the underlying agent has discovered. This table only contains dependency to this system or dependencies that this system has to others. select dependType dependPeer dependArgs dependType dependencyTypeType The type of dependency as defined by enumerated integer. get dependLastUpdate displayString The date/time this dependency was last discovered or re-validated. get dependArgs displayString Dependency arguments/options. The args field is usually a space-separated list of keyword=value pairs. get dependSrc dependencySrcType The source of this dependency which indicates how the dependency was discovered. get dependReference dependencyReferenceType Whether the dependency is inbound or outbound as defined by enumerated integer. A dependency is transit if the underlying system is neither the client or server. get dependReachable extendedBoolean Is this dependency peer (client or server) reachable via ICMP? get dependReachableTime dateTime The last time the dependency peer was successfully reached via ICMP. get dependPeer displayString The dependency peer for this entry. If the underlying system is the client, the then peer is the dependServer. If the underlying system is the server, then the peer is the dependClient. get dependClient displayString The client hostname or address for this dependency. get dependServer displayString The server hostname or address for this dependency. get dependCreateTime dateTime The date/time this dependency was first discovered and entry created within this table. get dependScore integer Health score for this dependency; the larger the value, the worse the "health" is. Health is calculated via a combination of ICMP delay and application/dependency-specific testing. get dependNumIcmp integer The number ICMP echo request sent to the dependency peer. get dependAvgIcmpRespTime integer Decaying average, in milliseconds, of the cumultative response times of all echo requests sent/received to/from the dependency peer. get dependMovingAvgIcmpRespTime integer Cumulative moving average, in milliseconds, of all ICMP echo request/replies sent/received to/from the dependency peer. get dependIcmpRespTime integer The response time, in milliseconds, of the last ICMP echo request/reply. Responses lost or dropped are counted as having taken 5 seconds. get dependIpVersion integer The version of the IP protocol over which this dependency is based. Current values for IP include 4 and 6. get processTable The process table contains one entry for each process running on the underlying system. select processPID processName processPID integer The unique identifier for this process. get processName displayString The name and command-line of the process. get processGID integer The group-identifier for this process. This field number supported on Windows. get processState displayString The operating-system specific state of this process. Processes can be sleeping, runnable, zombie, running, etc. depending on the unique flavor of the underlying operating system. get processRSS gauge The resident set size, in KBytes, of physical memory used by this process. get processSize gauge The size of the process, in KBytes, of virtual memory used by this process. get processHandleCount gauge The number of open handles owned by this process. Handles include sockets, files, devices, etc. get processThreadCount gauge The number of threads contained in and running within this process. get processCPUTime counter The total CPU time, in centi-seconds, consumed by this process. get processStartTime displayString The date/time this process was created. get processReads counter The number of read operations performed by this process which can include file and network. get processWrites counter The number of write operations performed by this process which can include file and network. get processReadBytes counter The number of bytes read by this process which can include file and network. get processWriteBytes counter The number of bytes written by this process which can include file and network. get processEndptTable This table contains endpoints of communication (e.g. TCP, UDP sockets) by process. Endpoints can be connected or unconnected. select processEndptPID processEndptProto processEndptState processEndptLocalAddress processEndptLocalPort processEndptRemAddress processEndptRemPort processEndptPID integer The process identifier (PID) for the process which owns this endpoint. get processEndptName displayString The name of the process which owns this endpoint. get processEndptProto integer The integer, corresponding to the IP header field proto, for the higher layer protocol that this endpoint is using. For example, UDP is 17, TCP is 6, Raw is 255, and ICMP is 1. get processEndptState integer The protocol-specific state of the endpoint. For example, if the endpoint is a TCP connection, the state corresponds to the TCP state of the endpoint. If UDP, the state corresponds to the UDP state. get processEndptLocalAddress ipAddress Either an IPv4 or IPv6 address of the local endpoint. get processEndptLocalPort integer The local protocol port number or 0 if no port has been assigned. get processEndptRemAddress ipAddress Either an IPv4 or IPv6 address of the remote endpoint. get processEndptRemPort integer The remote protocol port number or 0 if no port has been assigned. get totalSwap gauge Total swap space in KBytes contained by this system. get usedSwap gauge Used swap space in KBytes contained by this system. get freeSwap gauge Free swap space in KBytes contained by this system. get totalMem gauge Total random access memory (RAM) contained in this system in KBytes. get usedMem gauge RAM (in KBytes) used and/or allocated by the system. get freeMem gauge RAM (in KBytes) unused and/or un-allocated by the system. get loadAvg1Min floatingPoint The system's load average over the last one minute. The load average is decaying average of the length of the operating system run-queue. get loadAvg5Min floatingPoint The system's load average over the last five minutes. The load average is decaying average of the length of the operating system run-queue. get loadAvg15Min floatingPoint The system's load average over the last fifteen minutes. The load average is decaying average of the length of the operating system run-queue. get numberCPUs gauge Number of CPUs or cores contained in this system. CPUs may be online or offline as long as the operating system recognizes them. get kernelVers displayString The operating system kernel version which usually includes version number, build date/number, and CPU architecture. get numTCPEndpts gauge Total number of active TCP endpoints contained in this system. get numUDPEndpts gauge Total number of active UDP endpoints contained in this system. get numProcesses gauge Total number of processes in this system. get numHandles gauge Total number of handles allocated and active in this system. Handles include open files and communication endpoints. get numUsers gauge Total number of current users of the system. The value is somewhat system-dependent as it may include users logged into the system or those using resources. Typicall, however, the number represents users logged into the system. get numDependencies gauge Number of dependencies or entries in the dependency table. get numPeers gauge Number of peers this system knows about. A system is a peer if it utilizes the same service from same server as this system. This value also indicates the number of entries in the peer table. get numThreads gauge Total number active threads in the system including process and kernel threads. get diskReads counter Total disk reads over all the disks contained in the system. get diskReadKB counter Total KBs read from all the disks contained in the system. get diskWrites counter Total disk writes over all the disks contained in the system. get diskWriteKB counter Total KBs written to all the disks contained in the system. get systemTotalCpuUser counter Total number clock ticks spent, summed over all CPUs, in user mode. get systemTotalCpuIdle counter Total number clock ticks spent, summed over all CPUs, in idle mode. get systemTotalCpuKernel counter Total number clock ticks spent, summed over all CPUs, in kernel mode. get systemTotalCpuWait counter Total number clock ticks spent, summed over all CPUs, in wait mode. get virtualSystem extendedBoolean Is this system running within a virtual machine? get filesysTable Table containing an entry for each filesystem mounted by the underlying system. Filesystems can be local or remote. select mountpoint filesystem displayString The filesystem name (e.g /dev/sda1 or a Windows volume name) get mountpoint displayString The location that the filesystem is mounted (e.g. home or C:\). get fstype displayString The type of filesystem (e.g. NTFS, NFS, CDFS, ext4). get totalBlocks integer Total number of blocks of blockSize bytes in this filesystem. get usedBlocks integer Number of blocks in use or allocated in this filesystem. get freeBlocks integer Number of blocks free to be used or allocated in this filesystem. get availBlocks integer Some filesystems reserve blocks for root or administrator. Available blocks are those that are available to non-root users. get totalFiles integer Filesystems often contain a structure for tracking blocks allocated to files. This value represents the total number of file structures in this filesystem. get freeFiles integer The number of free file structures in this filesystem. get usedFiles integer The number of used or allocated file structures in this filesystem. get blockSize integer Size in bytes of a block in this filesystem. get percentUsedBlocks floatingPoint Percentage of blocks, in the filesystem, that are allocated and/or used. The value is calculated using the formula used / (used avail). get percentUsedFiles floatingPoint The percentage of file structures, in this filesystem, that are allocated and/or used. The value is calculated using the formula used / (used - avail). get availFiles integer The number of file structures available to non-root users. get cpuTable Table containing one entry per CPU or core contained in this system. select cpuNumber cpuNumber integer Index number of this CPU/core in the table. get cpuDescription displayString Description of this CPU/core. get cpuTotalUserPercent floatingPoint Running total of percentage of time this CPU has been in user mode since system boot. get cpuTotalIdlePercent floatingPoint Running total of percentage of time this CPU has been in idle mode since system boot. get cpuTotalKernelPercent floatingPoint Running total of percentage of time this CPU has been in kernel mode since system boot. get cpuTotalWaitPercent floatingPoint Running total of percentage of time this CPU has been in wait mode since system boot. get cpuIntervalUserPercent floatingPoint Percentage of time this CPU has been in user mode over the last interval. get cpuIntervalIdlePercent floatingPoint Percentage of time this CPU has been in idle mode over the last interval. get cpuIntervalKernelPercent floatingPoint Percentage of time this CPU has been in kernel mode over the last interval. get cpuIntervalWaitPercent floatingPoint Percentage of time this CPU has been in wait mode over the last interval. get cpuInterval integer The interval, in seconds, over which the interval CPU mode percentages were calculated. The interval is not a sliding one but rather discrete, consecutive intervals of time. get cpuTotalUser counter Raw counter of total ticks or time CPU has spent in user mode. Querying this value and the other raw counters allows the user to calculate CPU state percentages over arbitrary intervals of time. get cpuTotalIdle counter Raw counter of total ticks or time CPU has spent in idle mode. get cpuTotalKernel counter Raw counter of total ticks or time CPU has spent in kernel mode. get cpuTotalWait counter Raw counter of total ticks or time CPU has spent in wait mode. get peerTable A table containing known peers. A system is a peer if it utilizes the same service from same server as this system. select peerName peerDependType peerName displayString Hostname or IP address of the peer system. get peerServer displayString Hostname or IP address of the server which we share with peer. get peerDependType dependencyTypeType The type of service, we share with peer, that we utilize from server. get peerContactTime dateTime The date/time of the last peer contact. Agents periodically contact peers and exchange dependency information. This date/time represents the last successful XMP exchange with this peer. get peerReachable bool Is this peer reachable via ICMP echo or via XMP connection? True, false, or unknown. get peerReachableTime dateTime The date/time the last time this peer was reachable via ICMP echo. get logfileDependencyTable select lfDependType lfLogfile lfAddExpression lfRemExpression lfLogfile displayString The name of the logfile to scan. get lfDependType dependencyTypeType The type of dependency that this entry will match and add. get lfAddExpression displayString The remove regular expression used when searching for matches that would cause resulting dependencies to be added. get lfRemExpression displayString The remove regular expression used when searching for matches that would cause resulting dependencies to be removed. get lfDependClient displayString The dependency client used when entries are matched. It may be a hardcoded client name or a regular expression based on the matched string. get lfDependServer displayString The dependency server used when entries are matched. It may be a hardcoded server name or a regular expression based on the matched string. get lfDependArgs displayString Dependency arguments to be used when adding dependencies discovered via this entry. get lfScanInterval integer The interval, in seconds, between scans for this entry. get lfTimeout integer The timeout, in seconds, that dependencies discovered via this entry, will be automatically removed or pruned. If 0, dependencies will remain until they are explicitly removed. get lfLastScanTime dateTime Date/time of this entry's last file scan. get lfLastOffset integer The starting offset that this entry will scan next time it is processed. get lfNumberMatches integer Total number of matches for this entry which includes add and remove string matching. get lfLastMatch dateTime The date/time of the last match. get lfLastMatchOffset integer The file offset where the last match occurred. get lfLastMatchString displayString The last most recent string that matched this entry. get lfLastAddRemove integer Was the last match an add(1) or remove(0)? get lfLastUpdateTime dateTime The last date/time this entry was updated or modified. get lfNumberLines integer The number of logfile lines scanned so far by this entry. get lfDescription displayString A string describing the purpose or intent of this entry. get logfileMonitorTable Each entry in this table represents a logfile monitor which scan a logfile for a particular regular expression. When matches are made, events are sent and counters are updated. select lfmLogfile displayString The name of the logfile to scan. get lfmExpression displayString The regular expression that the logfile is scanned for. get lfmScanInterval integer The interval, in seconds, between scans for this entry. get lfmLastScanTime dateTime The date/time that this entry was last processed and logfile scanned. get lfmLastOffset integer The starting offset that this entry will scan next time it is processed. get lfmNumberMatches integer Total number of logfile matches made for this entry. get lfmLastMatchTime dateTime The date/time the last logfile match was made. get lfmLastMatchOffset integer The file offset containing the last matching string. get lfmLastMatchString displayString The last string to match this logfile monitor entry. get lfmLastUpdateTime dateTime The date/time of the last update to this entry. get lfmNumberLines integer The number of logfile lines scanned so far by this entry. get lfmDescription displayString A string describing the purpose or intent of this entry. get