Monitorar métricas do Knowledge Catalog

Este documento explica como usar o Cloud Monitoring para acompanhar a integridade do serviço do Knowledge Catalog (antigo Dataplex Universal Catalog), otimizar o desempenho e ter visibilidade da sua plataforma de dados. O monitoramento proativo ajuda a garantir a confiabilidade dos aplicativos de dados e tomar decisões conscientes sobre alocação de recursos e gerenciamento de custos.

Para entender os custos, consulte os preços do Monitoring.

Para mais informações sobre a retenção de dados de métricas, consulte Cotas e limites do Monitoring.

Casos de uso

É possível usar métricas do Knowledge Catalog no Cloud Monitoring para oferecer suporte aos seguintes casos de uso:

  • Garantir a confiabilidade do pipeline de dados: monitore as taxas de sucesso e falha das tarefas do Knowledge Catalog, como jobs de ingestão de dados ou qualidade de dados. Configure alertas para falhas ou durações incomuns para minimizar o tempo de inatividade das cargas de trabalho críticas.
  • Otimizar a performance: acompanhe as durações dos jobs e as métricas de utilização de recursos para identificar e resolver gargalos de performance nas cargas de trabalho de tratamento de dados, qualidade de dados e descoberta de dados.
  • Gerenciar custos: monitore o consumo de recursos do Knowledge Catalog para identificar oportunidades de otimização de custos, aplicar controles de orçamento e garantir o uso eficiente dos recursos.
  • Manter a governança de dados: acompanhe as métricas relacionadas à descoberta de metadados e ao enriquecimento do catálogo para garantir que os recursos de dados sejam verificados e marcados de acordo com suas políticas de governança.

Como funciona

O Knowledge Catalog é integrado ao Cloud Monitoring, que coleta métricas, eventos e metadados dos serviços do Knowledge Catalog. Essas métricas fornecem insights sobre áreas como status de execução do job, uso da API e integridade dos recursos. É possível analisar essas métricas usando ferramentas no Cloud Monitoring, como o Metrics Explorer, painéis personalizados e alertas. Com elas, é possível visualizar o comportamento do serviço, identificar tendências de desempenho e criar políticas de alertas que notificam você quando o desempenho se desvia dos limites definidos ou quando ocorrem falhas.

Acessar métricas de serviço no Monitoring

As métricas de recursos do serviço do Knowledge Catalog são ativadas automaticamente nos serviços do Knowledge Catalog. Para conferir essas métricas, use o Monitoring.

É possível acessar o Monitoring no console doGoogle Cloud ou usando a API Monitoring.

Se você não conseguir ver os gráficos de monitoramento ou criar alertas, talvez precise de mais permissões do Monitoring.

Console

  1. No console do Google Cloud , acesse a página do Metrics explorer.

    Acesse o Metrics explorer

  2. No menu Selecionar uma métrica, escolha um recurso Cloud Dataplex.

  3. Selecione uma categoria e uma métrica na lista.

    Para mostrar informações sobre uma métrica, mantenha o ponteiro do mouse sobre o nome dela.

  4. Clique em Aplicar.

  5. Opcional: selecione filtros, agrupe por rótulos de métricas, faça agregações e escolha opções de exibição de gráficos.

REST

Para capturar e listar métricas definidas por uma expressão filter, use o método timeSeries.list do Monitoring.

Para enviar uma solicitação de API e mostrar a resposta, use o modelo Testar esta API na página da API.

Métricas de serviço do Knowledge Catalog no Monitoring

As métricas do serviço Knowledge Catalog facilitam o monitoramento da integridade do serviço.

As strings "tipo de métrica" nesta tabela precisam ser prefixadas com dataplex.googleapis.com/. Esse prefixo foi omitido das entradas na tabela. Ao consultar um rótulo, use o prefixo metric.labels.. por exemplo, metric.labels.LABEL="VALUE".

