Estructura de la exportación de datos detallada

En este documento se proporciona información de referencia sobre el esquema de los datos de costes de uso detallados de Facturación de Cloud que se exportan a cada tabla de BigQuery.

Los datos de costes de uso detallados proporcionan toda la información incluida en los datos de costes de uso estándar, así como campos adicionales que ofrecen datos de costes granulares a nivel de recursos, como una máquina virtual o un SSD que genera uso. La exportación detallada incluye información pormenorizada sobre los costes de los siguientes servicios:

Identificar datos de costes detallados por servicio

Para analizar información detallada sobre los costes en una exportación detallada, consulta la siguiente tabla para identificar la columna que contiene información sobre recursos específicos.

Consulta ejemplos de consultas de datos granulares de tus recursos.

Esquema de datos de costes de uso detallado

En el conjunto de datos de BigQuery, los datos detallados de costes de uso de Google Cloudse cargan en una tabla de datos llamada gcp_billing_export_resource_v1_<BILLING_ACCOUNT_ID>.

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

• El esquema de la tabla de la exportación de datos detallados de Facturación de Cloud puede cambiar con el tiempo, por ejemplo, cuando se añaden campos nuevos a la exportación detallada. Para proteger tus consultas de futuros cambios en el esquema, en lugar de usar consultas que hagan referencia directamente a las columnas exportadas, te recomendamos que uses vistas de BigQuery para normalizar los datos de forma que la tabla presente el mismo esquema a tus consultas. Más información sobre esta limitación
• Al seleccionar o crear un conjunto de datos de BigQuery para obtener información detallada sobre los costes de uso, puedes seleccionar cualquier ubicación de conjunto de datos que se pueda usar con los datos de Facturación de Cloud.
• Cuando habilites la exportación de datos detallados sobre los costes de uso por 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 inicio del mes anterior. Los datos se exportan en orden cronológico. Para el relleno inicial de los datos exportados, pueden transcurrir hasta cinco días antes de que se complete la exportación de tus datos de Facturación de Cloud retroactivos y empieces a ver tus datos de uso más recientes.
• Si habilitas la exportación de datos de costes de uso detallados y seleccionas un conjunto de datos configurado para usar una ubicación de región admitida, tus datos de Facturación de Cloud estarán disponibles a partir de la fecha en la que habilitaste la exportación.
• Si has habilitado, inhabilitado y vuelto a habilitar la exportación de datos de costes de uso detallados, es posible que los datos de Facturación de Cloud no estén disponibles durante el periodo en el que la exportación de datos se haya inhabilitado explícitamente.
• Más información sobre la frecuencia de las cargas de datos en tus tablas de BigQuery
• Consulta otras limitaciones que pueden afectar a la exportación de tus datos de facturación a BigQuery, como los conjuntos de datos con claves de cifrado gestionadas por el cliente (CMEK) habilitadas.
• Tenga en cuenta el volumen de datos adicional que pueden necesitar sus tablas de BigQuery y el coste adicional que supone habilitar los datos de costes de uso detallados en lugar de los datos de costes de uso estándar. El aumento de la granularidad de la información a nivel de recurso puede incrementar el número de filas, que se agregan en el formato de coste de uso estándar. Te recomendamos que consultes el artículo Controlar los costes en BigQuery para obtener más información sobre las prácticas recomendadas para gestionar los costes de BigQuery.

Información sobre los datos de costes de uso estándar y detallados

En las siguientes secciones se describen los datos de costes de uso estándar y los datos de costes de uso detallados que se exportan a BigQuery.

Acerca de las etiquetas

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

También puede que vea datos de etiquetas en momentos diferentes para distintos servicios, en función de cuándo los proporcione cada servicio.

Etiquetas de sistema disponibles

Las etiquetas del sistema son pares clave-valor de metadatos importantes sobre el recurso que ha generado el uso. Las siguientes etiquetas del sistema se incluyen automáticamente en el uso aplicable.

Diferencias entre los datos exportados y las facturas

LosGoogle Cloud productos envían datos de uso y costes a los procesos de Facturación de Cloud a intervalos variables. Por lo tanto, es posible que se produzca un retraso entre el uso de los servicios de Google Cloud y la disponibilidad del uso y los costes en Facturación de Cloud. Por lo general, los costes están disponibles en un día, pero a veces pueden tardar más de 24 horas.

Al final de un mes natural, es posible que la factura de ese mes no incluya los datos de uso más reciente y que se transfieran a la del mes siguiente.

