Esportazione dei dati di utilizzo in formato FOCUS

Esportate i dati di utilizzo di IBM Cloud® nel formato FOCUS (Open Cost & Usage Specification) di FinOps per semplificare la gestione dei costi multi-cloud e consentire una perfetta integrazione con gli strumenti di FinOps.

Il formato FOCUS è uno standard cross-cloud sviluppato dalla FinOps Foundation che normalizza i dati di fatturazione e utilizzo tra i vari cloud provider. IBM Cloud ora supporta il formato FOCUS v1.2 ( FinOps Open Cost and Usage Specification) per la rendicontazione di costi e utilizzo. Esportando i dati di utilizzo di IBM Cloud in formato FOCUS, è possibile analizzare i costi di IBM Cloud insieme ai dati di AWS, Azure e GCP senza trasformazioni personalizzate. Per ulteriori informazioni, consultare le specifiche di FinOps Foundation FOCUS v1.2.

Prima di iniziare

Prima di esportare i dati di utilizzo in formato FOCUS, assicurarsi di disporre dell'accesso e delle risorse seguenti:

  • Accesso all'account IBM Cloud da parte dell'amministratore della fatturazione o del proprietario dell'account
  • Accesso alla console o alla CLI di IBM Cloud
  • Comprensione dei requisiti degli strumenti di gestione dei costi e di FinOps

Comprendere i vantaggi del formato FOCUS

Il formato FOCUS offre diversi vantaggi per la gestione dei costi del cloud:

Maggiore visibilità multi-cloud
Normalizzare i dati di utilizzo di IBM Cloud con AWS Cost and Usage Reports (CUR), Azure CSV esportazioni e GCP dati di fatturazione per un'analisi unificata dei costi.
Integrazione diretta degli strumenti
Importazione di dati in formato FOCUS direttamente nelle piattaforme FinOps come Apptio Cloudability, CloudHealth, Kubecost e altri strumenti di ottimizzazione dei costi senza script di trasformazione personalizzati.
Riduzione dei tempi di onboarding
Eliminate i processi di trasformazione manuale dei dati, riducendo i tempi e i costi necessari per integrare i dati di fatturazione di IBM Cloud nei vostri flussi di lavoro di gestione dei costi.
Miglioramento della trasparenza
Accesso a dimensioni di fatturazione standardizzate che si allineano alle migliori pratiche del settore, rendendo più facile la comprensione e la convalida degli addebiti di IBM Cloud.
Parità competitiva
Beneficiare dello stesso formato standardizzato utilizzato da altri fornitori di servizi cloud leader, garantendo pratiche di gestione dei costi coerenti in tutto l'ambiente multi-cloud.

Esportazione dei dati di utilizzo

I dati di utilizzo a livello di istanza forniscono dettagli granulari sulle singole istanze di risorse, consentendo l'allocazione dettagliata dei costi e il chargeback.

  1. Accedere alla console IBM Cloud.
  2. Andate su Gestione > Fatturazione e utilizzo > Utilizzo.
  3. Fare clic sul pulsante FOCUS. Il sistema scarica un file CSV contenente i dati di utilizzo a livello di istanza nel formato FOCUS v1.2, con colonne aggiuntive per i dettagli specifici della risorsa.

Campi completamente supportati

IBM CSV il file include tutti i campi obbligatori di FOCUS v1.2:

Campi MUST completamente supportati
Campo Immettere Descrizione
BilledCost Decimale Costo fatturato al cliente
BillingCurrency Stringa Codice valuta (ISO 4217)
ChargeCategory Stringa Tipo di addebito (Utilizzo, Acquisto, Tassa, Adeguamento)
ChargeDescription Stringa Descrizione dell'accusa
ChargePeriodEnd DateTime Fine del periodo di carica (ISO 8601)
ChargePeriodStart DateTime Inizio del periodo di carica (ISO 8601)
EffectiveCost Decimale Costo ammortizzato dopo gli sconti
ListUnitPrice Decimale Prezzo di listino per unità prima degli sconti
PricingCategory Stringa Modello di prezzi
PricingQuantity Decimale Quantità utilizzata per la determinazione del prezzo
PricingUnit Stringa Unità di misura per la determinazione dei prezzi
ProviderName Stringa Sempre " IBM "
PublisherName Stringa Nome dell'editore del servizio
ResourceId Stringa Identificatore univoco della risorsa
ResourceName Stringa Nome della risorsa
ServiceCategory Stringa Categoria di servizio di alto livello
ServiceName Stringa Nome del servizio
SkuId Stringa Identificatore SKU

