Création de votre rapport

Une fois les conditions requises remplies, vous êtes prêt à configurer le rapport correspondant à votre utilisationCompte AWS et à envoyer vos données d'utilisation àAWS Application Cost Profiler. Cette section explique comment configurer le rapport et comment envoyer les données d'utilisation à Application Cost Profiler.

Application Cost st Prost st st st st st Prost st st

La procédure suivante montre comment configurer le rapport que vous souhaitez générer en fonction de votre date d'utilisation. Vous configurez des détails tels que la fréquence à laquelle le rapport est généré.

Note

Si vousCompte AWS faites partie d'uneAWS organisation, vous pouvez configurer le rapport à l'aide du compte de gestion ou d'un compte de membre individuel. Les rapports configurés pour des comptes individuels contiennent uniquement des données relatives à ce compte. Les rapports configurés à l'aide du compte de gestion peuvent inclure des données pour l'ensemble de l'organisation.

Le compartiment Amazon S3 utilisé pour la sortie du rapport doit appartenir au compte qui crée la configuration du rapport.

Pour configurer votre rapport Application Cost Profiler

1. Ouvrez un navigateur Web et connectez-vous à la console Application Cost Profiler.

2. Choisissez Commencer maintenant pour configurer ou modifier un rapport.

3. Entrez un nom de rapport et une description pour votre rapport.

4. Entrez le nom de votre compartiment S3 dans le champ Entrez le nom du compartiment S3 et entrez le préfixe S3 dans le champ Entrez le préfixe S3. Pour plus d'informations sur la création de compartiments S3 et l'octroi d'autorisations à Application Cost Profiler, consultezConfiguration des compartiments Amazon S3 pour Application Cost Profiler.

5. Sélectionnez les options que vous souhaitez attribuer à votre rapport :

   • Fréquence : choisissez si le rapport est généré selon une cadence quotidienne ou mensuelle, ou les deux.

   • Format de sortie du rapport : choisissez le type de fichier à créer dans votre compartiment Amazon S3. Si vous choisissez CSV, Application Cost Profiler crée un fichier texte de valeurs séparées par des virgules avec compression gzip pour les rapports. Si vous choisissez Parquet, un fichier Parquet est généré pour les rapports.

6. Choisissez Configurer pour enregistrer la configuration de votre rapport.

Note

Vous pouvez également utiliser l'APIAWS Application Cost Profiler pour configurer les rapports.

Vérifiez les paramètres du rapport en choisissant Commencer maintenant pour afficher la configuration actuelle du rapport.

Note

Vous ne pouvez configurer qu'un seul rapport. Revenez à la page de configuration pour modifier votre rapport existant.

Une fois que vous avez configuré votre rapport, l'ingestion de données est activée. Vous pouvez intégrer vos services à Application Cost Profiler afin de fournir des données d'utilisation pour vos ressources.

Création de rapports sur les données d'utilisation des locataires à partir de vos services

Après avoir configuré le rapport, vous êtes prêt à envoyer les données d'utilisation des locataires à partir des ressources ou des services de votre compte. Vous devez informer Application Cost Profiler lorsque votre ressource est utilisée pour un locataire spécifique. Par exemple, si votre service accepte des appels d'API provenant de différents locataires, vous enregistrez une heure de début et de fin pour chaque client lorsque vous commencez et terminez un appel d'API provenant de ce client. Application Cost Profiler utilise ces données pour générer des rapports sur le coût de votre service, en fonction du temps consacré au travail par chaque locataire.

Pour communiquer les données d'utilisation de l'application Cost Prost Prost st Prost Prost Prost st Prost st Prost st Prost

• Préparez les données d'utilisation des ressources : créez des tables qui décrivent quand une ressource est utilisée pour un locataire spécifique.

• Charger les données d'utilisation : chargez les tables dans un compartiment Amazon S3 auquel vous avez autorisé Application Cost Profiler à accéder.

• Importer les données d'utilisation : appelez l'opération d'ImportApplicationUsageAPI pour indiquer à Application Cost Profiler que les données sont prêtes à être traitées.

Les sections suivantes décrivent chacune de ces étapes plus en détail.

Étape 1 : Préparation de vos données d'utilisation des ressources

Lorsqu'une ressource est utilisée dans votre service, vous pouvez suivre le locataire qui l'utilise. Enregistrez ces données dans un tableau que vous pourrez charger ultérieurement pour qu'Application Cost Profiler puisse les importer. Chaque ligne du tableau décrit une ressource, le locataire qui utilise la ressource, ainsi que les heures de début et de fin de cette utilisation. L'instance Amazon Elastic Compute Cloud (Amazon EC2) qui est utilisée est un exemple de ressource.

Cette étape nécessite que vous intégriez du code à votre service pour générer les informations correctes sur l'utilisation.

Les champs figurant dans un tableau d'utilisation des ressources sont répertoriés dans le tableau suivant.

Champ	Description
ApplicationId	Identifie l'application ou le produit de votre système qui est utilisé. Définit l'étendue des métadonnées du client.
TenantId	Un identifiant dans votre système pour le locataire qui consomme la ressource spécifiée. Le profileur des coûts des applications s'agrège à ce niveau dans le ApplicationId.
TenantDesc	(Facultatif) Données supplémentaires sur le locataire pour vos propres rapports supplémentaires.
UsageAccountId	Le compte dans lequel la ressource s'exécute (important pour les comptes faisant partie d'une organisation).
StartTime	Horodatage (en millisecondes et microsecondes) d'Epoch, en UTC. Indique l'heure de début de la période d'utilisation par le locataire spécifié.
EndTime	Horodatage (en millisecondes et microsecondes) d'Epoch, en UTC. Indique l'heure de fin de la période d'utilisation par le locataire spécifié.
ResourceId	Amazon Resource Name (ARN) de la ressource utilisée.
Name (Nom)	(Facultatif) Au lieu de spécifier une ResourceId, vous pouvez spécifier une balise de ressource Name pour attribuer des coûts à un ensemble de ressources (le champ doit inclure la valeur que vous souhaitez utiliser pour la balise Name). Les balises de ressources sont activées dans le cadre de votre rapport d'utilisation et de coût. Pour plus d'informations sur les balises de ressources, reportez-vous à la section Détails des balises de ressources dans le Guide de l'utilisateur du rapport sur les coûts et l'utilisation.

La sortie doit se trouver dans un fichier de valeurs séparées par des virgules (.csv) qui inclut une ligne d'en-tête, comme le montre l'exemple suivant.

ApplicationId,TenantId,TenantDesc,UsageAccountId,StartTime,EndTime,ResourceId
MyApp,Tenant1,,123456789012,1613681437032.9001,1613681437041.5312,arn:aws:ec2:us-east-1:123456789012:instance/1234-abcd-example-1234
MyApp,Tenant2,,123456789012,1613681245531.4426,1613681245551.1323,arn:aws:ec2:us-east-1:123456789012:instance/1234-abcd-example-1234
MyApp,Tenant1,,123456789012,1613681904815.3381,1613681904930.0972,arn:aws:ec2:us-east-1:123456789012:instance/1234-abcd-example-1234
MyApp,Tenant2,,123456789012,1613681904765.1956,1613681904946.574,arn:aws:ec2:us-east-1:123456789012:instance/1234-abcd-example-1234

Enregistrez les données sous forme de fichier, avec une extension .csv (ou .csv.gzip si elles sont compressées avec gzip). Lorsque vous chargez ces données dans Application Cost Profiler, chaque tranche de temps est attribuée au locataire associé. Dans cet exemple, le rapport inclut la tranche horaire du coût de l'instance Amazon EC2 pour ce locataire. Pour les instances Amazon EC2 uniquement, les tranches qui ne sont pas associées à un locataire spécifique sont ajoutées à un locataire non attribué. Les tranches de temps qui se chevauchent sont comptées plusieurs fois. Il est de votre responsabilité de vous assurer que les données de votre tableau d'utilisation sont exactes.

Note

Votre fichier doit représenter une heure. Si une ressource est utilisée pendant plusieurs heures, mettez fin à l'utilisation à cette heure et créez un nouvel enregistrement dans le fichier suivant qui commence à la même heure.

Vous devez soumettre un seul fichier contenant les données d'une heure complète. Si plusieurs fichiers sont soumis pour les données de la même heure, Application Cost Profiler ne prend en compte que les données du dernier fichier.

Par exemple, le tableau suivant montre comment Application Cost Profiler calcule l'utilisation pour trois locataires, sur une heure (3 600 000 millisecondes), en fonction des tranches de temps fournies.

Locataire	Tranches de temps fournies	Pourcentage calculé du coût horaire
Locataire 1	1 200 000 ms	33,34 %
Locataire 2	600 000 ms	16,66 %
<unattributed>		50,00 %

