View a markdown version of this page

Monitorar a solução - Agendador de instâncias na AWS

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Monitorar a solução

Registro em log e notificações

O Instance Scheduler usa registros estruturados otimizados para consultas do CloudWatch Logs Insights. Esta solução registra em log as informações de processamento de cada instância marcada, os resultados da avaliação do período da instância, o estado desejado da instância durante esse período, a ação aplicada e as mensagens de depuração.

Os registros são gravados no Amazon CloudWatch Logs em dois grupos de registros:

{stackName}-{namespace}-administrative-logs

Registros para registro e cancelamento de registro de recursos, operações personalizadas de recursos, solicitações de CLI e outras atividades administrativas.

{stackName}-{namespace}-scheduling-logs

Registros para operações de agendamento, incluindo orquestração e execução do manipulador de solicitações.

Os registros de aviso e erro também são encaminhados para um tópico do Amazon SNS criado pela solução, que pode ser configurado para enviar mensagens para um endereço de e-mail inscrito. Você pode encontrar o nome do tópico do Amazon SNS na guia Saídas da pilha de soluções.

Etiquetas informativas

Quando a marcação informativa está ativada (o padrão), o Instance Scheduler grava tags diretamente nos recursos gerenciados para fornecer at-a-glance visibilidade da atividade de agendamento da solução. Essas tags são aplicadas usando a API AWS Resource Groups Tagging e são atualizadas sempre que o programador processa um recurso.

Você pode ativar ou desativar esse recurso usando o parâmetro Enable informational tagging na pilha do hub. Para obter mais informações, consulte Atualizar as configurações globais.

Chaves de etiquetas informativas

As seguintes tags são gravadas em recursos gerenciados:

Chave de tag Description

IS-ManagedBy

O ARN da pilha de hubs do Instance Scheduler que gerencia esse recurso. Aplicado quando um recurso é registrado pela primeira vez para agendamento e em cada ação de agendamento subsequente.

IS-LastAction

A última ação de agendamento realizada no recurso, junto com um carimbo de data/hora UTC. Por exemplo: Started 2025-06-15 09:00:00 UTC ou Stopped 2025-06-15 17:00:00 UTC. Essa tag só é atualizada quando o agendador inicia ou interrompe ativamente um recurso (não quando avalia um recurso e determina que nenhuma ação é necessária).

IS-Error

Se o agendador encontrar um erro ao processar um recurso, essa tag conterá o código do erro e um carimbo de data/hora UTC. Por exemplo: StartFailed 2025-06-15 09:00:05 UTC. Essa tag é automaticamente apagada na próxima ação de agendamento bem-sucedida.

IS-ErrorMessage

Uma descrição do erro legível por humanos. Essa tag só está presente quando também IS-Error está presente e é limpa ao lado dela.

Códigos de erro

Os seguintes códigos de erro podem aparecer na IS-Error tag:

Código de erro Description

UnknownSchedule

O nome do agendamento especificado na tag de agendamento do recurso não corresponde a nenhum agendamento definido na tabela de configuração.

UnsupportedResource

O tipo de recurso não é suportado para agendamento (por exemplo, uma réplica de leitura de outra instância do RDS).

IncompatibleSchedule

A agenda atribuída ao recurso não é compatível com o tipo de recurso (por exemplo, uma agenda ASG que usa expressões cron não suportadas).

StartFailed

O programador tentou iniciar o recurso, mas a operação falhou.

StopFailed

O programador tentou interromper o recurso, mas a operação falhou.

ConfigurationFailed

O programador tentou configurar regras de escalonamento agendado em um grupo de Auto Scaling, mas a operação falhou.

UnknownError

Ocorreu um erro inesperado ao processar o recurso.

Comportamento de tags

  • Quando um recurso é registrado pela primeira vez para agendamento, a IS-ManagedBy tag é aplicada imediatamente.

  • Quando o registro de um recurso é cancelado (a tag de agendamento é removida), todas as tags informativas (IS-ManagedBy,, IS-LastActionIS-Error,IS-ErrorMessage) são removidas do recurso.

  • As tags de erro não são reescritas em cada intervalo de agendamento se o mesmo erro persistir e a tag existente ainda estiver presente no recurso. Eles só são atualizados quando o código de erro é alterado.

  • Todos os valores de tag são truncados para 256 caracteres para cumprir os limites de marcação da AWS.

Marque considerações sobre governança

Importante