Tipo de métrica Etapa do lançamento (níveis da hierarquia de recursos)
Nome de exibição
Classe, Tipo, Unidade
Recursos monitorados
Descrição
Rótulos
asset/active BETA(projeto)
Ativo
GAUGEINT641
dataplex.googleapis.com/Asset
Indica se o recurso está ativo.
resource_type: O tipo do recurso referenciado.
zone_type: O tipo da zona principal.
asset/data_items BETA(projeto)
Itens de dados
GAUGEINT641
dataplex.googleapis.com/Asset
A contagem de itens no recurso referenciado.
resource_type: O tipo do recurso referenciado.
zone_type: O tipo da zona principal.
asset/data_size BETA(projeto)
Tamanho dos dados
GAUGEINT64By
dataplex.googleapis.com/Asset
O número de bytes armazenados no recurso referenciado.
resource_type: O tipo do recurso referenciado.
zone_type: O tipo da zona principal.
asset/entities_pending_bigquery_iampolicy_updates BETA(project)
Entidades com atualizações pendentes da política do IAM do BigQuery
GAUGEINT641
dataplex.googleapis.com/Asset
Número de entidades associadas ao recurso com atualizações pendentes da política do IAM do BigQuery.
resource_type: O tipo do recurso referenciado.
zone_type: O tipo da zona principal.
asset/entities_pending_bigquery_metadata_updates BETA(project)
Entidades com atualizações pendentes de metadados do BigQuery
GAUGEINT641
dataplex.googleapis.com/Asset
Número de entidades associadas ao recurso com atualizações pendentes de metadados do BigQuery.
resource_type: O tipo do recurso referenciado.
zone_type: O tipo da zona principal.
asset/filesets BETA(projeto)
Conjuntos de arquivos
GAUGEINT641
dataplex.googleapis.com/Asset
A contagem de entidades de conjunto de arquivos no recurso referenciado.
resource_type: O tipo do recurso referenciado.
zone_type: O tipo da zona principal.
asset/requires_action BETA(projeto)
Requer ação
GAUGEINT641
dataplex.googleapis.com/Asset
Se o recurso tem ações de administrador não resolvidas.
resource_type: O tipo do recurso referenciado.
zone_type: O tipo da zona principal.
asset/tables BETA(projeto)
Tabelas
GAUGEINT641
dataplex.googleapis.com/Asset
A contagem de entidades de tabela no recurso referenciado.
resource_type: O tipo do recurso referenciado.
zone_type: O tipo da zona principal.
lake/requires_action BETA(projeto)
Requer ação
GAUGEINT641
dataplex.googleapis.com/Lake
Se o lake tem ações de administrador não resolvidas.
zone/requires_action BETA(projeto)
Requer ação
GAUGEINT641
dataplex.googleapis.com/Zone
Se a zona tem ações de administrador não resolvidas.
type: O tipo da zona.

Tabela gerada em 23-04-2026 19:46:18 UTC.

Criar um painel personalizado do Monitoring

É possível criar um painel personalizado do Monitoring com gráficos de métricas do serviço do catálogo de dados do Knowledge Catalog selecionadas. Para mais informações sobre como criar um painel, consulte Criar e gerenciar painéis personalizados. Ao selecionar uma métrica para um widget no painel, escolha um recurso Cloud Dataplex e uma métrica do Knowledge Catalog.

Usar alertas do Monitoring

É possível criar um alerta do Monitoring para notificar você quando um serviço ou métrica de job do Knowledge Catalog ultrapassar um limite especificado.

Criar um alerta

Para criar um alerta, siga as instruções em Criar políticas de alertas de limite de métrica. Ao selecionar uma série temporal para monitorar, escolha um recurso Cloud Dataplex e uma métrica do Knowledge Catalog.

Ver alertas

Quando um alerta é acionado por uma condição de limite de métrica, o Monitoring cria um incidente e um evento correspondente.

Para ver um incidente, siga esta etapa:

O Monitoring também envia uma notificação do incidente se tiver sido definido na política de alerta algum mecanismo de notificação, como notificações por e-mail ou por SMS.

Para mais informações sobre alertas, consulte Incidentes para alertas baseados em métricas.

A seguir