Estructura de la exportación de datos detallados

En este documento, se proporciona información de referencia para el esquema de datos de costo de uso detallados de Facturación de Cloud que se exportan a cada tabla en BigQuery.

Los datos de costos de uso detallados proporcionan toda la información incluida en los datos de costos de uso estándar, junto con campos adicionales que proporcionan datos detallados de costos a nivel de recurso, como una máquina virtual o SSD que genera el uso del servicio. La exportación detallada incluye información detallada de costos de los siguientes servicios:

  • AlloyDB para PostgreSQL
  • App Engine
  • BigQuery
  • Bigtable
  • Cloud Data Fusion
  • Cloud Deploy
  • Funciones de Cloud Run
  • Cloud Logging
  • Cloud Run
  • Cloud SQL
  • Cloud Storage
  • Compute Engine
  • Dataflow
  • Dataproc Metastore
  • Firestore y Datastore
  • Google Kubernetes Engine (GKE)
    Para ver un desglose de los costos del clúster de GKE en una exportación de datos detallada, también debes habilitar la asignación de costos en GKE.
  • Microsoft AD administrado
  • Memorystore for Redis
  • Secret Manager
  • Spanner

Identifica datos de costos detallados por servicio

Para analizar información detallada del costo en una exportación detallada, usa la siguiente tabla a fin de identificar la columna que contiene información sobre recursos específicos.

Descripción del servicio Columna Cómo identificar los recursos
AlloyDB para PostgreSQL service.description y resource.name o resource.global_name

La columna service.description contiene el nombre del servicio. La columna resource.name contiene el nombre que proporciona el usuario. La columna resource.global_name contiene un identificador único para el recurso.
App Engine service.description y resource.name o resource.global_name

La columna service.description contiene el nombre del servicio. La columna resource.name contiene el nombre que proporciona el usuario. La columna resource.global_name contiene un identificador único para el recurso.
BigQuery service.description y resource.name o resource.global_name

La columna service.description contiene el nombre del servicio. La columna resource.name contiene el nombre que proporciona el usuario. La columna resource.global_name contiene un identificador único para el recurso.
Bigtable service.description y resource.global_name

La columna service.description contiene el nombre del servicio. La columna resource.global_name contiene un identificador único para el recurso.
Cloud Data Fusion service.description y resource.name o resource.global_name

La columna service.description contiene el nombre del servicio. La columna resource.name contiene el nombre que proporciona el usuario. La columna resource.global_name contiene un identificador único para el recurso.
Cloud Deploy service.description y resource.name o resource.global_name

La columna service.description contiene el nombre del servicio. La columna resource.name contiene el nombre que proporciona el usuario. La columna resource.global_name contiene un identificador único para el recurso.
Funciones de Cloud Run service.description y resource.name o resource.global_name

La columna service.description contiene el nombre del servicio. La columna resource.name contiene el nombre que proporciona el usuario. La columna resource.global_name contiene un identificador único para el recurso.
Cloud Logging service.description y resource.global_name

La columna service.description contiene el nombre del servicio. La columna resource.global_name contiene un identificador único para el recurso.
Cloud Run service.description y resource.name o resource.global_name

La columna service.description contiene el nombre del servicio. La columna resource.name contiene el nombre que proporciona el usuario. La columna resource.global_name contiene un identificador único para el recurso.

El primer día completo de datos para este servicio es el 1 de diciembre de 2022.
Cloud SQL service.description y resource.global_name

La columna service.description contiene el nombre del servicio y la columna resource.global_name contiene un identificador único para el recurso.
Cloud Storage service.description y resource.global_name

La columna service.description contiene el nombre del servicio. La columna resource.global_name contiene un identificador único para el recurso.
Compute Engine service.description y resource.name o resource.global_name

La columna service.description contiene el nombre del servicio. La columna resource.name contiene el nombre que proporciona el usuario. La columna resource.global_name contiene un identificador único para el recurso.
Dataflow service.description y resource.name o resource.global_name

La columna service.description contiene el nombre del servicio. La columna resource.name contiene el nombre que proporciona el usuario. La columna resource.global_name contiene un identificador único para el recurso.
Dataproc Metastore service.description y resource.name o resource.global_name

La columna service.description contiene el nombre del servicio. La columna resource.name contiene el nombre que proporciona el usuario. La columna resource.global_name contiene un identificador único para el recurso.
Firestore y Datastore service.description y resource.name o resource.global_name

La columna service.description será App Engine. La columna resource.name contiene el nombre que proporciona el usuario. La columna resource.global_name contiene un identificador único para el recurso.
Google Kubernetes Engine (GKE) labels.key

Usa las siguientes claves de etiqueta para filtrar los recursos:

  • goog-fleet-project: Filtra los recursos de tu clúster por proyecto host de la flota, si el clúster está registrado en una flota.
  • goog-k8s-cluster-location: Filtra los recursos de GKE por ubicación.
  • goog-k8s-cluster-name: Filtra tus recursos de GKE por clúster.
  • goog-k8s-node-pool-name: Filtra los recursos de tu clúster por grupo de nodos.
  • k8s-namespace: Filtra tus recursos de GKE por espacio de nombres.
  • k8s-namespace-labels: Filtra tus recursos de GKE por etiqueta de espacio de nombres de la flota (solo clientes de GKE Enterprise).
  • k8s-label: Consulta todos tus recursos de GKE.

Para ver los costos detallados del clúster de GKE en la exportación de datos de costos detallada, debes también habilitar la asignación de costos para GKE.

