查詢範例

本文提供建議的查詢,讓您能更輕鬆地使用 Google Cloud 控制台中的 Logs Explorer 找出重要記錄檔。列出的查詢是以記錄查詢語言編寫,可用於 Logs Explorer、Logging API 或指令列介面。

Logs Explorer 會使用布林運算式,指定專案中所有記錄項目的子集。您可以使用這些查詢,從特定記錄或記錄服務中選擇記錄項目,或選擇符合中繼資料或使用者定義欄位條件的記錄項目。

事前準備

請確認您具備正確的 Identity and Access Management 權限或角色,可使用 Logs Explorer 建構查詢。如要進一步瞭解必要的 IAM 權限,請參閱「 Google Cloud 控制台的權限」。

開始使用

  1. 前往 Google Cloud 控制台的 「Logs Explorer」頁面:

    前往「Logs Explorer」(記錄檔探索工具)

    如果您是使用搜尋列尋找這個頁面,請選取子標題為「Logging」的結果。

  2. 選取要查看記錄的 Google Cloud 專案或其他 Google Cloud資源。

使用範例查詢

如要套用下表中的查詢,請按一下運算式的 「Content Copy」(複製內容) 圖示,然後將複製的運算式貼到 Logs Explorer 查詢編輯器欄位中。

如果沒有看到查詢編輯器欄位,請啟用「Show query」(顯示查詢)。

查看查詢運算式後,按一下「Run query」(執行查詢)。「Query results」(查詢結果) 下方會列出符合查詢的記錄。

本頁稍後列出的部分查詢包含變數,您應將這些變數替換為有效值。例如,如果查詢包含 logName,則您提供的 PROJECT_ID 必須參照所選Google Cloud 專案,否則查詢將無法運作。

注意事項:

  • 如果查詢含有時間戳記,系統會停用日期範圍選取器,並使用時間戳記運算式做為日期範圍限制。如果查詢未使用時間戳記運算式,則會使用日期範圍選取器做為日期範圍限制。

  • 查詢長度不得超過 20,000 個字元。

  • Logging 查詢語言不區分大小寫,但規則運算式除外。

  • 您可以使用 log_id 函式,查詢含有 log_name 運算式的資料。舉例來說,運算式 log_name="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access" 與 log_id("cloudaudit.googleapis.com/data_access") 相同。如要進一步瞭解 log_id 函式,請參閱「Logging 查詢語言:函式」。

如需在 Google Cloud 控制台執行查詢的操作說明,請參閱「在 Logs Explorer 中建構查詢」。

以下各節會依 Google Cloud 服務將查詢分組。

Cloud SQL 查詢

查詢/篩選器名稱 運算式
Cloud SQL 稽核記錄
resource.type="cloudsql_database" AND
resource.labels.database_id="DATABASE_ID" AND
log_id("cloudaudit.googleapis.com/activity")
Cloud SQL 執行個體刪除記錄
resource.type="cloudsql_database" AND
resource.labels.database_id="PROJECT_ID:INSTANCE_ID" AND
protoPayload.methodName="cloudsql.instances.delete" 
Cloud SQL MySQL 錯誤記錄
resource.type="cloudsql_database" AND
log_id("cloudsql.googleapis.com/mysql.err")
Cloud SQL MySQL 資料庫
resource.type="cloudsql_database" AND
resource.labels.database_id="DATABASE_ID" AND
log_id("cloudsql.googleapis.com/mysql")
Cloud SQL Postgres 資料庫
resource.type="cloudsql_database" AND
resource.labels.database_id="DATABASE_ID" AND
log_id("cloudsql.googleapis.com/postgres.log")
Cloud SQL SQL Server 錯誤記錄
resource.type="cloudsql_database" AND
log_id("cloudsql.googleapis.com/sqlserver.err")
Cloud SQL SQL Server 資料庫
resource.type="cloudsql_database" AND
resource.labels.database_id="DATABASE_ID" AND
log_id("cloudsql.googleapis.com/sqlagent.out")

Cloud Storage 查詢

查詢/篩選器名稱 運算式
Cloud Storage bucket 記錄
resource.type="gcs_bucket" AND
resource.labels.bucket_name="BUCKET_NAME"
Cloud Storage bucket 稽核記錄
resource.type="gcs_bucket" AND
logName:"cloudaudit.googleapis.com" 
Cloud Storage bucket 建立記錄檔
resource.type="gcs_bucket" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.methodName="storage.buckets.create" 
Cloud Storage bucket 刪除記錄
resource.type="gcs_bucket" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.methodName="storage.buckets.delete" 
Cloud Storage bucket IAM 政策變更
resource.type="gcs_bucket" AND
resource.labels.bucket_name="BUCKET_NAME" AND
protoPayload.serviceName="storage.googleapis.com" AND
protoPayload.methodName="storage.setIamPermissions" 

Google Cloud Armor 查詢

