Ver registros de instância

Nesta página, descrevemos como usar o Cloud Logging para visualizar e consultar registros da instância do Cloud SQL.

O Cloud Logging coleta automaticamente dados de registro das instâncias do Cloud SQL. Use o Logging para consultar, visualizar e analisar dados de registro para solucionar problemas e melhorar a observabilidade. Para mais informações, consulte a documentação do Cloud Logging e as consultas de amostra do Cloud SQL.

Antes de começar

Para receber as permissões necessárias para usar a Análise de registros e visualizar entradas de registro, peça ao administrador para conceder a você os seguintes papéis do IAM:

  • Para visualizar as entradas de registro no bucket _Required e na visualização _Default no bucket _Default ou para selecionar um escopo do registro: Visualizador de registros (roles/logging.viewer) no projeto, na pasta ou na organização.
  • Para visualizar todas as entradas de registro nos buckets _Required e _Default: Visualizador de registros (roles/logging.privateLogViewer) no projeto, na pasta ou na organização.

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Como visualizar registros

Para ver as entradas de registro da instância do Cloud SQL, faça o seguinte:

Console

  1. No console Google Cloud , acesse a página Cloud Logging.

    Acessar o Cloud Logging

  2. Selecione um projeto do Cloud SQL.
  3. No painel Consulta, faça as seguintes seleções:
    • Todos os recursos: selecione Banco de dados do Cloud SQL. Na caixa de diálogo, selecione uma instância do Cloud SQL.
    • Todos os nomes de registros: vá até a seção do Cloud SQL e selecione os arquivos de registro correspondentes à instância. Exemplo:
      • cloudsql.googleapis.com/sqlagent.out
      • cloudsql.googleapis.com/sqlserver.err
    • Todas as gravidades: selecione um nível de gravidade. Por exemplo, selecione Error para ver registros com um nível de gravidade de pelo menos Error.
    • Seletor de período: selecione uma opção de horário predefinida, especifique um horário de início e término personalizado ou centralize o período em um carimbo de data/hora específico.

gcloud

Use o comando gcloud logging para visualizar as entradas de registro. No exemplo abaixo, substitua PROJECT_ID. A sinalização limit é um parâmetro opcional que indica o número máximo de entradas a serem retornadas.

gcloud logging read "resource.type=cloudsql_database" \
--project=PROJECT-ID \
--limit=10 \
--format=json

Ver o registro de operações da instância

É possível ver os registros de uma instância no painel Operações. O painel Operações registra cada operação realizada na instância com as seguintes informações:

  • o horário em que a operação foi concluída, no fuso horário local
  • O tipo de operação
  • O status da operação
  • Uma mensagem que descreve o resultado da operação.

Se houver falha na operação, será possível usar a mensagem para resolver o problema.

Para ver um registro de operações de instâncias:

  1. No console do Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
  3. Acesse o painel Operações e registros para conferir o registro de operações.
Observação: o registro de operações não inclui operações executadas que usam ferramentas de gestão externas, como as ferramentas de linha de comando do SQL Server. Nesse registro, somente aparecem as operações de gerenciamento de usuários e alteração de senha realizadas com oGoogle Cloud console, a CLI gcloud ou a API Cloud SQL Admin.

Veja os registros do aplicativo.

Os aplicativos que se conectam ao Cloud SQL armazenam os registros em locais diferentes.

App Engine (ambiente flexível)

Para ver os registros dos serviços do App Engine, faça o seguinte:

  1. Acesse a página Serviços do App Engine no console do Google Cloud :

    Acessar Serviços

  2. Selecione um serviço na tabela e clique em Registros na coluna Diagnosticar.

    Você será redirecionado para a Análise de Registros com uma consulta que recupera os registros do serviço do App Engine.

Para ver os registros do App Engine na seção Análise de registros do console doGoogle Cloud , use uma consulta como esta:

resource.type="gae_app"
resource.labels.module_id="default"

Cloud Run

Para ver os registros do Cloud Run na seção Análise de registros do console doGoogle Cloud , use uma consulta como esta:

resource.type="cloud_run_revision"
resource.labels.service_name="$SERVICE_NAME"
resource.labels.revision_name="$REVISION_NAME"

O Cloud Run informa apenas mensagens de erro do proxy de autenticação do Cloud SQL.

Proxy de autenticação do Cloud SQL

Para ver os registros do proxy de autenticação do Cloud SQL na seção Análise de registros do console doGoogle Cloud , use uma consulta como esta:

log_id("appengine.googleapis.com/cloud-sql-proxy")

Acessar registros de auditoria

O Cloud SQL grava Registros de auditoria do Cloud para registrar atividades administrativas e acesso a dados nos seus recursos. É possível conferir os seguintes tipos de registros de auditoria para suas instâncias do Cloud SQL:

  • Atividade do administrador: entradas de registro gravadas por chamadas de API orientadas pelo usuário ou outras ações que modificam a configuração ou os metadados dos recursos. Não é possível desativar esses registros.
  • Acesso a dados: entradas de registro gravadas por chamadas de API que leem a configuração ou os metadados dos recursos. Esses registros também incluem operações que leem ou gravam dados fornecidos pelo usuário. Para gravar registros de auditoria de acesso a dados, é necessário ativá-los.
  • Evento do sistema: entradas de registro gravadas por sistemas do Google Cloud e agentes serviço gerenciado que modificam a configuração de recursos. Não é possível desativar esses registros.

Para mais informações sobre como visualizar os registros de auditoria do Cloud SQL, incluindo uma lista completa de métodos auditados, consulte Geração de registros de auditoria do Cloud SQL para SQL Server.

Preços

Para mais informações sobre os preços do Cloud Logging, consulte Resumo de preços do Cloud Logging.

Resolver problemas

Problema Solução de problemas
Registros de auditoria não encontrados. Os registros de acesso a dados só são gravados se a operação for uma chamada de API autenticada pelo usuário que cria, modifica ou lê dados criados pelo usuário ou se a operação acessar arquivos de configuração ou metadados de recursos.
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.
Alguns registros são filtrados do registro error.log de uma instância do Cloud SQL para SQL Server. Os registros filtrados incluem registros do AD sem carimbos de data/hora e incluem: Login failed for user 'x'. Reason: Token-based server access validation failed with an infrastructure error. Login lacks connect endpoint permission. [CLIENT: 127.0.0.1]. Esses registros são filtrados porque podem causar confusão.
Os arquivos de registros são difíceis de ler. Você preferiria ver os registros como json ou texto. É possível usar 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:

gcloud logging read \
"resource.type=cloudsql_database \
AND logName=projects/PROJECT_ID \
/logs/cloudsql.googleapis.com%2FLOG_NAME" \
--format json \
--project=PROJECT_ID \
--freshness="1d" \
> downloaded-log.json

Para fazer o download dos registros como TEXT:

gcloud logging read \
"resource.type=cloudsql_database \
AND logName=projects/PROJECT_ID \
/logs/cloudsql.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