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

Nesta página, descrevemos 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 do Cloud Logging, acesse a página Controle de acesso com o IAM na documentação do Cloud Logging.

Mostrar registros

Para conferir 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 de instância do Looker (Google Cloud Core).
    • Nomes de registro: role até a seção do Looker e selecione os arquivos de registros 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 (Google Cloud Core) reside.

Também é possível incluir as seguintes sinalizações:

  • A sinalização 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 com 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 visualizar 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 do Google Cloud em que a instância do Looker (Google Cloud Core) reside
  • 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 do Google Cloud em que a instância do Looker (Google Cloud Core) reside
  • LOG_NAME: o nome do recurso do registro

A seguir