查詢/篩選器名稱 運算式
Google Cloud Armor 安全性政策記錄
resource.type="http_load_balancer" AND
jsonPayload.enforcedSecurityPolicy.name="POLICY_NAME" 
Google Cloud Armor 後端安全性政策拒絕記錄
jsonPayload.enforcedSecurityPolicy.outcome="DENY" AND
jsonPayload.enforcedSecurityPolicy.name="BACKEND_POLICY_NAME" 
Google Cloud Armor 後端安全性政策允許記錄
jsonPayload.enforcedSecurityPolicy.outcome="ALLOW" AND
jsonPayload.enforcedSecurityPolicy.name="BACKEND_POLICY_NAME" 
Google Cloud Armor 邊緣安全性政策拒絕記錄
jsonPayload.enforcedEdgeSecurityPolicy.outcome="DENY" AND
jsonPayload.enforcedEdgeSecurityPolicy.name="EDGE_POLICY_NAME" 
Google Cloud Armor 邊緣安全性政策允許記錄
jsonPayload.enforcedEdgeSecurityPolicy.outcome="ALLOW" AND
jsonPayload.enforcedEdgeSecurityPolicy.name="EDGE_POLICY_NAME" 

Compute Engine 查詢

查詢/篩選器名稱 運算式
Compute Engine 管理員活動記錄
resource.type="gce_instance" AND
log_id("cloudaudit.googleapis.com/activity")
Compute Engine 防火牆規則刪除作業
resource.type="gce_firewall_rule" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.methodName:"firewalls.delete" 
Compute Engine VM 系統記錄
resource.type="gce_instance" AND
log_id("syslog") 
Compute Engine VM 驗證記錄
resource.type="gce_instance" AND
log_id("authlog") 
Compute Engine 主機錯誤
resource.type="gce_instance"
protoPayload.serviceName="compute.googleapis.com"
(protoPayload.methodName:"compute.instances.hostError"
OR
operation.producer:"compute.instances.hostError")
log_id("cloudaudit.googleapis.com/system_event")
resource.labels.instance_id="INSTANCE_ID"
 severity=INFO
    
Compute Engine 主機記憶體警告
resource.type="gce_instance" AND
protoPayload.serviceName="compute.googleapis.com" AND
(jsonPayload.methodName:"compute.instances.host_event_notify"
OR
operation.producer:"compute.instances.host_event_notify") AND
log_id("cloudaudit.googleapis.com/host_event_notify") AND
resource.labels.instance_id="INSTANCE_ID" AND
severity=CRITICAL
    
