Você pode criar uma métrica personalizada para gerar alertas ou fornecer informações para solucionar problemas com snapshots agendados.
Por exemplo, para configurar um alerta para falhas agendadas de snapshots, use o procedimento a seguir:
- Crie um filtro de log para capturar eventos de snapshot agendados.
- Crie uma métrica baseada no filtro de log que conta falhas de snapshot agendadas.
- Crie uma política de alerta para enviar um alerta quando houver uma falha de snapshot agendada.
Antes de começar
- Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
- Administrador de instância do Compute (v1) (
roles/compute.instanceAdmin.v1
) - Para se conectar a uma VM que pode ser executada como uma conta de serviço: Usuário da conta de serviço (v1) (
roles/iam.serviceAccountUser
) No console do Google Cloud, acesse a página Logging > Logs Explorer .
Na lista Filtrar por rótulo ou pesquisa de texto , selecione Converter em filtro avançado .
Substitua o campo de filtro inserindo o seguinte texto, substituindo
PROJECT_ID
pelo ID do seu projeto:resource.type="gce_disk" logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fsystem_event" protoPayload.methodName="ScheduledSnapshots" severity>"INFO"
Clique em Enviar filtro .
Na página Explorador de registros , clique em Criar métrica .
No Editor de Métricas , insira o seguinte:
- Nome :
scheduled_snapshot_failure_count
. - Descrição :
count of scheduled snapshot failures
. - Tipo :
Counter
- Nome :
Em Etiquetas , clique em Adicionar item e insira o seguinte:
- Nome :
status
- Descrição :
status of scheduled snapshot request
- Tipo de rótulo :
String
- Nome do campo :
protoPayload.response.status
- Nome :
Clique em Concluído .
Clique em Criar métrica .
No console do Google Cloud, acesse a página Cloud Logging > Métricas baseadas em registros .
Em Métricas definidas pelo usuário , encontre sua nova métrica chamada
user/scheduled_snapshot_failure_count
.Clique no botão de menu
Mais nesta linha e selecione Criar alerta a partir da métrica . A página de criação de condições de política de alerta é aberta.No painel Destino , em Agregador , selecione nenhum .
Em Filtro :
- Clique em Adicionar um filtro .
- Selecione o status na lista.
- No campo Valor , digite CONCLUÍDO.
- Clique em Aplicar .
Clique em Mostrar opções avançadas .
No painel Agregação avançada , clique na lista Alinhadores e selecione soma .
No painel Configuração , selecione os seguintes valores:
- A condição é acionada se :
Any time series violates
- Condição :
is above
- Limite :
1
- Para :
most recent value
- A condição é acionada se :
Clique em Salvar .
Na página Criar nova política de alertas , insira um nome de política. Opcionalmente, você pode adicionar canais de notificação e documentação para esta política.
Clique em Salvar .
- Saiba mais sobre frequências de agendamento de snapshots, políticas de retenção e regras de nomenclatura em Sobre agendamentos de snapshots para discos .
- Saiba mais sobre instantâneos de disco .
- Aprenda como criar snapshots agendados para discos .
- Saiba como visualizar registros .
- Crie um filtro de log para capturar eventos de snapshot agendados.
- Crie uma métrica baseada no filtro de log que conta falhas de snapshot agendadas.
- Crie uma política de alerta para enviar um alerta quando houver uma falha de snapshot agendada.
- Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
- Administrador de instância do Compute (v1) (
roles/compute.instanceAdmin.v1
) - Para se conectar a uma VM que pode ser executada como uma conta de serviço: Usuário da conta de serviço (v1) (
roles/iam.serviceAccountUser
) No console do Google Cloud, acesse a página Logging > Logs Explorer .
Na lista Filtrar por rótulo ou pesquisa de texto , selecione Converter em filtro avançado .
Substitua o campo de filtro inserindo o seguinte texto, substituindo
PROJECT_ID
pelo ID do seu projeto:resource.type="gce_disk" logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fsystem_event" protoPayload.methodName="ScheduledSnapshots" severity>"INFO"
Clique em Enviar filtro .
Na página Explorador de registros , clique em Criar métrica .
No Editor de Métricas , insira o seguinte:
- Nome :
scheduled_snapshot_failure_count
. - Descrição :
count of scheduled snapshot failures
. - Tipo :
Counter
- Nome :
Em Etiquetas , clique em Adicionar item e insira o seguinte:
- Nome :
status
- Descrição :
status of scheduled snapshot request
- Tipo de rótulo :
String
- Nome do campo :
protoPayload.response.status
- Nome :
Clique em Concluído .
Clique em Criar métrica .
No console do Google Cloud, acesse a página Cloud Logging > Métricas baseadas em registros .
Em Métricas definidas pelo usuário , encontre sua nova métrica chamada
user/scheduled_snapshot_failure_count
.Clique no botão de menu
Mais nesta linha e selecione Criar alerta a partir da métrica . A página de criação de condições de política de alerta é aberta.No painel Destino , em Agregador , selecione nenhum .
Em Filtro :
- Clique em Adicionar um filtro .
- Selecione o status na lista.
- No campo Valor , digite CONCLUÍDO.
- Clique em Aplicar .
Clique em Mostrar opções avançadas .
No painel Agregação avançada , clique na lista Alinhadores e selecione soma .
No painel Configuração , selecione os seguintes valores:
- A condição é acionada se :
Any time series violates
- Condição :
is above
- Limite :
1
- Para :
most recent value
- A condição é acionada se :
Clique em Salvar .
Na página Criar nova política de alertas , insira um nome de política. Opcionalmente, você pode adicionar canais de notificação e documentação para esta política.
Clique em Salvar .
- Saiba mais sobre frequências de agendamento de snapshots, políticas de retenção e regras de nomenclatura em Sobre agendamentos de snapshots para discos .
- Saiba mais sobre instantâneos de disco .
- Aprenda como criar snapshots agendados para discos .
- Saiba como visualizar registros .
REST
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.
Funções e permissões necessárias
Para obter as permissões necessárias para criar uma programação de snapshot, peça ao administrador para conceder a você as seguintes funções do IAM no projeto:
Para obter mais informações sobre a concessão de funções, consulte Gerenciar acesso a projetos, pastas e organizações .
Você também poderá obter as permissões necessárias por meio de funções personalizadas ou outras funções predefinidas .
Crie um filtro de registro
Crie um filtro de log para capturar eventos de snapshot agendados.
Console
Crie uma métrica
Depois de criar o filtro de log, crie uma métrica que conte falhas de snapshot agendadas.
Console
Crie uma política de alerta
Depois de criar a métrica, crie uma política de alerta para enviar um alerta quando houver uma falha de snapshot agendada.
Console
O que vem a seguir
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-04-21 UTC.
-
REST
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.
Funções e permissões necessárias
Para obter as permissões necessárias para criar uma programação de snapshot, peça ao administrador para conceder a você as seguintes funções do IAM no projeto:
Para obter mais informações sobre a concessão de funções, consulte Gerenciar acesso a projetos, pastas e organizações .
Você também poderá obter as permissões necessárias por meio de funções personalizadas ou outras funções predefinidas .
Crie um filtro de registro
Crie um filtro de log para capturar eventos de snapshot agendados.
Console
Crie uma métrica
Depois de criar o filtro de log, crie uma métrica que conte falhas de snapshot agendadas.
Console
Crie uma política de alerta
Depois de criar a métrica, crie uma política de alerta para enviar um alerta quando houver uma falha de snapshot agendada.
Console
O que vem a seguir
Você pode criar uma métrica personalizada para gerar alertas ou fornecer informações para solucionar problemas com snapshots agendados.
Por exemplo, para configurar um alerta para falhas agendadas de snapshots, use o procedimento a seguir:
Antes de começar
-