Exportation des données d'utilisation au format FOCUS

Exportez vos données d'utilisation IBM Cloud® au format FinOps Open Cost & Usage Specification (FOCUS) pour simplifier la gestion des coûts multi-cloud et permettre une intégration transparente avec les outils FinOps.

Le format FOCUS est une norme inter-cloud développée par la Fondation FinOps qui normalise les données de facturation et d'utilisation entre les fournisseurs de cloud. IBM Cloud prend désormais en charge le format FOCUS v1.2 ( FinOps Open Cost and Usage Specification) pour les rapports sur les coûts et l'utilisation. En exportant vos données d'utilisation IBM Cloud au format FOCUS, vous pouvez analyser les coûts IBM Cloud avec les données AWS, Azure et GCP sans transformation personnalisée. Pour plus d'informations, voir la spécification FOCUS v1.2 de la Fondation FinOps.

Avant de commencer

Avant d'exporter des données d'utilisation au format FOCUS, assurez-vous que vous disposez des accès et ressources suivants :

  • L'administrateur de la facturation ou le titulaire du compte a accès au compte IBM Cloud
  • Accès à la console IBM Cloud ou au CLI
  • Compréhension de vos besoins en matière de gestion des coûts et d'outils FinOps

Comprendre les avantages du format FOCUS

Le format FOCUS offre plusieurs avantages pour la gestion des coûts liés à l'informatique en nuage :

Visibilité multi-cloud améliorée
Normaliser les données d'utilisation IBM Cloud avec AWS Cost and Usage Reports (CUR), Azure CSV exports, et GCP billing data pour une analyse unifiée des coûts.
Intégration directe des outils
Importer des données au format FOCUS directement dans les plateformes FinOps telles que Apptio Cloudability, CloudHealth, Kubecost et d'autres outils d'optimisation des coûts sans scripts de transformation personnalisés.
Réduction du temps d'intégration
Éliminez les processus manuels de transformation des données, en réduisant le temps et les coûts nécessaires à l'intégration des données de facturation IBM Cloud dans vos flux de travail de gestion des coûts.
Amélioration de la transparence
Accédez à des dimensions de facturation normalisées qui correspondent aux meilleures pratiques du secteur, ce qui facilite la compréhension et la validation de vos frais sur IBM Cloud.
Parité concurrentielle
Bénéficiez du même format standardisé que celui utilisé par les principaux fournisseurs de services cloud, ce qui garantit des pratiques de gestion des coûts cohérentes dans votre environnement multi-cloud.

Exportation des données d'utilisation

Les données d'utilisation au niveau de l'instance fournissent des détails granulaires sur les instances de ressources individuelles, ce qui permet une répartition des coûts et une facturation détaillées.

  1. Connectez-vous à la console IBM Cloud.
  2. Accédez à Gérer > Facturation et utilisation > Utilisation.
  3. Cliquez sur le bouton FOCUS. Le système télécharge un fichier CSV contenant des données d'utilisation au niveau de l'instance au format FOCUS v1.2, avec des colonnes supplémentaires pour les détails spécifiques à la ressource.

Champs entièrement pris en charge

IBM CSV comprend tous les champs obligatoires de FOCUS v1.2:

Champs MUST entièrement pris en charge
Zone Type Description
BilledCost Décimal Coût facturé au client
BillingCurrency Chaîne Code devise (ISO 4217)
ChargeCategory Chaîne Type de frais (utilisation, achat, taxe, ajustement)
ChargeDescription Chaîne Description de l'accusation
ChargePeriodEnd DateTime Fin de la période de facturation (ISO 8601)
ChargePeriodStart DateTime Début de la période de facturation (ISO 8601)
EffectiveCost Décimal Coût amorti après escomptes
ListUnitPrice Décimal Prix de catalogue par unité avant remises
PricingCategory Chaîne Modèle de tarification
PricingQuantity Décimal Quantité utilisée pour la tarification
PricingUnit Chaîne Unité de mesure pour la tarification
ProviderName Chaîne Toujours " IBM "
PublisherName Chaîne Nom de l'éditeur du service
ResourceId Chaîne Identifiant unique de la ressource
ResourceName Chaîne Nom de la ressource
ServiceCategory Chaîne Catégorie de service de haut niveau
ServiceName Chaîne Nom du service
SkuId Chaîne Identifiant SKU