Compute Engine 主機已遷移
resource.type="gce_instance"
protoPayload.serviceName="compute.googleapis.com"
(protoPayload.methodName:
"compute.instances.migrateOnHostMaintenance"
OR
operation.producer:
"compute.instances.migrateOnHostMaintenance")
log_id("cloudaudit.googleapis.com/system_event")
resource.labels.instance_id="INSTANCE_ID"
severity=INFO 
Compute Engine VM 已終止/先占
resource.type="gce_instance"
protoPayload.methodName=~"compute\.instances\.(guestTerminate|preempted)"
log_id("cloudaudit.googleapis.com/system_event")
resource.labels.instance_id="INSTANCE_ID" 
無法建立臨時磁碟,因此 Compute Engine VM 已終止
resource.type="gce_instance"
protoPayload.serviceName="compute.googleapis.com"
(protoPayload.methodName="compute.instances.scratchDiskCreationFailed"
OR
operation.producer:
"compute.instances.scratchDiskCreationFailed")
log_id("cloudaudit.googleapis.com/system_event")
resource.labels.instance_id="INSTANCE_ID"
severity=INFO 
已建立 Compute Engine VM 執行個體
resource.type="gce_instance"
protoPayload.methodName:"compute.instances.insert"
log_id("cloudaudit.googleapis.com/activity")
protoPayload.request.name="INSTANCE_NAME" 
已刪除 Compute Engine VM 執行個體 (依名稱)
resource.type="gce_instance"
protoPayload.methodName:"compute.instances.delete"
log_id("cloudaudit.googleapis.com/activity")
protoPayload.resourceName:"INSTANCE_NAME" 
已刪除 Compute Engine VM 執行個體 (ID)
resource.type="gce_instance"
protoPayload.methodName:"compute.instances.delete"
log_id("cloudaudit.googleapis.com/activity")
resource.labels.instance_id="INSTANCE_ID" 
Compute Engine VM 執行個體已重新啟動
resource.type="gce_instance"
protoPayload.methodName=~"compute\.instances\.(
stop|reset|automaticRestart|guestTerminate|
instanceManagerHaltForRestart)"
(log_id("cloudaudit.googleapis.com/activity")
OR log_id("cloudaudit.googleapis.com/system_event"))
resource.labels.instance_id="INSTANCE_ID" 
Compute Engine Shielded VM 啟動完整性失敗
resource.type="gce_instance"
log_id("compute.googleapis.com/shielded_vm_integrity")
jsonPayload.earlyBootReportEvent.policyEvaluationPassed="false"
resource.labels.instance_id="INSTANCE_ID" 
Compute Engine VM 執行個體由客體 OS 停止
resource.type="gce_instance"
protoPayload.serviceName="compute.googleapis.com"
(protoPayload.methodName:"compute.instances.guestTerminate" OR
operation.producer:"compute.instances.guestTerminate")
log_id("cloudaudit.googleapis.com/system_event")
resource.labels.instance_id="INSTANCE_ID"
severity=INFO 
Compute Engine Shielded VM 啟動檔案遭到封鎖
resource.type="gce_instance"
log_id("serialconsole.googleapis.com/serial_port_1_output")
textPayload:"Security Violation"
resource.labels.instance_id="INSTANCE_ID" 
已建立 Persistent Disk
resource.type="gce_disk" AND
protoPayload.methodName:"compute.disks.insert" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.resourceName: "PERSISTENT_DISK_NAME"
在單一租戶節點中新增的節點
resource.type="gce_node_group"
log_id("cloudaudit.googleapis.com/activity")
protoPayload.methodName=~("compute.nodeGroups.addNodes"
OR "compute.nodeGroups.insert")
resource.labels.node_group_id="NODE_GROUP_ID"
severity=INFO
單一租戶節點中的自動調度資源事件
resource.type="gce_node_group"
log_id("cloudaudit.googleapis.com/system_event")
protoPayload.methodName=~("compute.nodeGroups.deleteNodes"
OR "compute.nodeGroups.addNodes")
resource.labels.node_group_id="NODE_GROUP_ID"
已手動建立快照
resource.type="gce_snapshot"
log_id("cloudaudit.googleapis.com/activity")
protoPayload.methodName:"compute.snapshots.insert"
protoPayload.resourceName:"SNAPSHOT_NAME"
已擷取排定的快照
resource.type="gce_disk"
log_id("cloudaudit.googleapis.com/system_event")
protoPayload.methodName="ScheduledSnapshots"
protoPayload.response.operationType="createSnapshot"
protoPayload.response.targetLink="PERSISTENT_DISK_NAME"
已建立快照排程
resource.type="gce_resource_policy"
log_id("cloudaudit.googleapis.com/activity")
protoPayload.methodName:"compute.resourcePolicies.insert"
protoPayload.request.name="SCHEDULE_NAME"
已附加快照排程
resource.type="gce_disk"
log_id("cloudaudit.googleapis.com/activity")
protoPayload.methodName:"compute.disks.addResourcePolicies"
protoPayload.request.resourcePolicys:"SCHEDULE_NAME"
protoPayload.resourceName:"PERSISTENT_DISK_NAME"
超過配額
resource.type="gce_instance"
protoPayload.methodName:"compute.instances.insert"
protoPayload.status.message:"QUOTA_EXCEEDED"
severity=ERROR
查詢執行個體群組中健康狀態不良的執行個體
resource.type="gce_instance_group"
resource.labels.instance_group_name="INSTANCE_GROUP_NAME"
jsonPayload.healthCheckProbeResult.healthState="UNHEALTHY"
以世界標準時間格式查詢特定時間範圍內的執行個體群組成員
resource.type="gce_instance_group_manager"
resource.labels.instance_group_manager_name="INSTANCE_GROUP_NAME"
jsonPayload.@type=
"type.googleapis.com/compute.InstanceGroupManagerEvent"
jsonPayload.instanceHealthStateChange.detailedHealthState="HEALTHY"
timestamp >= START_TIME timestamp <= END_TIME 
執行個體已新增至執行個體群組
resource.type="gce_instance_group"
protoPayload.methodName:"compute.instanceGroups.addInstances"
log_id("cloudaudit.googleapis.com/activity")
resource.labels.instance_group_name="INSTANCE_GROUP_NAME"
已從執行個體群組中移除執行個體
resource.type="gce_instance_group"
protoPayload.methodName:"compute.instanceGroups.removeInstances"
log_id("cloudaudit.googleapis.com/activity")
resource.labels.instance_group_name="INSTANCE_GROUP_NAME"
已設定或更新執行個體範本
resource.type="gce_instance_group_manager"
log_id("cloudaudit.googleapis.com/activity")
protoPayload.methodName=
"v1.compute.instanceGroupManagers.setInstanceTemplate"
resource.labels.instance_group_manager_name="INSTANCE_GROUP_MANAGER"
已刪除防火牆規則
resource.type="gce_firewall_rule"
log_id("cloudaudit.googleapis.com/activity")
protoPayload.methodName:"firewalls.delete"
防火牆記錄檔
resource.type="gce_subnetwork"
log_id("compute.googleapis.com/firewall")
jsonPayload.instance.vm_name="INSTANCE_NAME"

