Etiquetas de metadatos de recursos

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.

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.


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 ninguna
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.

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 Google Cloud Console:

    Ir a Cloud Console

  2. Haz clic en Activar Cloud Shell en la parte superior de la página de Google Cloud Console 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.

Actualiza los filtros

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

  1. Accede a Google Cloud Console.

  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.

    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 Google Cloud Console, consulta los recursos que aparecen en Edición.

    En algunos casos, es posible que debas usar la API de Cloud Monitoring en lugar de Cloud Console. 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:

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: