로그 탐색기를 사용한 샘플 쿼리

이 페이지에서는 Google Cloud Console의 로그 탐색기를 사용하여 중요한 로그를 쉽게 찾을 수 있는 추천 쿼리를 설명합니다.

나열된 모든 쿼리는로그 탐색기, Logging API 또는 명령줄 인터페이스에 적용할 수 있지만 하지만 이 페이지에서는 로그 탐색기의 쿼리 사용에 중점을 둡니다.

로그 탐색기는 부울 표현식을 사용하여 프로젝트 내 모든 로그 항목의 하위 집합을 지정합니다. 이러한 쿼리를 사용하여 특정 로그 또는 로그 서비스의 로그 항목을 선택하거나 메타데이터 또는 사용자 정의 필드의 조건을 충족하는 로그 항목을 선택할 수 있습니다. 쿼리에 대한 자세한 내용은 쿼리 빌드를 참조하세요.

시작하기

로그 탐색기로 이동하려면 다음 안내를 따르세요.

  1. Google Cloud 탐색 메뉴로 이동하여 Logging > 로그 탐색기를 차례로 선택합니다.
    로그 탐색기로 이동
  2. Google Cloud 프로젝트를 선택합니다.
  3. 업그레이드 메뉴에서 기존 로그 뷰어로그 탐색기로 전환합니다.

이제 로그 탐색기가 표시됩니다.

샘플 쿼리 사용

다음 표의 쿼리를 적용하려면 표현식 행 끝에 있는 클립보드 아이콘 을 클릭하여 표현식을 복사한 다음, 복사된 표현식을 쿼리 빌더 텍스트 상자에 붙여 넣으세요.

쿼리 빌더 텍스트 상자에 쿼리 입력 위치가 표시됩니다.

표현식을 입력한 후 쿼리 실행을 클릭합니다. 쿼리와 일치하는 로그가 쿼리 결과에 나열됩니다.

이 페이지의 뒷부분에 나열된 쿼리 중 일부는 올바른 값으로 바꿔야 하는 변수를 포함합니다. 이 변수는 대괄호([])로 표시됩니다. 예를 들어 쿼리에 logName이 포함되어 있으면 제공하는 [PROJECT_ID]가 현재 선택된 Google Cloud 프로젝트를 참조해야 합니다. 그렇지 않으면 쿼리가 작동하지 않습니다. 자세한 내용은 문제해결을 참조하세요.

다음 섹션에서는 Google Cloud 서비스를 기준으로 쿼리를 분류합니다.

App Engine 쿼리

필터 이름 표현식
새해 전날의 App Engine 로그(UTC 시간)

resource.type="gae_app" AND
severity>=ERROR AND
timestamp>="2018-12-31T00:00:00Z" AND timestamp<="2019-01-01T00:00:00Z" 
서버 오류가 있는 App Engine 요청 로그

resource.type="gae_app" AND
log_id("appengine.googleapis.com/request_log") AND
httpRequest.status>=500 
샘플 HTTP 오류 로그

resource.type="gae_app" AND
protoPayload.status >= 400 AND
sample(insertId, 0.1) 
App Engine trace ID 검색

resource.type="gae_app" AND
trace="projects/[PROJECT_ID]/traces/[TRACE_ID]" 

BigQuery 쿼리

필터 이름 표현식
BigQuery 감사 로그

resource.type=("bigquery_dataset" OR "bigquery_project") AND
logName:"cloudaudit.googleapis.com" 
프로젝트의 BigQuery 감사 로그

resource.type="bigquery_project" AND
logName:"cloudaudit.googleapis.com" 
데이터 세트의 BigQuery 감사 로그

resource.type="bigquery_dataset" AND
logName:"cloudaudit.googleapis.com" 
BI Engine 모델의 BigQuery 감사 로그

resource.type="bigquery_biengine_model" AND
logName:"cloudaudit.googleapis.com" 
Data Transfer Service Run의 BigQuery 감사 로그

resource.type="bigquery_dts_run" AND
logName:"cloudaudit.googleapis.com" 
Data Transfer Service 구성의 BigQuery 감사 로그

resource.type="bigquery_dts_config" AND
logName:"cloudaudit.googleapis.com" 
BigQuery Data Transfer Service 작업

resource.type=("bigquery_project") AND
protoPayload.requestMetadata.callerSuppliedUserAgent="BigQuery Data Transfer Service" AND
protoPayload.methodName=("google.cloud.bigquery.v2.JobService.InsertJob" OR "google.cloud.bigquery.v2.JobService.Query") 
BigQuery 데이터세트 업데이트