Revisa consultas de ejemplo para filtrar datos de GKE en exportaciones de BigQuery.
Microsoft AD administrado service.description y resource.name o resource.global_name

La columna service.description contiene el nombre del servicio. La columna resource.name contiene el nombre que proporciona el usuario. La columna resource.global_name contiene un identificador único para el recurso.
Memorystore for Redis service.description y resource.global_name

La columna service.description contiene el nombre del servicio. La columna resource.global_name contiene un identificador único para el recurso.
Secret Manager service.description, resource.name y resource.global_name

La columna service.description contiene el nombre del servicio. La columna resource.name contiene el nombre que proporciona el usuario. La columna resource.global_name contiene un identificador único para el recurso.
Spanner service.description y resource.global_name

La columna service.description contiene el nombre del servicio y la columna resource.global_name contiene un identificador único para el recurso.

Consulta ejemplos de consultas de datos detallados de tus recursos.

Esquema de los datos de costos de uso detallados

En tu conjunto de datos de BigQuery, tus datos de costos de uso detallados de Google Cloud se cargan en una tabla de datos llamada gcp_billing_export_resource_v1_<BILLING_ACCOUNT_ID>.

Cuando uses los datos de costos de uso detallados en BigQuery, ten en cuenta lo siguiente:

  • Cuando seleccionas o creas un conjunto de datos de BigQuery para los datos de costos de uso detallados, puedes seleccionar cualquier ubicación de conjunto de datos compatible para usarla con datos de Facturación de Cloud.
  • Cuando habilitas la exportación de datos detallados de los costos de uso la primera vez en Facturación de Cloud, si seleccionas un conjunto de datos configurado para usar una ubicación multirregional (UE o EE.UU.), los datos de Facturación de Cloud estarán disponibles de forma retroactiva desde el comienzo del mes anterior. Los datos se exportan en orden cronológico. En el caso del reabastecimiento inicial de datos exportados, es posible que los datos de la Facturación de Cloud tarden hasta cinco días en terminar de exportarse antes de que empieces a ver los datos de uso más recientes.
  • Si habilitas la exportación de datos detallados de los costos de uso y seleccionas un conjunto de datos configurado para usar una ubicación regional compatible, tus datos de Facturación de Cloud estarán disponibles a partir de la fecha en la que habilitaste la exportación.
  • Si habilitaste, inhabilitaste y, luego, vuelves a habilitar la exportación de datos de costos de uso detallados, es posible que los datos de Facturación de Cloud no estén disponibles para el período en el que la exportación de datos se inhabilitó de forma explícita.
  • Obtén más información sobre la frecuencia de los datos que se cargan en tus tablas de BigQuery.
  • Consulta otras limitaciones que podrían afectar la exportación de tus datos de facturación a BigQuery, como los conjuntos de datos con claves de encriptación administradas por el cliente (CMEK) habilitadas.
  • Considera el volumen de datos adicional que tus tablas de BigQuery pueden necesitar y el costo adicional cuando habilitas los datos de costos de uso detallados en lugar de la exportación de datos de costos de uso estándar. El aumento del nivel de detalle de la información a nivel de los recursos puede aumentar la cantidad de filas, que se agregan en el formato de costo de uso estándar. Te recomendamos revisar Controla los costos en BigQuery para conocer más prácticas recomendadas sobre la administración de los costos de BigQuery.
Campo Tipo Descripción
billing_account_id String

El ID de la cuenta de Facturación de Cloud con el que está asociado el uso.

Para los distribuidores: En el caso de los costos de uso generados por una cuenta secundaria de Facturación de Cloud, corresponde al ID de la cuenta secundaria y no al de la cuenta principal de Facturación de Cloud del distribuidor.
invoice.month String

El año y el mes (AAAAMM) de la factura que incluye los elementos de una sola línea del costo. Por ejemplo: “201901” es equivalente a enero de 2019.

Puedes usar este campo para obtener los cargos totales en la factura. Consulta Ejemplos de consultas de exportación de la Facturación de Cloud a BigQuery.
invoice.publisher_type String

Indica el publicador asociado con la transacción. Este campo admite la división de facturas entre transacciones realizadas directamente con Google (propio) y transacciones realizadas con un socio (tercero), lo que también indica qué reglamentaciones podrían aplicarse a la transacción.

Los valores posibles son los siguientes:
  • GOOGLE: Transacción propia y no regulada de Google Cloud.
  • PARTNER: Una transacción de terceros, regulada o no, que realiza un socio.
cost_type String

Tipo de costo que representa este elemento de una sola línea: regular, impuesto, ajuste o error de redondeo.
service.id String El ID del servicio con el que se asocia el uso.
service.description String El servicio de Google Cloud que informó los datos de la Facturación de Cloud.
sku.id String El ID del recurso que usa el servicio. Para ver la lista completa de SKU, consulta SKU de Google Cloud.
sku.description String Una descripción del tipo de recurso que usa el servicio. Por ejemplo, un tipo de recurso de Cloud Storage es Standard Storage US.
usage_start_time Marca de tiempo La hora de inicio del período de uso de una hora en el que se calculó el costo determinado. El uso y los costos de todos los servicios se muestran con un nivel de detalle por hora, lo que significa que el uso prolongado de un servicio se extiende en varios períodos de una hora.

Para obtener más información, consulta la documentación de BigQuery sobre los tipos de datos de las marcas de tiempo. También puedes consultar Diferencias entre los datos exportados y las facturas.
usage_end_time Marca de tiempo La hora de finalización del período de uso de una hora en el que se calculó el costo determinado. El uso y los costos de todos los servicios se muestran con un nivel de detalle por hora, lo que significa que el uso prolongado de un servicio se extiende en varios períodos de una hora.

