Ajouter des libellés aux ressources App Engine

Les libellés sont un moyen simple de regrouper les ressources liées ou associées. Par exemple, vous pouvez obtenir une vue plus détaillée de la facturation des ressources pour vos services App Engine. Vous pouvez également exploiter des fonctionnalités telles que le filtrage imbriqué pour effectuer des recherches plus précises sur vos ressources.

Voici quelques façons d'utiliser les libellés :

Ajoutez des libellés aux types de services que vous créez. Par exemple, si vous ajoutez des libellés tels que service:default, service:backend et service:frontend à vos services App Engine, vous pouvez comparer la façon dont ces différents services utilisent la bande passante sortante, les instances-heure et d'autres ressources.
Attribuez un libellé par équipe ou par centre de coûts afin de distinguer les projets appartenant à différentes équipes. Ceci peut être utile pour la comptabilité analytique ou la budgétisation. Par exemple, team:marketing et team:research.
Ajoutez un libellé à l'environnement dans lequel un service s'exécute. Par exemple, environment:prod et environment:test.
Ajoutez des libellés par propriétaire ou contact principal si une personne est chargée d'une ressource particulière.
Ajoutez un libellé à l'état d'un service. Par exemple, state:inuse et state:readyfordeletion.

Les libellés ne peuvent être utilisés que pour les données de facturation et non pour d'autres outils tels que l'explorateur de métriques.

Restrictions

Vous pouvez affecter jusqu'à 64 libellés à chaque ressource.
Vous pouvez ajouter des libellés aux services de manière explicite uniquement. Les versions et les instances héritent des libellés du service parent.
L'environnement flexible App Engine n'accepte pas les libellés de facturation pour l'utilisation de Firestore en mode Datastore (Datastore).

Ajouter ou modifier des libellés

Pour ajouter des libellés aux services App Engine, procédez comme suit :

Console

Accédez à la page "Services App Engine".

Accéder aux services
Cochez les cases à côté des services auxquels ajouter un libellé.
Cliquez sur Afficher le panneau d'informations, puis sélectionnez l'onglet Libellés pour développer la colonne des libellés.
Cliquez sur Ajouter un libellé pour ajouter une paire clé-valeur aux services sélectionnés. Par exemple, pour ajouter le libellé env:prod, saisissez env pour la clé et prod pour la valeur.
Enregistrez les modifications.

API Admin

Vous pouvez ajouter et définir des libellés via la ressource Service. Consultez la documentation de référence de l'API Admin :

Afficher les données de facturation associées à vos services porteurs d'un libellé

Vous pouvez affiner les données de facturation de votre application à l'aide des libellés. Par exemple, vous pouvez afficher les coûts associés à une ressource spécifique, telle que la bande passante sortante, répartis par jour et par service. Cela peut vous donner un aperçu des coûts quotidiens de l'application et vous permettre d'optimiser l'utilisation des ressources de votre application.

Pour afficher les libellés de facturation, vous devez exporter vos données vers BigQuery, puis les interroger :

Exportez vos données de facturation vers BigQuery.

Une fois que vous avez activé l'exportation BigQuery, quelques heures peuvent être nécessaires avant que vous puissiez visualiser vos données.
Sur la page BigQuery de la console Google Cloud, sélectionnez votre projet et votre ensemble de données de facturation.
Exécutez une requête sur la table créée à partir de votre exportation BigQuery.

Les libellés sont ajoutés à votre ensemble de données sous forme de champs répétés, ce qui signifie que plusieurs libellés peuvent être rattachés à une seule ligne de votre ensemble de données de coûts. Pour effectuer facilement des requêtes par libellé, vous souhaiterez peut-être aplatir la table au niveau du champ des libellés à l'aide de FLATTEN.

Par exemple, la requête suivante extrait les données de coût, la clé d'étiquette et la valeur d'étiquette de la bande passante sortante le cas échéant :

SELECT
  product,
  resource_type,
  start_time,
  end_time,
  labels.key,
  labels.value,
  cost
FROM (FLATTEN([YOUR_DATASET.TABLEID], labels))
WHERE
  cost > 0.0
  and labels.key is not null
  and resource_type = 'Out Bandwidth'
LIMIT 100

BigQuery renvoie les données de sortie sous forme aplatie :

produit	resource_type	start_time	end_time	labels_key	labels_value	coût
App Engine	Bande passante sortante	2017-10-07 22:00:00	2017-10-07 23:00:00	service	par défaut	0.020033
App Engine	Bande passante sortante	2017-10-07 13:00:00	2017-10-07 14:00:00	service	interface	0.016042
App Engine	Bande passante sortante	2017-10-07 06:00:00	2017-10-07 07:00:00	service	backend_task	0.013125
App Engine	Bande passante sortante	2017-10-07 21:00:00	2017-10-07 22:00:00	service	par défaut	0.020722
App Engine	Bande passante sortante	2017-10-07 19:00:00	2017-10-07 20:00:00	service	interface	0.020725
App Engine	Bande passante sortante	2017-10-08 04:00:00	2017-10-08 05:00:00	service	backend_task	0.02072
App Engine	Bande passante sortante	2017-10-08 02:00:00	2017-10-08 03:00:00	service	par défaut	0.020723
App Engine	Bande passante sortante	2017-10-07 14:00:00	2017-10-07 15:00:00	service	interface	0.020724
App Engine	Bande passante sortante	2017-10-07 23:00:00	2017-10-08 00:00:00	service	backend_task	0.021417

Périodes dans les rapports de facturation

Pour garantir que chaque jour du rapport couvre une période complète de 24 heures, les données de facturation que vous exportez ne contiennent que des données allant jusqu'au minuit le plus proche, heure du Pacifique. Par exemple, si vous exportez les données de facturation le 3 décembre à midi, l'exportation inclut les données allant jusqu'au 2 décembre à 23 h 59.

Pour chaque jour du rapport, les données de facturation sont attribuées à des libellés existant en début de journée. Par exemple, si vous créez un libellé le 3 décembre à midi (heure du Pacifique), le rapport du 3 décembre n'attribuera pas de données au libellé, car celui-ci n'existait pas en début de journée. Les données seront attribuées au libellé à partir du 4 décembre.

Les libellés créés à midi et supprimés au cours de la même période de 24 heures ne sont pas associés à des données.

Afficher les étiquettes dans la console Google Cloud

Après avoir ajouté des étiquettes aux ressources, vous pouvez les afficher dans la console Google Cloud.

Accédez à la page "Services App Engine".

Accéder aux services
Vous pouvez afficher tous les libellés de chaque service dans la colonne Libellés.

Supprimer des libellés

Pour supprimer des libellés des services, procédez comme suit :

Accédez à la page "Services App Engine".

Accéder aux services App Engine
Cochez les services pour lesquels vous souhaitez supprimer des libellés.
Cliquez sur Afficher le panneau d'informations, puis sélectionnez l'onglet Libellés pour développer la colonne des libellés.
Cliquez sur le symbole X à côté de tous les libellés à supprimer.
Enregistrez les modifications.