Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Monitora la soluzione ## Registrazione e notifiche Instance Scheduler utilizza la registrazione strutturata ottimizzata per le query di CloudWatch Logs Insights. Questa soluzione registra le informazioni di elaborazione per ogni istanza con tag, i risultati della valutazione del periodo per l'istanza, lo stato desiderato dell'istanza durante quel periodo, l'azione applicata e i messaggi di debug. I log vengono scritti su Amazon CloudWatch Logs in due gruppi di log: `{stackName}-{namespace}-administrative-logs` Registri per la registrazione e l'annullamento della registrazione delle risorse, le operazioni personalizzate sulle risorse, le richieste CLI e altre attività amministrative. `{stackName}-{namespace}-scheduling-logs` Registri per le operazioni di pianificazione, tra cui l'orchestrazione e l'esecuzione del gestore delle richieste. I log di avvisi ed errori vengono inoltre inoltrati a un argomento Amazon SNS creato dalla soluzione, che può essere configurato per inviare messaggi a un indirizzo e-mail sottoscritto. Puoi trovare il nome dell'argomento Amazon SNS nella scheda **Output dello stack** di soluzioni. ## Tag informativi Quando il tagging informativo è abilitato (impostazione predefinita), Instance Scheduler scrive i tag direttamente nelle risorse gestite per fornire at-a-glance visibilità sull'attività di pianificazione della soluzione. Questi tag vengono applicati utilizzando l'API AWS Resource Groups Tagging e vengono aggiornati ogni volta che lo scheduler elabora una risorsa. Puoi abilitare o disabilitare questa funzionalità utilizzando il parametro **Enable informational tagging** nello stack dell'hub. Per ulteriori informazioni, consulta [Aggiornare le impostazioni di configurazione globali](update-global-configuration-settings.md). ### Chiavi per i tag informativi I seguenti tag vengono scritti nelle risorse gestite: | Chiave tag | Description | | --- | --- | | `IS-ManagedBy` | L'ARN dello stack di hub Instance Scheduler che gestisce questa risorsa. Applicato quando una risorsa viene registrata per la prima volta per la pianificazione e a ogni azione di pianificazione successiva. | | `IS-LastAction` | L'ultima azione di pianificazione eseguita sulla risorsa, insieme a un timestamp UTC. Ad esempio: `Started 2025-06-15 09:00:00 UTC` o `Stopped 2025-06-15 17:00:00 UTC`. Questo tag viene aggiornato solo quando lo scheduler avvia o arresta attivamente una risorsa (non quando valuta una risorsa e determina che non è necessaria alcuna azione). | | `IS-Error` | Se lo scheduler riscontra un errore durante l'elaborazione di una risorsa, questo tag contiene il codice di errore e un timestamp UTC. Ad esempio: `StartFailed 2025-06-15 09:00:05 UTC`. Questo tag viene cancellato automaticamente alla successiva azione di pianificazione riuscita. | | `IS-ErrorMessage` | Una descrizione dell'errore leggibile dall'uomo. Questo tag è presente solo quando `IS-Error` è presente e viene cancellato insieme ad esso. | ### Codici di errore Nel `IS-Error` tag possono apparire i seguenti codici di errore: | Codice di errore | Description | | --- | --- | | `UnknownSchedule` | Il nome della pianificazione specificato nel tag di pianificazione della risorsa non corrisponde a nessuna pianificazione definita nella tabella di configurazione. | | `UnsupportedResource` | Il tipo di risorsa non è supportato per la pianificazione (ad esempio, una replica di lettura di un'altra istanza RDS). | | `IncompatibleSchedule` | La pianificazione assegnata alla risorsa non è compatibile con il tipo di risorsa (ad esempio, una pianificazione ASG che utilizza espressioni cron non supportate). | | `StartFailed` | Lo scheduler ha tentato di avviare la risorsa ma l'operazione non è riuscita. | | `StopFailed` | Lo scheduler ha tentato di arrestare la risorsa, ma l'operazione non è riuscita. | | `ConfigurationFailed` | Lo scheduler ha tentato di configurare le regole di scalabilità pianificate su un gruppo Auto Scaling, ma l'operazione non è riuscita. | | `UnknownError` | Si è verificato un errore imprevisto durante l'elaborazione della risorsa. | ### Comportamento dei tag + Quando una risorsa viene registrata per la prima volta per la pianificazione, il `IS-ManagedBy` tag viene applicato immediatamente. + Quando una risorsa viene annullata (il tag di pianificazione viene rimosso), tutti i tag informativi (`IS-ManagedBy`,, `IS-LastAction``IS-Error`,`IS-ErrorMessage`) vengono rimossi dalla risorsa. + I tag di errore non vengono riscritti su ogni intervallo di pianificazione se lo stesso errore persiste e il tag esistente è ancora presente sulla risorsa. Vengono aggiornati solo quando il codice di errore cambia. + Tutti i valori dei tag vengono troncati a 256 caratteri per rispettare i limiti di tagging di AWS. ### Considerazioni sulla governance dei tag **Importante** Instance Scheduler crea e aggiorna i tag sopra elencati sulle risorse gestite come parte del normale funzionamento. Se la tua organizzazione applica la governance dei tag tramite regole AWS Config, policy di tag, policy di controllo dei servizi o correzione automatica, assicurati che i controlli di gestione delle modifiche siano configurati per consentire le seguenti chiavi di tag: `IS-ManagedBy` `IS-LastAction` `IS-Error` `IS-ErrorMessage` `IS-PreferredInstanceTypes`(se si utilizzano tipi di istanze alternativi) `IS-MinDesiredMax`(se si pianificano gruppi di Auto Scaling) Se non riesci a inserire questi tag nelle tue politiche di governance, disabilita i tag informativi impostando il parametro **Enable informational tagging** su nello stack dell'hub. `No` Tieni presente che ciò disabiliterà anche il `IS-ManagedBy` tag utilizzato per confermare la registrazione delle risorse. ### Tag di controllo Oltre ai tag informativi, Instance Scheduler utilizza i seguenti tag di controllo per funzionalità specifiche: | Chiave tag | Description | | --- | --- | | `IS-PreferredInstanceTypes` | Un elenco separato da virgole di tipi di istanze EC2 alternativi da provare all'avvio di un'istanza ha esito negativo a causa della capacità insufficiente. Per ulteriori informazioni, consulta [Gestione degli errori di capacità insufficiente di EC2](specifying-alternate-instance-types-for-ec2.md). | | `IS-MinDesiredMax` | I valori di capacità minima, desiderata e massima per un gruppo Auto Scaling nel formato. `min,desired,max` Per ulteriori informazioni, consulta [EC2 Auto Scaling](ec2-auto-scaling-group-scheduling.md) Group Scheduling. | ### Capacità dei tag **Importante** Le risorse AWS hanno in genere un limite di 50 tag per risorsa. Instance Scheduler può utilizzare fino a 6 tag su una risorsa (4 tag informativi più un massimo di 2 tag di controllo). Assicurati che le tue risorse abbiano una capacità di tag sufficiente per includere i tag di Instance Scheduler insieme alla tua strategia di tagging esistente. Se una risorsa raggiunge o si avvicina al limite di 50 tag, la scrittura dei tag informativi potrebbe non riuscire. Lo scheduler registra questi errori ma continua le operazioni di pianificazione. Controlla i CloudWatch registri se sospetti problemi di etichettatura. ## CloudWatch Richieste di Logs Insights Il formato di registrazione strutturato di Instance Scheduler consente di eseguire interrogazioni efficienti utilizzando Logs Insights. CloudWatch È possibile utilizzare Logs Insights per cercare, analizzare e visualizzare i dati di registro per risolvere problemi operativi e monitorare l'attività di pianificazione. Instance Scheduler fornisce query di registro preformattate a cui puoi accedere dalla sezione Query salvate della console Logs: CloudWatch `SchedulingHistory` Azioni di pianificazione delle query eseguite sulle risorse, incluse le operazioni di avvio e arresto. `RegistrationEvents` Eventi di registrazione e cancellazione delle risorse di interrogazione. `Errors` Interroga i log degli errori per risolvere i problemi relativi alla soluzione. Per ulteriori informazioni su CloudWatch Logs Insights, consulta la sezione [Analyzing log data with CloudWatch Logs Insights nella *Amazon CloudWatch Logs*](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) User Guide. ## Dashboard di analisi operative La dashboard Operational Insights offre visibilità sulle prestazioni della soluzione e sui risparmi sui costi derivanti dalla gestione pianificata delle istanze. Per accedere alla dashboard, assicurati che **Operational Monitoring** sia impostato su «abilitato» nei parametri dello stack dell'hub. Vai a «Dashboard» CloudWatch e seleziona «Dashboards» dal menu di navigazione. Il nome del pannello di controllo è *\* {stack-name} -Operational-Insights-Dashboard\**. La dashboard mostra il numero di istanze gestite, le ore di esecuzione risparmiate e le metriche delle prestazioni della funzione Lambda. **Panoramica del dashboard di Operational Insights** ![OpsDashboardOverview](http://docs.aws.amazon.com/it_it/solutions/latest/instance-scheduler-on-aws/images/OpsDashboardOverview.png) **Nota** Le informazioni contenute in questi grafici dipendono dall'intervallo di pianificazione configurato nello stack del Solution Hub. Quando si aggiorna l'intervallo di pianificazione della soluzione, la dashboard mostrerà solo le metriche di pianificazione successive all'aggiornamento più recente dell'intervallo di pianificazione. Monitora i tempi di esecuzione di Lambda per garantire prestazioni ottimali (vedi [Quote](solution-quotas.md)). Se i tempi di esecuzione si avvicinano costantemente alla soglia di timeout, valuta la possibilità di aumentare la proprietà Lambda size o di implementare Instance Scheduler in una regione con una latenza inferiore rispetto alle aree gestite. **Metriche Lambda che mostrano la durata e il conteggio degli errori** ![OpsDashboardLambdaMetrics](http://docs.aws.amazon.com/it_it/solutions/latest/instance-scheduler-on-aws/images/OpsDashboardLambdaMetrics.png) ### Costi aggiuntivi associati a questa funzionalità Questa dashboard operativa si basa su CloudWatch metriche personalizzate raccolte dalla soluzione che comporteranno costi aggiuntivi. Questa funzionalità può essere disattivata disabilitando il «Monitoraggio operativo» nello stack dell'hub della soluzione. Questa funzionalità costa 3,00 USD aggiuntivi al mese più costi di scalabilità aggiuntivi in base alle dimensioni dell'implementazione. I costi sono i seguenti: | CloudWatch Dashboard personalizzata | $3 | | --- | --- | | Per-instance-type metriche | 0,90 USD per tipo di istanza\* | | Utilizzo delle API | [\~$0,10 per target attivo\*\*](cost.md#calculating-scheduling-targets) | ***\*Questi costi vengono registrati per categoria di servizio (EC2/RDS) e solo per i tipi di esempio effettivamente utilizzati per la pianificazione.*** ** **\*** ## Monitoraggio degli eventi EventBridge Instance Scheduler pubblica eventi di pianificazione e registrazione su bus di EventBridge eventi per fornire visibilità sulle operazioni della soluzione e consentire l'integrazione con altri servizi AWS. ### Event types (Tipi di evento) La soluzione pubblica due categorie principali di eventi: **Eventi di pianificazione**: pubblicato quando Instance Scheduler interviene per avviare, arrestare o configurare le risorse gestite. Questi eventi includono dettagli sull'istanza, sulla pianificazione e sulle azioni intraprese. Avvia, arresta o configura le risorse gestite. Questi eventi includono dettagli sull'istanza, sulla pianificazione e sull'azione intrapresa. **Eventi di registrazione**: pubblicati quando le risorse vengono registrate o non registrate per la pianificazione in base alle operazioni di etichettatura. ### Destinazioni degli eventi **IS- LocalEvents Event Bus**: un bus di `IS-LocalEvents` eventi viene distribuito in ogni regione gestita di ogni account membro (incluso l'account hub). Ogni bus riceve eventi per la pianificazione delle azioni e delle registrazioni delle risorse all'interno di quella regione. **IS- GlobalEvents Event Bus**: l'`IS-GlobalEvents`event bus nell'account dell'hub riceve una copia di ogni evento inviata a qualsiasi `IS-LocalEvents` bus di eventi, fornendo un monitoraggio centralizzato su tutti gli account e le regioni. ### Utilizzo EventBridge degli eventi Puoi creare EventBridge regole per: + Monitora le operazioni di pianificazione nell'intera infrastruttura + Attiva notifiche quando le istanze vengono avviate o interrotte + Integrazione con altri servizi AWS per flussi di lavoro automatizzati + Implementa il monitoraggio e gli avvisi di conformità ### Struttura degli eventi Tutti gli eventi utilizzano il EventBridge formato standard. Gli esempi seguenti mostrano la struttura per ogni tipo di evento: **Pianificazione dell'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 di registrazione:** ``` { "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" } } ``` Ogni evento contiene i seguenti campi chiave: + `Source`- Identifica l'origine dell'evento come «instance-scheduler» + `DetailType`- Speciifica la categoria dell'evento: «Scheduling Action» per esempio operazioni o «Resource Registered» per etichettare gli eventi + `Resources`- Array contenente ARNs le risorse AWS interessate + `Detail`- Contiene il payload dell'evento con l'ID dell'account, la regione, il tipo di servizio (ec2/rds), l'ID della risorsa, il nome della pianificazione e, per la pianificazione degli eventi, l'azione richiesta e il risultato effettivo Valori possibili `requested_action` per la pianificazione degli eventi: + `Start`: Scheduler destinato ad avviare l'istanza + `Stop`: Scheduler destinato a fermare l'istanza + `Configure`: Scheduler destinato a configurare l'istanza `action_taken`Valori possibili per la pianificazione degli eventi: + `Started`: L'istanza è stata avviata + `Stopped`: L'istanza è stata interrotta + `Hibernated`: L'istanza è stata ibernata + `Configured`: la configurazione dell'istanza è stata modificata + `Error`: si è verificato un errore durante l'operazione di pianificazione ### Creazione di regole EventBridge Per monitorare gli eventi di Instance Scheduler: 1. Accedi alla EventBridge console nel tuo account AWS 1. Crea una nuova regola per il bus degli `IS-GlobalEvents` eventi (per il monitoraggio centralizzato) o il bus degli `IS-LocalEvents` eventi (per il monitoraggio locale) 1. Definisci modelli di eventi in modo che corrispondano agli eventi di Instance Scheduler 1. Configura obiettivi come argomenti SNS, funzioni Lambda o log CloudWatch Per ulteriori informazioni su EventBridge, consulta [What is Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) nella *Amazon EventBridge User Guide*.