Para obtener más información, consulta la documentación de BigQuery sobre los tipos de datos de las marcas de tiempo. También puedes consultar Diferencias entre los datos exportados y las facturas.
project Struct project contiene campos que describen el proyecto de Facturación de Cloud, como el ID, el número, el nombre, los ancestry_numbers y las etiquetas.
project.id String El ID del proyecto de Google Cloud que generó los datos de Facturación de Cloud.
project.number String Un identificador único, generado de forma interna y anonimizado para el proyecto de Google Cloud que generó los datos de Facturación de Cloud. En los casos de asistencia y otras comunicaciones con los clientes, Google hará referencia a tus proyectos con este número de proyecto.
project.name String El nombre del proyecto de Google Cloud que generó los datos de Facturación de Cloud.
project.ancestry_numbers String Los principales en la jerarquía de recursos del proyecto que identifica el project.id específico (por ejemplo, my-project-123).

Por ejemplo: /ParentOrgNumber/ParentFolderNumber/. Obtén más información sobre la jerarquía de recursos.
project.ancestors Estructura

En este campo, se describe la estructura y el valor de la jerarquía de recursos de un elemento de una sola línea del costo, incluidos los proyectos, las carpetas y las organizaciones. Los principales se ordenan del nodo a la raíz (proyecto, carpeta y organización).

project.ancestors.resource_name String El nombre de recurso relativo de cada principal en el formato “resourceType/resourceNumber”. Si usas project.ancestors.resource_name, se mostrará una vista más completa de project.ancestry_numbers.
project.ancestors.display_name String El nombre que creaste para el recurso en tu consola.
project.labels.key String Si hay etiquetas, la parte de la clave del par clave-valor que incluye la etiqueta en el proyecto de Google Cloud en el que se produjo el uso. Para obtener más información sobre el uso de etiquetas, consulta Usa etiquetas.
project.labels.value String Si hay etiquetas, la parte del valor del par clave-valor que incluye la etiqueta en el proyecto de Google Cloud en el que se produjo el uso. Para obtener más información sobre el uso de etiquetas, consulta Usa etiquetas.
labels.key String Si hay etiquetas, la parte de la clave del par clave-valor que incluye la etiqueta en el recurso de Google Cloud en el que se produjo el uso. Para obtener más información sobre el uso de etiquetas, consulta Usa etiquetas.
labels.value String Si hay etiquetas, la parte del valor del par clave-valor que incluye la etiqueta en el recurso de Google Cloud en el que se produjo el uso. Para obtener más información sobre el uso de etiquetas, consulta Usa etiquetas.
system_labels.key String Si hay etiquetas del sistema, la parte de la clave del par clave-valor que incluye la etiqueta generada por el sistema en el recurso en el que se produjo el uso. Consulta también Etiquetas del sistema disponibles.
system_labels.value String Si hay etiquetas del sistema, la parte del valor del par clave-valor que contiene la etiqueta generada por el sistema en el recurso en el que se produjo el uso. Consulta también Etiquetas del sistema disponibles.
location.location String Ubicación del uso a nivel de una multirregión, un país, una región o una zona; o global para los recursos que no tienen una ubicación específica. Para obtener más información, consulta Geografía y regiones y Ubicaciones de Google Cloud.
location.country String Cuando location.location es un país, una región o una zona, este campo es el país del uso, p. ej., US. Para obtener más información, consulta Geografía y regiones y Ubicaciones de Google Cloud.
location.region String Cuando location.location es una región o una zona, este campo es la región del uso, p. ej., us-central1. Para obtener más información, consulta Geografía y regiones y Ubicaciones de Google Cloud.
location.zone String Cuando location.location es una zona, este campo es la zona del uso, p. ej., us-central1-a. Para obtener más información, consulta Geografía y regiones y Ubicaciones de Google Cloud.
cost Número de punto flotante El costo de uso antes de cualquier crédito, con una precisión de hasta seis decimales. Para obtener el costo total, incluidos los créditos, se debe agregar cualquier credits.amount al costo. Visita esta consulta de ejemplo para obtener más información.
currency String La moneda en la que se factura el costo. Si quieres obtener más información, consulta Moneda local para facturación y pagos.
currency_conversion_rate Número de punto flotante El tipo de cambio de dólares estadounidenses a la moneda local. Es decir, cost/currency_conversion_rate es el costo en dólares estadounidenses.
usage.amount Número de punto flotante La cantidad de usage.unit que se usó.
usage.unit String La unidad base en la que se mide el uso del recurso. Por ejemplo, la unidad base para el almacenamiento estándar es bytes por segundos.
usage.amount_in_pricing_units Número de punto flotante La cantidad de usage.pricing_unit que se usó.
usage.pricing_unit String La unidad en la que se mide el uso de recursos según la API del catálogo de Facturación de Cloud.
credits Estructura credits contiene campos que describen la estructura y el valor de los créditos asociados con los SKU de Google Cloud y Google Maps Platform.
credits.id String Si está presente, indica que un crédito está asociado con el SKU del producto. Los valores de credits.id pueden ser un identificador único alfanumérico (por ejemplo, 12-b34-c56-d78) o una descripción del tipo de crédito (como Descuento por compromiso de uso: CPU).

Si el campo credits.id está vacío, el SKU del producto no está asociado con un crédito.
credits.full_name String El nombre del crédito asociado con el SKU del producto. Esta es una descripción en lenguaje natural de un credits.id alfanumérico. En los ejemplos, se incluyen un crédito de prueba gratuita o un descuento por compromiso de uso basado en el gasto.

