Exportation de vos données d'utilisation pour une analyse continue

Vous pouvez exporter les données d'utilisation de votre compte vers un compartiment COS ( Cloud Object Storage ) pour bénéficier d'une visibilité, d'une optimisation et d'une gouvernance continues, entre autres, dans tous les environnements cloud. Par exemple, si vous êtes un administrateur de compte et que vous souhaitez en savoir plus sur l'utilisation de votre compte et obtenir une analyse d'optimisation des coûts, vous pouvez intégrer votre compte à un fournisseur tiers afin d'obtenir des informations sur l'utilisation de vos comptes.

Lorsque vous configurez votre compte pour exporter le rapport d'utilisation vers un compartiment d' IBM Cloud Object Storage, vous autorisez votre compte à exporter ces données en continu. Pour exporter des données ponctuelles, voir Exporter les détails de votre utilisation vers un fichier CSV.

Pour permettre à votre compte de partager les données d'utilisation, vous devez autoriser le service de facturation à accéder aux détails de l'utilisation et à les exporter vers un panier COS. Comme le rapport comprend des données d'utilisation pour l'ensemble du compte, l'utilisation du compte enfant et des informations sur les services et les instances, l'identifiant de service utilisé par le service de facturation doit être accessible à l'administrateur pour pouvoir exporter les détails de l'utilisation. Une fois la configuration terminée, un rapport de coûts et d'utilisation au format CSV est automatiquement exporté quotidiennement vers votre panier COS.

Permettre à votre compte d'exporter des données d'utilisation

Avant de permettre à votre compte d'exporter des données d'utilisation, vous devez avoir le rôle d'administrateur ou d'éditeur sur le service de gestion du compte de facturation. Pour plus d'informations, voir Accès IAM.

Lorsque vous activez votre compte pour exporter des données d'utilisation, le seau COS peut collecter des données remontant jusqu'à un an. Ainsi, si vous êtes en juin 2024, vous ne pourrez consulter l'utilisation qu'à partir de juin 2023, mais vous serez toujours en mesure de consulter les données qui remontent à cette date. Cela signifie que si vous avez activé cette fonctionnalité en juin 2023 et que nous sommes en juin 2024, vous pouvez consulter les données d'utilisation de juin 2022 à juin 2024.

Pour permettre à votre compte d'exporter des données d'utilisation, procédez comme suit :

  1. Dans la console IBM Cloud, allez à Gérer > Facturation et utilisation, et sélectionnez Paramètres.
  2. Cliquez sur Connecter.
  3. Sélectionnez une instance Cloud Object Storage et un Bucket. En les sélectionnant, vous choisissez le seau dans lequel seront stockés vos rapports d'utilisation.
    1. Facultatif : si vous ne souhaitez pas sélectionner une instance existante, vous pouvez cliquer sur Sélectionner une instance > Créer une nouvelle.
    2. Facultatif : vous pouvez sélectionner un seau ou en créer un nouveau en cliquant sur Créer un nouveau seau dans le menu déroulant Seau. Pour plus d'informations sur les buckets, reportez-vous à la section Premiers pas avec IBM Cloud Object Storage Après avoir créé votre seau
  4. Pour les autorisations de service à service, cliquez sur Autoriser. Pour l'accès requis, sélectionnez Rédacteur d'objet et Lecteur de contenu. Cliquez sur Réviser, puis sur Attribuer.
  5. Cliquez sur Connecter après avoir vérifié les détails de votre dossier.

Si vous convertissez votre compte en compte d'entreprise, vous devez suivre à nouveau ces étapes pour permettre au compte d'entreprise d'exporter des données d'utilisation. Vous pouvez conserver cette fonction sur votre compte d'origine ou la supprimer en déconnectant votre compte de l'utilisation du partage.

Demande d'accès aux données historiques

Lorsque vous activez votre compte pour exporter des données d'utilisation, le seau COS recueille par défaut les données du mois en cours, telles qu'elles sont fournies par l'exportation quotidienne automatique du service de facturation, mais il peut contenir des données remontant jusqu'à un an si vous demandez des données historiques. Ainsi, si vous êtes en juin 2024, vous ne pourrez consulter l'utilisation qu'à partir de juin 2023, mais vous serez toujours en mesure de consulter les données qui remontent à cette date. Cela signifie que si vous avez activé cette fonctionnalité en juin 2023 et que nous sommes en juin 2024, vous pouvez consulter les données d'utilisation de juin 2022 à juin 2024. Pour obtenir des données historiques, vous devez créer un dossier d'assistance.

Pour demander l'accès aux données historiques, procédez comme suit :

  1. Dans la barre de menu de la console " IBM Cloud, cliquez sur l'icône " Aide ", " Icône d'aide > " Centre d'assistance.

  2. Dans la section Contacter le support, cliquez sur Créer un cas.

  3. Pour la catégorie, sélectionnez Facturation et utilisation.

  4. Pour le sujet, sélectionnez Facturation et utilisation, et pour le sous-thème, sélectionnez Exporter vos détails d'utilisation vers un fichier .csv.

  5. Renseignez les zones obligatoires. Pour la description du cas d'assistance, vous devez mentionner les mois pour lesquels vous souhaitez obtenir des données.

    Pour garantir la sécurité, n'incluez aucune information personnelle, donnée sensible ou donnée d'identification du périphérique ou de service dans les réponses relatives aux cas. Par exemple, n'incluez pas de mots de passe, de clés API, de secrets ou d'informations relatives à une carte de crédit.

  6. Cliquez sur Suivant, examinez le récapitulatif de votre cas, puis cliquez sur Soumettre un cas. Après avoir reçu la vérification par courrier électronique pour le cas, suivez les instructions pour toute communication supplémentaire concernant le problème.

ne fois le cas de support créé, vous pouvez suivre sa progression sur la page Gérer les cas.

Permettre à votre compte d'exporter des données d'utilisation en utilisant Terraform

Avant d'activer votre compte pour exporter des données d'utilisation à l'aide de Terraform, assurez-vous d'avoir effectué les opérations suivantes :

  • Installez le CLI Terraform et configurez le plug-in IBM Cloud Pour Terraform. Pour plus d'informations, voir le tutoriel pour démarrer avec Terraform sur IBM Cloud® Ce plug-in résume les API IBM Cloud utilisées pour effectuer cette tâche.
  • Créez un fichier de configuration Terraform nommé main.tf. Dans ce fichier, vous définissez les ressources en utilisant le langage de configuration HashiCorp. Pour plus d'informations, voir la documentation de Terraform.

Pour permettre à votre compte d'exporter des données d'utilisation, vous devez autoriser une politique entre deux instances et provisionner 'billing_report_snaptshot pour une instance de ressource. Pour plus d'informations, voir la documentation terraform pour ibm_billing_report_snapshot. Suivez les étapes suivantes pour créer une politique d'autorisation et provisionner 'billing_report_snaptshot pour une instance de ressource en utilisant Terraform :

Les informations d'identification doivent être fournies en définissant la variable d'environnement " IC_API_KEY qui correspond à la clé API du compte concerné pour exécuter la configuration de l'instantané de facturation. Pour plus d'informations, voir la documentationIBM Cloud Provider terraform.

  1. L'exemple suivant crée une politique d'autorisation entre deux instances spécifiques.

    provider "ibm" {
    }
    resource "ibm_iam_authorization_policy" "policy" {
    source_service_name         = "billing"
    target_service_name         = "cloud-object-storage"
    target_resource_instance_id = var.cos_instance_id
    roles                       = ["Object Writer", "Content Reader"]
    }
    
  2. L'exemple suivant prévoit " billing_report_snaptshot pour une instance de ressource.

       provider "ibm" {
    }
    resource "ibm_billing_report_snapshot" "billing_report_snapshot_instance" {
    interval = var.billing_report_snapshot_interval
    versioning = var.billing_report_snapshot_versioning
    report_types = var.billing_report_snapshot_report_types
    cos_reports_folder = var.billing_report_snapshot_cos_reports_folder
    cos_bucket = var.billing_report_snapshot_cos_bucket
    cos_location = var.billing_report_snapshot_cos_location
    depends_on = [ ibm_iam_authorization_policy.policy ]
    }
    
  3. Une fois que vous avez terminé de construire votre fichier de configuration, initialisez le CLI Terraform. Pour plus d'informations, voir Initialisation des répertoires de travail.

    terraform init
    
  4. Fournir les ressources du fichier " main.tf. Pour plus d'informations, voir Provisionnement de l'infrastructure avec Terraform.

    1. Exécutez 'terraform plan pour générer un plan d'exécution Terraform afin de prévisualiser les actions proposées.

      terraform plan
      
    2. Exécutez le " terraform apply pour créer les ressources définies dans le plan.

      terraform apply
      

