사용량 모니터링

이 페이지에서는 Firestore 사용량을 모니터링하고 앱의 잠재적 문제를 파악하는 방법을 설명합니다. 앱 사용량을 살펴보면 청구 비용을 예상할 수 있습니다. 또한 데이터베이스 작업을 명확하게 파악할 수 있어 문제가 발견할 경우 문제해결 도구로도 유용합니다.

사용량 대시보드

Google Cloud Console과 Firebase Console에는 시간 경과에 따른 문서 읽기, 쓰기, 삭제를 보여주는 Firestore 사용량 대시보드가 있습니다.

Cloud Console

Firestore 사용량 페이지(Cloud Console)로 이동

Cloud Console의 Firestore 사용량 대시보드

액세스 제어

사용량 대시보드에는 monitoring.timeSeries.list IAM 권한이 필요합니다. 프로젝트 소유자, 편집자, 뷰어 역할이 이 권한을 부여합니다. Cloud Monitoring 역할 또는 커스텀 역할을 통해 이 권한을 부여할 수도 있습니다.

Firebase 콘솔

Firestore 사용량 페이지(Firebase Console)로 이동

Firebase Console의 Firestore 사용량 대시보드

보안 규칙 사용

또한 Firebase Console은 규칙 호출을 한 눈에 볼 수 있는 유용한 보안 규칙 평가 대시보드를 제공합니다. Cloud Monitoring의 자세한 분석으로 이 대시보드를 보완할 수 있습니다.

규칙 페이지로 이동

Firebase Console의 Firestore 규칙 모니터링 대시보드

일일 할당량

Cloud Console의 App Engine 할당량 페이지에서는 읽기, 쓰기, 색인 쓰기, 삭제, 저장된 데이터, 네트워크 이그레스와 같은 Firestore 사용량 정보를 매일 추적합니다.

할당량 페이지로 이동

App Engine 할당량 페이지의 Firestore 사용량

Cloud Monitoring

Cloud Monitoring은 Google Cloud 제품에서 측정항목, 이벤트, 메타데이터를 수집합니다. Firestore Console의 사용량 대시보드는 동일한 측정항목 데이터를 보고합니다. 커스텀 대시보드와 사용량 알림을 설정하려면 Cloud Monitoring을 사용합니다.

Cloud Monitoring에는 다음 Firestore 측정항목이 포함됩니다.

측정항목 이름 설명
문서 읽기

성공적인 문서 읽기 횟수입니다. 읽기 유형(LOOKUP 또는 QUERY)에 따라 이 측정항목을 분류할 수 있습니다.

이 측정항목에는 내보내기 관리 작업의 읽기가 포함되지 않습니다.

문서 쓰기

성공적인 문서 쓰기 횟수입니다. 쓰기 유형(CREATE 또는 UPDATE)에 따라 측정항목을 분류할 수 있습니다.

이 측정항목에는 가져오기 관리 작업의 쓰기가 포함되지 않습니다.

문서 삭제 성공적인 문서 삭제 횟수입니다.
활성 연결

데이터베이스에 대한 활성 연결 수입니다.

각 활성 모바일 및 웹 SDK는 여러 스냅샷 리스너 간에 공유할 수 있는 단일 연결을 유지합니다. 서버 클라이언트 라이브러리는 스냅샷 리스너당 하나의 연결을 만듭니다.

스냅샷 리스너

모든 활성 연결의 스냅샷 리스너 수입니다.

규칙 평가

쓰기 또는 읽기 요청에 대한 응답으로 수행된 Firestore 규칙의 평가 수입니다. 요청 결과(ALLOW, DENY 또는 ERROR)를 기준으로 이 측정항목을 분류할 수 있습니다.

실시간 업데이트 사용량

활성 연결과 스냅샷 리스너 측정항목을 사용하여 실시간 업데이트 사용량을 측정합니다.

사용자가 휴대전화에서 앱을 연다고 가정해 보겠습니다. 그러면 앱이 Firestore에 연결되고 쿼리 10개를 구독합니다. 이 경우 측정항목은 활성 연결 1개와 스냅샷 리스너 10개를 기준으로 증가합니다.

샘플링 레이트

Firestore 측정항목은 1분 간격으로 샘플링되지만 업데이트 내용이 대시보드에 표시되는 데 최대 4분이 걸릴 수 있습니다.

