使用日志记录和监控
本页面介绍了 Cloud DNS 的日志记录和监控指标,包括 专用区域 和转发区域 。
使用 Cloud DNS 日志记录
Cloud DNS 日志记录功能会跟踪域名服务器为您的 Virtual Private Cloud (VPC) 网络的查询。
所记录的查询可能来自使用同一 VPC 网络的 Compute Engine 虚拟机 (VM) 实例、同一 VPC 网络中的 Google Kubernetes Engine 容器、对等互连区域 或入站 DNS 转发 。专用 DNS 区域、转发 DNS 区域、备用域名服务器、内部Trusted Cloud DNS 区域或外部 DNS 区域可能会最终解析查询。
日志记录归属于传输请求的网络 所属的项目。对于共享 VPC ,日志记录归属于宿主项目,因为宿主项目拥有该网络。
注意 :Cloud DNS 可能会使用缓存的响应来响应查询。默认情况下,系统不会记录缓存的响应。不过,如果启用了日志记录,则会在未记录日志的情况下,先记录至少一个之前的响应,然后再提供后续的缓存响应。
为专用代管区域启用和停用日志记录功能
使用 DNS 政策为您的网络启用或停用日志记录功能。启用查询日志记录时,系统会记录对 Cloud DNS 专用代管区域的每个 DNS 查询。
如需为为没有 DNS 政策的网络启用日志记录,请运行 dns policies create
命令。
gcloud
gcloud dns policies create POLICY_NAME \
--networks=NETWORK \
--enable-logging \
--description=DESCRIPTION
请替换以下内容:
POLICY_NAME
:DNS 政策的名称
NETWORK
:英文逗号分隔列表中的一个或多个网络
DESCRIPTION
:政策的说明
如需为具有 DNS 政策的网络启用日志记录,请运行 dns policies update
命令。
gcloud
gcloud dns policies update POLICY_NAME \
--networks=NETWORK \
--enable-logging
请替换以下内容:
POLICY_NAME
:DNS 政策的名称
NETWORK
:英文逗号分隔列表中的一个或多个网络
如需在保留政策的同时关闭日志记录,请运行 dns policies update
命令。
gcloud
gcloud dns policies update POLICY_NAME \
--networks=NETWORK \
--no-enable-logging
请替换以下内容:
POLICY_NAME
:DNS 政策的名称
NETWORK
:英文逗号分隔列表中的一个或多个网络
如需完全删除政策,请运行 dns policies delete
命令。
gcloud
gcloud dns policies delete POLICY_NAME \
将 POLICY_NAME
替换为您要删除的 DNS 政策的名称。
查看日志
您可以在 Trusted Cloud 控制台中查看日志。
控制台 在 Trusted Cloud 控制台中,前往 Logs Explorer 页面。
转到日志浏览器
如果适用,每个日志条目都包含以下字段。部分字段还与监控指标共享。
字段
字段类型
说明
用于指标中
alias_query_response_code
(预览版 )
字符串
从查询中返回的响应代码,用于解析 ALIAS 记录的规范名称
是
authAnswer
布尔值/DNS
权威应答,RFC 1035
否
destinationIP
字符串/目标
目标 IP 地址,仅适用于转发情况
否
egressError
字符串
出站流量代理错误,即从本地 DNS 服务器收到的出站流量代理报告的实际错误
此字段可用于区分由本地 DNS 返回的实际 SERVFAIL 与出站流量代理遇到的网络连接错误
否
healthyIps
字符串
ResourceRecordSet 中的一组 IP 地址,对于 Cloud DNS,这些地址在查询时已知处于 HEALTHY
状态
否
location
字符串
从中传送响应的Trusted Cloud 区域,例如 us-east1
是
project_id
字符串
从中接收查询的网络的Trusted Cloud 项目 ID
是
protocol
字符串/DNS
TCP
| UDP
否
queryName
字符串/DNS
DNS 查询名称,RFC 1035 4.1.2
否
queryType
字符串/DNS
DNS 查询类型,RFC 1035 4.1.2
否
responseCode
数字/DNS
响应代码,RFC 1035 4.1.1
否
rdata
字符串/DNS
演示格式的 DNS 应答,RFC 1035 5.1 ,截断为 260 个字节
否
sourceIP
字符串/来源
发起查询的 IP
否
sourceNetwork
字符串/来源
访问我们系统的查询的来源网络
否
source_type
字符串
查询的来源:inbound-forwarding
、gce-vm
、internet
、peering-zone
、fqdn-forwarding-target
否
target_name
字符串
目标名称,例如区域名称、政策名称、内部区域名称、外部域名
是
target_type
字符串
解析 DNS 查询的目标类型:private-zone
、forwarding-zone
、forwarding-policy
、peering-zone
、internal
、external
是
unHealthyIps
字符串
ResourceRecordSet 中的一组 IP 地址,对于 Cloud DNS,这些地址在查询时已知处于 UNHEALTHY
状态
否
vmInstanceId
号码/来源
Compute Engine 虚拟机实例 ID,仅适用于 Compute Engine 虚拟机发起的查询
否
vmInstanceName
字符串/来源
Compute Engine 虚拟机实例名称,仅适用于 Compute Engine 虚拟机发起的查询
否
vmProjectId
字符串/来源
从中发送查询的网络的Trusted Cloud 项目 ID,仅适用于 Compute Engine 虚拟机发起的查询
否
vmZoneName
字符串/来源
从中发送查询的虚拟机区域的名称,仅适用于 Compute Engine 虚拟机发起的查询
否
价格
所有 Cloud DNS 日志都会写入 Cloud Logging。Cloud DNS 不对此服务单独收费。但是,这些日志可能会产生额外的存储费用,具体取决于写入和存储的日志的大小。
为便于计算,您可以理解为 Cloud DNS 会写入大约 5 MB 的日志数据来处理 10000 个 DNS 查询。
如需了解 Cloud Logging 价格,请参阅 Google Cloud Observability 的价格:Cloud Logging 。
排查出站转发问题
如果您收到包含 SERVFAIL
且缺少某些字段(如 destinationIP
、egressIP
和egressError
)的日志,请参阅“问题排查”文档中的相关部分 。
监控指标
Cloud DNS 会将监控指标导出到 Cloud Monitoring 。
您可以监控指向专用区域、转发区域、政策转发、内部 Trusted Cloud 区域和互联网的 DNS 查询和响应的速率。 Trusted Cloud 控制台 Monitoring 页面 和 Cloud Monitoring API 中提供了 Monitoring。
专用 DNS 会导出包含 response_code
标签的 dns.googleapis.com/query/response_count
增量指标,以计算每个响应代码的查询数。
response_code
标签的类型为 string
,可能的值为:NOERROR
、FORMERR
、SERVFAIL
、NXDOMAIN
、NOTIMP
和 UNKNOWN
。如需了解这些代码的定义,请参阅 IANA DNS RCODEs 。
系统会使用日志记录格式 的适用字段,在 dns_query
资源类型下导出指标。
监控 DNS 传播
当您使用 Google Cloud CLI 或 REST API 进行更改时,更改最初会被标记为待处理,直到操作完成。您可以使用 gcloud CLI 或 REST API 检查更改状态或获取更改历史记录。
在 Cloud DNS 成功更新用于控制服务器的系统后,操作完成(状态:done
)。在更新所有域名服务器之前,可能仍然有延迟。
列出代管可用区的更改
如需列出托管式区域的更改,请运行 dns record-sets changes list
命令。
gcloud
gcloud dns record-sets changes list --zone=ZONE
将 ZONE
替换为您要管理其记录集的代管区域的名称。
验证 DNS 传播
如需监控和验证 DNS 域名服务器是否已提取取更改,您可以使用 watch
和 dig
命令。以下示例演示了如何查找域名服务器,以及如何查看代管区域的某个域名服务器何时获取了对 MX
记录的更改。
注意 :watch
和 dig
命令由 Linux 操作系统提供,不属于 gcloud
命令。因此,运行这两条命令时不需要 gcloud
前缀。对于其他操作系统,您可能必须安装这些命令。如需查找您的区域的域名服务器,请运行 dns managed-zones describe
命令:
gcloud
gcloud dns managed-zones describe ZONE_NAME
将 ZONE_NAME
替换为您的 Cloud DNS 区域的名称。
如需检查权威域名服务器上是否已有可用的记录,请运行以下 dig
命令:
gcloud
watch dig example.com in MX @ZONE_NAME_SERVER
将 ZONE_NAME_SERVER
替换为代管区域中的一个域名服务器:
默认情况下,watch
命令每 2 秒运行一次 dig
命令。您可以使用此命令来确定权威域名服务器何时拾取您的更改(应在 120 秒内执行此操作)。在权威域名服务器拾取更改后,DNS 解析器就可以开始拾取新记录。如果解析器已经缓存了之前的记录,则它会等到该记录的先前 TTL 值过期后再拾取新记录。
如需对系统的域名服务器运行 dig
,您可以从 dig
命令中移除 @<address>
。如果您想要监控传播到其他域名服务器的情况,可以将 address
更改为指向其他域名服务器。
后续步骤
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可 获得了许可,并且代码示例已根据 Apache 2.0 许可 获得了许可。有关详情,请参阅 Google 开发者网站政策 。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-09-18。