Committed Use Discounts (CUD) Export

Learn how to enable and configure CUD metadata export in Google Cloud, grant access, and connect it to Ternary for commitment tracking and reporting.

Organizations that use Committed Use Discounts (CUDs) can enable the CUD Metadata Export to provide visibility into commitment terms, expiration, and utilization. Ternary ingests this export to support commitment analysis and reporting. This export must be enabled at the Billing Account level, not at the project level.

Step 1: Enable CUD Metadata Export in Google Cloud

  • Open Google Cloud Console → Billing → Billing Export and locate Committed Use Discounts Export (Preview).
  • Select Edit Settings and configure the export.
  • Under Linked Dataset Name, select the project where Ternary billing data is stored.
  • Create a new BigQuery dataset dedicated to the CUD export. Google requires a new dataset for this export and does not allow reuse of datasets used for Standard, Detailed, or Pricing exports.
  • Set Location Type to Region and choose the same region used for the primary billing export.
  • Select Save to enable the export.

Step 2: Grant Ternary access to the CUD dataset

  • Open BigQuery in the Google Cloud Console and select the project containing the new CUD Metadata dataset.
  • Open Share → Manage Permissions for the dataset and add the Ternary service account as a principal. Assign the BigQuery Data Viewer role.
  • The Ternary service account ID is available in the Ternary Admin panel → Tenant tab.

Step 3: Configure CUD Metadata Export in Ternary

After enabling the export in Google Cloud, update the Google Cloud configuration in Ternary.

  • Open Admin → Integrations → Edit.
  • Add a new billing export by selecting CUD Metadata Export and provide the Table ID from the BigQuery CUD dataset. Save the configuration and submit the update.
  • After submission, the CUD Metadata Export appears alongside existing billing exports. No additional configuration is required.

Viewing CUDs in Google Cloud

Commitment details can also be reviewed directly in the Google Cloud Console.

  • Navigate to Commitments → SQL Commitments or the relevant service for the commitment type.

  • The console displays:

    -- Commitment type
    -- Term (start and end dates)
    -- Region and SKU
    -- Current utilization

Ternary uses this metadata to display remaining term, effective unit pricing, and utilization efficiency. This ensures alignment between Google Cloud billing data and Ternary reporting.

Reviewing Requirements

RequirementDescription
Billing Account Admin AccessRequired to enable CUD Metadata Export
Must use a new datasetRequired by Google to initialize the export
Dataset regionNote the region of your existing Ternary billing export

After configuration is complete:

  • CUD Metadata appears in Ternary → Cloud → Commitments
  • Commitment reporting reflects active and expiring commitments
  • Data remains consistent between Google Cloud billing, BigQuery, and Ternary