Stay organized with collections
Save and categorize content based on your preferences.
Monitoring billing for tenants
All tenants are billed as part of their Identity Platform project.
This document explains how to export billing data and monitor the cost of
individual tenants.
Before you begin
To export tenant billing data, you'll need to be granted the
IAM Owner role (roles/owner) on the following:
An Identity Platform project with multi-tenancy enabled.
Select the table containing your project's billing information.
Click Compose Query to open the query editor.
Enter a query.
To list the total cost for each tenant, use the following,
replacing dataset-name.table-name with the name of the billing dataset
and table you exported in step 1:
All monthly active user reports have a start time at the beginning
of the month. You can use WHERE usage_start_time and the first day of the
month (expressed in Pacific Time) to filter on a monthly basis. For example,
to list the cost of each tenant for August 2019:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eTenants are billed as part of their Identity Platform project, and this guide explains how to monitor those costs.\u003c/p\u003e\n"],["\u003cp\u003eTo export billing data, you need the IAM Owner role on your Identity Platform project with multi-tenancy enabled and the linked billing account.\u003c/p\u003e\n"],["\u003cp\u003eBilling data can be exported to BigQuery, but note that historical data is not backfilled, so it's recommended to set up exporting before opening to customer traffic.\u003c/p\u003e\n"],["\u003cp\u003eYou can use SQL queries in BigQuery to list the total cost for each tenant or filter costs for a specific month or tenant ID.\u003c/p\u003e\n"],["\u003cp\u003eBilling export to BigQuery needs to only be completed once per project.\u003c/p\u003e\n"]]],[],null,["# Monitoring billing for tenants\n==============================\n\nAll tenants are billed as part of their Identity Platform project.\nThis document explains how to export billing data and monitor the cost of\nindividual tenants.\n\nBefore you begin\n----------------\n\nTo export tenant billing data, you'll need to be granted the\nIAM Owner role (`roles/owner`) on the following:\n\n- An Identity Platform project with multi-tenancy enabled.\n- The billing account linked to your project.\n\nEnabling billing export to BigQuery\n-----------------------------------\n\nTo make billing data available in BigQuery, follow the steps in\n[Export billing data to BigQuery](/billing/docs/how-to/export-data-bigquery).\n| **Note:** Data is not backfilled for the timeframe before exporting is enabled, so you should configure exporting before opening your project to customer traffic to ensure you have an accurate dataset.\n\nYou only need to complete the step once per project.\n\nQuerying billing data\n---------------------\n\n1. Open the BigQuery page in the Google Cloud console. \n\n [Go to the BigQuery page](https://console.cloud.google.com/bigquery)\n\n2. Select the table containing your project's billing information.\n\n3. Click **Compose Query** to open the query editor.\n\n4. Enter a query.\n\n To list the total cost for each tenant, use the following,\n replacing `dataset-name.table-name` with the name of the billing dataset\n and table you exported in step 1: \n\n SELECT labels.value as Tenant, SUM(cost) as TenantCost\n FROM [dataset-name.table-name]\n WHERE labels.key = \"goog-identitytoolkit-tenant\"\n GROUP BY 1\n\n All monthly active user reports have a start time at the beginning\n of the month. You can use `WHERE usage_start_time` and the first day of the\n month (expressed in Pacific Time) to filter on a monthly basis. For example,\n to list the cost of each tenant for August 2019: \n\n SELECT labels.value as Tenant, SUM(cost) as TenantCost\n FROM [dataset-name.table-name]\n WHERE labels.key = \"goog-identitytoolkit-tenant\"\n AND usage_start_time = \"2019-08-01 00:00:00 -07:00\"\n GROUP BY 1\n\n You can also get the costs for one specific tenant. Replace `tenant-id` with\n the ID of your tenant in the following example: \n\n SELECT labels.value as Tenant, SUM(cost) as TenantCost\n FROM [dataset-name.table-name]\n WHERE labels.key = \"goog-identitytoolkit-tenant\"\n AND labels.value = \"tenant-id\"\n GROUP BY 1\n\n5. Click **Run query** to execute it.\n\nYou should see a billing breakdown specific to one particular tenant.\n\nWhat's next\n-----------\n\n- [Learn more about billing on Google Cloud](/billing/docs/concepts).\n- [See pricing for Identity Platform](/identity-platform/pricing)."]]