Gateway DNS
Gateway DNS
The descriptions below detail the fields available for gateway_dns.
AccountID
Type: string
Cloudflare account ID.
ApplicationID
Type: int
ID of the application the domain belongs to (for example, 1, 2). Set to 0 when no ApplicationID is matched.
ApplicationName
Type: string
Name of the application the domain belongs to (for example, ‘Cloudflare Dashboard’).
AuthoritativeNameServerIPs
Type: array[string]
The IPs of the authoritative nameservers that provided the answers, if any (for example [‘203.0.113.1’, ‘203.0.113.2’]).
CNAMECategoryIDs
Type: array[int]
ID or IDs of category that the intermediate cname domains belongs to (for example, [7,12,28,122,129,163]).
CNAMECategoryNames
Type: array[string]
Name or names of category that the intermediate cname domains belongs to (for example, [‘Photography’, ‘Weather’]).
CNAMEs
Type: array[string]
Resolved intermediate cname domains (for example, [‘alias.example.com’]).
CNAMEsReversed
Type: array[string]
Resolved intermediate cname domains in reverse (for example, [‘com.example.alias’]).
ColoCode
Type: string
The name of the colo that received the DNS query (for example, ‘SJC’, ‘MIA’, ‘IAD’).
ColoID
Type: int
The ID of the colo that received the DNS query (for example, 46, 72, 397).
CustomResolveDurationMs
Type: int
The time it took for the custom resolver to respond.
CustomResolverAddress
Type: string
IP and port combo used to resolve the custom dns resolver query, if any.
CustomResolverPolicyID
Type: string
Custom resolver policy UUID, if matched.
CustomResolverPolicyName
Type: string
Custom resolver policy name, if matched.
CustomResolverResponse
Type: string
Status of the custom resolver response.
Datetime
Type: int or string
The date and time the corresponding DNS request was made (for example, ‘2021-07-27T00:01:07Z’).
DeviceID
Type: string
UUID of the device where the HTTP request originated from (for example, ‘dad71818-0429-11ec-a0dc-000000000000’).
DeviceName
Type: string
The name of the device where the HTTP request originated from (for example, ‘Laptop MB810’).
DoHSubdomain
Type: string
The destination DoH subdomain the DNS query was made to.
DoTSubdomain
Type: string
The destination DoT subdomain the DNS query was made to.
DstIP
Type: string
The destination IP address the DNS query was made to (for example, ‘104.16.132.2290’).
DstPort
Type: int
The destination port used at the edge. The port changes based on the protocol used by the DNS query (for example, 0).
EDEErrors
Type: array[int]
List of returned Extended DNS Error Codes (for example, [2, 3]).
Type: string
Email used to authenticate the client (for example, ‘user@test.com’).
InitialCategoryIDs
Type: array[int]
ID or IDs of category that the queried domains belongs to (for example, [7,12,28,122,129,163]).
InitialCategoryNames
Type: array[string]
Name or names of category that the queried domains belongs to (for example, [‘Photography’, ‘Weather’]).
IsResponseCached
Type: bool
Response comes from cache or not.
Location
Type: string
Name of the location the DNS request is coming from. Location is created by the customer (for example, ‘Office NYC’).
LocationID
Type: string
UUID of the location the DNS request is coming from. Location is created by the customer (for example, ‘7bdc7a9c-81d3-4816-8e56-000000000000’).
MatchedCategoryIDs
Type: array[int]
ID or IDs of category that the domain was matched with the policy (for example, [7,12,28,122,129,163]).
MatchedCategoryNames
Type: array[string]
Name or names of category that the domain was matched with the policy (for example, [‘Photography’, ‘Weather’]).
MatchedIndicatorFeedIDs
Type: array[int]
ID or IDs of indicator feed(s) that the domain was matched with the policy (for example, [7,12]).
MatchedIndicatorFeedNames
Type: array[string]
Name or names of indicator feed(s) that the domain was matched with the policy (for example, [‘Vendor Malware Feed’, ‘Vendor CoC Feed’]).
Policy (deprecated)
Type: string
Name of the policy that was applied (if any) (for example, ‘7bdc7a9c-81d3-4816-8e56-de1acad3dec5’).
PolicyID
Type: string
ID of the policy/rule that was applied (if any).
PolicyName
Type: string
Name of the policy that was applied (if any).
Protocol
Type: string
The protocol used for the DNS query by the client (for example, ‘udp’).
QueryCategoryIDs
Type: array[int]
Union of all categories; Initial categories + Resolved IP categories + Cname intermediate categories
QueryCategoryNames
Type: array[string]
Union of all category names; Initial categories + Resolved IP categories + Cname intermediate categories
QueryID
Type: string
Globally unique identifier of the query.
QueryIndicatorFeedIDs
Type: array[int]
ID or IDs of indicator feed(s) that the domain belongs to (for example, [7,12,28]).
QueryIndicatorFeedNames
Type: array[string]
Name or names of indicator feed(s) that the domain belongs to (for example, [‘Vendor Malware Feed’, ‘Vendor CoC Feed’, ‘Vendor Phishing Feed’]).
QueryName
Type: string
The query name (for example, ‘example.com’). Cloudflare will surface ’.’ for root server queries in your logs.
QueryNameReversed
Type: string
Query name in reverse (for example, ‘com.example’). Cloudflare will surface ’.’ for root server queries in your logs.
QuerySize
Type: int
The size of the DNS request in bytes (for example, 151).
QueryType
Type: int
The type of DNS query (for example, 1, 28, 15, or 16).
QueryTypeName
Type: string
The type of DNS query (for example, ‘A’, ‘AAAA’, ‘MX’, or ‘TXT’).
RCode
Type: int
The return code sent back by the DNS resolver.
RData (deprecated)
Type: array[object]
The rdata objects (for example, [{"type":"5","data":"dns-packet-placeholder..."}]).
ResolvedIPCategoryIDs
Type: array[int]
ID or IDs of category that the ips in the response belongs to (for example, [7,12,28,122,129,163]).
ResolvedIPCategoryNames
Type: array[string]
Name or names of category that the ips in the response belongs to (for example, [‘Photography’, ‘Weather’]).
ResolvedIPContinentCodes
Type: array[string]
Continent code of each resolved IP, if any (for example [‘NA’, ‘EU’]).
ResolvedIPCountryCodes
Type: array[string]
Country code of each resolved IP, if any (for example [‘US’, ‘PT’]).
ResolvedIPs
Type: array[string]
The resolved IPs in the response, if any (for example [‘203.0.113.1’, ‘203.0.113.2’]).
ResolverDecision
Type: string
Result of the DNS query (for example, ‘overrideForSafeSearch’).
ResourceRecords
Type: array[object]
The rdata objects (for example, [{"type":"5","data":"dns-packet-placeholder..."}]).
ResourceRecordsJSON
Type: string
String that represents the JSON array with the returned resource records (for example, ”[{\“name\”: \“example.com\”, \“type\”: \“CNAME\”, \“class\”: \“IN\”, \“ttl\”: 3600, \“rdata\”: \“cname.example.com.\”}]”).
SrcIP
Type: string
The source IP address making the DNS query (for example, ‘104.16.132.229’).
SrcIPContinentCode
Type: string
Continent code of the source IP address making the DNS query (for example, ‘NA’).
SrcIPCountryCode
Type: string
Country code of the source IP address making the DNS query (for example, ‘US’).
SrcPort
Type: int
The port used by the client when they sent the DNS request (for example, 0).
TimeZone
Type: string
Time zone used to calculate the current time, if a matched rule was scheduled with it.
TimeZoneInferredMethod
Type: string
Method used to pick the time zone for the schedule (from rule/ from user ip/ from local time).
UserID
Type: string
User identity where the HTTP request originated from (for example, ‘00000000-0000-0000-0000-000000000000’).