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 (núcleo do Google Cloud) 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 na documentação do produto.

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 > 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 da 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 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. É 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 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 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) está localizada.
  • LOG_NAME: o nome de recurso do registro

A seguir