Exportación de datos de utilización en formato FOCUS

Exporte sus datos de uso de IBM Cloud® en formato FinOps Open Cost & Usage Specification (FOCUS) para simplificar la gestión de costes en varias nubes y permitir una integración perfecta con las herramientas de FinOps.

El formato FOCUS es un estándar entre nubes desarrollado por la Fundación FinOps que normaliza los datos de facturación y uso entre proveedores de nubes. IBM Cloud es ahora compatible con el formato FOCUS v1.2 ( FinOps Open Cost and Usage Specification) para la elaboración de informes de costes y uso. Al exportar sus datos de uso de IBM Cloud en formato FOCUS, puede analizar los costes de IBM Cloud junto con los datos de AWS, Azure y GCP sin necesidad de una transformación personalizada. Para más información, consulte la especificación FinOps Foundation FOCUS v1.2.

Antes de empezar

Antes de exportar los datos de utilización en formato FOCUS, asegúrese de que dispone de los siguientes accesos y recursos:

  • Acceso del administrador de facturación o del propietario de la cuenta a la cuenta IBM Cloud
  • Acceso a la consola IBM Cloud o CLI
  • Comprensión de sus necesidades de gestión de costes y de la herramienta FinOps

Comprender las ventajas del formato FOCUS

El formato FOCUS ofrece varias ventajas para la gestión de sus costes de nube:

Visibilidad multi-nube mejorada
Normalice los datos de uso de IBM Cloud con AWS Informes de Costes y Usos (CUR), Azure CSV exportaciones y GCP datos de facturación para un análisis de costes unificado.
Integración directa de herramientas
Importe datos con formato FOCUS directamente en plataformas FinOps como Apptio Cloudability, CloudHealth, Kubecost y otras herramientas de optimización de costes sin necesidad de scripts de transformación personalizados.
Reducción del tiempo de incorporación
Elimine los procesos manuales de transformación de datos, reduciendo el tiempo y los costes necesarios para integrar los datos de facturación de IBM Cloud en sus flujos de trabajo de gestión de costes.
Mayor transparencia
Acceda a dimensiones de facturación estandarizadas que se ajustan a las mejores prácticas del sector, lo que facilita la comprensión y validación de sus cargos en IBM Cloud.
Paridad competitiva
Benefíciese del mismo formato estandarizado utilizado por otros proveedores líderes de servicios en la nube, garantizando prácticas coherentes de gestión de costes en todo su entorno multicloud.

Exportación de datos de uso

Los datos de uso a nivel de instancia proporcionan detalles pormenorizados sobre instancias de recursos individuales, lo que permite la asignación detallada de costes y la devolución de cargos.

  1. Acceda a la consola IBM Cloud.
  2. Vaya a Gestionar > Facturación y uso > Uso.
  3. Haga clic en el botón FOCUS. El sistema descarga un archivo CSV que contiene datos de uso a nivel de instancia en formato FOCUS v1.2, con columnas adicionales para detalles específicos de los recursos.

Campos totalmente compatibles

IBM CSV incluye todos los campos obligatorios de FOCUS v1.2:

Campos MUST totalmente compatibles
Campo Tipo Descripción
BilledCost Decimal Coste facturado al cliente
BillingCurrency Serie Código de moneda (ISO 4217)
ChargeCategory Serie Tipo de cargo (Uso, Compra, Impuesto, Ajuste)
ChargeDescription Serie Descripción del cargo
ChargePeriodEnd DateTime Fin del periodo de carga (ISO 8601)
ChargePeriodStart DateTime Inicio del periodo de carga (ISO 8601)
EffectiveCost Decimal Coste amortizado después de descuentos
ListUnitPrice Decimal Precio de catálogo por unidad antes de descuentos
PricingCategory Serie Modelo de precios
PricingQuantity Decimal Cantidad utilizada para la fijación de precios
PricingUnit Serie Unidad de medida de los precios
ProviderName Serie Siempre " IBM "
PublisherName Serie Nombre del editor del servicio
ResourceId Serie Identificador único de recursos
ResourceName Serie Nombre de recurso
ServiceCategory Serie Categoría de servicio de alto nivel
ServiceName Serie Nombre del servicio
SkuId Serie Identificador SKU

Campos adicionales admitidos

Además de los 16 campos obligatorios, los informes IBM Cloud FOCUS incluyen 39 campos adicionales:

Campos adicionales admitidos
Categoría Nombre de campo
Cuenta y facturación: BillingAccountId, BillingAccountName, BillingAccountType, BillingPeriodEnd, BillingPeriodStart, InvoiceIssuerName
Geográfica: AvailabilityZone, RegionId, RegionName
Compromiso y descuento: CommitmentDiscountCategory, CommitmentDiscountId, CommitmentDiscountName, CommitmentDiscountType, CommitmentDiscountUnit
Desglose de costes: ContractedCost, ContractedUnitPrice, ListCost
Detalles de la carga: ChargeClass, ChargeFrequency
Consumo: ConsumedQuantity, ConsumedUnit
Precios: PricingCurrency, SkuMeter
Metadatos de recursos: ResourceType, ServiceSubcategory, Tags
IBM-Extensiones específicas: x_DiscountId, x_DiscountName, x_DiscountQuantity, x_OfferId, x_OfferCredit

Exportación de datos de uso mediante la API

Puede automatizar la exportación de datos de uso utilizando la API de informes de uso de IBM Cloud. Para más información, consulte API de informes de uso.

  1. Obtenga una clave API con el acceso de facturación adecuado. Para obtener más información, consulte Gestión de claves de API.

  2. Utilice el siguiente punto final de la API para exportar los datos de uso:

    curl -X GET "https://billing.cloud.ibm.com/v4/accounts/{account_id}/focus/{month}" \
  -H "Authorization: Bearer {iam_token}" \
  -H "Accept: text/csv"

Sustituya {account_id} por su ID de cuenta IBM Cloud (obligatorio), {month} por el mes del informe en formato AAAA-MM (por ejemplo, 2024-01) y {iam_token} por su token de acceso IAM.

Parámetros de API

La API de exportación de FOCUS admite los siguientes parámetros: account_id (obligatorio) : El identificador de la cuenta IBM Cloud.

month (obligatorio)
Indique el mes en formato AAAA-MM (por ejemplo, 2024-01).

Headers: Authorization (obligatorio) : Token portador para la autenticación IAM.

x-focus-version (opcional)
Versión de FOCUS a utilizar (por defecto: 1.2 ). Seleccione true para omitir la memoria caché y generar un informe nuevo.

Parámetros de la consulta:

format
Las opciones incluyen:
  • json (por defecto)- devolverá los resultados en formato JSON paginado.
  • csv- devolverá todos los resultados en formato CSV.
_limit (opcional)
Límite de paginación, máximo 250 (por defecto: 200).

Validación de las exportaciones en formato FOCUS:

Para asegurarse de que los datos exportados cumplen las especificaciones de FOCUS v1.2, puede validar los archivos utilizando la herramienta de validación de FOCUS de la Fundación FinOps. Las exportaciones de IBM Cloud FOCUS están diseñadas para pasar la validación con un cumplimiento del 100% en los 16 campos obligatorios MUST.

Comparación de los formatos IBM nativo y FOCUS v1.2

Tanto IBM formatos nativos y FOCUS v1.2 están disponibles para las exportaciones de uso. El siguiente cuadro destaca las principales diferencias:

Comparación de formatos
Aspecto IBM Formato original FOCUS v1.2 Formato
Nombres de columna IBM-convenciones específicas de nomenclatura Nombres de columna normalizados de FOCUS v1.2
Compatibilidad con múltiples nubes IBM Cloud sólo Compatible con AWS, Azure, GCP
FinOps soporte de herramientas Requiere transformación personalizada Importación directa
Granularidad de datos Mismo nivel de detalle Mismo nivel de detalle
Conformidad IBM-específico 100% conforme con FOCUS v1.2 (16/16 campos OBLIGATORIOS)
Caso de uso IBM-análisis e informes específicos Herramientas de gestión de costes multicloud y FinOps

Puede exportar datos en ambos formatos simultáneamente para dar soporte a diferentes casos de uso dentro de su organización.

Próximos pasos

Después de exportar sus datos de uso en formato FOCUS, puede: