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

Nesta página, descrevemos como encontrar e usar o Cloud Logging para visualizar e consultar registros para 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 conferir as 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 exibir os registros das entradas de registro da instância do Looker (Google Cloud Core), selecione uma das seguintes opções:

Console

  1. No console do Google Cloud, acesse Logging > Análise de registros
  2. Selecione um projeto atual 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 da instância do Looker (Google Cloud Core).
    • Nomes dos registros: role até a seção do Looker e selecione os arquivos de registro adequados 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 do Google Cloud em que a instância do Looker (núcleo do Google Cloud) está armazenada.

Você também pode incluir as seguintes sinalizações:

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

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. A melhor opção é visualizar os registros como JSON ou texto. Você pode usar o 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 este 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 do Google Cloud em que a instância do Looker (Google Cloud Core) está localizada.
  • LOG_NAME: o nome de recurso do registro

Para fazer o download dos registros como texto, use este 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 do Google Cloud em que a instância do Looker (Google Cloud Core) está localizada.
  • LOG_NAME: o nome de recurso do registro

A seguir