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

Gestione delle chiavi dei tag monitorate

Amazon EC2 Capacity Manager consente di selezionare le chiavi di tag dalle risorse Amazon EC2 (ad esempioenvironment, team o) da utilizzare come dimensioni durante l'analisi dei dati di capacità. Dopo aver attivato un tag key, puoi raggruppare e filtrare le metriche in base ai valori di quel tag, proprio come puoi fare con Regione, Tipo di istanza o Zona di disponibilità.

Ogni account può monitorare fino a cinque chiavi di tag. I tag forniti da Capacity Manager non vengono conteggiati ai fini di questo limite.

Tag forniti da Capacity Manager

Capacity Manager include un set di tag predefiniti per ogni account. Questi non vengono conteggiati ai fini del limite di tag key. I tag forniti da Capacity Manager rappresentano le dimensioni di raggruppamento di uso comune e includono:

I tag forniti da Capacity Manager vengono visualizzati GetCapacityManagerMonitoredTagKeys con CapacityManagerProvided impostato su true e non possono essere attivati o disattivati dal cliente. Quando Capacity Manager viene abilitato per la prima volta, i tag forniti da Capacity Manager iniziano con activating lo stato e passano a activated dopo che Capacity Manager riceve il primo punto dati che include un tag fornito da Capacity Manager, in genere entro una o due ore.

Ciclo di vita dei tag

Le chiavi dei tag monitorate avanzano attraverso i seguenti stati:

Quando un tag è in suspended stato, GetCapacityManagerMonitoredTagKeys restituisce il seguente messaggio di stato: «Tag sospeso a causa di troppi valori dei tag. Riduci l'utilizzo del tag o disattivalo».

Attiva e disattiva le chiavi dei tag monitorate

Puoi attivare i tag key per iniziare a monitorarli come dimensioni o disattivare i tag key che non ti servono più. L'attivazione è asincrona: il tag entra in uno activating stato e passa a activated dopo che Capacity Manager inizia a ricevere i dati per quel tag. La disattivazione rimuove la chiave del tag dal set monitorato.

Console

Per attivare o disattivare le chiavi dei tag monitorate

1. Apri la console Amazon EC2 all'indirizzo https://console.aws.amazon.com/ec2/.

2. Nel riquadro di navigazione, scegli Capacity Manager.

3. Seleziona la scheda Impostazioni.

4. Nella sezione Chiavi tag monitorate, scegli Gestisci le chiavi dei tag.

5. Per attivare un tag key, inserisci il nome del tag key e scegli Aggiungi. Per disattivare un tag key, seleziona il tag key e scegli Rimuovi.

6. Scegli Save changes (Salva modifiche).

AWS CLI

Per attivare i tag key

Utilizzate il seguente comando per attivare una o più chiavi di tag:

aws ec2 update-capacity-manager-monitored-tag-keys \
    --activate-tag-keys "environment" "teamId"
                

L'output mostra le chiavi dei tag e i loro stati iniziali:

{
    "CapacityManagerTagKeys": [
        {
            "TagKey": "environment",
            "Status": "activating"
        },
        {
            "TagKey": "teamId",
            "Status": "activating"
        }
    ]
}

Per disattivare le chiavi dei tag

Utilizzate il seguente comando per disattivare una o più chiavi di tag:

aws ec2 update-capacity-manager-monitored-tag-keys \
    --deactivate-tag-keys "project"
                

L'output mostra gli stati aggiornati:

{
    "CapacityManagerTagKeys": [
        {
            "TagKey": "project",
            "Status": "deactivating"
        }
    ]
}

Puoi attivare e disattivare le chiavi dei tag nella stessa richiesta:

aws ec2 update-capacity-manager-monitored-tag-keys \
    --activate-tag-keys "environment" "teamId" \
    --deactivate-tag-keys "project"
                

Visualizza le chiavi dei tag monitorate

Puoi visualizzare tutte le chiavi dei tag monitorate per il tuo account, incluso il loro stato attuale e il primo timestamp a partire dal quale i dati sono disponibili.

Console

Per visualizzare le chiavi dei tag monitorate

1. Apri la console Amazon EC2 all'indirizzo https://console.aws.amazon.com/ec2/.

