로그 범위 만들기 및 관리

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

이 문서에서는 보거나 분석하려는 로그 항목을 효율적으로 찾는 데 사용할 수 있는 로그 범위를 만들고 관리하는 방법을 설명합니다. 프로젝트, 폴더 또는 조직에서 발생한 로그 항목만 보고 분석하려는 경우 이 문서가 적합하지 않습니다. 하지만 로그 싱크를 사용하여 로그를 다른 프로젝트 또는 사용자 정의 로그 버킷으로 라우팅하거나 로그 뷰를 사용하는 경우 이 문서의 정보가 특정 로그 항목을 효율적으로 찾는 데 도움이 될 수 있습니다.

이 문서에서는 로그를 보는 방법을 설명하지 않습니다. 이 주제에 관한 자세한 내용은 로그 탐색기를 사용하여 로그 보기를 참조하세요.

로그 범위 정보

로그 범위는 리소스 집합을 나열하는 프로젝트 수준의 영구 리소스입니다. 이러한 리소스는 프로젝트, 폴더, 조직, 로그 뷰가 될 수 있습니다. 예를 들어 프로덕션에 사용된 리소스가 포함된 프로젝트를 나열하거나 특정 리소스 유형의 로그 항목이 포함된 로그 뷰를 나열하는 로그 범위를 정의할 수 있습니다.

Google Cloud 프로젝트, 폴더 또는 조직 리소스를 만들 때 Logging은 _Default라는 로그 범위를 만듭니다. 이 범위에는 생성된 프로젝트, 폴더 또는 조직이 포함됩니다. 검색된 리소스가 Google Cloud 프로젝트, 폴더 또는 조직인 경우 결과에는 리소스에서 시작되어 로그 버킷에 저장되는 로그 항목이 포함됩니다. 프로젝트를 검색하면 결과에 다른 프로젝트의 싱크에 의해 프로젝트로 라우팅된 후 로그 버킷에 저장되는 로그 항목도 포함됩니다.

로그 범위를 만들 수 있습니다. 만드는 로그 범위를 수정하고 삭제할 수도 있습니다. 그러나 _Default라는 로그 범위는 수정하거나 삭제할 수 없습니다.

로그 범위를 사용하여 로그 탐색기 페이지에서 로그 데이터를 검색할 리소스를 제어합니다. 이 페이지를 열고 로그 범위를 선택하면 페이지에서 해당 범위에 나열된 리소스를 검색한 후 디스플레이를 새로고침합니다.

로그 범위를 사용하여 로그 패널에서 로그 데이터를 검색하는 리소스를 제어할 수도 있습니다. 로그 패널은 로그 데이터를 표시하는 커스텀 대시보드 위젯입니다. 각 로그 패널에는 자체 구성이 있으므로 각 패널에 서로 다른 로그 데이터를 표시하는 로그 패널 여러 개가 포함된 대시보드를 만들 수 있습니다. 자세한 내용은 커스텀 대시보드에 로그 및 오류 표시를 참조하세요.

프로젝트의 경우 기본 로그 범위에 따라 로그 탐색기 페이지가 열릴 때 검색하는 리소스 집합이 결정됩니다. 하지만 검색된 리소스에 대한 Identity and Access Management(IAM) 역할과 기간 설정에 따라 스토리지에서 가져올 로그 항목이 결정됩니다. 프로젝트가 생성될 때 _Default라는 로그 범위가 기본 로그 범위로 지정됩니다. 기본 로그 범위를 지정할 로그 범위를 설정할 수 있습니다.

로그 범위와 중앙 집중식 로그 스토리지의 차이점

중앙 집중식 로그 스토리지와 로그 범위는 모두 서로 다른 프로젝트에서 발생한 로그 데이터를 볼 수 있는 방법을 제공합니다.

중앙 집중식 로그 버킷을 구성하면 로그 항목이 Google Cloud에 수신되면 단일 스토리지 위치로 라우팅됩니다. 중앙 집중식 스토리지는 로그 데이터를 쿼리할 수 있는 단일 위치를 제공하므로 동향을 검색하거나 문제를 조사할 때 쿼리를 간소화할 수 있습니다. 보안 관점에서도 스토리지 위치가 하나이므로 보안 분석가의 작업을 간소화할 수 있습니다.

