Default package

Get desktop application:
View/edit binary Protocol Buffers messages

Used in: PBDNSMessageList

• required PBDNSMessage.Type type = 1

  Type of event

• optional bytes messageId = 2

  UUID, shared by the query and the response

• optional bytes serverIdentity = 3

  ID of the server emitting the protobuf message

• optional PBDNSMessage.SocketFamily socketFamily = 4

• optional PBDNSMessage.SocketProtocol socketProtocol = 5

• optional bytes from = 6

  DNS requestor (client) as 4 (IPv4) or 16 (IPv6) raw bytes in network byte order

• optional bytes to = 7

  DNS responder (server) as 4 (IPv4) or 16 (IPv6) raw bytes in network byte order

• optional uint64 inBytes = 8

  Size of the query or response on the wire

• optional uint32 timeSec = 9

  Time of message reception (seconds since epoch)

• optional uint32 timeUsec = 10

  Time of message reception (additional micro-seconds)

• optional uint32 id = 11

  ID of the query/response as found in the DNS header

• optional PBDNSMessage.DNSQuestion question = 12

  DNS query received from client

• optional PBDNSMessage.DNSResponse response = 13

• optional bytes originalRequestorSubnet = 14

  EDNS Client Subnet value (4 or 16 raw bytes in network byte order)

• optional string requestorId = 15

  Username of the requestor

• optional bytes initialRequestId = 16

  UUID of the incoming query that initiated this outgoing query or incoming response

• optional bytes deviceId = 17

  Device ID of the requestor (could be mac address IP address or e.g. IMEI, format implementation dependent)

• optional bool newlyObservedDomain = 18

  True if the domain has not been seen before

• optional string deviceName = 19

  Device name of the requestor

• optional uint32 fromPort = 20

  Source port of the DNS query (client)

• optional uint32 toPort = 21

  Destination port of the DNS query (server)

• repeated PBDNSMessage.Meta meta = 22

  Arbitrary meta-data - to be used in future rather than adding new fields all the time

• repeated PBDNSMessage.Event trace = 23

• optional PBDNSMessage.HTTPVersion httpVersion = 24

  HTTP version used for DNS over HTTP

• optional uint64 workerId = 25

  Thread id

• optional bool packetCacheHit = 26

  Was it a packet cache hit?

• optional uint32 outgoingQueries = 27

  Number of outgoing queries used to answer the query

• optional uint32 headerFlags = 28

  Flags field in wire format, 16 bits used

• optional uint32 ednsVersion = 29

  EDNS version and flags in wire format, see https://www.rfc-editor.org/rfc/rfc6891.html#section-6.1.3

Used in: PBDNSMessage

• optional string qName = 1

  Fully qualified DNS name (with trailing dot)

• optional uint32 qType = 2

  https://www.iana.org/assignments/dns-parameters/dns-parameters.xhtml#dns-parameters-4

• optional uint32 qClass = 3

  Typically 1 (IN), see https://www.iana.org/assignments/dns-parameters/dns-parameters.xhtml#dns-parameters-2

Used in: PBDNSMessage

• optional uint32 rcode = 1

  DNS Response code, or 65536 for a network error including a timeout

• repeated DNSResponse.DNSRR rrs = 2

  DNS resource records in response

• optional string appliedPolicy = 3

  Filtering policy (RPZ or Lua) applied

• repeated string tags = 4

  Additional tags applied

• optional uint32 queryTimeSec = 5

  Time of the corresponding query reception (seconds since epoch)

• optional uint32 queryTimeUsec = 6

  Time of the corresponding query reception (additional micro-seconds)

• optional PolicyType appliedPolicyType = 7

  Type of the filtering policy (RPZ or Lua) applied

• optional string appliedPolicyTrigger = 8

  The RPZ trigger

• optional string appliedPolicyHit = 9

  The value (qname or IP) that caused the hit

• optional PolicyKind appliedPolicyKind = 10

  The Kind (RPZ action) applied by the hit

• optional VState validationState = 11

  The DNSSEC Validation State

See exportTypes in https://docs.powerdns.com/recursor/lua-config/protobuf.html#protobufServer for the list of supported resource record types.

Used in: DNSResponse

• optional string name = 1

  Fully qualified DNS name (with trailing dot)

• optional uint32 type = 2

  https://www.iana.org/assignments/dns-parameters/dns-parameters.xhtml#dns-parameters-4

• optional uint32 class = 3

  Typically 1 (IN), see https://www.iana.org/assignments/dns-parameters/dns-parameters.xhtml#dns-parameters-2

• optional uint32 ttl = 4

  TTL in seconds

• optional bytes rdata = 5

  raw address bytes in network byte order for A & AAAA; text representation for others, with fully qualified (trailing dot) domain names