Google Cloud Observability 查詢

查詢/篩選器名稱 運算式
記錄檔接收器活動
resource.type="logging_sink" AND
log_id("cloudaudit.googleapis.com/activity")

Identity and Access Management 查詢

查詢/篩選器名稱 運算式
服務帳戶建立記錄
resource.type="service_account" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.methodName="google.iam.admin.v1.CreateServiceAccount" 
服務帳戶建立金鑰記錄
resource.type="service_account" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.methodName="google.iam.admin.v1.CreateServiceAccountKey" 
存取控管政策設定記錄檔
resource.type="project" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.methodName="SetIamPolicy" 
外部主體獲授予組織存取權
resource.type="project" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.@type="type.googleapis.com/google.cloud.audit.AuditLog" AND
protoPayload.request.@type:"IamPolicy" AND
protoPayload.serviceData.policyDelta.bindingDeltas.member:* AND NOT
protoPayload.serviceData.policyDelta.bindingDeltas.member:"@DOMAIN_NAME.com" 
建立、修改或刪除資源
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.methodName:("create" OR "delete" OR "update")
授予主體的角色
log_id("cloudaudit.googleapis.com/activity") AND
resource.type="project" AND
protoPayload.serviceName="cloudresourcemanager.googleapis.com" AND
protoPayload.methodName="SetIamPolicy" AND
protoPayload.serviceData.policyDelta.bindingDeltas.action="Add" AND
protoPayload.serviceData.policyDelta.bindingDeltas.member:"EMAIL_ID" 
已移除主體的角色
log_id("cloudaudit.googleapis.com/activity") AND
resource.type="project" AND
protoPayload.serviceName="cloudresourcemanager.googleapis.com" AND
protoPayload.methodName="SetIamPolicy" AND
protoPayload.serviceData.policyDelta.bindingDeltas.action="Remove" AND
protoPayload.serviceData.policyDelta.bindingDeltas.member:"EMAIL_ID" 
已更新自訂角色的權限
log_id("cloudaudit.googleapis.com/activity") AND
resource.type="iam_role" AND
protoPayload.serviceName="iam.googleapis.com" AND
protoPayload.methodName:"UpdateRole" AND
resource.labels.role_name:"ROLE_ID" 
建立、刪除或取消刪除專案
log_id("cloudaudit.googleapis.com/activity") AND
resource.type=("folder" OR "project") AND
protoPayload.serviceName="cloudresourcemanager.googleapis.com" AND
protoPayload.methodName=~"(Create|Delete|Undelete)Project" AND
resource.labels.project_id="PROJECT_ID" 
已強制執行組織政策限制
log_id("cloudaudit.googleapis.com/activity") AND
resource.type="audited_resource" AND
protoPayload.serviceName="orgpolicy.googleapis.com" AND
protoPayload.request.policy.name:"CONSTRAINT_NAME" AND
protoPayload.request.policy.spec.rules.enforce="true" 
組織政策模擬測試違規事項
(protoPayload.policyViolationInfo.orgPolicyViolationInfo:* OR
protoPayload.metadata.@type=
"type.googleapis.com/google.cloud.audit.OrgPolicyDryRunAuditMetadata") 

Kubernetes 相關查詢

如需管理員活動稽核記錄查詢的總覽和範例,請參閱 GKE 稽核記錄頁面提供的內容。

叢集層級查詢

查詢/篩選器名稱 運算式
Google Kubernetes Engine 叢集作業
resource.type="gke_cluster" AND
log_id("cloudaudit.googleapis.com/activity")
Google Kubernetes Engine 叢集建立作業
resource.type="gke_cluster" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.methodName="google.container.v1.ClusterManager.CreateCluster"
      
Kubernetes 叢集部署作業
resource.type="k8s_cluster" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.methodName:"deployments"
      
Kubernetes 叢集驗證失敗
resource.type="k8s_cluster" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.authenticationInfo.principalEmail="system:anonymous"
      
us-central1-b 中的 Kubernetes 叢集作業和事件
resource.type="k8s_cluster" AND
resource.labels.location="us-central1-b"
      
使用者提出的 Kubernetes Pod 要求
resource.type="k8s_cluster" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.methodName:"io.k8s.core.v1.pods" AND
protoPayload.authenticationInfo.principalEmail="USER_EMAIL"
      
Kubernetes 事件
resource.type="k8s_cluster" AND
log_id("events")
      
Kubernetes 端點更新
resource.type="k8s_cluster" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.request.kind="Endpoints"
      
Kubernetes 控制層記錄檔
resource.type="k8s_cluster" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.serviceName="k8s.io"
      
Kubernetes Engine 控制層記錄檔
resource.type="k8s_cluster" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.serviceName="container.googleapis.com"
      
