로그 애널리틱스 구성 문제 해결

이 문서에서는 Google Cloud 콘솔의 로그 애널리틱스 페이지를 사용할 때 발생할 수 있는 오류를 해결하는 방법을 보여줍니다.

오류 메시지

이 섹션에서는 표시될 수 있는 오류 메시지와 해당 오류 조건을 해결하는 방법을 설명합니다.

`No completion signal within allotted timeframe` 오류 메시지

SQL 쿼리를 입력하고 쿼리 실행을 선택합니다. 쿼리가 완료되지 않고 다음 오류 메시지가 표시됩니다.

The query failed to execute and return results due to error: No completion signal within allotted timeframe.

이 오류를 해결하려면 다음 중 한 가지를 따르세요.

로그 쿼리 간격을 단축한 후 쿼리를 재시도합니다. 예를 들어 쿼리 간격이 14일인 경우 간격을 7일로 줄인 다음 쿼리를 실행합니다.
연결된 BigQuery 데이터 세트를 만든 후 BigQuery 인터페이스에서 쿼리를 실행합니다. BigQuery 인터페이스는 Cloud Logging 인터페이스보다 긴 실행 시간이 필요한 쿼리를 지원합니다. 자세한 내용은 BigQuery를 사용하여 로그 쿼리를 참조하세요.

고유한 CMEK 키가 있는 버킷에 대한 쿼리 오류 메시지

여러 로그 버킷을 쿼리하는 SQL 쿼리를 입력하고 쿼리 실행을 선택합니다. 쿼리가 완료되지 않고 다음 오류 메시지가 표시됩니다.

Queries against buckets with distinct CMEK keys must have a key configured in the LogSettings.

이 상황을 해결하려면 다음 중 한 가지를 따르세요.

동일한 Cloud Key Management Service(Cloud KMS) 키를 사용하도록 로그 버킷을 구성합니다.
로그 버킷이 동일한 위치에 있는 경우 기본 Cloud KMS 키를 사용하여 로그 버킷의 상위 리소스인 폴더 또는 조직을 구성할 수 있습니다. 상위 요소의 기본 키는 로그 버킷과 동일한 위치에 있어야 합니다. 이 구성을 사용하면 상위 요소의 기본 키가 로그 애널리틱스 쿼리에서 생성된 임시 데이터를 암호화합니다. 자세한 내용은 로그 애널리틱스 제한사항을 참조하세요.

FROM 절에는 정확히 1개의 뷰 오류 메시지가 포함되어야 합니다.

Google Cloud 콘솔의 로그 분석 페이지의 쿼리 창에 SQL 쿼리를 입력하지만 SQL 파서에 다음 오류가 표시됩니다.

FROM clause must contain exactly one log view

FROM 문에 지정된 테이블을 특정 로그 뷰로 확인할 수 없는 경우 이전 오류가 보고됩니다.

이 오류를 해결하려면 테이블 이름에 적절한 구문이 있는지 확인합니다.

