Conferir os registros de instâncias do Looker (Google Cloud Core)

Esta página descreve como encontrar e usar o Cloud Logging para consultar e visualizar registros da instância do Looker (núcleo do Google Cloud).

O Looker (núcleo do Google Cloud) usa o Cloud Logging. Consulte a documentação do Cloud Logging para informações completas.

Funções exigidas

Para entender os papéis necessários para o Cloud Logging, acesse a página Controle de acesso com o IAM da documentação do Cloud Logging.

Ver registros

Para conferir os registros das entradas de registro da instância do Looker (núcleo do Google Cloud), selecione uma das seguintes opções:

Console

  1. No Google Cloud console, acesse Logging > Logs Explorer.
  2. Selecione um projeto do Looker (núcleo do Google Cloud) na parte de cima da página.
  3. No criador de consultas, adicione o seguinte:
    • Recurso: selecione Instância do Looker. Na caixa de diálogo, selecione um ID de instância do Looker (Google Cloud Core).
    • Nomes de registro: role até a seção do Looker e selecione os arquivos de registro apropriados para sua instância. Exemplo:
      • looker.googleapis.com%2FContentAccess
      • looker.googleapis.com%2FUserLogin
    • Gravidade: selecione um nível de registro.
    • Período: selecione um valor predefinido ou crie um período personalizado.

gcloud

Use o comando gcloud logging para visualizar as entradas de registro.

gcloud logging read "resource.type=looker.googleapis.com/Instance" \
--project=PROJECT_ID \
--limit=10 \
--format=json

Substitua:

  • PROJECT_ID: o ID do projeto Google Cloud em que a instância do Looker (núcleo do Google Cloud) está armazenada.

Também é possível incluir as seguintes flags:

  • A flag limit é um parâmetro opcional que indica o número máximo de entradas a serem retornadas.

Resolver problemas

Problema Solução de problemas
Os arquivos de registro estão incompletos. Verifique o nível de gravidade em que a geração de registros está configurada. As mensagens de registro abaixo do nível configurado serão descartadas.
Informações de operações não encontradas nos registros. Você quer encontrar mais informações sobre uma operação.

Por exemplo, um usuário foi excluído, mas não é possível descobrir quem fez isso. Os registros mostram que a operação foi iniciada, mas não fornecem mais informações. Você precisa ativar o registro de auditoria para que informações de identificação detalhadas e pessoais (PII, na sigla em inglês) sejam registradas.
Os arquivos de registros são difíceis de ler. É melhor ver os registros como JSON ou texto. Use o comando gcloud logging read junto com os comandos de pós-processamento do Linux para fazer o download dos registros.

Para fazer o download dos registros como JSON, use o seguinte código:

gcloud logging read \
"resource.type=looker.googleapis.com/Instance \
AND logName=projects/PROJECT_ID \
/logs/looker.googleapis.com%2FLOG_NAME" \
--format json \
--project=PROJECT_ID \
--freshness="1d" \
> downloaded-log.json

Substitua:

  • PROJECT_ID: o ID do projeto Google Cloud em que a instância do Looker (núcleo do Google Cloud) está armazenada
  • LOG_NAME: o nome do recurso do registro

Para fazer o download dos registros como texto, use o seguinte código:

gcloud logging read \
"resource.type=looker.googleapis.com/Instance \
AND logName=projects/PROJECT_ID \
/logs/looker.googleapis.com%2FLOG_NAME" \
--format json \
--project=PROJECT_ID \
--freshness="1d"| jq -rnc --stream 'fromstream(1|truncate_stream(inputs)) \
| .textPayload' \
--order=asc
> downloaded-log.txt

Substitua:

  • PROJECT_ID: o ID do projeto Google Cloud em que a instância do Looker (núcleo do Google Cloud) está armazenada
  • LOG_NAME: o nome do recurso do registro

A seguir