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 ti consente di selezionare le chiavi di tag dalle tue risorse Amazon EC2 (ad esempio, environment orteam) da utilizzare come dimensioni durante l'analisi dei dati sulla capacità. Dopo l'attivazione di una chiave di tag, puoi raggruppare e filtrare le metriche in base ai valori di quel tag, proprio come puoi fare con la regione, il tipo di istanza o la zona di disponibilità.

Ogni account può monitorare fino a cinque tag key. Manager-provided I tag di capacità non vengono conteggiati ai fini di questo limite.

Manager-provided Tag di capacità

Capacity Manager include un set di tag predefiniti per ogni account. Questi non vengono conteggiati ai fini del limite di tag key. I Manager-provided tag di capacità rappresentano le dimensioni di raggruppamento più utilizzate e includono:

Manager-provided I tag di capacità 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, activating lo stato dei Manager-provided tag di capacità inizia e passa a activated dopo che Capacity Manager riceve il primo data point che include un Manager-provided tag di capacità, in genere entro una o due ore.

Ciclo di vita dei tag

Le chiavi dei tag monitorate passano attraverso i seguenti stati:

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

Attiva e disattiva le chiavi dei tag monitorate

Puoi attivare i tag key per iniziare a monitorarli come dimensioni oppure 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 dei tag monitorati, 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 keys

Utilizzate il seguente comando per attivare uno o più tag key:

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 i tag keys

Usa 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 tutti i tag key monitorati per il tuo account, incluso il loro stato attuale e il primo timestamp a cui sono disponibili i dati.

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 dei tag monitorate, visualizza le chiavi dei tag, il loro stato e se sono Manager-provided tag di capacità.

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 Manager-provided tag Capacity 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 Capacity (true) o un Manager-provided tag gestito dal cliente (). false Manager-provided I tag di capacità non vengono conteggiati ai fini del limite chiave dei tag. EarliestDatapointTimestampIndica il primo momento a partire dal quale i dati sono disponibili per quella chiave del tag.

Metriche di interrogazione che utilizzano le dimensioni dei tag

Dopo che una chiave del tag ha raggiunto activated lo stato, puoi utilizzarla come dimensione in GetCapacityManagerMetricDimensions eGetCapacityManagerMetricData.

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 relativi a tutti i bucket rappresentino l'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 dei dati includono le chiavi dei tag attivate e i Manager-provided tag Capacity come colonne aggiuntive. Le colonne dei tag vengono visualizzate dopo tutte le colonne standard con intestazioni come tag:environment etag:team. Le colonne dei tag sono ordinate alfabeticamente.

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

Organizzazioni e amministratore delegato

Quando il tuo 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 tag keyEarliestDatapointTimestamp.

Un account può richiedere i dati metrici solo per le chiavi di tag che l'account stesso ha attivato. Se sia l'amministratore dell'organizzazione che un amministratore delegato attivano la stessa chiave di tag (ad esempioenvironment), ogni account monitora il proprio stato di attivazione e la disponibilità dei dati in modo indipendente.

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

Considerazioni