Etiquetas de metadatos de recursos obsoletas

Los recursos supervisados en Cloud Monitoring vienen con un conjunto de etiquetas que se usan para identificar una instancia en particular del tipo de recurso supervisado. Estas etiquetas están documentadas para cada tipo de recurso supervisado en la Lista de recursos supervisados.

Además, Monitoring puede crear etiquetas adicionales para capturar metadatos sobre un recurso supervisado. Estas etiquetas de metadatos del sistema están disponibles para los usuarios 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.

Dejó de estar disponible un grupo de etiquetas de metadatos de recursos supervisados. Las etiquetas del conjunto son redundantes y se pueden reemplazar por etiquetas equivalentes existentes, o representan conceptos obsoletos que ya no son compatibles con las políticas de alertas, gráficos, cuadros de evaluación o grupos de recursos de Cloud Monitoring.

Efectos de la baja

Todas las políticas de alertas, los gráficos, los cuadros de evaluación y los grupos de recursos en los que se especifica un recurso supervisado y se usan etiquetas de metadatos para las que se pudieron determinar etiquetas de reemplazo se migraron de forma automática con fin de usar los reemplazos antes del 31 de julio de 2020. Todos los demás usos de las etiquetas obsoletas se deben migrar de forma manual. En esta página, se proporciona información sobre cómo migrarlos.

Notas:

• Si tienes un filtro que no especifica un recurso supervisado, pero usa etiquetas de metadatos, no es posible determinar si la etiqueta de metadatos dejó de estar disponible: las etiquetas de metadatos no son únicas en todos los recursos supervisados, y las etiquetas obsoletas están asociadas a recursos supervisados específicos. Debes evaluar esos filtros de forma manual.
• Las etiquetas de metadatos de los filtros de una agregación secundaria no se migraron de forma automática.
• Las etiquetas de metadatos en las consultas escritas en el lenguaje de consulta de supervisión (MQL) no se migraron de forma automática.

Todas las políticas de alertas, los gráficos, los cuadros de evaluación y los grupos de recursos que usan etiquetas de metadatos que no se hayan migrado de forma automática o manual antes del 31 de julio de 2020 ya no son compatibles y podrían dejar de funcionar.

Acción obligatoria

Para reparar políticas de alertas, gráficos, cuadros de evaluación o grupos de recursos que hayan dejado de funcionar debido al uso de etiquetas de metadatos obsoletas, debes tomar algunas medidas. Puedes quitar las políticas de alertas, los gráficos, los cuadros de evaluación o los grupos, o bien modificar cualquier filtro que use esas etiquetas obsoletas a fin de usar etiquetas que proporcionen un comportamiento similar.

Del mismo modo, si tienes filtros que usan etiquetas de metadatos, pero no especifican recursos supervisados, no es posible determinar de forma automática si estas etiquetas dejaron de estar disponibles. Debes evaluarlos y abordarlos de forma manual.

En esta página, se incluye una secuencia de comandos para ayudarte a identificar los usos de las etiquetas de metadatos obsoletas.

Etiquetas de metadatos obsoletas

En la siguiente tabla, se enumeran las etiquetas de metadatos de recursos que dejaron de estar disponibles y sus reemplazos, si corresponde.

Nota: En los filtros, se usa el prefijo de etiqueta resource.metadata en lugar del prefijo metadata.system_labels que se muestra en la tabla. 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 supervisado	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 ninguna
dataflow_job	metadata.system_labels.name metadata.system_labels.state	resource.labels.job_name ninguna
gae_app	metadata.system_labels.gaeapp metadata.system_labels.gaemodule metadata.system_labels.gaeversion	ninguna^† considera resource.labels.project_id ninguna^† considera resource.labels.module_id ninguna^† considera 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	none
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 del filtro de Cloud Monitoring no permite que la etiqueta resources.labels.project_id se use de forma tan flexible como se puede usar la etiqueta metadata.system_labels.cloud_account. Por ejemplo, no puedes hacer lo siguiente:

• Usar OR para combinar una expresión en la que se usar la etiqueta project_id con una expresión en la que se usan etiquetas de metadatos
• Usar la operación != con la etiqueta project_id
• Usar las funciones starts_with o has_substring con la etiqueta project_id

^† Para los recursos gae_app: las etiquetas de recursos indicadas son similares a las etiquetas de metadatos obsoletas, por lo que pueden ser un buen reemplazo. Sin embargo, dado que solo son similares, no se migraron de forma automática.

