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

É possível usar o Cloud Logging para visualizar e consultar registros da instância do Looker (Google Cloud Core). O monitoramento desses registros ajuda a resolver problemas, acompanhar o uso e garantir a integridade e a segurança do ambiente do Looker, fornecendo dados confiáveis para suas operações. Para mais detalhes sobre o Cloud Logging, consulte a documentação do Cloud Logging.

Funções exigidas

Para entender as funções necessárias para o Cloud Logging, acesse a página Controle de acesso com o IAM da documentação do Cloud Logging.

Ver registros

Para visualizar os registros da instância do Looker (Google Cloud Core), selecione uma das seguintes opções:

Console

  1. No Google Cloud console, 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 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 gcloud logging comando 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 Google Cloud projeto em que a instância do Looker (Google Cloud Core) reside.

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

  • A limit flag é 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 visualizar os registros como JSON ou texto. É possível usar o gcloud logging read comando 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) 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 Google Cloud projeto em que a instância do Looker (Google Cloud Core) reside
  • LOG_NAME: o nome do recurso do registro

A seguir