Libellés de métadonnées de ressources

Les ressources surveillées dans Cloud Monitoring comportent un ensemble de libellés permettant d'identifier une instance particulière du type de ressource surveillée. Ces libellés sont documentés pour chaque type de ressource surveillée dans la liste des ressources surveillées.

En outre, Monitoring peut créer des libellés supplémentaires pour capturer des métadonnées concernant une ressource surveillée. Ces libellés de métadonnées système sont disponibles pour les utilisateurs sous forme de valeurs en lecture seule. Les utilisateurs peuvent également créer leurs propres libellés de métadonnées de ressources. Pour en savoir plus, consultez la section Libellés de métadonnées de ressources.

Un groupe de libellés de métadonnées de ressources surveillées est obsolète. Les libellés de l'ensemble sont soit redondants et peuvent être remplacés par des libellés équivalents existants, soit ils représentent des concepts obsolètes qui ne sont plus compatibles avec les règles d'alerte, les graphiques, les tableaux de données ou les groupes de ressources Cloud Monitoring.

Conséquences de cet abandon

Toutes les règles d'alerte, graphiques, tableaux de données et groupes de ressources qui spécifient une ressource surveillée et utilisent des libellés de métadonnées pour lesquels des libellés de remplacement existent seront automatiquement migrés pour utiliser les libellés remplacements le 31 juillet 2020.

Toutes les règles d'alerte, graphiques, tableaux de données et groupes de ressources qui utilisent des libellés de métadonnées pour lesquels aucun libellé de remplacement n'existe cesseront de fonctionner le 31 juillet 2020.

Action requise

Pour éviter tout comportement inattendu du système concernant les règles d'alerte actives, les graphiques, les tableaux de données ou les groupes de ressources qui utilisent des libellés de métadonnées non remplacées, voici ce que vous devez faire. Supprimez les règles d'alerte, les graphiques, les tableaux de données ou les groupes, ou modifiez les filtres utilisant ces libellés obsolètes pour utiliser des libellés au comportement similaire.

De même, si des filtres utilisent des libellés de métadonnées, mais ne spécifient pas de ressources surveillées, il n'est pas possible de déterminer automatiquement si ces libellés sont obsolètes. Vous devez les évaluer et les traiter manuellement.

Cette page inclut un script pour vous aider à identifier les utilisations de libellés de métadonnées obsolètes.

Libellés de métadonnées obsolètes

Le tableau suivant répertorie les libellés de métadonnées de ressources obsolètes et leurs remplaçants, le cas échéant.

Type de ressource surveillée Libellé obsolète Libellé équivalent
Tous les types Google Cloud metadata.system_labels.cloud_account resource.labels.project_id
cloud_tasks_queue metadata.system_labels.name
metadata.system_labels.state
resource.labels.queue_id
Aucun
dataflow_job metadata.system_labels.name
metadata.system_labels.state
resource.labels.job_name
Aucun
gae_app metadata.system_labels.gaeapp
metadata.system_labels.gaemodule
metadata.system_labels.gaeversion
Aucun
Aucun
Aucun
gce_disk metadata.user_labels.name metadata.system_labels.name
gce_instance metadata.user_labels.name
metadata.system_labels.name
l7_lb_rule metadata.system_labels.state Aucun texte
pubsub_topic metadata.system_labels.name metadata.system_labels.name
pubsub_subscription metadata.system_labels.name
metadata.system_labels.name
vpn_gateway metadata.system_labels.region resource.labels.region

pour les ressources gce_disk et gce_instance : si vous ne définissez pas d'élément metadata.user_labels.name, celui-ci est actuellement automatiquement renseigné avec la valeur de metadata.system_labels.name. Ce remplissage automatique prendra également fin le 31 juillet 2020. Les règles d'alerte, les graphiques, les tableaux de données et les groupes de ressources qui filtrent en fonction de valeurs metadata.user_labels.name renseignées automatiquement seront migrés afin d'utiliser metadata.system_labels.name.

Concernant les ressources pubsub_topic et pubsub_subscription, nous avons corrigé un bug persistant provoquant la conversion automatique en minuscules de metadata.system_labels.name (par exemple, "My-Subscription" devient "my-subscription"). Cela a généré un comportement inattendu dans les cas où les utilisateurs possèdent plusieurs ressources dont les noms en minuscules sont identiques. Ce comportement prendra également fin le 31 juillet 2020. Après cette date, le libellé de système de métadonnées name reflètera le nom réel du sujet ou de l'abonnement (par exemple, "My-Subscription").

Que dois-je faire ?

Voici les deux étapes majeures à suivre :

  1. Déterminez si vous utilisez des libellés de métadonnées affectés par cet abandon. Consultez la section Rechercher des libellés de métadonnées obsolètes pour en savoir plus sur l'exécution du script de détection fourni.

  2. Si vous utilisez des libellés de métadonnées parmi les concernés, mettez-les à jour ou supprimez-les. Pour plus d'informations, consultez la page Mettre à jour les filtres.