^‡ Para los recursos gce_disk y gce_instance: si no configuraras metadata.user_labels.name, se propagaría de forma automática con el valor de metadata.system_labels.name Esta propagación automática también finalizó el 31 de julio de 2020. Las políticas de alertas, los gráficos, los cuadros de evaluación y los grupos de recursos que filtran los valores metadata.user_labels.name propagados de forma automática se migraron para usar metadata.system_labels.name en su lugar.

^# Para los recursos pubsub_topic y pubsub_subscription: corregimos un error antiguo que provocaba que metadata.system_labels.name se convierta de forma automática en minúsculas (por ejemplo, "My-Subscription" se convertía en "my-subscription"). Esto produjo un comportamiento inesperado en casos en los que los usuarios tenían varios recursos cuyos nombres en minúsculas son idénticos. Este comportamiento también finalizó el 31 de julio de 2020. Desde esta fecha, la etiqueta del sistema de metadatos name refleja el nombre real del tema o la suscripción (por ejemplo, "My-Subscription").

¿Qué debo hacer?

Hay dos pasos de alto nivel:

1. Determina si usas etiquetas de metadatos afectadas por esta baja. Consulta Encuentra etiquetas de metadatos obsoletas para obtener información sobre cómo ejecutar la secuencia de comandos del detector proporcionada.

2. Si usas etiquetas de metadatos afectadas, actualízalas o quítalas. Consulta Actualiza los filtros para obtener pasos más detallados.

Busca 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 los 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 del proyecto (por ejemplo, my-project) o un número de proyecto (por ejemplo, 123456789). No incluyas el prefijo projects/.

En los siguientes pasos, se describe una forma de usar la secuencia de comandos:

1. Ve a la consola de Google Cloud.

   Ir a la consola de Google Cloud

2. Haz clic en Activar Cloud Shell en la parte superior de la página de la consola de Google Cloud para tu proyecto.

3. En la barra de herramientas de Cloud Shell, haz clic en Abrir editor. Si el lugar de trabajo para el directorio principal no está abierto, selecciona Archivo y, luego, Abrir lugar de trabajo a fin de abrirlo. Elige el lugar de trabajo con tu nombre de usuario.

4. Para crear un archivo nuevo llamado metadata_label_detection.py, selecciona Archivo y, luego, Archivo nuevo. Pega el texto de metadata_label_detection.py en el editor. Guarda el archivo. Para ello, selecciona Archivo y, luego, Guardar.

5. Para volver a la terminal, haz clic en Abrir terminal en la barra de herramientas de Cloud Shell.

6. En la línea de comandos de Cloud Shell, instala las dependencias de la secuencia de comandos mediante la ejecución del 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 extracto:

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 en donde la secuencia de comandos informa el 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.

Actualiza los filtros

Para actualizar tus políticas de alertas, gráficos, cuadros de evaluación y grupos de recursos, sigue estos pasos:

1. Acceda a la consola de Google Cloud.

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

3. Inspecciona cada una de las políticas de alertas, gráficos y grupos de recursos para verificar si el valor que recuperas proviene de una de las etiquetas obsoletas que identifica la secuencia de comandos.

   Para verificar todos los gráficos, debes verificar cada gráfico en cada panel personalizado que definiste.

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

   Nota: Si creaste paneles que contienen cuadros de evaluación mediante la API, debes usar la API para revisarlos. Los cuadros de evaluación no se pueden editar desde la consola de Google Cloud.

   Por cada etiqueta obsoleta, realiza una de las siguientes acciones:

   • Si la etiqueta no tiene reemplazo, quita el uso de la etiqueta o borra la política de alertas, el gráfico o el grupo de recursos.

   • Si la etiqueta tiene un reemplazo, reemplaza la etiqueta obsoleta por la de reemplazo.

   Si no tomas ninguna medida, la política de alertas, el gráfico o el grupo de recursos que se vio afectado no funcionará.

   Para obtener ayuda adicional sobre cómo realizar actualizaciones mediante la consola de Google Cloud, consulta los recursos que aparecen en Edición.

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

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

Información adicional

Para obtener información sobre las etiquetas de metadatos de recursos, los filtros o los tipos de recursos supervisados específicos, consulta los siguientes vínculos:

• Etiquetas: Etiquetas de metadatos de recursos
• Filtros: Filtros de supervisión
• Tipos de recursos supervisados específicos: Lista de recursos supervisados

Edición

Para obtener información sobre la actualización de las políticas de alertas, los gráficos, los paneles y los grupos de recursos, consulta los siguientes vínculos:

• Políticas de alertas: Administra las políticas
• Paneles y gráficos mediante la consola de Google Cloud: Administra paneles
• Paneles mediante la API de Monitoring: Actualiza los paneles
• Grupos de recursos: Edita un grupo