Rótulos de metadados de recursos

Os recursos monitorados no Cloud Monitoring vêm com um conjunto de rótulos usados para identificar uma instância específica do tipo de recurso monitorado. Esses rótulos são documentados para cada tipo de recurso monitorado na lista de recursos monitorados.

Além disso, o Monitoring pode criar rótulos adicionais para capturar metadados sobre um recurso monitorado. Esses rótulos de metadados do sistema estão disponíveis para os usuários como valores somente leitura. Os usuários também podem criar os próprios rótulos de metadados de recursos. Para mais informações, consulte Rótulos de metadados de recursos.

Um grupo de rótulos de metadados de recursos monitorados está sendo suspenso. Os rótulos no conjunto são redundantes e podem ser substituídos por rótulos equivalentes existentes ou representam conceitos obsoletos que não são mais compatíveis com políticas de alerta, gráficos, visões gerais ou grupos de recursos do Cloud Monitoring.

Efeitos da suspensão de uso

Todas as políticas de alertas, gráficos, visões gerais e grupos de recursos que especificam um recurso monitorado e usam rótulos de metadados para os quais há rótulos de substituição serão migrados automaticamente para usar as substituições em 31 de julho de 2020.

Todas as políticas de alertas, gráficos, visões gerais e grupos de recursos que usam rótulos de metadados para os quais não há rótulos de substituição deixarão de funcionar em 31 de julho de 2020.

Ação necessária

Para evitar um comportamento inesperado do sistema em políticas de alertas, gráficos, visões gerais ou grupos de recursos que usam rótulos de metadados sem substituições, é necessário realizar alguma ação. Você pode remover as políticas de alerta, gráficos, visões gerais ou grupos ou modificar qualquer filtro que use esses rótulos obsoletos para usar rótulos que fornecem comportamento semelhante.

Da mesma forma, se você tiver filtros que usam rótulos de metadados, mas não especificam recursos monitorados, não é possível determinar automaticamente se esses rótulos estão obsoletos. Você deve avaliá-los e resolvê-los manualmente.

Esta página inclui um script para ajudar você a identificar os usos de rótulos de metadados obsoletos.

Rótulos de metadados obsoletos

A tabela a seguir lista os rótulos de metadados de recursos que estão sendo suspensos e as substituições deles, se houver.

Tipo de recurso monitorado Rótulo obsoleto Rótulo equivalente
Todos os tipos do 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
nenhum
dataflow_job metadata.system_labels.name
metadata.system_labels.state
resource.labels.job_name
nenhum
gae_app metadata.system_labels.gaeapp
metadata.system_labels.gaemodule
metadata.system_labels.gaeversion
nenhum
nenhum
nenhum
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 recursos gce_disk e gce_instance: se você não definir metadata.user_labels.name, ele será preenchido automaticamente com o valor de metadata.system_labels.name. Esse preenchimento automático também termina em 31 de julho de 2020. Políticas de alertas, gráficos, visões gerais e grupos de recursos que filtram valores metadata.user_labels.name preenchidos automaticamente serão migrados para usar metadata.system_labels.name.

.000 Para recursos pubsub_topic e pubsub_subscription: corrigimos um bug antigo que fazia com que metadata.system_labels.name fosse convertido automaticamente em letras minúsculas (por exemplo, "My-Subscription" se torna "my-subscription"). Isso produziu um comportamento inesperado nos casos em que os usuários tinham vários recursos com nomes em minúsculas. Esse comportamento também termina em 31 de julho de 2020. Após essa data, o rótulo do sistema de metadados name refletirá o nome real do tópico ou da assinatura (por exemplo, "My-Subscription").

O que preciso fazer?

Há duas etapas gerais:

  1. Determine se você está usando rótulos de metadados afetados por essa suspensão de uso. Consulte Encontrar rótulos de metadados obsoletos para informações sobre como executar o script do detector fornecido.

  2. Se você estiver usando os rótulos de metadados afetados, atualize-os ou remova-os. Consulte Atualizar seus filtros para ver etapas mais detalhadas.

Encontrar rótulos de metadados obsoletos

Use esse script Python para identificar referências a rótulos de metadados obsoletos: metadata_label_detection.py.

Resumo da sintaxe: python3 metadata_label_detection.py [PROJECT_ID_OR_NUMBER]

PROJECT_ID_OR_NUMBER pode ser um ID de projeto (por exemplo, my-project) ou um número de projeto (por exemplo, 123456789).

As etapas a seguir descrevem uma maneira de usar o script:

  1. Acesse o Console do Google Cloud.

    Acessar o Console do Cloud

  2. Clique em Ativar o Cloud Shell na parte superior da página do Console do Google Cloud para seu projeto.

  3. Clique em Abrir o Editor na barra de ferramentas do Cloud Shell. Se o espaço de trabalho do seu diretório principal ainda não estiver aberto, abra-o selecionando Arquivo e Abrir espaço de trabalho. Escolha o espaço de trabalho com seu nome de usuário.

  4. Crie um novo arquivo chamado metadata_label_detection.py selecionando Arquivo e, em seguida, Novo arquivo. Cole o texto do metadata_label_detection.py no editor. Salve o arquivo selecionando Arquivo e, em seguida, Salvar.

  5. Volte para o terminal clicando em Open Terminal na barra de ferramentas do Cloud Shell.

  6. No prompt de linha de comando do Cloud Shell, instale as dependências do script executando o seguinte comando:

    sudo pip3 install google-cloud-monitoring google-cloud-monitoring-dashboards
    
  7. Depois de instalar as dependências, execute o script do detector:

    python3 metadata_label_detection.py $GOOGLE_CLOUD_PROJECT
    

O script gera um relatório como o trecho a seguir:

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.

Atualizar os filtros

Para atualizar as políticas de alertas, gráficos, tabelas gerais e grupos de recursos:

  1. Faça login no Console do Google Cloud.

  2. Execute o script do detector conforme descrito em Encontrar rótulos obsoletos.

  3. Inspecione cada uma das políticas de alerta, gráficos e grupos de recursos para verificar se o valor recuperado é proveniente de um dos rótulos obsoletos identificados pelo script.

    Para verificar todos os gráficos, você precisa verificar cada gráfico em cada painel personalizado definido.

    Para cada rótulo suspenso, siga um destes procedimentos:

    • Se o rótulo não tiver substituição, remova o uso do rótulo ou exclua a política de alertas, o gráfico ou o grupo de recursos.

      Se você não fizer nada, o filtro que usa o rótulo não funcionará depois de 31 de julho de 2020.

    • Se o rótulo tiver um substituto, substitua o rótulo suspenso pelo substituto.

      Se você não fizer nada, a substituição será feita em 31 de julho de 2020.

    Para ajuda adicional sobre como fazer atualizações, consulte os recursos listados em Edição.

  4. Execute o script do detector novamente para verificar se não há rótulos obsoletos.

Mais informações

Para informações sobre rótulos de metadados de recursos, filtros ou tipos específicos de recursos monitorados, consulte:

Edição

Para informações sobre como atualizar políticas de alertas, gráficos, painéis e grupos de recursos, consulte: