이 페이지에서는 Spanner 인스턴스에서 실행 중인 쿼리를 모니터링하고 문제 해결하는 방법을 설명합니다. 활성 쿼리는 인스턴스 성능에 영향을 줄 수 있는 장기 실행 쿼리입니다. 이러한 쿼리를 모니터링하면 인스턴스 지연 시간 및 높은 CPU 사용량의 원인을 파악하는 데 도움이 될 수 있습니다.
Google Cloud 콘솔을 사용하면 Spanner 쿼리 통계 페이지에서 활성 쿼리를 볼 수 있습니다. 이러한 쿼리는 쿼리 시작 시간순으로 정렬됩니다. 활성 쿼리가 많으면 Spanner에서 데이터 수집에 적용하는 메모리 제약조건으로 인해 결과가 총 쿼리의 일부로 제한될 수 있습니다.
시작하기 전에
활성 쿼리를 보는 데 필요한 권한을 얻으려면 관리자에게 인스턴스에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.
-
Cloud Spanner 뷰어(
roles/spanner.viewer) -
Cloud Spanner 데이터베이스 리더(
roles/spanner.databaseReader)
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
활성 쿼리 보기
각 데이터베이스의 활성 쿼리를 보려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 Spanner 인스턴스 페이지로 이동합니다.
모니터링할 쿼리가 포함된 인스턴스를 클릭합니다.
탐색 메뉴에서 쿼리 통계를 클릭합니다.
데이터베이스 메뉴를 사용하여 모니터링할 데이터베이스를 지정합니다.
활성 쿼리 탭을 클릭합니다. 이 탭에는 활성 쿼리의 요약과 가장 오래 실행된 활성 쿼리 50개가 표로 표시됩니다.
가장 오래 실행 중인 쿼리 보기
다음 표에서는 진행 중인 쿼리 탭의 가장 오래 실행 중인 쿼리 테이블에 있는 열을 설명합니다.
| 열 이름 | 설명 |
|---|---|
| 쿼리 ID | 쿼리의 고유 식별자입니다. |
| 쿼리 | SQL 쿼리 텍스트입니다. |
| 디지털 지문 | REQUEST_TAG 또는 SQL 쿼리 텍스트의 해시입니다. |
| 시작 시간 | 쿼리가 시작된 시점의 타임스탬프입니다. |
| 쿼리 기간 | 활성 쿼리가 실행된 시간입니다. |
| 작업 | 쿼리를 종료하는 링크가 포함됩니다. |
자동 새로고침 전환 버튼이 사용 설정되어 있으면 디스플레이가 60초마다 새로고침됩니다.
쿼리 종료
인스턴스에서 실행 중인 쿼리를 종료할 수 있습니다. 쿼리를 종료하면 리소스를 확보하고 인스턴스의 부하를 줄일 수 있습니다. 쿼리 종료는 최선의 작업입니다.
종료를 시작하면 Google Cloud 콘솔 페이지가 새로고침됩니다. 종료가 성공하면 쿼리가 테이블에서 삭제됩니다. 종료에 실패하면 백그라운드에서 종료되며 쿼리는 가장 오래 실행 중인 쿼리 표에 계속 표시됩니다.
서버가 사용 중이면 Spanner에서 쿼리를 취소하지 못할 수 있습니다. 쿼리를 다시 종료하여 취소할 수 있습니다.
쿼리를 종료하는 데 필요한 권한을 얻으려면 관리자에게 인스턴스에 대한 Cloud Spanner 데이터베이스 리더 (spanner.databaseReader) IAM 역할을 부여해 달라고 요청하세요.
쿼리를 종료하려면 다음 단계를 따르세요.
- 가장 오래 실행 중인 쿼리 테이블에서 종료할 쿼리를 선택합니다.
- 작업 열에서 종료를 클릭합니다.
- 연결 종료 창에서 확인을 클릭합니다.
다음 단계
- 쿼리 성능 분석에 대해 자세히 알아보세요.
- 가장 오래된 활성 쿼리 통계에 대해 자세히 알아보세요.