O Instance Scheduler cria e atualiza as tags listadas acima nos recursos gerenciados como parte da operação normal. Se sua organização aplica a governança de tags por meio de regras do AWS Config, políticas de tags, políticas de controle de serviços ou remediação automática, certifique-se de que seus controles de gerenciamento de alterações estejam configurados para permitir as seguintes chaves de tag:

  • IS-ManagedBy

  • IS-LastAction

  • IS-Error

  • IS-ErrorMessage

  • IS-PreferredInstanceTypes(se estiver usando tipos de instância alternativos)

  • IS-MinDesiredMax(se estiver agendando grupos de Auto Scaling)

Se você não conseguir acomodar essas tags em suas políticas de governança, desative a marcação informativa definindo o parâmetro Enable informational tagging como No on the hub stack. Observe que isso também desativará a IS-ManagedBy tag usada para confirmar o registro do recurso.

Etiquetas de controle

Além das tags informativas, o Instance Scheduler usa as seguintes tags de controle para recursos específicos:

Chave de tag Description

IS-PreferredInstanceTypes

Uma lista separada por vírgulas de tipos alternativos de instância do EC2 a serem testados ao iniciar uma instância falha devido à capacidade insuficiente. Para obter mais informações, consulte Como lidar com erros de capacidade insuficiente do EC2.

IS-MinDesiredMax

Os valores de capacidade mínima, desejada e máxima para um grupo de Auto Scaling no formato. min,desired,max Para obter mais informações, consulte EC2 Auto Scaling Group Scheduling.

Capacidade da etiqueta

Importante

Os recursos da AWS normalmente têm um limite de 50 tags por recurso. O Instance Scheduler pode usar até 6 tags em um recurso (4 tags informativas mais até 2 tags de controle). Garanta que seus recursos tenham capacidade de tags suficiente para acomodar as tags do Instance Scheduler junto com sua estratégia de marcação existente.

Se um recurso estiver no limite de 50 tags ou próximo a ele, as gravações de tags informativas podem falhar. O agendador registra essas falhas, mas continua programando as operações. Verifique CloudWatch os registros se você suspeitar de problemas de marcação.

CloudWatch Consultas do Logs Insights

O formato de registro estruturado do Instance Scheduler permite consultas eficientes usando o CloudWatch Logs Insights. Você pode usar o Logs Insights para pesquisar, analisar e visualizar dados de registro para solucionar problemas operacionais e monitorar a atividade de agendamento.

O Instance Scheduler fornece consultas de registro pré-formatadas que você pode acessar na seção Consultas salvas no console de registros: CloudWatch

SchedulingHistory

Consulte as ações de agendamento realizadas nos recursos, incluindo operações de início e término.

RegistrationEvents

Consulte eventos de registro e cancelamento de registro de recursos.

Errors

Consulte os registros de erros para solucionar problemas com a solução.

Para obter mais informações sobre o CloudWatch Logs Insights, consulte Análise de dados de log com o CloudWatch Logs Insights no Guia do usuário do Amazon CloudWatch Logs.

Painel de insights operacionais

O painel Operational Insights fornece visibilidade sobre o desempenho da solução e a economia de custos com o gerenciamento programado de instâncias.

Para acessar o painel, certifique-se de que o monitoramento operacional esteja definido como “ativado” nos parâmetros da pilha do hub. Navegue até “Painéis” CloudWatch e selecione “Painéis” no menu de navegação. O nome do painel é * {stack-name} -Operational-Insights-Dashboard*.

O painel exibe contagens de instâncias gerenciadas, horas de execução economizadas e métricas de desempenho da função Lambda.

Visão geral do painel de insights operacionais

OpsDashboardOverview
nota

As informações nesses gráficos dependem do intervalo de agendamento configurado na pilha do hub de soluções. Ao atualizar o intervalo de agendamento da solução, o painel exibirá somente as métricas de agendamento geradas após a atualização mais recente até o intervalo de agendamento.

Monitore os tempos de execução do Lambda para garantir o desempenho ideal (consulte Cotas). Se os tempos de execução se aproximarem consistentemente do limite de tempo limite, considere aumentar a propriedade de tamanho do Lambda ou implantar o Instance Scheduler em uma região com menor latência em suas regiões gerenciadas.

Métricas do Lambda mostrando a duração e as contagens de erros

OpsDashboardLambdaMetrics

Custos adicionais associados a esse recurso

Esse painel operacional é alimentado por CloudWatch métricas personalizadas coletadas pela solução que incorrerão em custos adicionais. Esse recurso pode ser desativado desabilitando o “Monitoramento operacional” na pilha do hub de soluções. Esse recurso custa mais USD 3,00/mês, além de custos adicionais de escalabilidade com base no tamanho da sua implantação. Os custos são o seguinte:

CloudWatch Painel personalizado $3

Per-instance-type métricas

0,90 USD por tipo de instância*

Uso da API

~0,10 USD por alvo ativo**

*Esses custos são monitorados por categoria de serviço (EC2/RDS) e somente para os tipos de instância realmente usados para agendamento.

*

EventBridge Eventos de monitoramento

O Instance Scheduler publica eventos de agendamento e registro em barramentos de EventBridge eventos para fornecer visibilidade das operações da solução e permitir a integração com outros serviços da AWS.

Tipos de eventos

A solução publica duas categorias principais de eventos:

Eventos de agendamento: publicados quando o Instance Scheduler age para iniciar, interromper ou configurar recursos gerenciados. Esses eventos incluem detalhes sobre a instância, o cronograma e a ação realizada. Iniciar, interromper ou configurar recursos gerenciados. Esses eventos incluem detalhes sobre a instância, o cronograma e a ação tomada.

Eventos de registro: publicados quando os recursos são registrados ou não registrados para agendamento com base nas operações de marcação.

Destinos de eventos

IS- LocalEvents barramentos de eventos: um barramento de IS-LocalEvents eventos é implantado em cada região gerenciada de cada conta membro (incluindo a conta do hub). Cada ônibus recebe eventos para agendar ações e cadastros de recursos dentro daquela região.

IS- barramento de GlobalEvents eventos: o barramento de IS-GlobalEvents eventos na conta do hub recebe uma cópia de cada evento enviada para qualquer barramento de IS-LocalEvents eventos, fornecendo monitoramento centralizado em todas as contas e regiões.

Usando EventBridge eventos

Você pode criar EventBridge regras para:

  • Monitore as operações de agendamento em toda a sua infraestrutura

  • Acione notificações quando as instâncias forem iniciadas ou interrompidas

  • Integre-se com outros serviços da AWS para fluxos de trabalho automatizados

  • Implemente monitoramento e alertas de conformidade

Estrutura de eventos

Todos os eventos usam o EventBridge formato padrão. Os exemplos a seguir mostram a estrutura de cada tipo de evento:

Agendamento de evento:

{ "Source": "instance-scheduler", "DetailType": "Scheduling Action", "Resources": ["arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0"], "Detail": { "account": "123456789012", "region": "us-east-1", "service": "ec2", "resource_id": "i-1234567890abcdef0", "requested_action": "Start", "action_taken": "Started", "schedule": "office-hours" } }

Evento de inscrição:

{ "Source": "instance-scheduler", "DetailType": "Resource Registered", "Resources": ["arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0"], "Detail": { "account": "123456789012", "region": "us-east-1", "service": "ec2", "resource_id": "i-1234567890abcdef0", "schedule": "office-hours" } }

Cada evento contém esses campos principais:

  • Source- Identifica a origem do evento como “agendador de instâncias”

  • DetailType- Especifica a categoria do evento: “Ação de agendamento” para operações de exemplo ou “Recurso registrado” para marcar eventos

  • Resources- Matriz contendo os recursos afetados ARNs da AWS

  • Detail- Contém a carga útil do evento com ID da conta, região, tipo de serviço (ec2/rds), ID do recurso, nome da agenda e, para agendar eventos, tanto a ação solicitada quanto o resultado real

requested_actionValores possíveis para agendamento de eventos:

  • Start: Agendador destinado a iniciar a instância

  • Stop: Agendador destinado a interromper a instância

  • Configure: Agendador destinado a configurar a instância

action_takenValores possíveis para agendamento de eventos:

  • Started: A instância foi iniciada

  • Stopped: A instância foi interrompida

  • Hibernated: A instância foi hibernada

  • Configured: a configuração da instância foi modificada

  • Error: ocorreu um erro durante a operação de agendamento

Criação de EventBridge regras

Para monitorar eventos do Instance Scheduler:

  1. Navegue até o EventBridge console em sua conta da AWS

  2. Crie uma nova regra direcionada ao barramento de IS-GlobalEvents eventos (para monitoramento centralizado) ou ao barramento de IS-LocalEvents eventos (para monitoramento local)

  3. Defina padrões de eventos que correspondam aos eventos do Instance Scheduler

  4. Configure destinos como tópicos do SNS, funções Lambda ou registros CloudWatch

Para obter mais informações sobre EventBridge, consulte O que é a Amazon EventBridge? no Guia do EventBridge usuário da Amazon.