Dans cet exemple, le tiers de l'heure est attribué à Tenant1 et le sixième à Tenant2. La demi-heure restante (1 800 000 ms) n'est attribuée à aucun des clients, soit 50 % de l'heure.

Actuellement, les ressources suivantes sont activées pour Application Cost Profiler :

• Instances Amazon EC2 (à la demande et instances ponctuelles uniquement)

• Fonctions Lambda (si vous envoyez des données pour une fonction Lambda, vous devez envoyer l'ARN de la ressource non qualifiée sous la formeResourceId.)

• Amazon Elastic Container Service (Amazon ECS)

• Files d'attente Amazon Simple Queue Service (Amazon SQS)

• Rubriques Amazon Simple Notification Service (Amazon SNS)

• Amazon DynamoDB lit et écrit

Note

L'utilisation d'Amazon SQS, Amazon SNS et DynamoDB n'est pas facturée en fonction du temps, contrairement à la plupart des ressources. Dans leur cas, l'utilisation pendant une heure (par exemple, un certain nombre de lectures et d'écritures dans DynamoDB) est classée en fonction du pourcentage d'heure que vous allouez aux différents locataires, quel que soit le moment où les lectures ou écritures ont eu lieu pendant l'heure.

Étape 2 : Chargement de l'utilisation de vos ressources

Une fois que vous disposez d'un fichier d'utilisation par locataire, chargez votre fichier de données sur Amazon S3 et assurez-vous que Application Cost Profiler est autorisé à y accéder.

Pour plus d'informations sur la création d'un compartiment S3, consultezConditions préalables spécifiques à Application Cost Profiler.

Vous devez vous assurer que Application Cost Profiler a accès à votre compartiment S3. Cela ne doit être fait qu'une seule fois par compartiment S3 (vous pouvez réutiliser le même compartiment pour télécharger plusieurs fichiers d'utilisation). Pour plus d'informations sur l'accès au compartiment, consultezDonner à Application Cost Profiler l'accès à votre compartiment S3 de données d'utilisation. Si le compartiment est chiffré, consultezDonner accès à Application Cost Profiler aux compartiments S3 chiffrés SSE-KMS.

Note

Il n'est pas nécessaire de chiffrer les compartiments S3 que vous utilisez pour les données d'utilisation.

Importez vos données dans le compartiment S3 sous forme de fichier, avec une extension .csv (ou .csv.gzip s'il est compressé avec gzip), toutes les heures. Après avoir chargé un nouveau fichier, vous devez informer Application Cost Profiler que vous l'avez chargé afin que le fichier puisse être importé dans votre rapport.

Note

En donnant à Application Cost Profiler l'accès à vos données d'utilisation, vous acceptez que nous puissions copier temporairement ces objets de données d'utilisation vers l'est des États-Unis (Virginie du Nord)Région AWS lors du traitement des rapports. Ces objets de données seront conservés dans la région USA Est (N. Virginia) jusqu'à la fin de la génération du rapport mensuel.

Étape 3 : Importation des données d'utilisation dans Application Cost Profiler

Après avoir chargé les données d'utilisation dans un compartiment Amazon S3 auquel Application Cost Profiler a accès, informez Application Cost Profiler que les données existent et importez-les dans votre rapport final. Pour ce faire, utilisez l'ImportApplicationUsageopération de l'API Application Cost Profiler.

Pour plus d'informations sur l'APIAWS Application Cost Profiler, y compris sonImportApplicationUsage fonctionnement, consultez la référence de l'APIAWS Application Cost Profiler.

L'exemple suivant de indique comment appelerImportApplicationUsage. Remplacez le texte saisi entre crochets par les valeurs de votre compartiment S3 et de l'objet chargé.

POST /ImportApplicationUsage HTTP/1.1
Content-type: application/json

{
    "sourceS3Location" : {
        "bucket": "<bucket-name>",
        "key": "<object-key>",
        "region": "<region-id>"
    }
}

Note

Leregion paramètre n'est requis que si votre compartiment se trouve dans unRégion AWS compartiment désactivé par défaut. Pour plus d'informations, consultez Gestion de Régions AWS dans le Références générales AWS.

Application Cost Profiler génère un nouveau rapport à la fréquence que vous avez demandée lors de la configuration de votre rapport, en utilisant les données que vous avez importéesImportApplicationUsage.

Après avoir configuré votre rapport et importé automatiquement vos données d'utilisation dans Application Cost Profiler, vous êtes prêt à consulter les rapports générés. Pour plus d'informations sur les rapports, consultezUtilisation des rapports Application Cost Profiler.