operations list 명령어를 사용하면 모든 실행 중인 작업과 최근에 완료된 내보내기/가져오기 작업을 볼 수 있습니다.
gcloud firestore operations list
관리자 작업 감사 로그
Firestore는 내보내기 작업, 가져오기 작업, 색인 생성 작업에 대한 감사 로그를 작성합니다. 자세한 내용은 Firestore 감사 로깅 정보를 참조하세요.
Console 사용량
Firebase Console 및 Cloud Console의 Firestore 데이터 뷰어가 수행한 읽기 작업은 Firestore 청구 사용량에 포함되지 않습니다. Firestore 페이지를 열거나 새로고침하면 Console에서 문서를 로드하여 페이지를 채웁니다. Firestore 페이지가 열려 있으면 Console에서 실시간 쿼리를 사용하여 표시되는 문서와 컬렉션을 업데이트합니다.
사용량을 분석할 때 Console 사용량을 Firestore 작업의 다른 출처로 고려하세요. 청구 보고서에서는 콘솔 트래픽을 애플리케이션 트래픽과 구분할 수 있는 방법이 없습니다.
청구 작업
가격 책정 정보 외에도 앱에서 예상보다 빠르게 청구 비용이 증가할 수 있는 다음 작업이 있는지 검토하세요.
실시간 업데이트
쿼리 결과를 수신 대기하면 결과 집합의 문서가 추가되거나 업데이트될 때마다 읽기 요금이 부과됩니다. 또한 결과 집합에서 문서가 삭제될 때도 문서가 변경되므로 읽기 요금이 부과됩니다. 반면, 문서 자체가 삭제되면 읽기 요금이 부과되지 않습니다.
실시간 리스너의 범위를 검토합니다. 광범위한 쿼리의 결과를 수신하거나 전체 컬렉션을 수신 대기하면 필요한 것보다 많은 읽기 작업이 수행될 수 있습니다.
노옵스(no-ops) 쓰기 및 노옵스(no-ops) 삭제
노옵스(no-ops)는 이 문서에서 변경한 사항이 없는 작업입니다. 노옵스(no-ops) 쓰기 및 삭제 요금이 계속 부과됩니다.
삭제 작업의 경우 해당 문서가 없는 경우에도 요금이 부과됩니다.
쓰기 작업의 경우 변경한 사항이 없어도 요금이 부과됩니다. 예를 들어 문서 필드를 동일한 필드 값으로 업데이트하는 작업에는 요금이 부과됩니다.
쿼리 오프셋
쿼리 오프셋은 지정된 수의 쿼리 결과를 건너뛰지만 건너뛴 결과는 여전히 청구에 집계됩니다. 이 같은 추가 비용이 부과되므로 오프셋 대신 커서를 사용해야 합니다.
사용량 대시보드 불일치
Firebase 및 Cloud Console의 Firestore 사용량 대시보드는 예상 사용량을 제공합니다. 이는 사용량 급증을 식별하는 데 도움이 됩니다.
하지만 대시보드는 청구 작업의 정확한 뷰가 아닙니다. 청구 사용량이 더 높을 수 있습니다. 불일치가 발생하는 경우 언제나 청구 보고서가 사용량 대시보드보다 우선합니다.
사용량 대시보드와 청구 사용량 사이에 불일치를 일으킬 수 있는 작업은 다음과 같습니다.
가져오기 및 내보내기 작업 이러한 작업으로 수행되는 읽기 및 쓰기는 사용량 대시보드에 표시되지 않습니다.
노옵스(no-ops) 확인 전용 쓰기: 문서의 존재 여부만 확인하는 쓰기는 청구 대상 읽기 작업에 속하지만 쓰기 사용량 대시보드에 각각 'UPDATE_NOOP' 및 'DELETE_NOOP'로 표시됩니다.
노옵스(no-ops) 쓰기: 필드 값을 변경하지 않는 업데이트 또는 삭제된 문서에 대한 쓰기 등 데이터베이스가 변경되지 않는 작업은 사용량 대시보드에 'UPDATE_NOOP' 또는 'DELETE_NOOP'로 표시될 수 있습니다. 'NOOP'로 표시되더라도 청구 대상 작업에 속합니다.
축소된 쓰기: 동일한 문서에 여러 번의 쓰기 작업이 연속으로 빠르게 발생하는 경우 사용량 대시보드는 여러 번의 쓰기를 한 번의 쓰기로 축소하여 계산할 수 있습니다. 청구 사용량에서 각각의 쓰기는 별도로 계산됩니다.
또한 사용량 대시보드는 서버 타임스탬프, 숫자 증가, 배열 통합 작업과 같은 필드 변환에 대한 쓰기도 축소합니다. 사용량 대시보드는 필드 변환의 여러 작업을 단일 작업으로 계산할 수 있습니다.
0개의 결과를 반환하는 쿼리: 결과가 0개인 쿼리는 읽기 작업 1회에 대한 비용이 발생합니다. 이 사용량에는 요금이 청구되지만 사용량 대시보드에는 표시되지 않습니다.
색인 항목 읽기의 읽기 작업. 이 사용량에는 요금이 청구되지만 사용량 대시보드에는 표시되지 않습니다. 예를 들어 집계 쿼리는 읽은 색인 항목에 대해 요금이 청구되지만 이 사용량은 사용량 대시보드에 표시되지 않습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[],[],null,["# Understanding your billing report\n=================================\n\nThis page gives tips and resources to help you understand your Firestore billing\nreport. This page covers the following common sources of billing questions:\n\n- Outside of app usage, sources of costs include import operations, export operations, and console usage.\n- Within your app, real-time updates, no-op writes, and query offsets can make your usage rise faster than expected.\n- As you use the usage dashboard in the console, note the discrepancies between the dashboard and the billing report.\n\nImport and Export Usage\n-----------------------\n\nWhen breaking down your billing report, make sure to review costs related to\n[import and export operations](/firestore/docs/manage-data/export-import).\nThese operations perform read and write operations\nwhich count towards your Firestore billing. Depending on how often you import\nand export data, these operations can make up a significant source of billed\noperations.\n\nNote that the usage dashboard in the console does not reflect reads and writes\nfrom import and export operations. You can view import/export operations and\nrelated costs in the following ways:\n\n### Billing Labels\n\nExport and import operations apply the `goog-firestoremanaged:exportimport`\nlabel to their read and write operations. In the Cloud Billing reports page,\nyou can use this label to view costs related to import and export operations:\n\n### List recent operations\n\nYou can view recent import and export operations using the console or `gcloud`. \n\n### Console\n\nYou can view a list of recent export and import operations in the\n**Firestore Import/Export** page of the Google Cloud console.\n\n[Go to the Import/Export page](https://console.cloud.google.com/firestore/import-export)\n\n### gcloud\n\nUse the [`operations list`](/sdk/gcloud/reference/firestore/operations/list) command to see all running and\nrecently completed export and import operations: \n\n```\ngcloud firestore operations list\n```\n\n### Audit Logs for admin operations\n\nFirestore writes audit logs for export operations, import operations, and\nindexing operations, see [Firestore audit logging information](/firestore/docs/audit-logging).\n\nConsole usage\n-------------\n\nRead operations performed by the Firestore data viewer in the Firebase Console\nand Cloud console count towards your billed Firestore usage. When you open or\nrefresh the Firestore page, the console loads documents to populate the page. As\nlong as the Firestore page remains open, the console uses real-time queries to\nupdate visible documents and collections.\n\nAs you breakdown your usage, factor in console usage as another source of\nFirestore operations. In your billing report, there is no way to distinguish\nconsole traffic from application traffic.\n\nBilled operations\n-----------------\n\nIn addition to the [pricing information](/firestore/pricing), review your app for the following\noperations which can lead to billing rising faster than expected:\n\n- **Real-time updates**\n\n When you\n [listen to the results of a query](/firestore/docs/query-data/listen), you\n are charged for a read each time a document in the result set is added or\n updated. You are also charged for a read when a document is removed from the\n result set because the document has changed. (In contrast, when a document\n is deleted, you are not charged for a read.)\n\n Review the scope of your real-time listeners. Listening to the results of a\n very broad query or listening to an entire collection might result in more\n read operations than required.\n- **No-op writes and no-op deletes**\n\n A no-op is an operation that does not result in changes to any documents. You\n still incur charges for no-op writes and deletes.\n\n For a delete operation, you incur charges even if the given document doesn't\n exist.\n\n For a write operation, you still incur charges if the operations result in no\n changes. For example, an operation that updates a document field to the same\n field value incurs charges.\n- **Query offsets**\n\n [Query offsets](https://googleapis.dev/nodejs/firestore/latest/Query.html#offset) skip a specified number of query results but skipped\n results still count towards billing. Because of this additional cost, you\n should use [cursors](/firestore/docs/query-data/query-cursors) instead of\n offsets.\n\nUsage dashboard discrepancies\n-----------------------------\n\nThe Firestore usage dashboards in the Firebase and Cloud consoles\nprovide an estimate of usage. They can help you identify spikes in usage.\nHowever, the dashboard is not an exact view of billed operations. Billed usage\nis likely higher. In all cases of discrepancy, the billing report takes\nprecedence over the usage dashboard.\n\nOperations that cause discrepancies between the usage dashboard and billed\nusage include:\n\n- Import and export operations. Reads and writes performed by these operations do not show up in the usage dashboard.\n- No-op verify-only writes. Writes that only verify the existence or non-existence of a document contribute to billed read operations, but they show as \\`UPDATE_NOOP\\` and \\`DELETE_NOOP\\` respectively in the write usage dashboard.\n- No-op writes. Operations that do not result in a change to the database, such as an update that does not change field values or a write to a deleted document may show in the usage dashboard as \\`UPDATE_NOOP\\` or \\`DELETE_NOOP\\`. Even though they show as \\`NOOP\\`, they still contribute to billed operations.\n-\n Collapsed writes. In cases with multiple writes to the same document in quick\n succession, the usage dashboard might collapse multiple writes together and\n count them as one. When billing usage, each write is still counted separately.\n\n\n The usage dashboard also collapses writes for field transforms like server timestamps, numeric increments, and array union operations. For field transforms, the usage dashboard might count multiple operations as a single operation.\n- Queries that return zero results. Queries with zero results incur a cost of one read operation. This usage is billed but does not appear in the usage dashboard.\n- Read operations from [index entries read](/firestore/pricing#index-reads). This usage is billed but does not appear in the usage dashboard. For example, aggregation queries bill for index entries read but this usage does not appear in the usage dashboard.\n\nWhat's next\n-----------\n\nFor more help with your billing report, contact [Cloud Billing Support](/support/billing)."]]
