dns_query_logs

Creates, updates, deletes, gets or lists a dns_query_logs resource.

Overview

Name	dns_query_logs
Type	Resource
Id	railway.observability.dns_query_logs

Fields

The following fields are returned by SELECT queries:

list

One row per DnsQueryLog. A single DNS query resolved for a service (one row per query, not aggregated).

Name	Datatype	Description
deployment_id	string	The deployment ID
deployment_instance_id	string	The deployment instance ID
service_id	string	The service ID that made the queries
answers	array	The IP addresses the name resolved to
cname_chain	array	Ordered CNAME targets the queried name aliased through before the final answer (empty when the response had no CNAME)
qname	string	The domain name that was looked up
qtype	string	The DNS record type queried (A, AAAA, TXT, ...)
queried_at	string	When the query was resolved (ISO timestamp)
query_zone	string	Whether the query targeted the internal zone or the public internet (external, internal)
rcode	string	The DNS response code (NOERROR, NXDOMAIN, SERVFAIL, ...) or synthetic TIMEOUT/ERROR when no upstream response was received

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	environment_id	after_date, after_limit, anchor_date, before_date, before_limit, deployment_instance_id, filter, service_id	Fetch individual DNS query logs for an environment. Backed by the Railway GraphQL query dnsQueryLogs.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
environment_id	string
after_date	string	Latest date to look for logs after the anchor.
after_limit	integer	Limit logs returned after the anchor.
anchor_date	string	Target date time to look for logs.
before_date	string	Oldest date to look for logs before the anchor.
before_limit	integer	Limit logs returned before the anchor.
deployment_instance_id	string	Filter by deployment instance / sandbox ID (optional).
filter	string	Filter expression (e.g., @rcode:NXDOMAIN @qtype:A @domain:example.com @status:failed). Prefix a term with - to exclude it; repeat a key to match any of its values.
service_id	string	Filter by service ID (optional).

SELECT examples

list

Fetch individual DNS query logs for an environment. Backed by the Railway GraphQL query dnsQueryLogs.

SELECT
deployment_id,
deployment_instance_id,
service_id,
answers,
cname_chain,
qname,
qtype,
queried_at,
query_zone,
rcode
FROM railway.observability.dns_query_logs
WHERE environment_id = '{{ environment_id }}' -- required
AND after_date = '{{ after_date }}'
AND after_limit = '{{ after_limit }}'
AND anchor_date = '{{ anchor_date }}'
AND before_date = '{{ before_date }}'
AND before_limit = '{{ before_limit }}'
AND deployment_instance_id = '{{ deployment_instance_id }}'
AND filter = '{{ filter }}'
AND service_id = '{{ service_id }}'
;