summaryrefslogtreecommitdiffstats
path: root/DNSDIST-MIB.txt
diff options
context:
space:
mode:
Diffstat (limited to 'DNSDIST-MIB.txt')
-rw-r--r--DNSDIST-MIB.txt743
1 files changed, 743 insertions, 0 deletions
diff --git a/DNSDIST-MIB.txt b/DNSDIST-MIB.txt
new file mode 100644
index 0000000..d6f5a92
--- /dev/null
+++ b/DNSDIST-MIB.txt
@@ -0,0 +1,743 @@
+-- -*- snmpv2 -*-
+-- ----------------------------------------------------------------------
+-- MIB file for dnsdist
+-- ----------------------------------------------------------------------
+
+DNSDIST-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+ OBJECT-TYPE, MODULE-IDENTITY, enterprises,
+ Counter64, Unsigned32, NOTIFICATION-TYPE
+ FROM SNMPv2-SMI
+ CounterBasedGauge64
+ FROM HCNUM-TC
+ Float64TC
+ FROM FLOAT-TC-MIB
+ OBJECT-GROUP, MODULE-COMPLIANCE, NOTIFICATION-GROUP
+ FROM SNMPv2-CONF
+ InetAddressType
+ FROM INET-ADDRESS-MIB
+ TEXTUAL-CONVENTION, DisplayString
+ FROM SNMPv2-TC;
+
+dnsdist MODULE-IDENTITY
+ LAST-UPDATED "201611080000Z"
+ ORGANIZATION "PowerDNS BV"
+ CONTACT-INFO "support@powerdns.com"
+ DESCRIPTION
+ "This MIB module describes information gathered through dnsdist."
+
+ REVISION "201611080000Z"
+ DESCRIPTION "Initial revision."
+
+ ::= { powerdns 3 }
+
+powerdns OBJECT IDENTIFIER ::= { enterprises 43315 }
+
+stats OBJECT IDENTIFIER ::= { dnsdist 1 }
+
+queries OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of queries received"
+ ::= { stats 1 }
+
+responses OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of responses received"
+ ::= { stats 2 }
+
+servfailResponses OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of servfail responses received"
+ ::= { stats 3 }
+
+aclDrops OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of queries dropped because of the ACL"
+ ::= { stats 4 }
+
+-- stats 5 was a BlockFilter Counter, removed in 1.2.0
+
+ruleDrop OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of queries dropped because of a rule"
+ ::= { stats 6 }
+
+ruleNXDomain OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of NXDomain responses returned because of a rule"
+ ::= { stats 7 }
+
+ruleRefused OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of Refused responses returned because of a rule"
+ ::= { stats 8 }
+
+selfAnswered OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of self-answered responses"
+ ::= { stats 9 }
+
+downstreamTimeouts OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of downstream timeouts"
+ ::= { stats 10 }
+
+downstreamSendErrors OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of downstream send errors"
+ ::= { stats 11 }
+
+truncFailures OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of errors while truncating a response"
+ ::= { stats 12 }
+
+noPolicy OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of queries dropped because no server was available"
+ ::= { stats 13 }
+
+latency01 OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of queries answered in less than 1 ms"
+ ::= { stats 14 }
+
+latency110 OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of queries answered in 1-10 ms"
+ ::= { stats 15 }
+
+latency1050 OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of queries answered in 10-50 ms"
+ ::= { stats 16 }
+
+latency50100 OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of queries answered in 50-100 ms"
+ ::= { stats 17 }
+
+latency1001000 OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of queries answered in 100-1000 ms"
+ ::= { stats 18 }
+
+latencySlow OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of queries answered in more than 1s"
+ ::= { stats 19 }
+
+latencyAVG100 OBJECT-TYPE
+ SYNTAX Float64TC
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Average latency over the last 100 queries"
+ ::= { stats 20 }
+
+latencyAVG1000 OBJECT-TYPE
+ SYNTAX Float64TC
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Average latency over the last 1000 queries"
+ ::= { stats 21 }
+
+latencyAVG10000 OBJECT-TYPE
+ SYNTAX Float64TC
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Average latency over the last 10000 queries"
+ ::= { stats 22 }
+
+latencyAVG1000000 OBJECT-TYPE
+ SYNTAX Float64TC
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Average latency over the last 1000000 queries"
+ ::= { stats 23 }
+
+uptime OBJECT-TYPE
+ SYNTAX CounterBasedGauge64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Uptime of the dnsdist process, in seconds"
+ ::= { stats 24 }
+
+realMemoryUsage OBJECT-TYPE
+ SYNTAX CounterBasedGauge64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Memory usage"
+ ::= { stats 25 }
+
+nonCompliantQueries OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of queries dropped as non-compliant"
+ ::= { stats 26 }
+
+nonCompliantResponses OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of responses dropped as non-compliant"
+ ::= { stats 27 }
+
+rdQueries OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of queries with the RD flag set"
+ ::= { stats 28 }
+
+emptyQueries OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of empty queries received"
+ ::= { stats 29 }
+
+cacheHits OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of cache hits"
+ ::= { stats 30 }
+
+cacheMisses OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of cache misses"
+ ::= { stats 31 }
+
+cpuUserMSec OBJECT-TYPE
+ SYNTAX CounterBasedGauge64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "CPU Usage (user)"
+ ::= { stats 32 }
+
+cpuSysMSec OBJECT-TYPE
+ SYNTAX CounterBasedGauge64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "CPU Usage (sys)"
+ ::= { stats 33 }
+
+fdUsage OBJECT-TYPE
+ SYNTAX CounterBasedGauge64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of file descriptors"
+ ::= { stats 34 }
+
+dynBlocked OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of queries dropped because of a dynamic block"
+ ::= { stats 35 }
+
+dynBlockNMGSize OBJECT-TYPE
+ SYNTAX CounterBasedGauge64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Dynamic blocks (NMG) size"
+ ::= { stats 36 }
+
+ruleServFail OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of ServFail responses returned because of a rule"
+ ::= { stats 37 }
+
+securityStatus OBJECT-TYPE
+ SYNTAX CounterBasedGauge64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Security status of this software. 0=unknown, 1=OK, 2=upgrade recommended, 3=upgrade mandatory"
+ ::= { stats 38 }
+
+specialMemoryUsage OBJECT-TYPE
+ SYNTAX CounterBasedGauge64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Memory usage (more precise but expensive to retrieve)"
+ ::= { stats 39 }
+
+ruleTruncated OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of Truncated responses returned because of a rule"
+ ::= { stats 40 }
+
+backendStatTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF BackendStatEntry
+ MAX-ACCESS not-accessible
+ STATUS current
+ DESCRIPTION "Statistics for backends"
+ ::= { dnsdist 2 }
+
+backendStatEntry OBJECT-TYPE
+ SYNTAX BackendStatEntry
+ MAX-ACCESS not-accessible
+ STATUS current
+ DESCRIPTION "Statistics for one backend"
+ INDEX { backendId }
+ ::= { backendStatTable 1 }
+
+BackendStatEntry ::= SEQUENCE {
+ backendId Unsigned32,
+ backendName DisplayString,
+ backendLatency CounterBasedGauge64,
+ backendWeight CounterBasedGauge64,
+ backendOutstanding CounterBasedGauge64,
+ backendQPSLimit CounterBasedGauge64,
+ backendReused Counter64,
+ backendState DisplayString,
+ backendAddress OCTET STRING,
+ backendPools DisplayString,
+ backendQPS CounterBasedGauge64,
+ backendQueries Counter64,
+ backendOrder CounterBasedGauge64
+}
+
+backendId OBJECT-TYPE
+ SYNTAX Unsigned32
+ MAX-ACCESS not-accessible
+ STATUS current
+ DESCRIPTION
+ "Backend ID"
+ ::= { backendStatEntry 1 }
+
+backendName OBJECT-TYPE
+ SYNTAX DisplayString
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Backend name"
+ ::= { backendStatEntry 2 }
+
+backendLatency OBJECT-TYPE
+ SYNTAX CounterBasedGauge64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Backend latency"
+ ::= { backendStatEntry 3 }
+
+backendWeight OBJECT-TYPE
+ SYNTAX CounterBasedGauge64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Backend weight"
+ ::= { backendStatEntry 4 }
+
+backendOutstanding OBJECT-TYPE
+ SYNTAX CounterBasedGauge64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Backend outstanding queries"
+ ::= { backendStatEntry 5 }
+
+backendQPSLimit OBJECT-TYPE
+ SYNTAX CounterBasedGauge64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Backend QPS limit"
+ ::= { backendStatEntry 6 }
+
+backendReused OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Backend reused slots"
+ ::= { backendStatEntry 7 }
+
+backendState OBJECT-TYPE
+ SYNTAX DisplayString
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Backend state"
+ ::= { backendStatEntry 8 }
+
+backendAddress OBJECT-TYPE
+ SYNTAX OCTET STRING (SIZE (2..24))
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Backend address"
+ ::= { backendStatEntry 9 }
+
+backendPools OBJECT-TYPE
+ SYNTAX DisplayString
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "List of pools this backend belongs to"
+ ::= { backendStatEntry 10 }
+
+backendQPS OBJECT-TYPE
+ SYNTAX CounterBasedGauge64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Backend QPS"
+ ::= { backendStatEntry 11 }
+
+backendQueries OBJECT-TYPE
+ SYNTAX Counter64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Number of queries sent to this backend"
+ ::= { backendStatEntry 12 }
+
+backendOrder OBJECT-TYPE
+ SYNTAX CounterBasedGauge64
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Backend order"
+ ::= { backendStatEntry 13 }
+
+---
+--- Textual Conventions
+---
+
+SocketProtocolType ::= TEXTUAL-CONVENTION
+ STATUS current
+ DESCRIPTION
+ "A value that represents a type of socket protocol."
+ SYNTAX INTEGER {
+ unknown(0),
+ udp(1),
+ tcp(2)
+ }
+
+DNSQueryType ::= TEXTUAL-CONVENTION
+ STATUS current
+ DESCRIPTION
+ "A value that represents a type of DNS query (question or response)."
+ SYNTAX INTEGER {
+ unknown(0),
+ question(1),
+ response(2)
+ }
+
+---
+--- Traps / Notifications
+---
+
+trap OBJECT IDENTIFIER ::= { dnsdist 10 }
+traps OBJECT IDENTIFIER ::= { trap 0 } --- reverse-mappable
+trapObjects OBJECT IDENTIFIER ::= { dnsdist 11 }
+
+socketFamily OBJECT-TYPE
+ SYNTAX InetAddressType
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Socket family type"
+ ::= { trapObjects 1 }
+
+socketProtocol OBJECT-TYPE
+ SYNTAX SocketProtocolType
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Socket protocol type"
+ ::= { trapObjects 2 }
+
+fromAddress OBJECT-TYPE
+ SYNTAX OCTET STRING (SIZE (2..24))
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Requestor address"
+ ::= { trapObjects 3 }
+
+toAddress OBJECT-TYPE
+ SYNTAX OCTET STRING (SIZE (2..24))
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Responder address"
+ ::= { trapObjects 4 }
+
+queryType OBJECT-TYPE
+ SYNTAX DNSQueryType
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Query / Response"
+ ::= { trapObjects 5 }
+
+querySize OBJECT-TYPE
+ SYNTAX Unsigned32
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Size in bytes"
+ ::= { trapObjects 6 }
+
+queryID OBJECT-TYPE
+ SYNTAX Unsigned32
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "DNS query ID"
+ ::= { trapObjects 7 }
+
+qName OBJECT-TYPE
+ SYNTAX OCTET STRING (SIZE (0..255))
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "DNS qname"
+ ::= { trapObjects 8 }
+
+qClass OBJECT-TYPE
+ SYNTAX Unsigned32
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "DNS query class"
+ ::= { trapObjects 9 }
+
+qType OBJECT-TYPE
+ SYNTAX Unsigned32
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "DNS query type"
+ ::= { trapObjects 10 }
+
+trapReason OBJECT-TYPE
+ SYNTAX OCTET STRING
+ MAX-ACCESS read-only
+ STATUS current
+ DESCRIPTION
+ "Reason for this trap"
+ ::= { trapObjects 11 }
+
+--- { trapObjects 5000 } up to and including { trapObjects 5999 } are reserved for local, product-specific extensions to the dnsdist MIB
+
+backendStatusChangeTrap NOTIFICATION-TYPE
+ OBJECTS {
+ backendName,
+ backendAddress,
+ backendState
+ }
+ STATUS current
+ DESCRIPTION "Backend status changed"
+ ::= { traps 1 }
+
+actionTrap NOTIFICATION-TYPE
+ OBJECTS {
+ socketFamily,
+ socketProtocol,
+ fromAddress,
+ toAddress,
+ queryType,
+ querySize,
+ queryID,
+ qName,
+ qClass,
+ qType,
+ trapReason
+ }
+ STATUS current
+ DESCRIPTION "Trap sent by SNMPTrapAction"
+ ::= { traps 2 }
+
+customTrap NOTIFICATION-TYPE
+ OBJECTS {
+ trapReason
+ }
+ STATUS current
+ DESCRIPTION "Trap sent by sendCustomTrap"
+ ::= { traps 3 }
+
+--- { traps 5000 } up to and including { traps 5999 } are reserved for local, product-specific extensions to the dnsdist MIB
+
+---
+--- Conformance
+---
+
+dnsdistConformance OBJECT IDENTIFIER ::= { dnsdist 100 }
+
+dnsdistCompliances MODULE-COMPLIANCE
+ STATUS current
+ DESCRIPTION "dnsdist compliance statement"
+ MODULE
+ MANDATORY-GROUPS {
+ dnsdistGroup,
+ dnsdistTrapsGroup
+ }
+ ::= { dnsdistConformance 1 }
+
+dnsdistGroup OBJECT-GROUP
+ OBJECTS {
+ queries,
+ responses,
+ servfailResponses,
+ aclDrops,
+ ruleDrop,
+ ruleNXDomain,
+ ruleRefused,
+ ruleServFail,
+ ruleTruncated,
+ selfAnswered,
+ downstreamTimeouts,
+ downstreamSendErrors,
+ truncFailures,
+ noPolicy,
+ latency01,
+ latency110,
+ latency1050,
+ latency50100,
+ latency1001000,
+ latencySlow,
+ latencyAVG100,
+ latencyAVG1000,
+ latencyAVG10000,
+ latencyAVG1000000,
+ uptime,
+ realMemoryUsage,
+ specialMemoryUsage,
+ nonCompliantQueries,
+ nonCompliantResponses,
+ rdQueries,
+ emptyQueries,
+ cacheHits,
+ cacheMisses,
+ cpuUserMSec,
+ cpuSysMSec,
+ fdUsage,
+ dynBlocked,
+ dynBlockNMGSize,
+ securityStatus,
+ backendName,
+ backendLatency,
+ backendWeight,
+ backendOutstanding,
+ backendQPSLimit,
+ backendReused,
+ backendState,
+ backendAddress,
+ backendPools,
+ backendQPS,
+ backendQueries,
+ backendOrder,
+ socketFamily,
+ socketProtocol,
+ fromAddress,
+ toAddress,
+ queryType,
+ querySize,
+ queryID,
+ qName,
+ qClass,
+ qType,
+ trapReason
+ }
+ STATUS current
+ DESCRIPTION "Objects conformance group for dnsdist"
+ ::= { dnsdistConformance 2 }
+
+dnsdistTrapsGroup NOTIFICATION-GROUP
+ NOTIFICATIONS {
+ actionTrap,
+ customTrap,
+ backendStatusChangeTrap
+ }
+ STATUS current
+ DESCRIPTION "Traps conformance group for dnsdist"
+ ::= { dnsdistConformance 3 }
+
+END