테이블 이름이 로그 애널리틱스 이름 지정 스키마에 필요한 구문을 따르는지 확인합니다. BigQuery와 로그 분석의 테이블 이름 요구사항은 서로 다릅니다. 기본 쿼리를 확인하여 테이블 이름에 필요한 구문을 찾을 수 있습니다.
로그 버킷의 Google Cloud 프로젝트 ID, 리전, 버킷 ID 또는 뷰 ID에 마침표 문자 (.)가 포함된 경우 각 필드가 작은따옴표인 (`)로 래핑되는지 확인합니다.

예를 들어 Google Cloud 프로젝트 ID가 example.com:bluebird인 경우 _Default 로그 버킷의 _AllLogs 뷰를 쿼리하려면 다음 구문을 사용하여 테이블을 지정합니다.
```
SELECT *
FROM `example.com:bluebird`.`global`.`_Default`.`_AllLogs`
```
이전 쿼리는 _Default 버킷이 global 리전에 있다고 가정합니다.

쿼리를 저장할 수 없음

SQL 쿼리를 입력하고 실행하면 저장이 비활성화되며, 조직 또는 폴더의 기본 리소스 설정이 조직 정책에서 허용하지 않는 위치를 정의합니다. 이 문제를 해결하려면 조직의 관리자에게 조직 정책에서 허용하는 위치와 일치하도록 기본 리소스 설정에 위치를 정의하도록 요청하세요. 자세한 내용은 조직 및 폴더의 기본 설정 구성을 참조하세요.

저장 버튼이 활성화되었지만 대화상자를 완료하고 쿼리를 저장할 수 없으면 다음을 수행합니다.

쿼리에 구문 오류가 포함되어 있지 않은지 확인합니다. 유효한 쿼리만 저장할 수 있습니다.
선택사항: 쿼리를 클립보드에 복사합니다.
페이지를 새로고침합니다.
쿼리를 클립보드에 복사한 후 쿼리를 쿼리 창에 붙여넣고 쿼리를 실행한 후 저장 작업을 수행합니다.

로그 분석 페이지에 대한 액세스가 거부됨

Google Cloud 콘솔에서 로그 애널리틱스 페이지를 열면 권한 거부됨 오류 메시지가 표시됩니다.

로그 애널리틱스 페이지를 로드하고, 쿼리를 실행하고, 로그를 보는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요

로그 보기: 로그 뷰어(roles/logging.viewer)
커스텀 로그 버킷에서 로그 보기: 로그 뷰 접근자(roles/logging.viewAccessor)

커스텀 역할이나 Logging 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

로그 분석 페이지에서 로그 항목을 보고 쿼리를 실행하는 데 필요한 권한은 로그 탐색기에서 로그를 보는 데 필요한 권한과 동일합니다. 사용자 정의 버킷의 뷰를 쿼리하거나 _Default 로그 버킷의 _AllLogs 뷰를 쿼리해야 하는 추가 역할에 대한 자세한 내용은 Cloud Logging 역할을 참조하세요.

로그 분석을 사용할 수 있도록 로그 버킷 업그레이드 실패

로그 버킷을 만들고 로그 애널리틱스 사용 옵션을 선택하거나 로그 애널리틱스를 사용하도록 기존 로그 버킷을 업그레이드합니다. 다음과 유사한 오류 조건으로 업그레이드가 실패합니다.

Failed precondition (HTTP 400): Constraint "my-constraint" violated for PROJECT_ID  with location global.

이전의 오류 메시지는 조직에서 사용할 수 있는 리전을 제한하는 조직 정책을 구성했음을 나타냅니다. 로그 애널리틱스를 사용하도록 업그레이드할 수 있는 로그 버킷은 global 리전을 사용해야 합니다. global 리전 사용을 제한하는 조직 정책을 삭제할 수 있는 경우 로그 버킷을 업그레이드할 수 있습니다. 그렇지 않으면 로그 버킷을 업그레이드할 수 없습니다.

연결된 BigQuery 데이터 세트를 만들 수 없습니다.

로그 버킷을 수정하여 연결된 BigQuery 데이터 세트를 만들거나 새 로그 버킷을 만들고 연결된 데이터 세트를 만드는 옵션을 선택합니다. 하지만 연결된 데이터 세트는 생성되지 않습니다.

이 오류를 해결하려면 Google Cloud 프로젝트의 시스템 관리자에게 다음 권한이 포함된 IAM 역할을 부여하도록 요청합니다.

logging.links.create

이전 권한은 Logging 관리자(roles/logging.admin) 및 로그 구성 작성자(roles/logging.configWriter) 역할에 포함되어 있습니다.

역할 및 권한에 대한 자세한 내용은 IAM으로 액세스 제어를 참조하세요.

연결된 BigQuery 데이터 세트를 삭제할 수 없음

연결된 데이터 세트를 더 이상 원하지 않지만 데이터 세트 삭제 옵션이 비활성화되었습니다.