이러한 측정항목을 사용하여 다음과 같은 Firestore 대시보드를 설정할 수 있습니다.

Cloud Monitoring 대시보드의 Firestore 사용량

Cloud Monitoring으로 Firestore 모니터링을 시작하려면 다음 단계를 완료하세요.

Cloud Monitoring 작업공간 만들기

Cloud Monitoring으로 Firestore를 모니터링하려면 프로젝트에 작업공간을 설정해야 합니다. 작업공간은 프로젝트 한 개 이상의 모니터링 정보를 구성합니다. 작업공간을 설정한 후 커스텀 대시보드 및 알림 정책을 만들 수 있습니다.

  1. Cloud Monitoring 페이지 열기

    프로젝트가 이미 작업공간의 일부인 경우 Cloud Monitoring 페이지가 열립니다. 그렇지 않으면 프로젝트의 작업 공간을 선택합니다.

  2. 새 작업공간 옵션을 선택하거나 기존 작업공간을 선택합니다.

  3. 추가를 클릭합니다. 작업공간이 빌드되면 Cloud Monitoring 페이지가 열립니다.

대시보드 만들기 및 차트 추가

Cloud Monitoring에서 수집된 Firestore 측정항목을 자체 차트와 대시보드에 표시합니다.

계속하기 전에 프로젝트가 Cloud Monitoring 작업공간의 일부인지 확인하세요.

  1. Cloud Monitoring 페이지에서 작업공간을 열고 대시 보드 페이지로 이동합니다.

    대시보드 페이지로 이동

  2. 대시보드 만들기를 클릭하고 대시보드 이름을 입력합니다.

  3. 오른쪽 상단에서 차트 추가를 클릭합니다.

  4. 차트 추가 창에 차트 제목을 입력합니다. 측정항목 탭을 클릭합니다.

  5. 리소스 유형 및 측정항목 찾기 필드에 Firestore를 입력합니다. 자동으로 입력된 드롭다운에서 Firestore 측정항목 중 하나를 선택합니다.

  6. 동일한 차트에 측정항목을 더 추가하려면 측정항목 추가를 클릭하고 이전 단계를 반복합니다.

  7. 필요에 따라 차트를 맞춤 설정합니다. 예를 들어 필터 필드에서 + 필터 추가를 클릭합니다. 아래로 스크롤한 후 차트에서 필터링할 측정항목 값 또는 범위를 선택합니다.

  8. 저장을 클릭합니다.

Cloud Monitoring 차트에 대한 자세한 내용은 차트 다루기를 참조하세요.

알림 정책 만들기

Firestore 측정항목을 기반으로 알림 정책을 만들 수 있습니다. 다음 단계를 수행하면 특정 Firestore 측정항목이 특정 임곗값에 도달할 때마다 이메일을 보내는 알림 정책을 만들 수 있습니다.

계속하기 전에 프로젝트가 Cloud Monitoring 작업공간의 일부인지 확인하세요.

  1. Cloud Monitoring 페이지에서 작업공간을 열고 알림 페이지로 이동합니다.

    새 알림 정책 만들기 페이지로 이동

  2. 정책 만들기를 클릭합니다.

  3. 알림 정책 이름을 입력합니다.

  4. Firestore 측정항목 중 하나를 기반으로 알림 조건을 추가합니다. 조건 추가를 클릭합니다.

  5. 대상을 선택합니다. 리소스 유형 및 측정항목 찾기 필드에 Firestore를 입력합니다. 자동으로 입력된 드롭다운에서 Firestore 측정항목 중 하나를 선택합니다.

  6. 정책 트리거 아래의 드롭다운 필드를 사용하여 알림 조건을 정의합니다.

  7. 알림 정책에 알림 채널을 추가합니다. 알림에서 알림 채널 추가를 클릭합니다. 드롭다운 메뉴에서 이메일을 선택합니다.

  8. 이메일 주소 필드에 이메일을 입력합니다. 추가를 클릭합니다.

  9. 필요한 경우 문서 필드를 작성하여 이메일 알림에 추가 정보를 포함합니다.

  10. 저장을 클릭합니다.

Firestore 사용량이 구성된 임곗값을 초과하면 이메일 알림이 수신됩니다. Firestore 알림 이메일 예시

알림 정책에 관한 자세한 내용은 알림 소개를 참조하세요.

다음 단계