刪除 Pod
resource.type="k8s_cluster" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.methodName=~"io\.k8s\.core\.v1\.pods\.(create|delete)"
      
控制層中的 Kubernetes Pod 稽核記錄
resource.type="k8s_cluster" AND
resource.labels.location="CLUSTER_LOCATION" AND
resource.labels.cluster_name="CLUSTER_NAME" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.resourceName="core/v1/namespaces/POD_NAMESPACE/pods/POD_NAME
      
撤銷 Kubernetes Pod
resource.type="k8s_cluster" AND
resource.labels.location="CLUSTER_LOCATION" AND
resource.labels.cluster_name="CLUSTER_NAME" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.methodName="io.k8s.core.v1.pods.eviction.create"
      
控制層中的 Kubernetes 節點稽核記錄
resource.type="k8s_cluster" AND
resource.labels.location="CLUSTER_LOCATION" AND
resource.labels.cluster_name="CLUSTER_NAME" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.methodName:"io.k8s.core.v1.nodes"
      
外掛程式管理工具活動的 Kubernetes 叢集控制層
resource.type="k8s_cluster" AND
resource.labels.location="CLUSTER_LOCATION" AND
resource.labels.cluster_name="CLUSTER_NAME" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.authenticationInfo.principalEmail="system:addon-manager"
      
Kubernetes 控制層錯誤 (不含 Conflict,這是正常現象)
resource.type="k8s_cluster" AND
resource.labels.location="CLUSTER_LOCATION" AND
resource.labels.cluster_name="CLUSTER_NAME" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.status.message!="Conflict" AND
protoPayload.status.code!=0
      
Ingress 控制器事件
resource.type="k8s_cluster" AND
resource.labels.location="CLUSTER_LOCATION" AND
resource.labels.cluster_name="CLUSTER_NAME" AND
log_id("events") AND
jsonPayload.source.component="loadbalancer-controller"
      
Service 控制器事件 (kube-controller-manager)
resource.type="k8s_cluster" AND
resource.labels.location="CLUSTER_LOCATION" AND
resource.labels.cluster_name="CLUSTER_NAME" AND
log_id("events") AND
jsonPayload.source.component="service-controller"
      
叢集自動配置器事件
resource.type="k8s_cluster" AND
resource.labels.location="CLUSTER_LOCATION" AND
resource.labels.cluster_name="CLUSTER_NAME" AND
log_id("events") AND
jsonPayload.source.component="cluster-autoscaler"
      

廣告連播層級查詢

篩選器名稱 運算式
在建立期間查詢 Pod
resource.type="k8s_pod" AND
resource.labels.pod_name="POD_NAME" AND
log_id("events")
      
查詢 Pod 因資源壓力而終止
resource.type="k8s_pod" AND
        log_id("events") AND
        jsonPayload.reason="Evicted"
      
排程器事件
resource.type="k8s_pod" AND
resource.labels.location="CLUSTER_LOCATION" AND
resource.labels.cluster_name="CLUSTER_NAME" AND
log_id("events") AND
jsonPayload.source.component="default-scheduler"
      
排程器事件 (搶占)
resource.type="k8s_pod" AND
resource.labels.location="CLUSTER_LOCATION" AND
resource.labels.cluster_name="CLUSTER_NAME" AND
log_id("events") AND
jsonPayload.source.component="default-scheduler" AND
jsonPayload.reason="Preempted"
      

節點層級查詢

篩選器名稱 運算式
節點事件
resource.type="k8s_node" AND
log_id("events")
      
查看 Kube-proxy 記錄
resource.type="k8s_node" AND
log_id("kube-proxy")
      
查看 dockerd 記錄
resource.type="k8s_node" AND
log_id("container-runtime")
      
查看 kubelet 錯誤或失敗
resource.type="k8s_node" AND
log_id("kubelet") AND
jsonPayload.MESSAGE:("error" OR "fail")
      
查看 GKE 系統記錄的節點記錄
resource.type = "k8s_node"
logName:( "logs/container-runtime" OR
"logs/docker" OR
"logs/kube-container-runtime-monitor" OR
"logs/kube-logrotate" OR
"logs/kube-node-configuration" OR
"logs/kube-node-installation" OR
"logs/kubelet" OR
"logs/kubelet-monitor" OR
"logs/node-journal" OR
"logs/node-problem-detector")
      

命名空間查詢

篩選器名稱 運算式
GKE 系統記錄的容器和 Pod 記錄
resource.type = ("k8s_container" OR "k8s_pod")
resource.labels.namespace_name = (
"cnrm-system" OR
"config-management-system" OR
"gatekeeper-system" OR
"gke-connect" OR
"gke-system" OR
"istio-system" OR
"knative-serving" OR
"monitoring-system" OR
"kube-system")
      

容器查詢

篩選器名稱 運算式
叢集中所有 Pod 和容器的 Stdout 容器記錄
resource.type="k8s_container" AND
log_id("stdout")
      