2. Nel riquadro di navigazione, scegli Capacity Manager.

3. Seleziona la scheda Impostazioni.

4. Nella sezione Chiavi tag monitorate, visualizza le chiavi dei tag, i relativi stati e se si tratta di tag forniti da Capacity Manager.

AWS CLI

Per visualizzare le chiavi dei tag monitorate

Esegui il comando seguente:

aws ec2 get-capacity-manager-monitored-tag-keys
                

L'output elenca tutte le chiavi dei tag, inclusi i tag forniti da Capacity Manager e i tag gestiti dal cliente:

{
    "CapacityManagerTagKeys": [
        {
            "TagKey": "aws:autoscaling:groupName",
            "Status": "activated",
            "CapacityManagerProvided": true,
            "earliestDatapointTimestamp": "2026-04-08T00:00:00"
        },
        {
            "TagKey": "environment",
            "Status": "activated",
            "CapacityManagerProvided": false,
            "earliestDatapointTimestamp": "2025-08-11T22:00:00"
        }
    ]
}

Il CapacityManagerProvided campo indica se un tag è un tag fornito da Capacity Manager (true) o un tag gestito dal cliente (). false I tag forniti da Capacity Manager non vengono conteggiati ai fini del limite di tag chiave. EarliestDatapointTimestampIndica il primo momento a partire dal quale i dati sono disponibili per quella chiave di tag.

Interroga le metriche utilizzando le dimensioni dei tag

Dopo che una chiave di tag ha raggiunto activated lo stato, puoi usarla come dimensione in GetCapacityManagerMetricDimensions andGetCapacityManagerMetricData.

Per interrogare le metriche raggruppate in base a una dimensione del tag

Utilizza il seguente comando:

aws ec2 get-capacity-manager-metric-dimensions \
    --group-by tag:environment account-id \
    --filter-by 'DimensionCondition={Dimension=tag:environment,Comparison=equals,Values=[prod]}'
          

Quando esegui il raggruppamento in base a una dimensione del tag, i risultati includono tutte le risorse del tuo account, non solo quelle che hanno il tag. Le risorse che non hanno un valore per il tag vengono raggruppate in un bucket separato con un valore di stringa vuoto. Ad esempio, se il tuo account ha utilizzato 800 ore di vCPU in un determinato periodo e solo alcune di queste risorse hanno un environment tag, il raggruppamento in base alla chiave del environment tag potrebbe restituire:

Ciò garantisce che i totali di tutti i bucket tengano conto dell'utilizzo completo. Puoi filtrare in modo esplicito le risorse senza tag passando una stringa vuota come valore del filtro:

--filter-by 'DimensionCondition={Dimension=tag:environment,Comparison=equals,Values=[""]}'
          

Tag nelle esportazioni di dati

Quando abiliti il monitoraggio dei tag, le esportazioni di dati includono le chiavi dei tag attivate e i tag forniti da Capacity Manager come colonne aggiuntive. Le colonne di tag vengono visualizzate dopo tutte le colonne standard con intestazioni come e. tag:environment tag:team Le colonne dei tag sono ordinate alfabeticamente.

Le esportazioni includono solo i tag nello stato. activated Capacity Manager esclude i activating tag o deactivating lo suspended stato.

Organizzazioni e amministratore delegato

Quando l'account fa parte di un' AWS organizzazione con un Capacity Manager a livello di organizzazione abilitato, ogni account (l'amministratore dell'organizzazione e l'amministratore delegato) può attivare, disattivare e interrogare le chiavi dei tag in modo indipendente. Ogni account mantiene il proprio stato di tag e il proprio limite di chiavi di tag. EarliestDatapointTimestamp

Un account può solo interrogare i dati metrici relativi alle chiavi dei tag che l'account stesso ha attivato. Se sia l'amministratore dell'organizzazione che un amministratore delegato attivano lo stesso tag key (ad esempio,environment), ogni account tiene traccia del proprio stato di attivazione e della disponibilità dei dati in modo indipendente.

Quando l'amministratore delegato disattiva una chiave di tag, l'amministratore delegato non può più interrogare i dati per quel tag, anche se l'amministratore dell'organizzazione ha ancora la stessa chiave di tag attivata.

Considerazioni