Cuando consultas tus costes mediante campos de marca de tiempo, los datos devueltos pueden incluir un uso que se ha registrado tarde y que no se incluyó originalmente en la factura que se generó para el mismo mes de uso. Por lo tanto, es posible que los datos de facturación de Cloud que se devuelvan no se correspondan directamente con esa factura.

Estos son algunos de los campos de marca de tiempo:

• usage_start_time
• usage_end_time
• export_time

Para devolver datos de facturación de Cloud que se correspondan directamente con una factura, haz una consulta en invoice.month en lugar de en los campos de marca de tiempo.

Impuestos

Desde el 1 de septiembre del 2020, los datos de costes de uso muestran la obligación fiscal de cada uno de sus proyectos, en lugar de un solo elemento de línea. Si tienes consultas o visualizaciones que dependen de datos fiscales, puede que tengas que actualizar las consultas para tener en cuenta estos cambios.

Por ejemplo, en el caso de los costes registrados antes del 1 de septiembre, los datos de costes de uso serán similares al siguiente ejemplo, que muestra una obligación fiscal total de 10 USD.

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

Errores y ajustes

En el caso poco probable de que sus datos de Facturación de Cloud contengan un error o requieran un ajuste, se les añadirán datos correctivos. Estos ajustes se incluyen en una de estas dos categorías: modificaciones o correcciones de facturación.

Modificaciones de facturación

Las modificaciones de facturación aparecen como elementos de línea independientes. Si has recibido una modificación de la facturación, se mostrará una nueva línea de pedido en tu exportación de Facturación de Cloud a BigQuery con el cambio. Los ajustes que se muestran corresponden a los documentos de factura, nota de crédito y nota 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 la facturación y cómo se aplican, consulta Información sobre las notas y los ajustes.

Correcciones

Las correcciones se muestran como datos nuevos que anulan los datos incorrectos de los SKUs de origen. En algunos casos, los datos nuevos sustituyen al 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, supongamos que se te cobran 10 USD por el uso de SKU A el 1 de enero. En la factura de enero (emitida a principios de febrero), verás un cargo de 10 USD por SKU A. Sin embargo, el 2 de febrero, Google Cloud emitió una corrección contra SKU A, lo que redujo el coste de uso a 5 USD. Recibirás dos elementos de línea adicionales en la factura de febrero (que se emite a principios de marzo):

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

Estos nuevos elementos tienen una columna adjustment_info en la exportación de datos de facturación. La factura original de enero, en la que se muestra el cargo adicional, no se modificará. Para verificar los cargos en la exportación de datos de facturación, consulta los costes por usage_start_time y agrúpalos por Day. En estas vistas, se acumulan las correcciones o los cargos por el uso monetizado tardíamente, por lo que no tienes que preocuparte por los datos incorrectos temporales.

Si quieres obtener información más detallada sobre tus correcciones, consulta todos los cargos de un mes de facturación y busca los cargos cuya fecha de uso sea anterior al mes de facturación. Estos cargos son el resultado de correcciones o del uso monetizado tardíamente.

En el siguiente código de ejemplo se muestra cómo crear una consulta básica que devuelva el coste total de las correcciones o del uso monetizado tardíamente:

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 devuelve un desglose de costes por servicio de los cargos de una factura, donde la fecha de uso es anterior al mes de la factura, consulta el artículo Consultar los detalles de los costes para ver las correcciones o el uso monetizado tardíamente por servicio de 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 contratos de precios personalizados

Si tienes un contrato de precios personalizado, es posible que recibas créditos promocionales para usar en Google Cloud como parte del contrato. Por ejemplo, puedes recibir 1000 USD para usar en recursos de Compute Engine. Los créditos promocionales suelen considerarse una forma de pago. Cuando hay créditos promocionales disponibles, se aplican automáticamente para reducir el importe total de la factura.

En los términos de tu contrato se especifica si los créditos promocionales se aplican a los costes calculados al precio de catálogo de un SKU o al precio neto (después de los descuentos).

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

Acerca de las etiquetas

Las etiquetas son recursos en forma de pares clave-valor que se pueden asociar a recursos directamente o mediante herencia. Puede usar etiquetas para hacer devoluciones de cargo, auditorías y otros análisis de asignación de costes. También puedes usar etiquetas y la aplicación condicional de políticas para tener un control preciso en toda tu jerarquía de recursos.

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

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

Etiquetas disponibles

Las exportaciones Costes estándar y Costes detallados de recursos, proyectos, carpetas y organizaciones incluyen los siguientes campos de datos de etiquetas: Clave de etiquetas, Valor de etiquetas, Etiquetas heredadas y Espacio de nombres de etiquetas.

Las etiquetas a nivel de recurso de la exportación de datos de 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
• Instancias de Bigtable
• Servicios y tareas de Cloud Run
• Segmentos de Cloud Storage
• Instancias de Compute Engine
• Instancias de Memorystore para Redis
• Secretos globales y regionales de Secret Manager
• Instancias de Spanner
• Bases de datos de Firestore

Limitaciones de las etiquetas

• Las etiquetas pueden tardar hasta una hora en propagarse a las exportaciones de BigQuery. Si se ha añadido o eliminado una etiqueta en la última hora, o si un recurso lleva menos de una hora, es posible que no aparezca en la exportación.

Ejemplos de consultas de costes de uso detallados

En esta sección se ofrecen ejemplos de cómo consultar los datos de costes de uso detallados de Facturación de Cloud que se han exportado a BigQuery.

• Devolver los costes a nivel de recurso de una factura
  • Suma los costes de cada recurso por factura
  • Devuelve los detalles por tipo de coste de cada recurso, por mes de facturación.

• Obtener un desglose de los costes de los clústeres de Google Kubernetes Engine (GKE)
  • Filtrar el desglose de costes de GKE

Como el esquema de costes de uso detallado incluye todos los campos del esquema de costes de uso estándar, los ejemplos de consultas proporcionados para los datos estándar exportados a BigQuery también funcionan con los datos detallados exportados. Las consultas estándar no se han escrito para obtener ninguna de las informaciones a nivel de recurso que se proporcionan con la opción de exportación de costes de uso detallada. Cuando crees consultas para los datos detallados, puedes usar una consulta estándar como plantilla, actualizar el nombre de la tabla y añadir cualquiera de los campos disponibles en el esquema de costes de uso detallados.

Valores comunes usados en las consultas de costes detalladas de ejemplo

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

Devolver los costes a nivel de recurso de una factura

Las siguientes consultas muestran dos formas de ver los valores de costes y créditos a nivel de recurso en una factura mediante los datos de facturación exportados.

• El campo total suma directamente los valores de coste y crédito de coma flotante, lo que puede provocar errores de redondeo de coma flotante.
• El campo total_exact convierte los costes y los valores de crédito a micro antes de sumarlos y, después, los vuelve a convertir a dólares para evitar el error de redondeo de coma flotante.

Suma de los costes de cada recurso por factura

Esta consulta muestra el total de la factura de cada resource.name al mes, como suma de los costes normales, los impuestos, los ajustes y los errores de redondeo. Los costes que no estén asociados a un elemento de nivel de recurso se agregan 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:

Devuelve los detalles por tipo de coste de cada recurso por mes de facturación.

Esta consulta muestra los totales de cada cost_type de cada resource.name por mes. Los tipos de costes incluyen los costes normales, los impuestos, los ajustes y los errores de redondeo. Los costes que no estén asociados a un elemento de nivel de recurso se agregan 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:

Consultar un desglose de los costes de los clústeres de Google Kubernetes Engine (GKE)

En esta sección se proporcionan ejemplos de cómo filtrar los costes de los clústeres de GKE en los informes de exportación de BigQuery. Para obtener más información sobre los costes de los clústeres de GKE, consulta Ver el desglose de los costes de los clústeres.

Filtrar costes de GKE

En las siguientes consultas de ejemplo se muestra cómo filtrar y agrupar los costes de GKE de los tipos de recursos admitidos por nombre de clúster, espacio de nombres y etiqueta.

Costes de los clústeres de GKE antes de aplicar 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
;

Costes de GKE después de aplicar los 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
;

Costes 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

En los siguientes ejemplos se muestran formas de consultar tus datos con etiquetas.

Calcular los costes por mes de facturación con etiquetas

La siguiente consulta muestra cómo puede usar los costes de retorno por mes de facturación de la etiqueta 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:

Ver los costes de los recursos sin etiquetar

Esta consulta 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:

Temas relacionados

Temas relacionados con los datos de Facturación de Cloud exportados

• Configurar la exportación de datos de Facturación de Cloud a BigQuery
• Consultas de ejemplo para exportar datos de Facturación de Cloud a BigQuery
• Visualizar la inversión a lo largo del tiempo con Looker Studio

Informes de costes y precios disponibles en la Google Cloud consola

• Ver los informes de facturación y las tendencias de costes de Cloud
• Ver y descargar los detalles de los costes de una factura o un extracto
• Ver y descargar los precios de los servicios en la nube de Google
• Comprender lo que se ahorra con informes de desglose de costes
• Analizar la eficacia de los descuentos por uso confirmado
• Consultar el historial de costes y pagos