Esta página descreve como visualizar um log de auditoria para um backup automatizado da sua instância do Cloud SQL.
Você pode usar logs de auditoria para fazer o seguinte:
- Visualize um log de auditoria para verificar se o backup foi concluído com sucesso.
- Configure um alerta baseado em log para notificá-lo sobre o status do backup.
Exibir um log de auditoria
Você pode usar o Google Cloud console, gcloud CLI
ou API para visualizar um log de auditoria para verificar se um backup foi concluído com sucesso dentro de uma janela de backup.
Console
No Google Cloud console, selecione Registro e, em seguida, selecione Logs Explorer .
Para filtrar logs de auditoria para backups automatizados de instâncias do Cloud SQL, execute a seguinte consulta:
logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fsystem_event" protoPayload.methodName="cloudsql.instances.automatedBackup" resource.type="cloudsql_database"
Substitua PROJECT_ID pelo seu Google Cloud ID do projeto.
A primeira expressão filtra logs de auditoria de eventos do sistema . A segunda expressão filtra logs de auditoria para backups automatizados. A última expressão filtra logs de auditoria para instâncias do Cloud SQL.
Para obter mais informações sobre como usar o Google Cloud console para consultar logs de auditoria, consulte Exibir logs .
Visualize o status de um backup criado durante a janela de backup. Esse status é exibido no campo
windowStatus
. Para visualizar esse campo, siga estas etapas:- Clique no log de auditoria.
- Clique no campo
metadata
.
gcloud
Para filtrar logs de auditoria para backups automatizados de instâncias do Cloud SQL, execute a seguinte consulta:
gcloud logging read \ "logName=projects/PROJECT_NAME/logs/cloudaudit.googleapis.com%2Fsystem_event AND protoPayload.methodName=cloudsql.instances.automatedBackup AND resource.type=cloudsql_database" \ --project=PROJECT_NAME
Substitua PROJECT_NAME pelo seu Google Cloud nome do projeto.
A primeira expressão filtra logs de auditoria de eventos do sistema . A segunda expressão filtra logs de auditoria para backups automatizados. A última expressão filtra logs de auditoria para instâncias do Cloud SQL.
Para obter mais informações sobre como usar
gcloud
para consultar logs de auditoria, consulte Exibir logs .Visualize o status de um backup criado durante a janela de backup. Este status é exibido no campo
windowStatus
.
API
Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:
- PROJECT_ID : O ID do seu Google Cloud projeto.
Para o corpo JSON da solicitação, a primeira expressão filtra os logs de auditoria de eventos do sistema . A segunda expressão filtra os logs de auditoria para backups automatizados. A última expressão filtra os logs de auditoria para instâncias do Cloud SQL.
Para obter mais informações sobre como usar a API para consultar logs de auditoria, consulte Exibir logs .
Método HTTP e URL:
POST https://logging.googleapis.com/v2/entries:list
Corpo JSON da solicitação:
{ "resourceNames": [ "projects/PROJECT_ID" ], "pageSize": 5, "filter": "logName=projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fsystem_event AND protoPayload.methodName = cloudsql.instances.automatedBackup AND resource.type=cloudsql_database", "orderBy": "timestamp desc" }
Para enviar sua solicitação, expanda uma destas opções:
Você deve receber uma resposta JSON semelhante à seguinte:
Para obter mais informações sobre LOG_ENTRY_UNIQUE_IDENTIFIER para o campo insertId
, consulte LogEntry .
Visualize o status de um backup criado durante a janela de backup. Este status é exibido no campo windowStatus
.
Status de backup automatizado
-
STATUS_SUCCEEDED
: O backup automatizado foi concluído com sucesso. STATUS_ATTEMPT_FAILED
: O Cloud SQL tentou criar o backup, mas ele não foi iniciado ou falhou. Os motivos para esse status incluem:- Outro backup está em execução na instância.
- O local do backup é restrito pela política da sua organização.
- O backup da instância foi concluído, mas ocorreu um erro.
- A instância não estava em execução quando o Cloud SQL tentou criar o backup.
STATUS_FAILED
: O backup automatizado da instância não foi concluído com sucesso ou não pode ser concluído dentro da janela de backup.Por exemplo, se você habilitou backups automatizados e agendou a janela de backup para entre 1h e 5h, seu backup poderá falhar se houver muitas operações de
EXPORT
durante esse período. Os backups automatizados também poderão falhar se houver muitos conflitos com uma operaçãoEXPORT
em execução por um longo período.Se o Cloud SQL tentar criar um backup várias vezes durante uma janela de backup, mas o backup não puder ser criado pelos motivos listados para
STATUS_ATTEMPT_FAILED
, o Cloud SQL gerará outro log de auditoria com o campowindowStatus
definido comoSTATUS_FAILED
.STATUS_SKIPPED
: A instância do Cloud SQL parou de funcionar desde o último backup bem-sucedido. Portanto, um novo backup automatizado não foi criado.
Configurar um alerta baseado em log
Você pode configurar um alerta baseado em log para notificá-lo sobre o status do backup.
- Se um backup tiver o status
STATUS_SUCCEEDED
, você poderá ser notificado para fins de rastreamento. - Se um backup apresentar o status
STATUS_FAILED
ouSTATUS_ATTEMPT_FAILED
, você poderá ser notificado para tomar medidas corretivas, com base na mensagem exibida na entrada de log. Você também pode fazer um backup sob demanda antes da próxima janela de backup agendada. - Se um backup tiver o status
STATUS_SKIPPED
, você poderá ser notificado para reiniciar a instância do Cloud SQL.
O que vem a seguir
- Saiba mais sobre como fazer backup dos seus dados .
- Saiba mais sobre como criar e gerenciar backups .
- Saiba mais sobre restauração de dados .
- Veja como restaurar seus dados a partir de um backup .
- Veja como executar uma recuperação de ponto no tempo .