Through these dashboards, you can filter the metric values by namespace, Task
Order (TO), or Contract Line Item Number (CLIN).
Before you begin
To get the permissions you need to access the billing usage and projected cost
dashboards, ask your Organization IAM admin to grant you the corresponding
role in the applicable namespace.
Filter namespace metric values
To filter metric values by labels on namespaces, perform the following query
in the Explore page of the monitoring instance:
none
sum by (label_CONVERTED_LABEL_NAME) (METRIC_NAME{} * on (cluster, namespace) \
group_left(label_CONVERTED_LABEL_NAME) \
kube_namespace_labels{label_CONVERTED_LABEL_NAME=LABEL_VALUE})
Replace the following variables:
CONVERTED_LABEL_NAME: the label key to filter metric
values. Replace all non-alphabetic characters in this label with the
underscore _. For example: app.kubernetes.io/component becomes
app_kubernetes_io_component.
METRIC_NAME: the name of the billing-related metrics.
LABEL_VALUE: the label value to filter metrics.
Filter pod metric values
To filter metric values by labels on pods, perform the following query
in the Explore page of the monitoring instance:
none
sum by (label_CONVERTED_LABEL_NAME) (METRIC_NAME{} * on (cluster, namespace, pod) \
group_left(label_CONVERTED_LABEL_NAME) \
kube_pod_labels{label_CONVERTED_LABEL_NAME=LABEL_VALUE})
[[["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\u003eBilling metrics can be queried and visualized using the Billing Usage and Projected Cost dashboards.\u003c/p\u003e\n"],["\u003cp\u003eThe dashboards provide visualizations for various billing-related metrics, including \u003ccode\u003eserver_org_count\u003c/code\u003e, \u003ccode\u003ekube_namespace_resource_usage\u003c/code\u003e, and several others related to storage, backups, and AI usage.\u003c/p\u003e\n"],["\u003cp\u003eMetric values can be filtered by namespace, Task Order (TO), or Contract Line Item Number (CLIN).\u003c/p\u003e\n"],["\u003cp\u003eTo filter metric values by labels on namespaces or pods, specific queries can be used in the \u003cstrong\u003eExplore\u003c/strong\u003e page of the monitoring instance by inputting the metric name, label name, and label value.\u003c/p\u003e\n"],["\u003cp\u003eAccess to the billing usage and projected cost dashboards requires the appropriate permissions, granted by an Organization IAM admin.\u003c/p\u003e\n"]]],[],null,["# Query billing metrics\n\nTo query and visualize billing metrics, use the\n[Billing Usage](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/billing/track-resource-consumption)\nand\n[Projected Cost](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/billing/estimate-projected-costs)\ndashboards.\n\nThese dashboards provide visualizations on the following billing related\nmetrics:\n\n- `server_org_count`\n- `kube_namespace_resource_usage`\n- `pod:kube_pod_container_resource_requests:sum`\n- `metering_storage_organization_allocated_capacity_bytes`\n- `metering_storage_allocated_capacity_bytes`\n- `metering_gdcbackup_protected_pods_count`\n- `metering_gdcbackup_protected_vms_count`\n- `ai_vision_usage`\n- `ai_speech_audio_length_sum`\n- `ai_translation_usage_codepoints`\n\nThrough these dashboards, you can filter the metric values by namespace, Task\nOrder (TO), or Contract Line Item Number (CLIN).\n| **Note:** Contact your Infrastructure Operator to request the TO or CLIN necessary to filter metric values.\n\nBefore you begin\n----------------\n\nTo get the permissions you need to access the billing usage and projected cost\ndashboards, ask your Organization IAM admin to grant you the corresponding\nrole in the applicable namespace.\n\nFilter namespace metric values\n------------------------------\n\n- To filter metric values by labels on namespaces, perform the following query in the **Explore** page of the monitoring instance:\n\n`none\nsum by (label_`\u003cvar translate=\"no\"\u003eCONVERTED_LABEL_NAME\u003c/var\u003e`) (`\u003cvar translate=\"no\"\u003eMETRIC_NAME\u003c/var\u003e`{} * on (cluster, namespace) \\\ngroup_left(label_`\u003cvar translate=\"no\"\u003eCONVERTED_LABEL_NAME\u003c/var\u003e`) \\\nkube_namespace_labels{label_`\u003cvar translate=\"no\"\u003eCONVERTED_LABEL_NAME\u003c/var\u003e`=`\u003cvar translate=\"no\"\u003eLABEL_VALUE\u003c/var\u003e`})`\n\n\u003cbr /\u003e\n\nReplace the following variables:\n\n- \u003cvar translate=\"no\"\u003eCONVERTED_LABEL_NAME\u003c/var\u003e: the label key to filter metric values. Replace all non-alphabetic characters in this label with the underscore `_`. For example: `app.kubernetes.io/component` becomes `app_kubernetes_io_component`.\n- \u003cvar translate=\"no\"\u003eMETRIC_NAME\u003c/var\u003e: the name of the billing-related metrics.\n- \u003cvar translate=\"no\"\u003eLABEL_VALUE\u003c/var\u003e: the label value to filter metrics.\n\nFilter pod metric values\n------------------------\n\n- To filter metric values by labels on pods, perform the following query in the **Explore** page of the monitoring instance:\n\n`none\nsum by (label_`\u003cvar translate=\"no\"\u003eCONVERTED_LABEL_NAME\u003c/var\u003e`) (`\u003cvar translate=\"no\"\u003eMETRIC_NAME\u003c/var\u003e`{} * on (cluster, namespace, pod) \\\ngroup_left(label_`\u003cvar translate=\"no\"\u003eCONVERTED_LABEL_NAME\u003c/var\u003e`) \\\nkube_pod_labels{label_`\u003cvar translate=\"no\"\u003eCONVERTED_LABEL_NAME\u003c/var\u003e`=`\u003cvar translate=\"no\"\u003eLABEL_VALUE\u003c/var\u003e`})`"]]