resource.type="bigquery_dataset" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.methodName="google.cloud.bigquery.v2.DatasetService.UpdateDataset" 
BigQuery 작업 완료됨

resource.type="bigquery_project" AND
log_id("cloudaudit.googleapis.com/data_access") AND
protoPayload.methodName=("google.cloud.bigquery.v2.JobService.InsertJob" OR "google.cloud.bigquery.v2.JobService.Query") 
BigQuery 대규모 쿼리

resource.type="bigquery_project" AND
protoPayload.metadata.jobChange.job.jobStats.queryStats.totalBilledBytes>1073741824 
BigQuery 할당량 초과됨

resource.type=("bigquery_dataset" OR "bigquery_project") AND
protoPayload.status.code=8 AND
severity>=WARNING 
BigQuery 쿼리 시작됨

resource.type="bigquery_project" AND
protoPayload.metadata.jobInsertion.reason:*

Dataflow 쿼리

필터 이름 표현식
Dataflow 작업자의 오류 및 경고

resource.type="dataflow_step" AND
log_id("dataflow.googleapis.com/worker") AND
severity>=WARNING 

Dataproc 쿼리

필터 이름 표현식
Dataproc Apache Hadoop 로그

resource.type="cloud_dataproc_cluster" AND
jsonPayload.class:"org.apache.hadoop.mapreduce" 

Cloud Deployment Manager

필터 이름 표현식
Deployment Manager 오류

resource.type="deployment" AND
severity>=ERROR 

Cloud Functions 쿼리

필터 이름 표현식
Cloud 함수 오류

resource.type="cloud_function" AND
log_id("cloudfunctions.googleapis.com/cloud-functions") AND
severity>=ERROR 

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")

Cloud Source Repositories 쿼리

필터 이름 표현식
Cloud Source Repository 로그

resource.type="csr_repository" AND
resource.labels.name="[REPOSITORY_NAME]"

Cloud Spanner 쿼리

필터 이름 표현식
특정 Spanner 인스턴스의 Cloud Spanner 로그

resource.type="spanner_instance" AND
resource.labels.instance_id="[SPANNER_INSTANCE]"

Cloud SQL 쿼리

필터 이름 표현식
Cloud SQL 감사 로그

resource.type="cloudsql_database" AND
resource.labels.database_id="[DATABASE_ID]" AND
log_id("cloudaudit.googleapis.com/activity")
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")

Compute Engine 쿼리

필터 이름 표현식
Google Compute Engine 관리자 활동 로그

resource.type="gce_instance" AND
log_id("cloudaudit.googleapis.com/activity")
Google Compute Engine 방화벽 규칙 삭제

resource.type="gce_firewall_rule" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.methodName:"firewalls.delete" 
Google Compute Engine VM syslog

resource.type="gce_instance" AND
log_id("syslog") 

Cloud Storage 쿼리

필터 이름 표현식
GCS 버킷 로그

resource.type="gcs_bucket" AND
resource.labels.bucket_name="[BUCKET_NAME]"
GCS 버킷 감사 로그

resource.type="gcs_bucket" AND
logName:"cloudaudit.googleapis.com" 
GCS 버킷 생성 로그

resource.type="gcs_bucket" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.method_name="storage.buckets.create" 
GCS 버킷 삭제 로그

resource.type="gcs_bucket" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.method_name="storage.buckets.delete" 

Cloud Tasks 쿼리

필터 이름 표현식
Cloud Tasks 큐 로그

resource.type="cloud_tasks_queue" AND
resource.labels.queue_id="[QUEUE_ID]"

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
      
인그레스 컨트롤러 이벤트

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"
      