叢集中所有 Pod 和容器的容器錯誤記錄
resource.type="k8s_container" AND
log_id("stderr") AND
severity=ERROR
      
特定名稱 Pod 的容器錯誤記錄
resource.type="k8s_container" AND
resource.labels.pod_name="POD_NAME" AND
severity=ERROR
      
特定 Pod 中特定容器的容器錯誤記錄檔
resource.type="k8s_container" AND
resource.labels.pod_name="POD_NAME" AND
resource.labels.container_name="server" AND
severity=ERROR
      
特定命名空間和容器的容器錯誤記錄檔
resource.type="k8s_container" AND
resource.labels.namespace_name="istio-system" AND
resource.labels.container_name="egressgateway" AND
severity=ERROR
      
特定標籤 Pod 的容器記錄
resource.type="k8s_container" AND
labels."k8s-pod/app"="loadgenerator" AND
severity=ERROR
      
在特定節點上執行的 Pod 容器錯誤記錄檔
resource.type="k8s_container" AND
labels."compute.googleapis.com/resource_name"="NODE_NAME" AND
severity=ERROR
      
使用 skaffold 產生的標籤,為 Pod 建立容器記錄
resource.type="k8s_container" AND
labels."k8s-pod/app"="loadgenerator" AND
labels."k8s-pod/skaffold_dev/run-id"="SKAFFOLD_RUN_ID"
severity=ERROR
      
特定 Pod 的容器錯誤記錄檔,textPayload 包含 POST
resource.type="k8s_container" AND
resource.labels.pod_name="POD_NAME" AND
textPayload:"POST" AND
severity=ERROR
      
特定 Pod 的容器錯誤記錄,結構化 JSON 中包含 GET
resource.type="k8s_container" AND
resource.labels.pod_name="POD_NAME" AND
jsonPayload."http.req.method"="GET" AND
severity=ERROR
      
kube-system 命名空間中的容器錯誤記錄
resource.type="k8s_container" AND
resource.labels.namespace_name="kube-system" AND
severity=ERROR
      
容器深入分析記錄中的容器錯誤
resource.type="k8s_container" AND
log_id("clouderrorreporting.googleapis.com/insights")
      
Kubernetes 容器記錄
resource.type="k8s_container" AND
resource.labels.container_name="CONTAINER_NAME"
      

控制層查詢

注意:必須啟用 GKE 控制層記錄。
篩選器名稱 運算式
Kubernetes API 伺服器記錄
resource.type="k8s_control_plane_component"
resource.labels.component_name="apiserver"
resource.labels.location="CLUSTER_LOCATION"
resource.labels.cluster_name="CLUSTER_NAME"
      
Kubernetes 排程器記錄
resource.type="k8s_control_plane_component"
resource.labels.component_name="scheduler"
resource.labels.location="CLUSTER_LOCATION"
resource.labels.cluster_name="CLUSTER_NAME"
      
Kubernetes Controller Manager 記錄
resource.type="k8s_control_plane_component"
resource.labels.component_name="controller-manager"
resource.labels.location="CLUSTER_LOCATION"
resource.labels.cluster_name="CLUSTER_NAME"
      

TPU 工作負載查詢

注意:必須啟用 GKE 系統和工作負載記錄功能。
篩選器名稱 運算式
前置字元相同的所有 TPU 節點 stdout 容器記錄檔
resource.type="k8s_container" AND
labels."compute.googleapis.com/resource_name"=~"TPU_NODE_PREFIX.*" AND
log_id("stdout")
      
前置字元相同的所有 TPU 節點容器錯誤記錄檔
resource.type="k8s_container" AND
labels."compute.googleapis.com/resource_name"=~"TPU_NODE_PREFIX.*" AND
log_id("stderr") AND
severity=ERROR
      
來自相同 GKE 工作的 Stdout 容器記錄
resource.type="k8s_container" AND
labels."k8s-pod/batch.kubernetes.io/job-name" = "JOB_NAME" AND
log_id("stdout")
      
來自相同 GKE 工作的容器錯誤記錄
resource.type="k8s_container" AND
labels."k8s-pod/batch.kubernetes.io/job-name"="JOB_NAME" AND
log_id("stderr") AND
severity=ERROR
      
來自相同 GKE JobSet 的 stdout 容器記錄
resource.type="k8s_container" AND
labels."k8s-pod/jobset_sigs_k8s_io/jobset-name"="JOBSET_NAME" AND
log_id("stdout")
      
來自相同 GKE JobSet 的容器錯誤記錄
resource.type="k8s_container" AND
labels."k8s-pod/jobset_sigs_k8s_io/jobset-name"="JOBSET_NAME" AND
log_id("stderr") AND
severity=ERROR
      

Managed Service for Apache Airflow 查詢

