View a markdown version of this page

Risoluzione dei problemi Parameter Store - AWS Systems Manager

• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la documentazione di Amazon CloudWatch Dashboard.

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à.

Risoluzione dei problemi Parameter Store

Utilizza le informazioni seguenti per risolvere i problemi relativi al Parameter Store.

Risoluzione dei problemi di throughput

Utilizza le seguenti informazioni per risolvere i problemi di throughput in. Parameter Store Per informazioni sulle quote di throughput e sui motivi per cui si verifica la limitazione, consulta. Ottimizzazione della produttività in Parameter Store

Ricevute o errori dell'applicazione ThrottlingException RateExceeded

Problema: i log o CloudWatch i log dell'applicazione mostrano un errore come il seguente durante la chiamataGetParameter,GetParameters, oppureGetParametersByPath:

An error occurred (ThrottlingException) when calling the GetParameters operation (reached max retries: 4): Rate exceeded
  • Soluzione: questo errore indica che la frequenza combinata delle chiamate per queste azioni API ha superato la quota di throughput dell'account corrente. Regione AWS Esegui una o più delle seguenti azioni:

    • Riduci la frequenza delle chiamate dell'applicazioneParameter Store. Memorizza nella cache i valori dei parametri nell'applicazione anziché recuperarli a ogni chiamata o richiesta.

      Per ulteriori informazioni, consulta Parameters and Secrets Lambda Extension e Utilizzo dell'estensione Parameter and Secrets Lambda per memorizzare nella cache AWS parametri e segreti.

    • GetParametersConsente di recuperare più nomi di parametri noti in una singola chiamata, anziché GetParameter effettuare chiamate separate o una chiamata. GetParametersByPath

    • Stagger legge quando molte istanze, contenitori o funzioni vengono avviate contemporaneamente, ad esempio durante una distribuzione o un evento di scalabilità.

    • Se l'applicazione utilizza modelli di richiesta efficienti e continua a generare errori di limitazione, abilita un throughput più elevato per il tuo account e. Regione AWS Puoi abilitare e disabilitare un throughput più elevato in qualsiasi momento. Il costo è determinato dall'utilizzo. Per ulteriori informazioni, consulta Prezzi di AWS Systems Manager per Parameter Store.

La limitazione si verifica solo sulle chiamate DescribeParameters

Problema: la tua applicazione riceve un ThrottlingException errore durante DescribeParameters le chiamate, anche se le tue GetParameterGetParameters, e GetParametersByPath le chiamate non superano la quota.

  • Soluzione: DescribeParameters ha un limite di throughput separato rispetto alle altre azioni di recupero dei parametri: 3 TPS per impostazione predefinita o 10 TPS con un throughput più elevato abilitato. Effettuare meno GetParameter GetParametersByPath chiamate o effettuare meno chiamate non GetParameters influisce su questo limite.

    Una causa comune è la chiamata DescribeParameters con un filtro su un account con un numero elevato di parametri. L'API esamina tutti i parametri dell'account prima di applicare il filtro. Gli account con molti parametri possono superare la DescribeParameters quota anche quando il set di risultati filtrato è piccolo.

    Ove possibile, utilizzalo GetParametersByPath in base a una gerarchia specifica anziché DescribeParameters con un filtro. Puoi anche ridurre la frequenza delle DescribeParameters chiamate negli script e nelle automazioni eseguiti in base a una pianificazione.

Nessun errore di limitazione, ma la latenza aumenta durante le distribuzioni

Problema: non viene visualizzato alcun ThrottlingException errore nei log, ma l'applicazione presenta una latenza elevata o errori intermittenti durante le distribuzioni, i riavvii o gli eventi di scalabilità.

  • Soluzione: se l'applicazione o l'SDK riprova automaticamente le richieste limitate, un nuovo tentativo può avere esito positivo senza che si verifichi un errore di limitazione. Se la latenza aumenta, controlla il numero di tentativi nei log o nelle metriche del tuo SDK. Un numero di tentativi diverso da zero nelle Parameter Store chiamate durante questi eventi indica che ti stai avvicinando alla tua quota di throughput, anche senza che si verifichi un errore. Applica le stesse tecniche di ottimizzazione descritte in Ottimizzazione della produttività in Parameter Store per ridurre i tentativi prima che si trasformino in errori.

