Leitor de ingestão

O visualizador de ingestão (acessível em Ingestão > Histórico na Central de ações) oferece visibilidade quase em tempo real do status, da integridade da validação e do histórico de processamento dos feeds de pontos de interesse locais.

Use o visualizador de ingestão para acompanhar os uploads diários de feeds, monitorar a integridade da ingestão, inspecionar as estatísticas de erros de validação no nível do item e verificar a chegada dos arquivos de feed.

Visão geral

A página principal do visualizador de ingestão mostra um registro cronológico inverso de todos os feeds recebidos pelo Google.

Fases do ciclo de vida da ingestão

Cada envio de feed passa pelas seguintes etapas de processamento sequencial:

  1. Aquisição de arquivos:o Google recebe o arquivo de feed usando SFTP.
  2. Validação de arquivos:o sistema verifica a integridade, a descompactação e o formato geral do esquema.
  3. Extração e validação de entidades:o pipeline analisa registros locais individuais (poi_id, endereço, coordenadas, localizações) e verifica a sintaxe, a integridade e a conformidade com a política.
  4. Conciliação e correspondência:as entidades válidas são enviadas ao mecanismo de correspondência do Google para serem vinculadas aos IDs canônicos de lugar do Google para veiculação.
  5. Geração de relatórios:as métricas de resumo e os diagnósticos de problemas agrupados são publicados no visualizador de ingestão.

Para conferir o histórico de ingestão de feeds, siga estas etapas:

  1. Faça login na Central de ações.
  2. Abra a página Ingestão > Histórico.
  3. Filtre, classifique e veja a tabela de ingestão usando os controles de coluna.

Colunas da lista de ingestão

A tabela de resumo principal fornece as seguintes colunas para cada execução de ingestão:

Coluna Tipo de dados Descrição
ID String Identificador exclusivo da execução de ingestão.
Horário de ingestão (UTC) Timestamp Data e hora (em UTC) em que o Google começou a processar a ingestão do feed.
Tipo de ingestão Enum Tipo de aquisição de dados (por exemplo, Feed).
Nome String Nome do tipo de ingestão de feed. Ele será google.local_vss.
Status State Estado geral do processamento da ingestão (por exemplo, "Concluído" ou "Falha"). Consulte Definições de status.
Comportamento de ingestão Enum Todos os feeds de PDI locais são processados no modo Batch.
Erros Integer Número total de problemas de validação no nível de erro detectados.
Avisos Integer Contagem total de problemas não bloqueadores detectados no nível de aviso.
Itens Integer Número total de propriedades locais processadas nesta ingestão.

Definições de status

A coluna Status indica o estado operacional atual de um envio de feed:

  • Concluído (STATUS_COMPLETE): o feed foi ingerido, validado e processado sem erros fatais.
  • Falha (STATUS_FAILED): a ingestão encontrou erros fatais de esquema, corrupção de arquivo ou pipeline e não pôde ser concluída.
  • Em processamento (STATUS_PROCESSING): o Google está validando, correspondendo e armazenando ativamente os dados do feed.
  • Ignorado (NOT_STARTED): o envio do feed foi ignorado (por exemplo, se o carimbo de data/hora de geração for mais antigo que um feed processado anteriormente).

Visualização de detalhes da transferência de programa

Clique em qualquer linha na tabela do Ingestion Viewer para abrir a Visualização de detalhes da ingestão. Essa visualização oferece cards de diagnóstico abrangentes e painéis de expansão para depurar problemas.

Painéis de detalhes

A página de detalhes da ingestão é dividida em quatro seções expansíveis:

1. Informações básicas

Mostra os principais metadados sobre a execução:

  • Horário de ingestão (UTC): carimbo de data/hora em que o Google iniciou a ingestão.
  • Tipo de ingestão:Feed.
  • Nome: google.local_vss
  • Comportamento de ingestão:Batch
  • Status:selo de status com código de cores (Done, Failed, Processing, Skipped).

2. Validações

Lista todas as descobertas de validação encontradas durante a ingestão:

  • Erros de arquivo (caixa de destaque): se todo o arquivo de feed falhar (por exemplo, devido a um arquivo ilegível ou sintaxe JSON malformada), uma caixa de destaque de aviso vai mostrar a mensagem da causa raiz.
  • Problemas de entidade (tabela em acordeão): problemas de validação no nível do item agrupados por gravidade e código de erro.
    • Código do problema:identificador de erro específico (como INVALID_ATTRIBUTE_VALUE, MISSING_RECOMMENDED_FIELD ou SAFE_SEARCH_POLICY_VIOLATION_TEXT).
    • Informações do problema:descrição do diagnóstico explicando a causa raiz e os campos afetados.
    • Registros:a contagem total de entidades de propriedade afetadas por esse problema.
    • Clique em qualquer linha de problema para expandir os IDs de entidades de amostra (poi_ids) com links diretos para inspecionar as propriedades no Visualizador de inventário.

3. Itens

Fornece quadros de visão geral do delta de inventário no nível do item para a execução da ingestão:

  • Total:número total de propriedades locais processadas.
  • Adicionadas:contagem de fichas de empresas recém-descobertas adicionadas ao seu catálogo.
  • Mudança:contagem de propriedades atuais cujos atributos (por exemplo, nome, endereço, coordenadas ou imagens) foram atualizados.
  • Removido:contagem de propriedades descartadas ou omitidas em comparação com o valor de referência anterior do feed.

4. Arquivos

Mostra o nome do arquivo de feed enviado:

  • Nome do arquivo:nome do arquivo de feed (por exemplo, local_feed.json.gz).

Solução de problemas de falhas de ingestão

Ao resolver problemas de feeds no visualizador de ingestão, use as seguintes diretrizes:

Sintoma Causa provável Ação recomendada
Status is Failed with File Error Arquivo ZIP/GZIP corrompido, sintaxe JSON malformada ou codificação de arquivo não compatível. Verifique se o feed está empacotado corretamente usando as diretrizes de empacotamento de feeds.
Contagem Errors alta em Validações Os campos obrigatórios do esquema (como poi_id, location.address estruturado ou coordenadas WGS84) estão faltando nos registros. Revise o acordeão Validações para identificar os poi_ids problemáticos, corrija os pipelines do feed de PDI e importe o feed novamente.
Zero Items processed O arquivo de feed está vazio ou não foi possível analisar a matriz JSON no nível raiz. Verifique se a estrutura do wrapper do feed está de acordo com a especificação da mensagem VssPoi. Consulte as Diretrizes de empacotamento de feeds.