Etiquetas de metadatos de recursos

Los recursos supervisados en Cloud Monitoring vienen con un conjunto de etiquetas que se usan para identificar una instancia particular del tipo de recurso supervisado. Estas etiquetas se documentan 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.

Un grupo de etiquetas de metadatos de recursos supervisados dejará de estar disponible. 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 ni los grupos de recursos de Cloud Monitoring.

Efectos de la baja

Todas las políticas de alertas, gráficos, cuadros de evaluación y grupos de recursos que especifican un recurso supervisado y usan etiquetas de metadatos para las que existen etiquetas de reemplazo migrarán de forma automática para usar los reemplazos el 31 de julio de 2020.

Todas las políticas de alertas, gráficos, cuadros de evaluación y grupos de recursos que usan etiquetas de metadatos para las que no existen etiquetas de reemplazo dejarán de funcionar el 31 de julio de 2020.

Acción obligatoria

A fin de evitar un comportamiento inesperado del sistema en las políticas de alertas activas, gráficos, guiones bajos o grupos de recursos que usan etiquetas de metadatos sin reemplazos, debes realizar alguna acción. Puedes quitar las políticas, los gráficos, los cuadros de evaluación o los grupos de alertas, o puedes modificar los filtros que usan esas etiquetas obsoletas para proporcionar etiquetas similares.

De manera similar, si tienes filtros que usan etiquetas de metadatos, pero no especificas recursos supervisados, no es posible determinar automáticamente si estas etiquetas están obsoletas. Debes evaluarlas y abordarlas de forma manual.

Esta página 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 están obsoletas y sus reemplazos, si las hubiera.

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

Para los recursos gce_disk y gce_instance: Si no configuras metadata.user_labels.name, por el momento se completa de forma automática con el valor de metadata.system_labels.name. Esta propagación automática también finaliza 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 migrarán para usar metadata.system_labels.name en su lugar.

Para pubsub_topic y recursos pubsub_subscription: Arreglamos un error antiguo, lo que produjo que metadata.system_labels.name se convirtiera de forma automática en minúsculas (por ejemplo, "My-Subscription" se convierte en "my-subscription"). Esto produjo un comportamiento inesperado en los casos en que los usuarios tenían varios recursos cuyos nombres en minúscula son idénticos. Este comportamiento también finaliza el 31 de julio de 2020. Después de esta fecha, la etiqueta del sistema de metadatos name reflejará 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 Busca etiquetas de metadatos obsoletas para obtener más 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 tus filtros para obtener pasos más detallados.

Encuentra 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).

Los siguientes pasos describen una manera 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. Haz clic en Abrir editor en la barra de herramientas de Cloud Shell. Si el lugar de trabajo de tu directorio principal aún no está abierto, selecciónalo Archivo y, luego, Abrir lugar de trabajo. 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. Para guardar el archivo, selecciona File (Archivo) y luego Save (Guardar).

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

  6. En la ventana de 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 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. 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.

Actualiza tus filtros

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

  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 tus políticas de alertas, gráficos y grupos de recursos para verificar si el valor que recuperas proviene de una de las etiquetas obsoletas identificados por la secuencia de comandos.

    Para verificar todos los gráficos, debe revisar cada gráfico en cada panel personalizado que haya definido.

    Para cada etiqueta en desuso, 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 no realiza ninguna acción, el filtro que utilice la etiqueta no funcionará después del 31 de julio de 2020.

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

      Si no realizas ninguna acción, el reemplazo se realizará el 31 de julio de 2020.

    Para obtener ayuda adicional sobre cómo realizar actualizaciones, consulta los recursos que aparecen en Edición.

  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 etiquetas de metadatos de recursos, filtros o tipos de recursos supervisados específicos, consulta lo siguiente:

Edición

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