Etiquetas de metadatos de recursos obsoletas

Los recursos monitorizados de Cloud Monitoring incluyen un conjunto de etiquetas que se usan para identificar una instancia concreta del tipo de recurso monitorizado. Estas etiquetas se documentan para cada tipo de recurso monitorizado en la lista de recursos monitorizados.

Además, Monitoring puede crear etiquetas adicionales para registrar metadatos sobre un recurso monitorizado. Los usuarios pueden acceder a estas etiquetas de metadatos del sistema como valores de solo lectura. Los usuarios también pueden crear sus propias etiquetas de metadatos de recursos. Para obtener más información, consulta Etiquetas de metadatos de recursos.

Se ha retirado un grupo de etiquetas de metadatos de recursos monitorizados. Las etiquetas del conjunto son redundantes y se pueden sustituir por etiquetas equivalentes, o bien representan conceptos obsoletos que ya no admiten las políticas de alertas, los gráficos, las tarjetas de resultados ni los grupos de recursos de Cloud Monitoring.

Efectos de la obsolescencia

Todas las políticas de alertas, los gráficos, las tarjetas de resultados y los grupos de recursos que especificaban un recurso monitorizado y usaban etiquetas de metadatos para las que se podían determinar etiquetas de sustitución se migraron automáticamente para usar las etiquetas de sustitución antes del 31 de julio del 2020. Todos los demás usos de las etiquetas obsoletas deben migrarse manualmente. En esta página se explica cómo migrar estos datos.

Notas:

• Si tiene un filtro que no especifica un recurso monitorizado, pero usa etiquetas de metadatos, no se ha podido determinar si la etiqueta de metadatos está obsoleta, ya que las etiquetas de metadatos no son únicas en todos los recursos monitorizados y las etiquetas obsoletas están asociadas a recursos monitorizados específicos. Debes evaluar estos filtros manualmente.
• Las etiquetas de metadatos de los filtros de una agregación secundaria no se migraron automáticamente.
• Las etiquetas de metadatos de las consultas escritas en el lenguaje de consulta de Monitoring (MQL) no se han migrado automáticamente.

Las políticas de alertas, los gráficos, las tarjetas de resultados y los grupos de recursos que usen etiquetas de metadatos que no se hayan migrado automáticamente o manualmente antes del 31 de julio del 2020 ya no se admiten y podrían dejar de funcionar.

Acción necesaria

Para reparar las políticas de alertas, los gráficos, las tarjetas de resultados o los grupos de recursos que han dejado de funcionar debido a que las etiquetas de metadatos están obsoletas, debes tomar medidas. Puedes quitar las políticas de alertas, los gráficos, las tarjetas de resultados o los grupos, o bien modificar los filtros que usen esas etiquetas obsoletas para que usen etiquetas que proporcionen un comportamiento similar.

Del mismo modo, si tiene filtros que usan etiquetas de metadatos, pero no especifica recursos monitorizados, no es posible determinar automáticamente si estas etiquetas están obsoletas. Debes evaluarlos y solucionarlos manualmente.

Esta página incluye una secuencia de comandos que te ayudará a identificar los usos de las etiquetas de metadatos obsoletas.

Etiquetas de metadatos obsoletas

En la siguiente tabla se indican las etiquetas de metadatos de recursos que van a quedar obsoletas y sus sustituciones, si las hay.

Nota: En los filtros, se usa el prefijo de etiqueta resource.metadata, mientras que en la tabla se muestra el prefijo metadata.system_labels. Por ejemplo, la etiqueta que se muestra como metadata.system_labels.name en la tabla se denomina resource.metadata.name en los filtros.

Tipo de recurso monitorizado	Etiqueta obsoleta	Etiqueta equivalente
Todos los tipos de 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 none
dataflow_job	metadata.system_labels.name metadata.system_labels.state	resource.labels.job_name none
gae_app	metadata.system_labels.gaeapp metadata.system_labels.gaemodule metadata.system_labels.gaeversion	ninguno^† considerar resource.labels.project_id ninguno^† considerar resource.labels.module_id ninguno^† considerar resource.labels.version_id
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	ninguno
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

^* La sintaxis de filtro de Cloud Monitoring no permite usar la etiqueta resources.labels.project_id con la misma flexibilidad que la etiqueta metadata.system_labels.cloud_account. Por ejemplo, no puedes hacer lo siguiente:

• Usa OR para combinar una expresión con la etiqueta project_id y otra con etiquetas de metadatos.
• Usa la operación != con la etiqueta project_id.
• Usa las funciones starts_with o has_substring con la etiqueta project_id.

^† En el caso de los recursos gae_app: las etiquetas de recursos indicadas son similares a las etiquetas de metadatos obsoletas, por lo que pueden ser buenos sustitutos. Sin embargo, como solo son similares, no se han migrado automáticamente.

^‡ En el caso de los recursos gce_disk y gce_instance: si no defines metadata.user_labels.name, se rellenaba automáticamente con el valor de metadata.system_labels.name. Esta función de rellenado automático también finalizó el 31 de julio del 2020. Las políticas de alertas, los gráficos, las tarjetas de resultados y los grupos de recursos que filtran por el valor metadata.user_labels.name rellenado automáticamente se han migrado para usar metadata.system_labels.name en su lugar.

^# En el caso de los recursos pubsub_topic y pubsub_subscription, hemos corregido un error que provocaba que metadata.system_labels.name se convirtiera automáticamente en minúsculas (por ejemplo, "My-Subscription" se convertía en "my-subscription"). Esto provocaba un comportamiento inesperado en los casos en los que los usuarios tenían varios recursos cuyos nombres en minúsculas eran idénticos. Este comportamiento también finalizó el 31 de julio del 2020. Después de esa fecha, la etiqueta de sistema de metadatos name reflejará el nombre real del tema o de la suscripción (por ejemplo, "My-Subscription").

¿Qué debo hacer?

Hay dos pasos generales:

1. Determina si usas alguna etiqueta de metadatos afectada por esta obsolescencia. Consulta Buscar etiquetas de metadatos obsoletas para obtener información sobre cómo ejecutar la secuencia de comandos del detector proporcionada.

2. Si usas alguna de las etiquetas de metadatos afectadas, actualízala o quítala. Consulta Actualizar los filtros para ver los pasos detallados.

Buscar etiquetas de metadatos obsoletas

Puedes usar esta secuencia de comandos de Python para identificar referencias a etiquetas de metadatos obsoletas: metadata_label_detection.py.

Nota: La secuencia de comandos no puede detectar etiquetas de metadatos en filtros de agregaciones secundarias.

Resumen de la sintaxis: python3 metadata_label_detection.py PROJECT_ID_OR_NUMBER

PROJECT_ID_OR_NUMBER puede ser un ID de proyecto (por ejemplo, my-project) o un número de proyecto (por ejemplo, 123456789). No incluyas el prefijo projects/.

En los pasos que se indican a continuación se describe una forma de usar la secuencia de comandos:

1. Ve a la Google Cloud consola.

   Ir a la Google Cloud consola

2. En la parte superior de la página de la consola de Google Cloud tu proyecto, haz clic en Activar Cloud Shell.

3. Haz clic en Abrir editor en la barra de herramientas de Cloud Shell. Si el espacio de trabajo de tu directorio principal aún no está abierto, ábrelo seleccionando Archivo y, a continuación, Abrir espacio de trabajo. Elige el espacio de trabajo con tu nombre de usuario.

4. Crea un archivo llamado metadata_label_detection.py seleccionando Archivo y, a continuación, Nuevo archivo. Pega el texto de metadata_label_detection.py en el editor. Para guardar el archivo, selecciona Archivo y, a continuación, Guardar.

5. Vuelve al terminal haciendo clic en Abrir terminal en la barra de herramientas de Cloud Shell.

6. En el mensaje de la línea de comandos de Cloud Shell, instala las dependencias de la secuencia de comandos ejecutando el siguiente comando:

   sudo pip3 install google-cloud-monitoring=="1.*" google-cloud-monitoring-dashboards
   

7. Después de instalar las dependencias, ejecuta la secuencia de comandos del detector:

   python3 metadata_label_detection.py $GOOGLE_CLOUD_PROJECT
   

La secuencia de comandos genera un informe como el siguiente:

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. Please manually remove the reference.

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 remove the reference if this group is used for cloud_tasks_queue resources.

Xy_chart "Test chart" in dashboard "Demo dashboard" (projects/PROJECT_ID/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. Please
manually remove the reference.

Nota: En los filtros, se usa el prefijo de etiqueta resource.metadata cuando la secuencia de comandos informa del prefijo metadata.system_labels. Por ejemplo, la etiqueta que se muestra como metadata.system_labels.name en el resultado se denomina resource.metadata.name en los filtros.

Actualizar los filtros

Para actualizar tus políticas de alertas, gráficos, tarjetas de resultados y grupos de recursos, sigue estos pasos:

1. Inicia sesión en la consola de Google Cloud .

2. Ejecuta la secuencia de comandos del detector tal como se describe en Buscar etiquetas obsoletas.

3. Inspecciona cada una de tus políticas de alertas, gráficos y grupos de recursos para comprobar si el valor que estás obteniendo procede de una de las etiquetas obsoletas identificadas por la secuencia de comandos.

   Para comprobar todos los gráficos, debe revisar cada uno de los gráficos de cada panel de control personalizado que haya definido.

   Recuerda que los filtros usan el prefijo resource.metadata en lugar de metadata.system_labels.

   Nota: Si has creado paneles de control que contienen tarjetas de resultados mediante la API, debes usar la API para consultarlos. Las tarjetas de resultados no se pueden editar desde la Google Cloud consola
   .

   En cada etiqueta obsoleta, haz una de las siguientes acciones:

   • Si la etiqueta no tiene ningún sustituto, elimina el uso de la etiqueta o la política de alertas, el gráfico o el grupo de recursos.

   • Si la etiqueta tiene un sustituto, reemplaza la etiqueta obsoleta por el sustituto.

   Si no haces nada, la política de alertas, el gráfico o el grupo de recursos afectados no funcionarán.

   Para obtener más ayuda sobre cómo hacer cambios con la consola Google Cloud , consulta los recursos que se indican en la sección Editar.

   En algunos casos, es posible que tengas que usar la API Cloud Monitoring en lugar de la consola. Google Cloud La API puede expresar algunas consultas que no se pueden construir de otra forma.

4. Vuelve a ejecutar la secuencia de comandos del detector para comprobar que no quedan etiquetas obsoletas.

Información adicional

Para obtener información sobre las etiquetas de metadatos de recursos, los filtros o los tipos de recursos monitorizados específicos, consulta lo siguiente:

• Etiquetas: etiquetas de metadatos de recursos
• Filtros: Filtros de Monitoring
• Tipos de recursos monitorizados específicos: Lista de recursos monitorizados

Edición

Para obtener información sobre cómo actualizar las políticas de alertas, los gráficos, los paneles de control y los grupos de recursos, consulta los siguientes artículos:

• Políticas de alertas: gestionar políticas
• Paneles de control y gráficos con la consola: Gestionar paneles de control Google Cloud
• Paneles de control con la API de Monitoring: actualizar paneles de control
• Grupos de recursos: editar un grupo