Si une authentification de service à service existe déjà, la contrainte " depends_on peut être supprimée pour la création de l'instance billing_report_snapshot_instance.

Exigences en matière de godets

Le seau que vous utilisez pour stocker vos résultats ne nécessite pas de paramètres ou de format de dénomination particuliers. Tout le trafic entre le service de facturation et Cloud Object Storage se fait sur un réseau privé. La récupération des données à des fins d'affichage dans la console ne vous coûte rien. Toutefois, si vous choisissez de télécharger les données directement à partir du Cloud Object Storage une fois qu'elles ont été stockées, vous devez payer des frais de transfert de données. Pour plus d'informations, voir les tarifs duCloud Object Storage.

Déconnexion de votre compte de l'utilisation partagée

Si vous avez configuré votre compte pour exporter des données d'utilisation, vous pouvez déconnecter le seau choisi afin de ne plus exporter de données.

Pour déconnecter, procédez comme suit :

  1. Dans la console IBM Cloud, allez à Gérer > Facturation et utilisation, et sélectionnez Paramètres.
  2. Cliquez sur Déconnecter.
  3. Saisissez le nom de votre seau.
  4. Cliquez sur Déconnecter.

Savoir comment vos données d'utilisation sont stockées et utilisées

Vos données sont partagées en utilisant des instantanés de rapports de facturation et en suivant les étapes pour permettre à votre compte d'exporter des données d'utilisation, vous configurez les instantanés.

Des instantanés des rapports de facturation sont stockés en fonction de la configuration établie. Selon la configuration, les anciens clichés sont soit supprimés, soit conservés. Chaque instantané est accompagné d'un fichier manifeste décrivant les détails de l'instantané, tels que les fichiers inclus dans l'instantané. Le manifeste du dernier instantané pour ce mois de facturation sera également stocké dans chaque dossier de mois de facturation.

Voici un exemple de la structure des dossiers des instantanés dans le seau COS.

<cos_reports_folder>/
<cos_reports_folder>/<billing-month>/
<cos_reports_folder>/<billing-month>/manifest.json
<cos_reports_folder>/<billing-month>/<snaphot-id>
<cos_reports_folder>/<billing-month>/<snaphot-id>/manifest.json
<cos_reports_folder>/<billing-month>/<snaphot-id>/*.gz
dossier_rapports_cos
Le dossier racine des rapports de facturation que le client a configuré dans le cadre de l'installation de biling-reports-snapshots.
La valeur par défaut est IBMCloud-Billing-Reports
mois de facturation
Le mois de facturation correspondant à l'instantané.
Le format est " YYYY-MM. Par exemple, 2023-03.
identifiant-instantané
ID de l'instantané.
Valeur alphanumérique. Par exemple, 1678234269105.
manifest.json
Fichier de métadonnées décrivant les détails de l'instantané, tels que l'identifiant du compte client, les fichiers csv correspondant à l'instantané, les types de rapports
Le fichier manifeste du mois de facturation contient le dernier instantané pris
*.gz
Liste des fichiers mentionnés dans le manifest.json

Pour plus d'informations sur l'utilisation de l'API de cliché instantané, voir Configuration du cliché instantané.