查詢/篩選器名稱 運算式
Managed Service for Apache Airflow 環境建構記錄
resource.type="cloud_composer_environment" AND
resource.labels.location="LOCATION" AND
resource.labels.environment_name="ENVIRONMENT_NAME" AND
log_id("build-log") 
Managed Service for Apache Airflow composer-agent 記錄
resource.type="cloud_composer_environment" AND
resource.labels.location="LOCATION" AND
resource.labels.environment_name="ENVIRONMENT_NAME" AND
log_id("composer-agent") 
Managed Service for Apache Airflow DAG 處理器管理員記錄
resource.type="cloud_composer_environment" AND
resource.labels.location="LOCATION" AND
resource.labels.environment_name="ENVIRONMENT_NAME" AND
log_id("dag-processor-manager") 
Managed Service for Apache Airflow Cloud Storage syncd 記錄
resource.type="cloud_composer_environment" AND
resource.labels.location="LOCATION" AND
resource.labels.environment_name="ENVIRONMENT_NAME" AND
log_id("gcs-syncd") 
Managed Service for Apache Airflow Airflow 監控記錄
resource.type="cloud_composer_environment" AND
resource.labels.location="LOCATION" AND
resource.labels.environment_name="ENVIRONMENT_NAME" AND
log_id("airflow-monitoring") 
Managed Service for Apache Airflow Airflow 排程器記錄
resource.type="cloud_composer_environment" AND
resource.labels.location="LOCATION" AND
resource.labels.environment_name="ENVIRONMENT_NAME" AND
log_id("airflow-scheduler") 
Managed Service for Apache Airflow Airflow 網路伺服器記錄
resource.type="cloud_composer_environment" AND
resource.labels.location="LOCATION" AND
resource.labels.environment_name="ENVIRONMENT_NAME" AND
log_id("airflow-webserver") 
Managed Service for Apache Airflow Airflow worker 記錄
resource.type="cloud_composer_environment" AND
resource.labels.location="LOCATION" AND
resource.labels.environment_name="ENVIRONMENT_NAME" AND
log_id=~"airflow-(k8s-)?worker" 

網路查詢

查詢/篩選器名稱 運算式
所有防火牆記錄檔
resource.type="gce_subnetwork" AND
log_id("compute.googleapis.com/firewall")
特定國家/地區的防火牆記錄
resource.type="gce_subnetwork" AND
log_id("compute.googleapis.com/firewall") AND
jsonPayload.remote_location.country=COUNTRY_ISO_ALPHA_3
VM 的防火牆記錄
resource.type="gce_subnetwork" AND
log_id("compute.googleapis.com/firewall") AND
jsonPayload.instance.vm_name="INSTANCE_NAME"
防火牆子網路記錄
resource.type="gce_subnetwork" AND
log_id("compute.googleapis.com/firewall") AND
resource.labels.subnetwork_name="SUBNET_NAME"
傳送至子網路的 Compute Engine 子網路流量記錄
resource.type="gce_subnetwork" AND
ip_in_net(jsonPayload.connection.dest_ip, "SUBNET_IP")
虛擬私有雲流量記錄
resource.type="gce_subnetwork" AND
log_id("compute.googleapis.com/vpc_flows")
特定通訊埠和通訊協定的虛擬私有雲流量記錄
resource.type="gce_subnetwork" AND
log_id("compute.googleapis.com/vpc_flows") AND
jsonPayload.connection.src_port="PORT_ID" AND
jsonPayload.connection.protocol="PROTOCOL"
特定子網路的虛擬私有雲流量記錄
resource.type="gce_subnetwork" AND
log_id("compute.googleapis.com/vpc_flows") AND
resource.labels.subnetwork_name="SUBNET_NAME"
特定子網路前置字元的虛擬私有雲流量記錄
resource.type="gce_subnetwork" AND
log_id("compute.googleapis.com/vpc_flows") AND
ip_in_net(jsonPayload.connection.dest_ip, "SUBNET_IP")
特定 VM 的虛擬私有雲流量記錄
resource.type="gce_subnetwork" AND
log_id("compute.googleapis.com/vpc_flows") AND
jsonPayload.src_instance.vm_name="VM_NAME"
虛擬私有雲網路所有 egress 流量的虛擬私有雲流量記錄
log_id("compute.googleapis.com/vpc_flows") AND
jsonPayload.reporter="SRC" AND
jsonPayload.src_vpc.vpc_name="VPC_NAME" AND
(jsonPayload.dest_vpc.vpc_name!="VPC_NAME" OR NOT
jsonPayload.dest_vpc:*)
僅記錄子網路 egress 流量的虛擬私有雲流量記錄
log_id("compute.googleapis.com/vpc_flows") AND
jsonPayload.reporter="SRC" AND
jsonPayload.src_vpc.subnetwork_name="SUBNET_NAME" AND
(jsonPayload.dest_vpc.subnetwork_name!="SUBNET_NAME" OR NOT
jsonPayload.dest_vpc.subnetwork_name:*)
Cloud VPN 閘道記錄
resource.type="vpn_gateway" AND
resource.labels.gateway_id="GATEWAY_ID"
Cloud VPN IKE (第 1 階段) 驗證事件
resource.type="vpn_gateway" AND
("generating IKE_AUTH request" OR "parsed IKE_AUTH response")
Cloud VPN 第 2 階段 (子 SA) 事件
resource.type="vpn_gateway" AND
"CHILD_SA"
HTTP 負載平衡器 5xx 錯誤
resource.type="http_load_balancer" AND
httpRequest.status>=500
HTTP 負載平衡器對 PHPMyAdmin 發出的要求
resource.type="http_load_balancer" AND
httpRequest.request_url:"phpmyadmin"
內部 HTTP(S) 負載平衡器記錄
resource.type="internal_http_lb_rule"
負載平衡健康狀態檢查失敗記錄
log_id("compute.googleapis.com/healthchecks") AND
jsonPayload.healthCheckProbeResult.previousDetailedHealthState="HEALTHY" AND
jsonPayload.healthCheckProbeResult.detailedHealthState="TIMEOUT"