로그 범위에 나열된 리소스에 쿼리가 실행되면 개별 쿼리 결과가 결합됩니다. 로그 범위는 여러 위치에 저장될 수 있는 로그 데이터의 읽기 시간 집계를 용이하게 합니다. 하지만 로그 범위는 중앙 집중식 로그 버킷의 하나 이상의 로그 뷰에 대한 읽기 액세스 권한을 제공하는 데도 사용할 수 있습니다.

로그 탐색기 페이지가 열리면 기본 로그 범위에 나열된 리소스에 쿼리를 실행합니다. 따라서 페이지에 일반적으로 확인하려는 데이터가 표시되도록 기본 범위를 구성합니다. 예를 들어 로그 뷰를 나열하도록 기본 로그 범위를 설정할 수 있습니다. 이 로그 뷰는 쿼리 시 App Hub 애플리케이션의 로그 데이터를 반환합니다.

권장사항

로그 범위는 나중에 사용할 수 있도록 구성을 정의하고 저장할 수 있는 방법을 제공하므로 복잡한 검색 구성의 로그 범위를 만드는 것이 좋습니다.

예를 들어 문제를 해결하는 중이며 팀에서 소유한 모든 가상 머신(VM) 인스턴스의 로그 항목을 보려고 한다고 가정해 보겠습니다. 이 태스크를 완료하려면 다음을 수행할 수 있습니다.

1. 보려는 로그 항목이 여러 로그 버킷과 여러 프로젝트에 저장되어 있는지 확인합니다. 대부분의 로그 버킷에는 분석하려는 로그 항목이 포함된 로그 뷰가 있습니다. 로그 뷰가 없는 경우 새로 만들면 됩니다.

2. 향후 유사한 문제 해결 작업이 있을 것으로 예상되어 로그 범위를 만들기로 합니다.

3. Google Cloud 콘솔에서 로그 탐색기 페이지를 열고 범위 미세 조정 메뉴를 사용하여 새 로그 범위를 선택합니다.

4. 로그 항목을 검토하고 조사 중인 문제를 해결하는 데 필요한 정보를 찾습니다.

5. 문제를 해결한 후 실패 원인을 동료와 공유합니다. 또한 향후 유사한 오류가 발생할 것으로 예상하여 자신 또는 오류를 조사하는 사용자가 관련 로그 항목을 빠르게 찾을 수 있는 로그 범위를 만들었다는 것을 공유합니다.

App Hub 애플리케이션 및 로그 범위

App Hub 애플리케이션이 여러 프로젝트에 로그 데이터를 쓸 수 있습니다. 로그 데이터가 발생한 프로젝트에 저장되어 있거나 조직 관리자가 중앙 집중식 스토리지를 구성했을 수 있습니다. 애플리케이션의 로그 데이터를 보려면 로그 범위를 만들고 애플리케이션의 로그 데이터를 저장하는 프로젝트 또는 로그 뷰를 나열하도록 구성한 다음 기본 로그 범위로 구성합니다. 이 단계를 완료하면 데이터가 다른 프로젝트 또는 중앙 집중식 로그 버킷에 저장되어 있더라도 애플리케이션에서 작성한 데이터가 로그 탐색기 페이지에 자동으로 표시됩니다.

로그 데이터를 볼 프로젝트에서 맞춤 로그 범위를 만듭니다. 이 프로젝트는 App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트입니다. 예를 들어 폴더의 표시 이름이 My Folder이면 관리 프로젝트의 표시 이름은 My Folder-mp입니다.

제한사항

• _Default라는 로그 범위는 삭제하거나 수정할 수 없습니다.
• Google Cloud 프로젝트만 기본 로그 범위를 지원합니다.
• 사용자 정의 로그 범위에 폴더나 조직을 추가할 수 없습니다.
• 로그 범위는 global 위치에 생성됩니다.

시작하기 전에

