로그 쿼리 작성

이 페이지에서는 Google Cloud Console 로그 탐색기에서 쿼리를 작성하여 검색, 조정, 분석하는 방법을 설명합니다.

시작하기 전에

특정 Cloud 프로젝트의 로그를 보려면 Google Cloud Console 프로젝트 선택기에서 해당 Cloud 프로젝트를 선택한 다음 기존 로그 뷰어를 사용합니다.

Amazon Web Services(AWS) 계정에서 Logging으로 전송하는 로그를 보려면 Google Cloud Console 프로젝트 선택기에서 AWS 커넥터 프로젝트를 선택한 후 기존 로그 뷰어를 사용합니다. AWS 커넥터 프로젝트는 AWS 계정의 Amazon 리소스 이름(ARN)을 저장하고 AWS 계정을 Google Cloud 서비스에 연결합니다. 자세한 내용은 작업공간에 프로젝트 또는 계정 추가를 참조하세요.

시작하기

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

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

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

쿼리 빌드

쿼리 빌더 창에서는 여러 가지 방법으로 로그를 검색 할 수 있습니다.

  1. 쿼리 빌더 드롭다운 메뉴
  2. Logging 쿼리 언어를 사용하는 쿼리
  3. 최근, 저장됨, 추천 쿼리 탭

query-builder-pane

다음 섹션에서는 쿼리를 빌드하고 실행하여 로그를 검색하는 방법을 설명합니다.

쿼리 빌더 드롭다운 메뉴

드롭다운 메뉴를 사용하면 쿼리 빌더에 쿼리 매개변수를 추가할 수 있습니다. 드롭다운 메뉴를 사용하여 리소스, 로그 이름, 로그 심각도, 시간 범위를 선택할 수 있습니다. 이 옵션은 모든 Logging 로그의 LogEntry 필드에 해당합니다.

쿼리 빌더 드롭다운 메뉴

  • 리소스: resource.type을 지정할 수 있습니다. 한 번에 하나의 리소스를 선택하여 쿼리 빌더에 추가할 수 있습니다. 항목은 논리 연산자 AND를 사용합니다.
  • 로그 이름: 로그 이름을 지정할 수 있습니다. 여러 로그 이름을 동시에 선택하여 쿼리 빌더에 추가할 수 있습니다. 여러 항목을 선택할 때 논리 연산자 OR를 사용합니다.
  • 심각도: 심각도를 지정할 수 있습니다. 여러 심각도 수준을 동시에 선택하여 쿼리 빌더에 추가할 수 있습니다. 여러 항목을 선택할 때 논리 연산자 OR를 사용합니다.

검색 매개변수 메뉴를 사용하려면 매개변수를 확장하고 한 개 또는 여러 개의 매개변수를 선택한 다음 추가를 클릭합니다.

쿼리를 빌드한 후 쿼리 실행을 클릭하여 원하는 로그 항목을 검색합니다.

시간 제한이 있는 쿼리

시간을 기준으로 로그를 쿼리하는 방법에는 두 가지가 있습니다.

  1. 타임 스탬프 표현식을 사용하여 쿼리
  2. 시간 범위 선택기를 사용하여 쿼리

    로그 탐색기는 시간을 기준으로 필터링하는 두 가지 방법을 보여줍니다.

타임스탬프가 있는 쿼리의 경우 시간 범위 선택기가 비활성화되고 쿼리는 시간 범위 제한으로 타임스탬프 표현식을 사용합니다. 쿼리가 타임스탬프 표현식을 사용하지 않는 경우 쿼리는 시간 범위 선택기를 시간 범위 제한으로 사용합니다.

Logging 쿼리 언어를 사용하는 쿼리

Logging 쿼리 언어를 사용하여 Cloud Logging 쿼리 빌더 창, Logging API 또는 명령줄 인터페이스에서 쿼리를 빌드할 수 있습니다.

자세한 내용은 Logging 쿼리 언어를 참조하세요.

저장된 쿼리

쿼리 빌더 창에는 저장된 쿼리에 액세스 할 수 있는 저장됨 탭이 있습니다.

저장된 쿼리 목록

저장된 쿼리를 사용하면 쿼리 표현식을 저장하여 로그를 일관되고 효율적으로 탐색할 수 있습니다.

쿼리 빌더 창에서 빌드한 쿼리를 저장하려면 다음 안내를 따르세요.

  1. 쿼리 빌더 창에서 저장을 선택합니다. 쿼리 저장 대화상자가 열리고 쿼리 필드에 쿼리 표현식이 표시됩니다.

  2. 쿼리의 이름을 추가합니다.

    이름은 64자로 제한됩니다.

  3. 선택사항: 쿼리에 요약 필드를 추가하려면 요약 필드 포함으로 전환합니다.

  4. 선택사항: 쿼리 설명을 추가합니다.

    설명은 1,000자로 제한됩니다. 민감한 정보를 포함하면 안 됩니다.

  5. 대화상자에서 쿼리 저장을 선택합니다.

저장된 쿼리는 쿼리 빌더 창의 저장됨 탭 아래 목록에 표시됩니다.

저장된 쿼리를 실행하려면 쿼리 실행을 클릭합니다.

공유 쿼리

공유 쿼리를 사용하면 프로젝트 사용자가 저장된 쿼리를 서로 공유할 수 있습니다.

공유 쿼리를 보고 수정하는 데 필요한 역할과 권한은 액세스 제어 페이지의 권한 및 역할 섹션을 참조하세요.

쿼리 공유

이미 저장한 쿼리를 공유하거나 새 쿼리를 공유할 수 있습니다.