安全性查詢

查詢/篩選器名稱 運算式
稽核記錄:所有
logName:"cloudaudit.googleapis.com"
資料存取透明化控管機制 (AXT) 稽核記錄
log_id("cloudaudit.googleapis.com/access_transparency")
管理員活動稽核記錄
log_id("cloudaudit.googleapis.com/activity")
資料存取稽核記錄
log_id("cloudaudit.googleapis.com/data_access")
系統事件稽核記錄
log_id("cloudaudit.googleapis.com/system_event")
Cloud Key Management Service 金鑰版本刪除
resource.type="cloudkms_cryptokeyversion" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.methodName="DestroyCryptoKeyVersion" AND
resource.labels.crypto_key_id="KMS_KEY_NAME" 
Secret Manager 密鑰生命週期事件
(resource.type="audited_resource" AND
log_id("cloudaudit.googleapis.com/activity") AND protoPayload.methodName=
~"google.cloud.secretmanager.v1.SecretManagerService.(Create|Delete)Secret") OR
(resource.type="secretmanager.googleapis.com/Secret" AND
log_id("secretmanager.googleapis.com/secret_event") AND
jsonPayload.@type=
"type.googleapis.com/google.cloud.secretmanager.logging.v1.SecretEvent") 
服務違反 VPC Service Controls 政策
log_id("cloudaudit.googleapis.com/policy") AND
resource.type="audited_resource" AND
protoPayload.metadata.@type=
"type.googleapis.com/google.cloud.audit.VpcServiceControlAuditMetadata" AND
protoPayload.serviceName="SERVICE_NAME" AND
severity=ERROR 
呼叫端 IP 位址違反 VPC Service Controls 政策
log_id("cloudaudit.googleapis.com/policy") AND
resource.type="audited_resource" AND
protoPayload.metadata.@type=
"type.googleapis.com/google.cloud.audit.VpcServiceControlAuditMetadata" AND
protoPayload.requestMetadata.callerIp="CALLER_IP" AND
severity=ERROR 
依專屬 ID 查看 VPC Service Controls 違反政策詳細資料
log_id("cloudaudit.googleapis.com/policy") AND
resource.type="audited_resource" AND
protoPayload.metadata.@type=
"type.googleapis.com/google.cloud.audit.VpcServiceControlAuditMetadata" AND
protoPayload.metadata.vpcServiceControlsUniqueId="UNIQUE_ID" AND
severity=ERROR 
移除稽核記錄設定
log_id("cloudaudit.googleapis.com/activity") AND
resource.type=("organization" OR "project" OR "folder") AND
protoPayload.serviceData.policyDelta.auditConfigDeltas.action="REMOVE" 
新增稽核記錄設定
log_id("cloudaudit.googleapis.com/activity") AND
resource.type=("organization" OR "project" OR "folder") AND
protoPayload.serviceData.policyDelta.auditConfigDeltas.action="ADD" 
記錄檔 bucket 檢視權限查詢
resource.type="logging_log" AND
protoPayload.authorizationInfo.permission="logging.views.access" AND
protoPayload.methodName="google.logging.v2.LoggingServiceV2.AggregateLogs" AND
protoPayload.authorizationInfo.resource=
"projects/PROJECT_ID/locations/global/buckets/BUCKET_NAME/views/_AllLogs" 

疑難排解

如需使用 Logs Explorer 時常見問題的疑難排解操作說明,請參閱「使用 Logs Explorer:疑難排解」。

後續步驟

如要進一步瞭解可用來自訂這些查詢的查詢語法,請參閱「Logging 查詢語言」。

如要進一步瞭解如何在 Google Cloud 控制台查詢,請參閱「使用 Logging 查詢語言建構查詢」。