Champs supplémentaires pris en charge

Outre les 16 champs obligatoires, les rapports IBM Cloud FOCUS comprennent 39 champs supplémentaires :

Champs supplémentaires pris en charge
Catégorie Nom de zone
Compte et facturation : BillingAccountId, BillingAccountName, BillingAccountType, BillingPeriodEnd, BillingPeriodStart, InvoiceIssuerName
Géographique : AvailabilityZone, RegionId, RegionName
Engagement et remise : CommitmentDiscountCategory, CommitmentDiscountId, CommitmentDiscountName, CommitmentDiscountType, CommitmentDiscountUnit
Ventilation des coûts : ContractedCost, ContractedUnitPrice, ListCost
Détails de la charge : ChargeClass, ChargeFrequency
Consommation : ConsumedQuantity, ConsumedUnit
Tarification : PricingCurrency, SkuMeter
Métadonnées des ressources : ResourceType, ServiceSubcategory, Tags
IBM-Extensions spécifiques : x_DiscountId, x_DiscountName, x_DiscountQuantity, x_OfferId, x_OfferCredit

Exporter des données d'utilisation à l'aide de l'API

Vous pouvez automatiser l'exportation des données d'utilisation à l'aide de l'API IBM Cloud Usage Reports. Pour plus d'informations, voir Rapports d'utilisation API.

  1. Obtenir une clé API avec un accès approprié à la facturation. Pour plus d'informations, voir Gestion des clés d'API.

  2. Utilisez le point de terminaison API suivant pour exporter des données d'utilisation :

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

Remplacez {account_id} par votre identifiant de compte IBM Cloud (obligatoire), {month} par le mois du rapport au format AAAA-MM (par exemple, 2024-01) et {iam_token} par votre jeton d'accès IAM.

Paramètres d'API

L'API d'exportation FOCUS prend en charge les paramètres suivants : account_id(obligatoire) : L'identifiant du compte IBM Cloud.

month(obligatoire)
Déclarer le mois au format AAAA-MM (par exemple, 2024-01).

En-têtes : Authorization(obligatoire) : Jeton de support pour l'authentification IAM.

x-focus-version (facultatif)
Version de FOCUS à utiliser (par défaut : 1.2 ). Régler sur true pour contourner le cache et générer un nouveau rapport.

Query Parameters:

format
Les options incluent :
  • json (par défaut)- renvoie les résultats au format JSON paginé.
  • csv- renvoie tous les résultats au format CSV.
_limit (facultatif)
Limite de pagination, max 250 (par défaut : 200).

Validation des exportations au format FOCUS :

Pour vous assurer que les données exportées sont conformes aux spécifications de FOCUS v1.2, vous pouvez valider les fichiers à l'aide de l'outil FOCUS validator de la Fondation FinOps. Les exportations IBM Cloud FOCUS sont conçues pour passer la validation avec une conformité à 100 % sur les 16 champs obligatoires MUST.

Comparaison des formats natifs IBM et FOCUS v1.2

Les formats natifs IBM et FOCUS v1.2 sont disponibles pour les exportations d'utilisation. Le tableau suivant met en évidence les principales différences :

Comparaison des formats
Aspect IBM Format natif FOCUS v1.2 Format
Noms de colonne IBM-les conventions de dénomination spécifiques Noms de colonnes standardisés de FOCUS v1.2
Compatibilité multi-cloud IBM Cloud seulement Compatible avec AWS, Azure, GCP
FinOps soutien aux outils Nécessite une transformation personnalisée Importation directe possible
Granularité des données Même niveau de détail Même niveau de détail
Conformité IBM-spécifique 100% conforme à FOCUS v1.2 (16/16 champs obligatoires)
Cas d'utilisation IBM-analyse et rapports spécifiques Outils de gestion des coûts multi-cloud et FinOps

Vous pouvez exporter des données dans les deux formats simultanément pour répondre à différents cas d'utilisation au sein de votre organisation.

Etapes suivantes

Après avoir exporté vos données d'utilisation au format FOCUS, vous pouvez.. :