Los valores de credits.full_name solo están presentes para los SKU con credits.id alfanuméricos. Si el valor de credits.id es una descripción del tipo de crédito (como Descuento por compromiso de uso: CPU), el campo credits.full_name estará vacío.

credits.type String En este campo, se describe el propósito o el origen de credits.id. Entre los tipos de crédito, se incluyen los siguientes:
  • COMMITTED_USAGE_DISCOUNT: Contratos de compromiso de uso basados en recursos comprados para Compute Engine a cambio de descuentos considerables en los precios por el uso de VM.
  • COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE: Contratos de compromiso de uso basados en gastos adquiridos por servicios a cambio de su compromiso para invertir un importe mínimo.
  • DISCOUNT: El tipo de crédito de descuento se usa para los créditos que se obtienen después de alcanzar un límite de gastos contractual. Ten en cuenta que, en los informes de Facturación de Cloud disponibles en la consola de Google Cloud, el tipo de crédito de descuento se muestra como Descuentos basados en gastos (contrato).
  • FREE_TIER: Algunos servicios ofrecen uso de recursos gratuitos hasta los límites especificados. En estos servicios, se aplican créditos para implementar el uso del nivel gratuito.
  • PROMOTION: El tipo de crédito promocional incluye la prueba gratuita de Google Cloud y los créditos de la campaña de marketing o algún otro otorgamiento para usar Google Cloud. Cuando están disponibles, estos créditos se consideran una forma de pago y se aplican de forma automática para reducir el total de tu factura.
  • RESELLER_MARGIN: Si eres un distribuidor, el tipo de crédito de margen del distribuidor indica los descuentos del programa para distribuidores ganados en cada línea de pedido apta.
  • SUBSCRIPTION_BENEFIT: Son los créditos que se obtienen mediante la compra de suscripciones a largo plazo a los servicios a cambio de descuentos.
  • SUSTAINED_USAGE_DISCOUNT: El tipo de crédito de descuento por uso continuo es un descuento automático que obtienes por ejecutar recursos de Compute Engine específicos en una parte significativa de la facturación mensual.
credits.name String Una descripción del crédito aplicado a la cuenta de facturación de Cloud.
credits.amount Número de punto flotante El importe del crédito aplicado al uso.
adjustment_info Estructura adjustment_info contiene campos que describen la estructura y el valor de un ajuste para los elementos de una sola línea de costos asociados con una cuenta de Facturación de Cloud.

Los valores de adjustment_info solo están presentes si el elemento de una sola línea del costo se generó para una modificación de la Facturación de Cloud. Puede suceder una modificación por motivos de corrección o falta de corrección. El tipo adjustment_info contiene detalles sobre el ajuste, si se emitió para corregir un error o por otros motivos.

adjustment_info.id String Si está presente, indica que un ajuste está asociado con un elemento de una sola línea del costo. adjustment_info.id es el ID único para todos los ajustes asociados con un problema.
adjustment_info.description String Una descripción del ajuste y su causa.
adjustment_info.type String

El tipo de ajuste.

Se incluyen los siguientes tipos:

  • USAGE_CORRECTION: Una corrección debido a un uso incorrecto informado.
  • PRICE_CORRECTION: Una corrección debido a reglas de fijación de precios incorrectas.
  • METADATA_CORRECTION: Una corrección para corregir metadatos sin cambiar el costo.
  • GOODWILL: Se trata de un crédito que se emite al cliente para el fondo de comercio.
  • SALES_BASED_GOODWILL: Un crédito que se emite al cliente para el fondo de comercio, como parte de un contrato.
  • SLA_VIOLATION: Un crédito que se emite al cliente debido a un incumplimiento del objetivo de nivel de servicio (SLO).
  • BALANCE_TRANSFER: Un ajuste para transferir fondos de una cuenta de pago a otra.
  • ACCOUNT_CLOSURE: Un ajuste para llevar una cuenta cerrada a un saldo de cero.
  • GENERAL_ADJUSTMENT: Una modificación general de la cuenta de facturación.
adjustment_info.mode String

Cómo se emitió el ajuste.

Se incluyen los siguientes modos:

  • PARTIAL_CORRECTION: La corrección anula de forma parcial el uso y el costo originales.
  • COMPLETE_NEGATION_WITH_REMONETIZATION: La corrección anula por completo el uso y el costo originales, y emite elementos de una sola línea corregidos con el uso y el costo actualizados.
  • COMPLETE_NEGATION: La corrección anula por completo el uso y el costo originales y no se vuelve a monetizar el uso.
  • MANUAL_ADJUSTMENT: El ajuste se asigna al costo y al uso de forma manual.
export_time Marca de tiempo Un tiempo de procesamiento asociado con una adición de datos de la Facturación de Cloud. Este aumentará con cada exportación nueva.
También puedes consultar Diferencias entre los datos exportados y las facturas, que se encuentra más adelante.
tags Estructura

Campos que describen la etiqueta de política, como clave, valor y espacio de nombres.
tags.key String

El nombre corto o el nombre visible de la clave asociada con esta etiqueta de política en particular.
tags.value String

Los recursos adjuntos a un tags.key En cualquier momento, se puede adjuntar un valor a un recurso para una clave determinada.
tags.inherited Booleano

Indica si una vinculación de etiqueta de política es heredada (etiquetas de política heredadas = verdadero) o directa/no heredada (etiquetas de política heredadas = falso). Puedes crear una vinculación de etiqueta de política a un recurso superior en la jerarquía de recursos.
tags.namespace String

Representa la jerarquía de recursos que define los valores y la clave de la etiqueta de política. El espacio de nombres se puede combinar con los nombres cortos de los valores de etiqueta de política y las claves de etiqueta de política para crear un nombre único a nivel global para la clave o el valor de etiqueta de política.
cost_at_list Número de punto flotante

Los precios de lista asociados con todos los elementos de una sola línea cobrados a tu cuenta de Facturación de Cloud.
transaction_type String

Es el tipo de transacción del vendedor. El tipo de transacción puede ser uno de los siguientes:

  • GOOGLE = 1: Son los servicios vendidos por Google Cloud.
  • THIRD_PARTY_RESELLER = 2: Servicios de terceros que Google Cloud revende.
  • THIRD_PARTY_AGENCY = 3: Servicios de terceros que vende un socio, en los que Google Cloud actúa como el agente.
seller_name String

Es el nombre legal del vendedor.
Campos adicionales disponibles para la exportación detallada de datos de costos de uso
resource Struct

Los campos que describen la estructura y el valor de la información relevante para los recursos de servicio (como una máquina virtual o un SSD) que generan un uso de servicios.
resource.global_name String

Un identificador de servicio único a nivel global para el recurso que generó el uso relevante.
resource.name String

Un identificador específico del servicio para el recurso que generó el uso relevante. Esto puede ser una entrada que genera el usuario.
price Struct

Campos que describen la estructura y el valor relacionados con los precios que se cobran por el uso.
price.effective_price Numérico

El precio que se cobra por el uso de los SKU y los SKU de Google Cloud Platform o de Google Maps Platform. Si tu cuenta de facturación de Cloud tiene precios personalizados por contrato, este es el precio específico de la cuenta de facturación, de lo contrario, este es el precio de lista del SKU o nivel de SKU.
price.tier_start_amount Numérico

La cantidad limitada de unidades para el nivel de precios de un SKU. Por ejemplo, un SKU con tres niveles de precios, como de 0 a 100 unidades, de 101 a 1,000 unidades y más de 1,001 unidades, mostrará tres filas de precios para el SKU, con 0, 101 y 1,001 en el campo price.tier_start_amount que representa la cantidad de unidades iniciales para los niveles de precios del SKU.

Obtén más información sobre los niveles de precios
price.unit String

Es la unidad de uso en la que se especifica el precio y se mide el uso de recursos (como gibibyte, tebibyte, mes, año, gibibyte por hora, gibibyte por mes o recuento). El valor en el campo price.unit coincide con el valor en el campo usage.pricing_unit.
price.pricing_unit_quantity Numérico

El nivel de precios por cantidad de unidades del SKU. Por ejemplo, si el nivel de precio es $1 por 1,000,000 de bytes, en esta columna aparecerá 1,000,000.
subscription Estructura

Campos que describen los compromisos basados en la inversión o en los recursos. Puedes usar estos campos para analizar las tarifas de compromisos específicos.
subscription.instance_id String

El ID de suscripción vinculado a un compromiso.

Comprende los datos de costos de uso estándar y detallados

En las siguientes secciones, se describen los datos estándar y los datos detallados de costos de uso exportados a BigQuery.

Acerca de las etiquetas

Los datos de costos de una etiqueta específica solo muestran el uso a partir de la fecha en que la etiqueta se aplicó a un recurso. Por ejemplo, si agregas la etiqueta environment:dev a una VM de Compute Engine el 15 de enero de 2024, cualquier análisis de environment:dev solo incluye el uso de esa VM desde el 15 de enero.

También es posible que veas datos de etiqueta en diferentes momentos para distintos servicios, según cuándo los proporcione cada servicio.

Etiquetas del sistema disponibles

Las etiquetas del sistema son pares clave-valor para metadatos importantes sobre el recurso que generó el uso. Las siguientes etiquetas del sistema se incluyen en el uso aplicable de manera automática.

system_labels.key Ejemplo system_labels.value Descripción
compute.googleapis.com/machine_spec n1-standard-1, custom-2-2048 Configuración de la máquina virtual. Consulta Tipos de máquinas para obtener más información.
compute.googleapis.com/cores Para n1-standard-4 es 4; para custom-2-2048 es 2 El número de CPU virtuales disponibles para la máquina virtual.
compute.googleapis.com/memory Para n1-standard-4 es 15,360 (es decir, 15 GB * 1,024 MB/GB); para custom-2-2048 es 2,048 La cantidad de memoria (en MB) disponible para la máquina virtual.
compute.googleapis.com/is_unused_reservation true; false Indica el uso que se reservó a través de Reservas zonales, pero que no se usó.
storage.googleapis.com/object_state live; noncurrent; soft_deleted; multipart El estado del objeto de almacenamiento que se cobra.

Diferencias entre los datos exportados y las facturas

Los servicios de Google Cloud informan los datos de costos y de uso a los procesos de la Facturación de Cloud en intervalos variables. Como resultado, es posible que veas una demora entre el uso que haces de los servicios de Google Cloud y el uso y los costos disponibles para ver en la Facturación de Cloud. Por lo general, tus costos están disponibles dentro de un día, aunque, a veces, pueden tardar más de 24 horas.

Al final de un mes calendario, es posible que los informes de uso que se retrasaron no se incluyan en la factura de ese mes y, en su lugar, se transfieran a la factura del mes siguiente.

Cuando consultas los costos mediante campos de marca de tiempo, los datos que se muestran pueden incluir datos de uso informados con demora que no estaban en un principio en la factura que se generó para el mismo mes de uso. Como resultado, es posible que los datos de la Facturación de Cloud que se muestran no se asignen directamente a esa factura.

Entre los campos de marca de tiempo se incluyen los siguientes:

  • usage_start_time
  • usage_end_time
  • export_time

Para mostrar los datos de la Facturación de Cloud que se asignan directamente a una factura, haz una consulta en función de invoice.month y no en función de los campos de marca de tiempo.

Impuestos

A partir del 1 de septiembre de 2020, los datos de costos de uso detallados mostrarán la responsabilidad fiscal de cada uno de tus proyectos, en lugar de aparecer como un elemento de una sola línea. Si tienes consultas o visualizaciones que dependan de los datos fiscales, es posible que debas actualizar las consultas para que reflejen estos cambios.

Por ejemplo, en el caso de los costos registrados antes del 1 de septiembre, tus datos de costos de uso detallados son similares a los del siguiente ejemplo, en el que muestra una responsabilidad fiscal total de USD 10.

billing_account_id project.id cost_type cost
123456-ABCDEF-123456 example-project Normal $60
123456-ABCDEF-123456 test-project Normal $40
123456-ABCDEF-123456 [empty] Impuesto $10

En el caso de los costos registrados después del 1 de septiembre, los $10 se desglosan en $6 para example-project y $4 para test-project:

billing_account_id project.id cost_type cost
123456-ABCDEF-123456 example-project Normal $60
123456-ABCDEF-123456 test-project Normal $40
123456-ABCDEF-123456 example-project Impuesto $6
123456-ABCDEF-123456 test-project Impuesto $4

Errores y ajustes

En el caso poco probable de que los datos de la Facturación de Cloud contengan un error o se deban ajustar, se adjuntarán datos correctivos. Estos ajustes se dividen en una de las siguientes dos categorías: modificaciones o correcciones de facturación.

Modificaciones de facturación

Las modificaciones de facturación aparecen como líneas de pedido independientes. Si recibiste una modificación de facturación, el cambio se mostrará en un nuevo elemento de una sola línea en la exportación de Facturación de Cloud a BigQuery. Los ajustes que se muestran corresponden a los documentos de facturas, notas de crédito y notas de débito disponibles en el área Documentos de la sección Facturación de la consola de Google Cloud.

Para obtener más información sobre las modificaciones de facturación y cómo se aplican, consulta Comprende las notas y los ajustes.

Correcciones

Las correcciones aparecen como datos nuevos que anulan los datos incorrectos en los SKUs de origen. En algunos casos, los datos nuevos reemplazan el cargo incorrecto. Todas las columnas de la exportación de datos de facturación coincidirán con los datos originales, excepto las siguientes:

  • cost
  • credit
  • usage.amount
  • export_time

Por ejemplo, imagina que se te cobra USD 10 por el uso de SKU A el 1 de enero. En tu factura de enero (emitida a principios de febrero), verás un cargo de USD 10 por SKU A. Sin embargo, el 2 de febrero, Google Cloud emitió una corrección para SKU A, lo que redujo el costo de uso a USD 5. Recibirás dos conceptos adicionales en tu factura de febrero (emitida a principios de marzo):

  • USD -10 por el uso del 1 de enero (anula el cargo original)
  • USD 5 por el uso del 1 de enero (se indica el cargo previsto)

Estos elementos nuevos tienen una columna adjustment_info en la exportación de datos de facturación. No se ajustará la factura original de enero, que muestra el cobro excesivo. Para verificar los cargos en la exportación de datos de facturación, puedes ver los costos por usage_start_time y agruparlos por Day. En estas vistas, se acumulan las correcciones o los cargos por el uso monetizado tardío, y no tienes que preocuparte por los datos incorrectos temporalmente.

Si deseas obtener información más detallada sobre tus correcciones, consulta todos los cargos de un mes de facturación y busca cargos en los que la fecha de uso haya ocurrido antes del mes de facturación. Estos cargos son el resultado de correcciones o usos monetizados tardíamente.

En la siguiente muestra de código, se muestra cómo crear una consulta básica que devuelve el costo total de las correcciones o el uso monetizado tardío:

SELECT
  SUM(cost)
    + SUM(IFNULL((SELECT SUM(c.amount)
      FROM   UNNEST(credits) c), 0))
    AS total
FROM `project.dataset.gcp_billing_export_v1_XXXXXX-XXXXXX-XXXXXX`
WHERE
  invoice.month = '202311' AND
  DATE(TIMESTAMP_TRUNC(usage_start_time, Day, 'US/Pacific')) < '2023-11-01';

Para ver un ejemplo de consulta que muestra un desglose de costos por servicio, para cargos de la factura, en el que la fecha de uso ocurrió antes del mes de facturación, consulta Consulta los detalles de los costos para ver las correcciones o el uso monetizado tardío por servicio para un mes de facturación específico en "Consultas de ejemplo para la exportación de datos de Facturación de Cloud".

Acerca de los créditos promocionales en los contratos con precios personalizados

Si tienes un contrato de precios personalizados, es posible que recibas créditos promocionales para usar en Google Cloud como parte del contrato. Por ejemplo, puedes recibir $1,000 para usar en los recursos de Compute Engine. Los créditos promocionales se consideran una forma de pago. Si están disponibles, los créditos promocionales se aplican de forma automática para reducir el total de tu factura.

Las condiciones de tu contrato especifican si los créditos promocionales se aplican a los costos calculados al precio de lista de un SKU o al precio neto (después de aplicar descuentos).