새 쿼리를 공유하려면 다음 안내를 따르세요.

  1. 쿼리 빌더에 쿼리를 입력합니다.

  2. 쿼리 빌더 창에서 저장을 선택합니다.

  3. 쿼리 저장 대화상자의 필드를 작성합니다.

  4. 프로젝트와 공유를 사용 설정합니다.

이제 쿼리가 프로젝트의 다른 사용자와 공유됩니다.

이미 저장된 쿼리를 공유하려면 다음 안내를 따르세요.

  1. 저장됨을 선택합니다.

  2. 옵션 더보기 > 수정 을 선택하거나 쿼리를 직접 선택합니다.

  3. 쿼리 수정 대화상자에서 프로젝트와 공유를 사용 설정한 다음 쿼리 업데이트를 선택합니다.

이제 쿼리가 프로젝트의 다른 사용자와 공유됩니다.

공유 쿼리 보기

모든 공유 쿼리를 빠르게 보려면 공개 상태 열을 정렬하여 공유 쿼리를 먼저 표시합니다.

  1. 저장됨 탭을 선택합니다.

  2. 전체를 선택합니다.

  3. 공개 상태 열을 정렬합니다.

공개 상태 열이 정렬됩니다.

공개 상태 열은 나에게 공유된 쿼리와 내가 프로젝트의 다른 사용자와 공유하는 쿼리를 구분합니다.

내 쿼리만 보기

내가 만들거나 공유한 공유 쿼리를 보려면 내 쿼리를 클릭합니다. 이제 만들고 저장한 쿼리 목록이 표시됩니다. 공개 상태 열에서 공유되지 않은 비공개 쿼리를 볼 수 있습니다. 공유한 쿼리는 내가 공유한 쿼리로 표시됩니다.

추천 쿼리

Logging은 사용 중인 Google Cloud 제품에 대한 이해를 기반으로 추천 쿼리를 생성합니다. 문제를 정확하게 식별하고 시스템의 전체 상태에 대해 유용한 정보를 제공하는 데 도움이 되는 쿼리를 제안합니다. 예를 들어 Google Kubernetes Engine을 사용하는 경우 Logging이 컨테이너의 모든 오류 로그를 찾아내는 쿼리를 추천할 수 있습니다.

쿼리 빌더 창에서 추천 쿼리를 보고 실행하려면 다음을 수행합니다.

  1. 추천 탭을 클릭합니다.

    쿼리 모음을 보여주는 추천 검색어 탭

  2. 추천 쿼리에 대한 설명을 검토합니다.

  3. 추천 쿼리에 대한 세부정보를 검토하려면 다음 작업 중 하나를 수행하세요.

    a. 행을 클릭합니다.

    b. 더보기 를 클릭하고 새로 만들기를 선택합니다.

  4. 쿼리 빌더 창에 쿼리와 이를 실행 또는 저장할 수 있는 옵션이 표시됩니다.

    a. 쿼리를 저장하려면 저장을 클릭합니다. 저장됨 목록에 쿼리가 표시됩니다. 여기에서 나중에 쿼리를 실행하도록 선택할 수 있습니다.

    b. 쿼리를 실행하려면 실행을 클릭합니다. 쿼리 빌더의 쿼리 미리보기에 쿼리가 표시됩니다.

  5. 쿼리를 검토한 후 쿼리 실행을 클릭합니다. 추천 쿼리의 결과가 쿼리 결과에 표시됩니다.

추천 쿼리는 Google Cloud 프로젝트 컨텍스트에 따라 동적으로 생성됩니다. 연속으로 페이지를 로드하면 동일한 쿼리가 동일한 순서로 표시되지 않을 수 있습니다. 이는 정상적인 동작입니다.

최근 쿼리

쿼리 빌더 창에는 최근 탭이 있습니다. 쿼리를 실행하면 쿼리가 최근 쿼리 목록에 추가되며, 여기에는 30일 동안 발생한 10,000개의 고유한 쿼리가 포함됩니다.

최근 탭에는 최근 쿼리가 표시됩니다.

최근 쿼리를 보려면 쿼리 빌더 창에서 최근 탭을 선택합니다. 최근 탭에서는 다음 옵션을 사용할 수 있습니다.

  • 스트림. 지정된 쿼리 매개변수를 기반으로 로그를 스트리밍합니다.
  • 실행. 쿼리를 실행합니다.
  • 옵션 더보기 . 쿼리 실행 옵션과 함께 쿼리 매개변수를 보거나 저장된 쿼리 목록에 저장할 수 있습니다. 쿼리를 직접 선택하여 이러한 옵션을 가져올 수도 있습니다.

    쿼리를 실행하려면 실행을 선택합니다.

    쿼리를 저장하려면 다른 이름으로 저장을 선택하고 다음 필드를 작성합니다.

    • 이름(필수사항): 이름을 입력합니다.
    • 설명(선택사항): 쿼리의 목적을 식별하는 데 도움이 되는 설명을 제공합니다.
    • 요약 필드 포함(선택사항): 요약 필드 포함을 사용 설정하고 표시할 필드를 입력합니다.
    • 요약 필드 자르기(선택사항): 요약 필드 자르기를 사용 설정하고 잘라낼 문자 수와 자르기가 필드의 시작 부분에서 발생할지 끝부분에서 발생할지 여부를 선택합니다.

    쿼리 저장을 선택합니다. 이제 저장된 쿼리 목록에서 쿼리를 사용할 수 있습니다.

최근 쿼리를 필터링할 수도 있습니다. 필터와 쿼리의 표현식에 있는 텍스트가 일치합니다.