• optional bool udr = 6

  True if this is the first time this RR has been seen for this question

Used in: PBDNSMessage

• required int64 ts = 1

  Timestamp in ns relative to time of creation of event trace data structure

• required EventType event = 2

  Type of event

• required bool start = 3

  true for "start" events, false for "completed" events

• optional bool boolVal = 4

  Below are optional values associated with events

• optional int64 intVal = 5

• optional string stringVal = 6

• optional bytes bytesVal = 7

• optional string custom = 8

  The name of the event for custom events

The well known EventTrace event numbers

Used in: Event

• CustomEvent = 0

  Range 0..99: Generic events

  A custom event

• ReqRecv = 1

  A request was received

• PCacheCheck = 2

  A packet cache check was initiated or completed; value: bool cacheHit

• AnswerSent = 3

  An answer was sent to the client

• SyncRes = 100

  Range 100: Recursor events

  Recursor Syncres main function has started or completed; value: int rcode

• LuaGetTag = 101

  Events below mark start or end of Lua hook calls; value: return value of hook

• LuaGetTagFFI = 102

• LuaIPFilter = 103

• LuaPreRPZ = 104

• LuaPreResolve = 105

• LuaPreOutQuery = 106

• LuaPostResolve = 107

• LuaNoData = 108

• LuaNXDomain = 109

• LuaPostResolveFFI = 110

Used in: PBDNSMessage

• HTTP1 = 1

  HTTP/1.1

• HTTP2 = 2

  HTTP/2

• HTTP3 = 3

  HTTP/3

Used in: PBDNSMessage

• required string key = 1

  MUST be unique, so if you have multiple values they must be aggregated into one Meta

• required MetaValue value = 2

Used in: Meta

• repeated string stringVal = 1

• repeated int64 intVal = 2

Used in: DNSResponse

• NoAction = 1

  No action taken

• Drop = 2

  https://tools.ietf.org/html/draft-vixie-dns-rpz-04 3.4

• NXDOMAIN = 3

  https://tools.ietf.org/html/draft-vixie-dns-rpz-04 3.1

• NODATA = 4

  https://tools.ietf.org/html/draft-vixie-dns-rpz-04 3.2

• Truncate = 5

  https://tools.ietf.org/html/draft-vixie-dns-rpz-04 3.5

• Custom = 6

  https://tools.ietf.org/html/draft-vixie-dns-rpz-04 3.6

Used in: DNSResponse

• UNKNOWN = 1

  No RPZ policy applied, or unknown type

• QNAME = 2

  Policy matched on the QName

• CLIENTIP = 3

  Policy matched on the client IP

• RESPONSEIP = 4

  Policy matched on one of the IPs contained in the answer

• NSDNAME = 5

  Policy matched on the name of one nameserver involved

• NSIP = 6

  Policy matched on the IP of one nameserver involved

Used in: PBDNSMessage

• INET = 1

  IPv4 (RFC 791)

• INET6 = 2

  IPv6 (RFC 2460)

Used in: PBDNSMessage

• UDP = 1

  User Datagram Protocol (RFC 768)

• TCP = 2

  Transmission Control Protocol (RFC 793)

• DOT = 3

  DNS over TLS (RFC 7858)

• DOH = 4

  DNS over HTTPS (RFC 8484)

• DNSCryptUDP = 5

  DNSCrypt over UDP (https://dnscrypt.info/protocol)

• DNSCryptTCP = 6

  DNSCrypt over TCP (https://dnscrypt.info/protocol)

• DOQ = 7

  DNS over QUIC (RFC 9250)

Used in: PBDNSMessage

• DNSQueryType = 1

  Query received by the service

• DNSResponseType = 2

  Response returned by the service

• DNSOutgoingQueryType = 3

  Query sent out by the service to a remote server

• DNSIncomingResponseType = 4

  Response returned by the remote server

Used in: DNSResponse

• Indeterminate = 1

• Insecure = 2

• Secure = 3

• BogusNoValidDNSKEY = 4

• BogusInvalidDenial = 5

• BogusUnableToGetDSs = 6

• BogusUnableToGetDNSKEYs = 7

• BogusSelfSignedDS = 8

• BogusNoRRSIG = 9

• BogusNoValidRRSIG = 10

• BogusMissingNegativeIndication = 11

• BogusSignatureNotYetValid = 12

• BogusSignatureExpired = 13

• BogusUnsupportedDNSKEYAlgo = 14

• BogusUnsupportedDSDigestType = 15

• BogusNoZoneKeyBitSet = 16

• BogusRevokedDNSKEY = 17

• BogusInvalidDNSKEYProtocol = 18

• repeated PBDNSMessage msg = 1