Si tus créditos promocionales se aplican a costos que se calculan según el precio de lista, en el informe Tabla de costos, hay un servicio llamado Invoice, con un SKU llamado Contract billing adjustment. Este SKU ajusta tus créditos para que se apliquen a los costos al precio de lista. Para ver el uso al que se aplica el ajuste, consulta las columnas system.labels. La clave en system.labels.key es cloud-invoice.googleapis.com/sku_id, y el valor en system.labels.value contiene el ID del SKU al que se aplicaron el crédito y el ajuste.

Acerca de las etiquetas de política

Las etiquetas son recursos en forma de pares clave-valor que se pueden adjuntar a recursos directamente o a través de la herencia. Puedes usar etiquetas de política para hacer devoluciones de cargos, auditorías y otros análisis de asignación de costos. Puedes usar etiquetas y la aplicación condicional de políticas para obtener un control detallado de toda la jerarquía de tus recursos.

Las etiquetas tienen un modelo de permisos sólido y pueden admitir la herencia, la administración centralizada, la estandarización de la nomenclatura y la integración de motores de políticas, mientras que las etiquetas son una herramienta independiente que te permite anotar recursos.

Los datos de las etiquetas de política aparecen en las exportaciones de BigQuery para recursos, proyectos, carpetas y organizaciones.

Etiquetas disponibles

Las exportaciones de costos estándar y de costos detallados para recursos, proyectos, carpetas y organizaciones incluyen estos campos para los datos de etiquetas de política: clave de etiquetas de política, valor de etiquetas de política, etiquetas de política heredadas y espacio de nombres de etiquetas.

Las etiquetas a nivel de recurso en la exportación de datos de la Facturación de Cloud están disponibles para los siguientes recursos:

  • Clústeres, instancias y copias de seguridad de AlloyDB para PostgreSQL
  • Repositorios de Artifact Registry
  • Servicios y trabajos de Cloud Run
  • Buckets de Cloud Storage
  • Instancias de Compute Engine
  • Instancias de Memorystore para Redis
  • Secretos de Secret Manager
  • Instancias de Spanner

Limitaciones de etiquetas

  • Las etiquetas de política pueden tardar hasta una hora en propagarse a las exportaciones de BigQuery. Si se agregó o quitó una etiqueta de política en un plazo de una hora, o si existe un recurso durante menos de una hora, es posible que no aparezca en la exportación.

Ejemplos de consultas de costos de uso detallados

En esta sección, se proporcionan ejemplos de cómo consultar los datos de costos de uso detallados de Facturación de Cloud exportados a BigQuery.

Debido a que el esquema de costos de uso detallados incluye todos los campos del esquema de costos de uso estándar, los ejemplos de consulta proporcionados para los datos estándar exportados a BigQuery también funcionan con los datos detallados que se exportan. Los ejemplos de consultas estándar no se escriben para recuperar información a nivel de recurso que se proporcione con la opción de exportación de costos de uso detallados. Cuando creas consultas para los datos detallados puedes usar un ejemplo de consulta estándar como una plantilla, actualizar el Nombre de la tabla y agregar cualquiera de los campos que están disponibles en el esquema de costos de uso detallados.

Valores comunes usados en las consultas de costos detalladas de ejemplo

En los ejemplos de consulta de esta sección, se usa el siguiente valor para nombre de tabla: project.dataset.gcp_billing_export_resource_v1_XXXXXX_XXXXXX_XXXXXX

Muestra los costos a nivel de recurso en una factura

En las siguientes consultas, se demuestran dos formas de ver los costos y los valores de crédito a nivel de recurso en una factura mediante el uso de los datos de facturación exportados.

  • El campo total suma directamente el costo de punto flotante y los valores de crédito, lo que puede generar errores de redondeo de punto flotante.
  • El campo total_exact convierte los costos y los valores de crédito en micros antes de sumar; luego, los vuelve a convertir a dólares después de la suma y así evita el error de redondeo de punto flotante.

Suma de costos por cada recurso por factura

Esta consulta muestra el total de la factura de resource.name cada mes como una suma de costos regulares, impuestos, ajustes y errores de redondeo. Cualquier costo no asociado con un elemento a nivel de recurso se agrega en el nombre null del mes.

SQL estándar

SELECT
  invoice.month,
  resource.name,
  SUM(cost)
    + SUM(IFNULL((SELECT SUM(c.amount)
                  FROM UNNEST(credits) c), 0))
    AS total,
  (SUM(CAST(cost * 1000000 AS int64))
    + SUM(IFNULL((SELECT SUM(CAST(c.amount * 1000000 as int64))
                  FROM UNNEST(credits) c), 0))) / 1000000
    AS total_exact
FROM `project.dataset.gcp_billing_export_resource_v1_XXXXXX_XXXXXX_XXXXXX`
GROUP BY 1, 2
ORDER BY 1 ASC, 2 ASC
;

Por ejemplo, el resultado de la consulta anterior podría ser el siguiente:

Fila mes nombre total total exacto
1 201901 null $1,005.004832999999984 $1,005.00
2 201901 backend1 $781.8499760000028 $781.85
3 201902 null $953.0034923645475983 $953.03
4 201902 backend1 $992.3101739999999717 $992.31
5 201902 bitnami-launchpad-wordpress-1-wordpress $1.2817819999999998 $1.28

Muestra detalles por tipo de costo para cada recurso, por factura mensual