Risoluzione dei problemi relativi alla creazione dei parametri aws:ec2:image

Utilizzare le seguenti informazioni per risolvere i problemi relativi alla creazione di parametri del tipo di dati aws:ec2:image.

Nessuna autorizzazione a creare un'istanza

Problema: si tenta di creare un'istanza utilizzando un parametro ,aws:ec2:image ma viene visualizzato un messaggio di errore del tipo “Non si è autorizzati a eseguire questa operazione”.

  • Soluzione: non disponi di tutte le autorizzazioni necessarie per creare un'istanza EC2 utilizzando un valore di parametro, come quelle per ec2:RunInstances, ec2:DescribeImages e ssm:GetParameter, tra gli altri. Contatta un utente IAM con autorizzazioni di amministratore all'interno dell'organizzazione per richiedere le autorizzazioni necessarie.

EventBridge riporta il messaggio di errore «Impossibile descrivere la risorsa»

Problema: è stato eseguito un comando per creare un parametro aws:ec2:image, ma la creazione dei parametri non è riuscita. Ricevi una notifica da Amazon EventBridge che riporta l'eccezione «Impossibile descrivere la risorsa».

Soluzione: questo messaggio può indicare quanto segue:

  • Non disponi di tutte le autorizzazioni necessarie per l'operazione API ec2:DescribeImages oppure non disponi dell'autorizzazione per accedere all'immagine specifica a cui si fa riferimento nel parametro. Contatta un utente IAM con autorizzazioni di amministratore all'interno dell'organizzazione per richiedere le autorizzazioni necessarie.

  • L'ID Amazon Machine Image (AMI) immesso come valore di parametro non è valido. Assicurati di inserire l'ID di un AMI utente disponibile nell'account corrente Regione AWS e in cui lavori.

Il nuovo parametro aws:ec2:image non è disponibile

Problema: hai appena eseguito un comando per creare un parametro aws:ec2:image ed è stato indicato un numero di versione, ma il parametro non è disponibile.

  • Soluzione: quando si esegue il comando per creare un parametro che utilizza il tipo di dati aws:ec2:image, viene generato immediatamente un numero di versione per il parametro, ma il formato del parametro deve essere convalidato prima che il parametro sia disponibile. Questo processo può richiedere alcuni minuti. Per monitorare il processo di creazione e la convalida dei parametri, è possibile effettuare le seguenti operazioni:

    • EventBridge Usalo per inviarti notifiche sulle tue operazioni e sui parametricreate. update Queste notifiche segnalano se un'operazione con parametro ha avuto esito positivo o meno. Per informazioni sulla sottoscrizione agli Parameter Store eventi in EventBridge, consultaImpostazione delle notifiche o delle azioni di attivazione basate su Parameter Store eventi.

    • Nella sezione Parameter Store della console Systems Manager aggiornare periodicamente l'elenco dei parametri per ricercare i dettagli dei parametri nuovi o aggiornati.

    • Utilizzare il comando GetParameter per verificare il parametro nuovo o aggiornato. Ad esempio, utilizzando l' AWS Command Line Interface (AWS CLI):

      aws ssm get-parameter name MyParameter

      Per un nuovo parametro, viene restituito un messaggio ParameterNotFound fino a quando il parametro non viene convalidato. Per un parametro esistente che si sta aggiornando, le informazioni sulla nuova versione non vengono incluse fino a quando il parametro non viene convalidato.

    Se si tenta di creare o aggiornare nuovamente il parametro prima del completamento del processo di convalida, il sistema segnala che la convalida è ancora in corso. Se il parametro non viene creato o aggiornato, è possibile riprovare dopo 5 minuti dal primo tentativo.