Veja os registos de instâncias do Looker (Google Cloud Core)

Esta página descreve como encontrar e usar o Cloud Logging para ver e consultar registos da sua instância do Looker (essencial para o Google Cloud).

O Looker (Google Cloud Core) usa o Cloud Logging. Consulte a documentação do Cloud Logging para ver informações completas.

Funções necessárias

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

Ver registos

Para ver as entradas de registo da sua instância do Looker (essencial para o Google Cloud), selecione uma das seguintes opções:

consola

  1. Na Google Cloud consola, aceda a Registo > Explorador de registos
  2. Selecione um projeto do Looker (Google Cloud core) existente na parte superior 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 registos: desloque a página até à secção do Looker e selecione os ficheiros de registo adequados para a sua instância. Por exemplo:
      • looker.googleapis.com%2FContentAccess
      • looker.googleapis.com%2FUserLogin
    • Gravidade: selecione um nível de registo.
    • Intervalo de tempo: selecione uma predefinição ou crie um intervalo personalizado.

gcloud

Use o comando gcloud logging para ver as entradas do registo.

gcloud logging read "resource.type=looker.googleapis.com/Instance" \
--project=PROJECT_ID \
--limit=10 \
--format=json

Substitua o seguinte:

  • PROJECT_ID: o ID do Google Cloud projeto no qual a instância do Looker (Google Cloud Core) reside.

Também pode incluir as seguintes flags:

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

Resolver problemas

Problema Resolução de problemas
Os ficheiros de registo estão incompletos. Verifique o nível de gravidade no qual o registo está configurado. As mensagens de registo abaixo do nível configurado são ignoradas.
As informações das operações não são encontradas nos registos. Quiser encontrar mais informações sobre uma operação.

Por exemplo, um utilizador foi eliminado, mas não consegue saber quem o fez. Os registos mostram que a operação foi iniciada, mas não fornecem mais informações. Tem de ativar o registo de auditoria para que informações de identificação pessoal (PII) detalhadas e pessoais como estas sejam registadas.
Os ficheiros de registo são difíceis de ler. Preferir ver os registos como JSON ou texto. Pode usar o comando gcloud logging read juntamente com os comandos de pós-processamento do Linux para transferir os registos.

Para transferir os registos 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 o seguinte:

  • PROJECT_ID: o ID do Google Cloud projeto no qual a instância do Looker (Google Cloud Core) reside
  • LOG_NAME: o nome do recurso do registo

Para transferir os registos 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 o seguinte:

  • PROJECT_ID: o ID do Google Cloud projeto no qual a instância do Looker (Google Cloud Core) reside
  • LOG_NAME: o nome do recurso do registo

O que se segue?