En esta consulta, se muestran los totales de cada cost_type para cada resource.name por mes. Los tipos de costos incluyen costos regulares, impuestos, ajustes y errores de redondeo. Cualquier costo no asociado con un elemento a nivel de recurso se agrega en el nombre null del mes.

SQL estándar

SELECT
  invoice.month,
  cost_type,
  resource.name,
  SUM(cost)
    + SUM(IFNULL((SELECT SUM(c.amount)
                  FROM   UNNEST(credits) c), 0))
    AS total,
  (SUM(CAST(cost * 1000000 AS int64))
    + SUM(IFNULL((SELECT SUM(CAST(c.amount * 1000000 as int64))
                  FROM UNNEST(credits) c), 0))) / 1000000
    AS total_exact
FROM `project.dataset.gcp_billing_export_resource_v1_XXXXXX_XXXXXX_XXXXXX`
GROUP BY 1, 2, 3
ORDER BY 1 ASC, 2 ASC, 3 ASC
;

Por ejemplo, el resultado de la consulta anterior podría ser el siguiente:

Fila mes tipo de costo nombre total total exacto
1 201901 regular null $1,000.501209987994782 $1,000.50
2 201901 error de redondeo null –$0.500489920049387 –$0.50
3 201901 impuesto null $10.000329958477891 $10.00
4 201901 ajuste null –$5.002572999387045 –$5.00
5 201901 regular backend1 $410.998795012082947 $411.00
2 201901 error de redondeo backend1 –$0.2404900489920378 –$0.24
3 201901 impuesto backend1 $4.105840329977189 $4.11

Obtén un desglose de costos de los clústeres de Google Kubernetes Engine (GKE)

En esta sección, se proporcionan ejemplos de filtrado de costos de clústeres de GKE en tus informes de exportación de BigQuery. Para obtener más información sobre los costos de los clústeres de GKE, consulta Ve el desglose de los costos de los clústeres.

Filtra los costos de GKE

Las siguientes consultas de ejemplo muestran cómo filtrar y agrupar los costos de GKE para los tipos de recursos admitidos por nombre de clúster, espacio de nombres y etiqueta.

Costos de los clústeres de GKE antes de los créditos

SELECT
  SUM(cost) AS cost_before_credits,
  labels.value AS cluster_name
FROM  `project-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX`
LEFT JOIN UNNEST(labels) as labels
  ON labels.key = "goog-k8s-cluster-name"
GROUP BY labels.value
;

Costos de GKE después los de créditos por espacio de nombres

SELECT
  labels.value as namespace,
  SUM(cost) + SUM(IFNULL((SELECT SUM(c.amount) FROM UNNEST(credits) c), 0)) AS cost_after_credits,
FROM `project-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX`
LEFT JOIN UNNEST(labels) as labels
  ON labels.key = "k8s-namespace"
GROUP BY namespace
;

Costos de GKE por SKU

SELECT
  project.id AS project_id,
  labels.value AS cluster_name,
  sku.id AS sku_id,
  sku.description AS sku_description,
  SUM(cost) AS cost
FROM `project-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX`
JOIN UNNEST(labels) AS labels
  ON labels.key = "goog-k8s-cluster-name"
GROUP BY
  cluster_name, project_id, sku_description, sku_id
;

Ejemplos de consultas con etiquetas de política

En los siguientes ejemplos, se ilustran las maneras de consultar tus datos con etiquetas de política.

Calcula los costos por mes de facturación con etiquetas de política

En la siguiente consulta, se demuestra cómo puedes usar los costos de devolución por mes de facturación para la etiqueta de política cost_center.

SELECT
  invoice.month AS invoice_month,
  tag.value AS cost_center,
  ROUND((SUM(CAST(cost AS NUMERIC))
    + SUM(IFNULL((SELECT SUM (CAST(c.amount AS NUMERIC))
                  FROM UNNEST(credits) AS c), 0))), 2)
    AS net_cost
FROM `project-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX`, UNNEST(tags) AS tag
WHERE tag.key = "cost_center" AND tag.namespace = "821092389413"
GROUP BY invoice.month, tag.value
ORDER BY invoice.month, tag.value;

Por ejemplo, el resultado de la consulta anterior podría ser el siguiente:

Fila invoice_month cost_center net_cost
1 202208 android_mobile_apps 9.93
2 202208 ios_mobile_apps 9.93
3 202209 android_mobile_apps 25.42
4 202209 ios_mobile_apps 25.4
5 202209 personalización 16.08

Visualiza los costos de los recursos sin etiquetar

En esta consulta se muestra el total de la factura de los recursos sin etiquetar, agrupados por mes de facturación.

SELECT
 invoice.month AS invoice_month,
 ROUND((SUM(CAST(cost AS NUMERIC))
   + SUM(IFNULL((SELECT SUM(CAST(c.amount AS NUMERIC))
                 FROM UNNEST(credits) AS c), 0))), 2)
   AS net_cost
FROM
 `project-ID.dataset.gcp_billing_export_v1_XXXXXX-XXXXXX-XXXXXX`
WHERE "color" NOT IN (SELECT key FROM UNNEST(tags))
GROUP BY invoice_month
ORDER BY invoice_month;

Por ejemplo, el resultado de la consulta anterior podría ser el siguiente:

Fila invoice_month net_cost
1 202202 0
2 202203 16.81
3 202204 54.09
4 202205 55.82
5 202206 54.09
6 202207 55.83
7 202208 31.49

Informes de costos y precios disponibles en la consola de Google Cloud

Anterior
Estructura de la exportación de datos estándar
Siguiente
Estructura de la exportación de datos de precios