서비스 컨트롤러 이벤트(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 수준 쿼리

필터 이름 표현식
생성 중 쿼리 pod

resource.type="k8s_pod" AND
resource.labels.pod_name="POD_NAME" AND
log_id("events")
      
스케줄러 이벤트

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")
      

컨테이너 쿼리

필터 이름 표현식
클러스터에 있는 모든 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
      
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
      
textPayload에 POST가 포함된 특정 pod의 컨테이너 오류 로그

resource.type="k8s_container" AND
resource.labels.pod_name="POD_NAME" AND
textPayload:"POST" AND
severity=ERROR
      
구조화된 JSON에 GET이 포함된 특정 pod의 컨테이너 오류 로그

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.cluster_name="CONTAINER_NAME"
      

Logging 에이전트 애플리케이션 쿼리

필터 이름 표현식
Apache 로그

resource.type="gce_instance" AND
(logName:"/apache-access" OR logName:"/apache-error")
Cassandra 로그

resource.type="gce_instance" AND
log_id("cassandra")
Chef 로그

resource.type="gce_instance" AND
logName:"projects/[PROJECT_ID]/logs/chef-"
Gitlab 로그

resource.type="gce_instance"
logName:"projects/[PROJECT_ID]/logs/gitlab-" 
Jenkins 로그

resource.type="gce_instance" AND
log_id("jenkins")
Jetty 로그

resource.type="gce_instance" AND
logName:"projects/[PROJECT_ID]/logs/jetty-"
Joomla 로그

resource.type="gce_instance" AND
log_id("joomla")
Linux syslog

resource.type="gce_instance" AND
log_id("syslog")
Magneto 로그

resource.type="gce_instance" AND
logName:"projects/[PROJECT_ID]/logs/magneto-"
Mediawiki 로그

resource.type="gce_instance" AND
log_id("mediawiki")
memcached 로그

resource.type="gce_instance" AND
log_id("memcached")
MongoDB 로그

resource.type="gce_instance" AND
log_id("mongodb")
MySQL 로그

resource.type="gce_instance" AND
log_id("mysql")
Nginx 로그

resource.type="gce_instance" AND
logName:"projects/[PROJECT_ID]/logs/nginx-"
Postgresql 로그

resource.type="gce_instance" AND
log_id("postgresql")
Puppet 로그

resource.type="gce_instance" AND
logName:"projects/[PROJECT_ID]/logs/puppet-"
RabbitMQ 로그

resource.type="gce_instance" AND
logName:"projects/[PROJECT_ID]/logs/rabbitmq-"
Redmine 로그

resource.type="gce_instance" AND
log_id("redmine")
Salt 로그

resource.type="gce_instance" AND
logName:"projects/[PROJECT_ID]/logs/salt-"
MySQL 느린 쿼리

resource.type="gce_instance" AND
log_id("mysql-slow")
Solr 로그

resource.type="gce_instance" AND
log_id("solr")
SugarCRM 로그

resource.type="gce_instance" AND
log_id("sugarcrm")
Tomcat 로그

resource.type="gce_instance" AND
log_id("tomcat")
Zookeeper 로그

resource.type="gce_instance" AND
log_id("zookeeper")

네트워킹 쿼리

필터 이름 표현식
방화벽 - 모든 로그

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]")
VPC 흐름 로그

resource.type="gce_subnetwork" AND
log_id("compute.googleapis.com/vpc_flows")
특정 포트 및 프로토콜의 VPC 흐름 로그

resource.type="gce_subnetwork" AND
log_id("compute.googleapis.com/vpc_flows") AND
jsonPayload.connection.src_port="[PORT_ID]" AND
jsonPayload.connection.protocol="[PROTOCOL]"
특정 서브넷 VPC 흐름 로그

resource.type="gce_subnetwork" AND
log_id("compute.googleapis.com/vpc_flows") AND
resource.labels.subnetwork_name"=[SUBNET_NAME]"
특정 서브넷 프리픽스의 VPC 흐름 로그

resource.type="gce_subnetwork" AND
log_id("compute.googleapis.com/vpc_flows") AND
ip_in_net(jsonPayload.connection.dest_ip,[SUBNET_IP])
특정 VM의 VPC 흐름 로그

resource.type="gce_subnetwork" AND
log_id("compute.googleapis.com/vpc_flows") AND
jsonPayload.src_instance.vm_name="[VM_NAME]"
VPN 게이트웨이 로그

resource.type="vpn_gateway" AND
resource.labels.gateway_id="[GATEWAY_ID]"
HTTP 부하 분산기 5xx 오류

resource.type="http_load_balancer" AND
httpRequest.status>=500
HTTP 부하 분산기의 PHPMyAdmin 요청

resource.type="http_load_balancer" AND
httpRequest.request_url:"phpmyadmin"

보안 로깅 쿼리

필터 이름 표현식
감사 로그 - 모두

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")

Google Cloud의 작업 제품군 쿼리

필터 이름 표현식
로그 싱크 활동

resource.type="logging_sink" AND
log_id("cloudaudit.googleapis.com/activity")
로그 기반 측정항목 생성 또는 업데이트 활동

resource.type="metric" AND
log_id("cloudaudit.googleapis.com/activity") AND
protoPayload.methodName:(UpdateLogMetric OR CreateLogMetric)
호스트의 업타임 URL 확인

resource.type="uptime_url" AND
resource.labels.host="[URL]"

문제해결

쿼리 구문 및 문제해결 안내에 대한 자세한 내용은 쿼리 빌드: 문제해결을 참조하세요.

다음 단계

쿼리를 맞춤설정하는 데 사용할 수 있는 쿼리 구문에 대한 자세한 내용은 쿼리 빌드를 참조하세요.