Trouver des libellés de métadonnées obsolètes

Vous pouvez utiliser ce script Python pour identifier les références aux libellés de métadonnées obsolètes : metadata_label_detection.py.

Résumé de la syntaxe : python3 metadata_label_detection.py [PROJECT_ID_OR_NUMBER]

PROJECT_ID_OR_NUMBER peut être un ID de projet (par exemple, my-project) ou un numéro de projet (par exemple, 123456789).

Pour utiliser le script, procédez comme suit :

  1. Accédez à Google Cloud Console

    Accéder à Cloud Console

  2. Cliquez sur Activer Cloud Shell en haut de la page Google Cloud Console de votre projet.

  3. Cliquez sur Ouvrir l'éditeur dans la barre d'outils Cloud Shell. Si l'espace de travail de votre répertoire d'accueil n'est pas déjà ouvert, ouvrez-le en sélectionnant Fichier, puis Ouvrir l'espace de travail. Choisissez l'espace de travail avec votre nom d'utilisateur.

  4. Créez un fichier nommé metadata_label_detection.py en sélectionnant Fichier, puis Nouveau fichier. Collez le texte de metadata_label_detection.py dans l'éditeur. Enregistrez le fichier en sélectionnant Fichier, puis Enregistrer.

  5. Revenez à la fenêtre de terminal en cliquant sur Ouvrir le terminal dans la barre d'outils Cloud Shell.

  6. Dans l'invite de ligne de commande dans Cloud Shell, installez les dépendances de script en exécutant la commande suivante :

    sudo pip3 install google-cloud-monitoring google-cloud-monitoring-dashboards
    
  7. Après avoir installé les dépendances, exécutez le script de détection :

    python3 metadata_label_detection.py $GOOGLE_CLOUD_PROJECT
    

Le script génère un rapport semblable à l'extrait suivant :

Alert "Test alert" (projects/[PROJECT_ID]/alertPolicies/8401129027900817186) is affected.
URL: https://console.cloud.google.com/monitoring/alerting/policies/8401129027900817186?project=[PROJECT_ID]
        metadata.system_labels.cloud_account is deprecated for non-AWS resource
types. This reference will be auto-migrated to resource.labels.project_id.

Group "Test group" (projects/[PROJECT_ID]/groups/4518177785663978371) might be affected,
depending on the type of resources it is used for.
URL: https://console.cloud.google.com/monitoring/groups/4518177785663978371?project=[PROJECT_ID]
        metadata.system_labels.name is deprecated for dataflow_job. Please
manually remove the reference if this group is used for dataflow_job resources.
        metadata.system_labels.name is deprecated for cloud_tasks_queue. Please
manually migrate to resource.labels.queue_id if this group is used for cloud_tasks_queue resources.

Xy_chart "Test chart" in dashboard "Demo dashboard" (projects/[PROJECT_NUM]/dashboards/2826428163455705326) is affected.
URL: https://console.cloud.google.com/monitoring/dashboards/custom/2826428163455705326?project=[PROJECT_ID]
        metadata.user_labels.name is deprecated for gce_instance. This
reference will be auto-migrated to metadata.system_labels.name.

Mettre à jour vos filtres

Pour mettre à jour vos règles d'alerte, graphiques, tableaux de données et groupes de ressources :

  1. Connectez-vous à Google Cloud Console.

  2. Exécutez le script de détection comme expliqué dans la section Rechercher des libellés obsolètes.

  3. Inspectez chaque règle d'alerte, graphique et groupe de ressources pour vérifier si la valeur que vous récupérez provient de l'un des libellés obsolètes identifiés par le script.

    Pour vérifier tous les graphiques, vous devez vérifier chaque graphique dans chaque tableau de bord personnalisé que vous avez défini.

    Pour chaque libellé obsolète, effectuez l'une des opérations suivantes :

    • Si le libellé n'a pas de remplaçant, supprimez l'utilisation du libellé ou supprimez la règle d'alerte, le graphique ou le groupe de ressources.

      Si vous ne faites rien, le filtre utilisant le libellé ne fonctionnera plus après le 31 juillet 2020.

    • Si le libellé a un remplaçant, remplacez le libellé obsolète par celui-ci.

      Si vous ne faites rien, le remplacement sera effectué pour vous le 31 juillet 2020.

    Pour obtenir de l'aide sur les mises à jour, consultez les ressources répertoriées dans la section Modification.

  4. Exécutez à nouveau le script de détection pour vérifier qu'il ne reste aucun libellé obsolète.

Informations supplémentaires

Pour en savoir plus sur les libellés de métadonnées de ressources, les filtres ou les types de ressources surveillées spécifiques, consultez les pages suivantes :

Modifications

Pour plus d'informations sur la mise à jour des règles d'alerte, des graphiques, des tableaux de bord et des groupes de ressources, consultez les pages suivantes :