[null,null,["Last updated 2025-08-15 UTC."],[],[],null,["\u003cbr /\u003e\n\nThe following values are returned as results to operations performed with\n[Firestore Query Explain](../query-explain).\n| **Note:** Query Explain is designed for useful ad hoc analysis; its report format will evolve to maximize ease of reading and understanding, not suitability for machine processing. Some metrics are expected to change as Cloud Firestore evolves (i.e., metrics may be added, removed, or updated) and are not covered by the same deprecation policy as other Cloud Firestore APIs. The following tables indicate which portions of the data are subject to change.\n\nPlan records\n\n| Key | Type | Field subject to change? | Description |\n|--------------|--------------------------------------------------------------------------------------------|-----------------------------------------------------------------|----------------------------------------------------------------------------------------------|\n| indexes_used | List of [Generic Structs](https://protobuf.dev/reference/protobuf/google.protobuf/#struct) | Yes, the contents in the Struct response are subject to change. | List of indexes selected for this query. See [below](#query-analyze-reference-indexes-used). |\n\nIndexes used\n\nThe contents of indexes used are subject to change as Cloud Firestore evolves.\n\n| Key | Type | Description |\n|-------------|--------|------------------------------------------------------------------------------------------------------------|\n| query_scope | String | The scope at which a query is run. For example: `Collection`, `Collection Group` and `Includes Ancestors`. |\n| properties | String | The index fields in a format. For example: `(age ASC, __name__ ASC)`. |\n\nExecution statistics\n\nAggregated execution statistics for the query.\n\n| Key | Type | Field subject to change? | Description |\n|--------------------|-----------------------------------------------------------------------------------|-----------------------------------------------------------------|----------------------------------------------------------------------------------------------------------|\n| results_returned | long | No | Total number of results returned, including documents, projections, aggregation results, keys. |\n| execution_duration | [Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration) | No | Total time to execute the query in the backend. |\n| read_operations | long | No | Total billable read operations. |\n| debug_stats | [Generic Struct](https://protobuf.dev/reference/protobuf/google.protobuf/#struct) | Yes, the contents in the Struct response are subject to change. | Debugging statistics from the execution of the query. See [below](#query-analyze-reference-debug-stats). |\n\nDebug statistics\n\nThe following results are helpful for debugging use cases and analysis of raw,\noptional statistics.\n\nThe contents of debug statistics are subject to change as Cloud Firestore evolves.\n\n| Key | Type | Description |\n|-----------------------|-----------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------|\n| index_entries_scanned | String | Total number of index entries inspected during the query. |\n| documents_scanned | String | Total number of documents scanned during the query. |\n| billing_details | [Generic Struct](https://protobuf.dev/reference/protobuf/google.protobuf/#struct) | Billing details including metrics like: \"documents_billable\", \"index_entries_billable\", \"knn_vector_index_entries_billable\", \"min_query_cost\". |"]]