• 로그 범위를 만들고 보는 데 필요한 권한을 얻고 기본 로그 범위를 설정하려면 관리자에게 다음의 IAM 역할을 부여해 달라고 요청하세요.

  • 로그 범위를 만들고 보거나 기본 로그 범위를 가져오려는 경우: 프로젝트, 폴더 또는 조직에 대한 로그 구성 작성자(roles/logging.configWriter)
  • 기본 로그 범위를 설정하거나 가져오려면 프로젝트, 폴더 또는 조직의 관측 가능성 편집자(roles/observability.editor)를 사용하세요.

  역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

  이러한 사전 정의된 역할에는 로그 범위를 만들고 보고, 기본 로그 범위를 설정하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

  필수 권한

  로그 범위를 만들고 보고 기본 로그 범위를 설정하려면 다음 권한이 필요합니다.

  • 기본 로그 범위 설정하기: observability.scopes.{get, update}
  • 로그 범위를 만들고 관리하기: logging.logScopes.{create, delete, get, list, update}

  커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

• Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  In the Google Cloud console, activate Cloud Shell.

  Activate Cloud Shell

  At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  Terraform

  로컬 개발 환경에서 이 페이지의 Terraform 샘플을 사용하려면 gcloud CLI를 설치 및 초기화한 다음 사용자 인증 정보로 애플리케이션 기본 사용자 인증 정보를 설정하세요.

  1. Install the Google Cloud CLI.

  2. To initialize the gcloud CLI, run the following command:

     gcloud init

  3. If you're using a local shell, then create local authentication credentials for your user account:

     gcloud auth application-default login

     You don't need to do this if you're using Cloud Shell.

  자세한 내용은 Google Cloud 인증 문서의 로컬 개발 환경의 ADC 설정을 참조하세요.

  REST

  로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.

  Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

  자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참조하세요.

로그 범위 나열

 gcloud logging scopes list --project=PROJECT_ID

 gcloud logging scopes describe LOG_SCOPE_ID --project=PROJECT_ID

projects/PROJECT_ID/locations/LOCATION_ID

기본 로그 범위 설정

이 섹션은 폴더 또는 조직에는 적용되지 않습니다. 폴더 및 조직의 경우 로그 탐색기 페이지가 열릴 때 폴더 또는 조직에서 발생한 로그 항목을 검색합니다.

프로젝트가 생성되면 _Default라는 로그 범위가 생성됩니다. 이 범위에는 프로젝트라는 하나의 리소스가 나열되며 기본 로그 범위로 지정됩니다. 프로젝트를 만들고 기본 로그 범위를 수정하지 않으면 로그 탐색기 페이지가 열릴 때 프로젝트에서 발생한 모든 로그 항목이 검색됩니다.

사용자는 자체 로그 범위를 만들어 기본 로그 범위로 지정할 수 있습니다. 이 기능을 사용하면 로그 탐색기 페이지에서 로그 항목을 검색할 리소스를 구성할 수 있습니다.

로그 범위 만들기

프로젝트당 로그 범위를 100개까지 만들 수 있습니다. 로그 범위에는 총 100개의 로그 뷰와 프로젝트가 포함될 수 있지만 프로젝트는 5개만 포함할 수 있습니다. 로그 범위에 폴더나 조직을 추가할 수 없습니다.

 gcloud logging scopes create LOG_SCOPE_ID --project=PROJECT_ID \
   --description=DESCRIPTION \
   --resource-names=RESOURCE_NAMES

projects/PROJECT_ID/locations/LOCATION_ID

로그 범위 수정 또는 삭제

 gcloud logging scopes update LOG_SCOPE_ID --project=PROJECT_ID \
   --description=DESCRIPTION \
   --resource-names=RESOURCE_NAMES

 gcloud logging scopes delete LOG_SCOPE_ID --project=PROJECT_ID

projects/PROJECT_ID/locations/LOCATION_ID/logScopes/LOG_SCOPE_ID

다음 단계

• 로그 탐색기를 사용하여 로그 보기
• 로그 버킷에 로그 뷰 구성