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

Nesta página, você vai saber como encontrar e usar o Cloud Logging para visualizar e consultar registros da sua instância do Looker (Google Cloud Core).

O Looker (Google Cloud Core) 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 ver os registros das entradas de registro da instância do Looker (Google Cloud Core), selecione uma das seguintes opções:

Console

  1. No console Google Cloud , acesse Logging > Explorador de registros.
  2. Selecione um projeto do Looker (Google Cloud Core) 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 registros: vá até a seção do Looker e selecione os arquivos de registro correspondentes à 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 (Google Cloud Core) está.

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 registros 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 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 Google Cloud projeto em que a instância do Looker (Google Cloud Core) está localizada
  • 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 Google Cloud projeto em que a instância do Looker (Google Cloud Core) está localizada
  • LOG_NAME: o nome do recurso do registro

A seguir