Campi aggiuntivi supportati

Oltre ai 16 campi obbligatori, i report di IBM Cloud FOCUS includono 39 campi aggiuntivi:

Altri campi supportati
Categoria Nome campo
Conto e fatturazione: BillingAccountId, BillingAccountName, BillingAccountType, BillingPeriodEnd, BillingPeriodStart, InvoiceIssuerName
Geografico: AvailabilityZone, RegionId, RegionName
Impegno e sconto: CommitmentDiscountCategory, CommitmentDiscountId, CommitmentDiscountName, CommitmentDiscountType, CommitmentDiscountUnit
Ripartizione dei costi: ContractedCost, ContractedUnitPrice, ListCost
Dettagli sulla carica: ChargeClass, ChargeFrequency
Consumo: ConsumedQuantity, ConsumedUnit
Prezzi: PricingCurrency, SkuMeter
Metadati delle risorse: ResourceType, ServiceSubcategory, Tags
IBM-Estensioni specifiche: x_DiscountId, x_DiscountName, x_DiscountQuantity, x_OfferId, x_OfferCredit

Esportazione dei dati di utilizzo tramite API

È possibile automatizzare l'esportazione dei dati di utilizzo utilizzando l'API IBM Cloud Usage Reports. Per ulteriori informazioni, vedere Rapporti d'uso API.

  1. Ottenere una chiave API con accesso adeguato alla fatturazione. Per ulteriori informazioni, vedere Gestione delle chiavi API.

  2. Utilizzare il seguente endpoint API per esportare i dati di utilizzo:

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

Sostituire {account_id} con l'ID account IBM Cloud (obbligatorio), {month} con il mese del report nel formato AAAA-MM (ad esempio, 2024-01) e {iam_token} con il token di accesso IAM.

Parametri API

L'API di esportazione di FOCUS supporta i seguenti parametri: account_id (Obbligatorio) : L'ID dell'account IBM Cloud.

month (Obbligatorio)
Riportare il mese nel formato AAAA-MM (ad esempio, 2024-01).

Intestazioni: Authorization (Obbligatorio) : Token portatore per l'autenticazione IAM.

x-focus-version (facoltativo)
Versione di FOCUS da utilizzare (default: 1.2 ). Impostare su true per bypassare la cache e generare un nuovo report.

Parametri query:

format
Le opzioni includono:
  • json (predefinito)- restituisce i risultati in formato JSON paginato.
  • csv- restituisce tutti i risultati in formato CSV.
_limit (facoltativo)
Limite di paginazione, max 250 (default: 200).

Convalida delle esportazioni in formato FOCUS:

Per assicurarsi che i dati esportati siano conformi alle specifiche di FOCUS v1.2, è possibile convalidare i file utilizzando lo strumento FOCUS validator della FinOps Foundation. Le esportazioni di IBM Cloud FOCUS sono progettate per superare la convalida con il 100% di conformità su tutti i 16 campi obbligatori MUST.

Confronto tra i formati IBM nativo e FOCUS v1.2

Per le esportazioni di utilizzo sono disponibili sia il formato nativo di IBM che quello di FOCUS v1.2. La tabella seguente evidenzia le principali differenze:

Confronto tra formati
Aspetto IBM Formato nativo FOCUS v1.2 Formato
Nomi colonne IBM-convenzioni di denominazione specifiche Nomi standardizzati delle colonne di FOCUS v1.2
Compatibilità multi-cloud IBM Cloud solo Compatibile con AWS, Azure, GCP
FinOps supporto per gli strumenti Richiede una trasformazione personalizzata Importazione diretta supportata
Granularità dei dati Stesso livello di dettaglio Stesso livello di dettaglio
Conformità IBM-specifico 100% conforme a FOCUS v1.2 (16/16 campi obbligatori)
Caso d'uso IBM-analisi e reportistica specifica Strumenti di gestione dei costi multi-cloud e FinOps

È possibile esportare i dati in entrambi i formati contemporaneamente per supportare diversi casi d'uso all'interno dell'organizzazione.

Passi successivi

Dopo aver esportato i dati di utilizzo in formato FOCUS, è possibile: