

# EC2 Capacity Manager
<a name="capacity-manager"></a>

O Amazon EC2 Gerenciador de Capacidade ajuda você a monitorar, analisar e gerenciar o uso da capacidade em instâncias sob demanda, instâncias spot e reservas de capacidade a partir de um único local. O Capacity Manager simplifica o controle de capacidade por meio de um painel unificado que agrega seus dados de uso com atualizações de hora em hora e oportunidades de otimização.

Projetado para grandes empresas e organizações com várias contas, o Capacity Manager elimina a coleta manual de dados de várias fontes. A ferramenta fornece insights profundos sobre suas Regiões da AWS. É possível detalhar métricas de capacidade detalhadas e tomar medidas imediatas para otimizar seus recursos de nuvem.

Ao habilitar a integração do AWS Organizations, é possível visualizar e analisar os dados de capacidade em todas as contas de membro da sua organização a partir de um único painel. Sem a integração do Organizations, o Capacity Manager monitora apenas os recursos dentro da Conta da AWS individual em que está ativado.

**nota**  
Você só pode ativar o Capacity Manager em uma Região da AWS por conta.
Todos os custos exibidos no Capacity Manager são custos estimados com base nos preços publicados sob demanda. Essas estimativas não incluem descontos como Savings Plans ou instâncias reservadas. Seus custos reais podem diferir dessas estimativas.

## Recursos principais
<a name="capacity-manager-key-features"></a>
+  **Painel centralizado:** visualize o uso da capacidade em todas as contas e regiões com novos pontos de dados atualizados a cada hora
+ **Visibilidade entre contas:** visualização em nível organizacional para contas de administrador
+ **Exportação de dados:** exportação de dados de capacidade para o Amazon S3
+ **APIs:** acesso programático a métricas e dados de capacidade
+ **Análise flexível:** seletor de datas dinâmico para explorar o uso da capacidade em diferentes períodos dos últimos 90 dias
+ **Métricas e dimensões abrangentes:** acesso a mais de 30 métricas em várias unidades de medição (vCPUs, instâncias, custos estimados) com amplos recursos de filtragem, incluindo ID da conta, região, família de instâncias, zona de disponibilidade, tipo de instância, plataforma, locação e dimensões específicas de reservas

# Habilitação do EC2 Capacity Manager
<a name="enable-capacity-manager"></a>

O Capacity Manager pode ser habilitado em dois níveis diferentes, dependendo de suas necessidades. É possível habilitá-lo para que uma única Conta da AWS monitore recursos somente dentro dessa conta, ou integrá-lo ao AWS Organizations para ter visibilidade centralizada em todas as contas de membro em sua organização.
+ **Nível organizacional:** visualize e analise os dados de capacidade em todas as contas de membro da sua organização a partir de um único painel. 
+ **Nível de conta:** monitore o uso da capacidade em uma única Conta da AWS.

**Topics**
+ [Habilitação do EC2 Capacity Manager com o AWS Organizations](enable-capacity-manager-organizations.md)
+ [Habilitação do EC2 Capacity Manager no nível da conta](enable-capacity-manager-account.md)
+ [Registro de um administrador delegado](enable-capacity-manager-da.md)
+ [Uso de perfis vinculados ao serviço do EC2 Capacity Manager](using-service-linked-roles-cm.md)

# Habilitação do EC2 Capacity Manager com o AWS Organizations
<a name="enable-capacity-manager-organizations"></a>

É possível habilitar o EC2 Capacity Manager with AWS Organizations para visibilidade em nível organizacional e gerenciamento de sua capacidade em todas as contas de membro. Essa integração permite monitorar, analisar e gerenciar o uso da capacidade a partir de um local centralizado.

A conta gerencial é responsável por permitir o acesso em nível organizacional e gerenciar a capacidade em toda a organização.

Habilitar o Capacity Manager com o AWS Organizations proporciona os benefícios a seguir:
+ **Visibilidade centralizada da capacidade**: visualize o uso da capacidade em todas as contas de membro da sua organização a partir de um único painel com agregação entre regiões e contas.
+ **Otimização em toda a organização**: identifique reservas de capacidade não utilizadas e oportunidades de otimização em todas as contas da sua organização.
+ **Administrador delegado**: permite que contas de membro específicas gerenciem o Capacity Manager de uma organização, mantendo os controles de acesso adequados.

Se você não habilitar a integração com o AWS Organizations, só poderá monitorar recursos na Conta da AWS individual que habilitou o Capacity Manager.

## Pré-requisitos
<a name="organizations-prerequisites"></a>
+ É necessário ter uma configuração no AWS Organizations com uma conta de gerenciamento e uma ou mais contas de membro. Para obter mais informações sobre os tipos de conta, consulte [Terminologia e conceitos](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html) no *Guia do usuário do AWS Organizations*.
+ A conta gerencial deve ter permissões para as ações do IAM a seguir:
  + `organizations:EnableAwsServiceAccess`
  + `organizations:RegisterDelegatedAdministrator` (se estiver usando administração delegada)
  + `iam:CreateServiceLinkedRole`
+ É necessário criar um perfil vinculado ao serviço com o caso de uso **AWSEC2CapacityManagerServiceRolePolicy** para permitir o acesso ao AWS Organizations. Para obter mais informações, consulte [Criação de um perfil vinculado ao serviço para Capacity Manager](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-service-linked-roles-cm.html#create-slr).

## Habilitação do Capacity Manager com o AWS Organizations
<a name="enable-organization-integration"></a>

Usando a conta gerencial, habilite o acesso da organização no Capacity Manager.

------
#### [ Console ]

**Para habilitar o acesso da organização no Capacity Manager**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. No painel de navegação, selecione **Capacity Manager**.

1. Escolha a guia **Configurações**.

1. Na seção **Acesso confiável**, escolha **Gerenciar acesso confiável**.

1. No prompt exibido, selecione **Habilitar acesso confiável**. Selecione **Salvar**.

------
#### [ AWS CLI ]

**Para habilitar o acesso da organização no Capacity Manager**

1. Criar um perfil vinculado ao serviço

   ```
   aws iam create-service-linked-role --aws-service-name ec2.capacitymanager.amazonaws.com
   ```

1. Habilite o acesso ao AWS Organizations

   ```
   aws organizations enable-aws-service-access --service-principal ec2.capacitymanager.amazonaws.com
   ```

1. Habilite o Capacity Manager com o AWS Organizations 

   ```
   aws ec2 enable-capacity-manager --organizations-access
   ```

Para atualizar o acesso da organização a um Capacity Manager existente, execute o comando a seguir:

```
aws ec2 update-capacity-manager-organizations-access --organizations-access
```

------
#### [ PowerShell ]

**Para habilitar o acesso da organização no Capacity Manager**

1. Crie uma função vinculada a um serviço usando o cmdlet [New-IAMServiceLinkedRole](https://docs.aws.amazon.com/powershell/latest/reference/items/New-IAMServiceLinkedRole.html).

   ```
   New-IAMServiceLinkedRole -AWSServiceName "ec2.capacitymanager.amazonaws.com"
   ```

1. Habilite o acesso à Organização da AWS usando o cmdlet [Enable-ORGAWSServiceAccess](https://docs.aws.amazon.com/powershell/latest/reference/items/Enable-ORGAWSServiceAccess.html).

   ```
   Enable-ORGAWSServiceAccess -ServicePrincipal "ec2.capacitymanager.amazonaws.com"
   ```

1. Habilite o Gerenciador de Capacidade com a Organização da AWS usando o cmdlet [Enable-EC2CapacityManager](https://docs.aws.amazon.com/powershell/latest/reference/items/Enable-EC2CapacityManager.html).

   ```
   Enable-EC2CapacityManager -OrganizationsAccess $true
   ```

Para atualizar o acesso às organizações de um Gerenciador de Capacidade, execute o cmdlet [Update-EC2CapacityManagerOrganizationsAccess](https://docs.aws.amazon.com/powershell/latest/reference/items/Update-EC2CapacityManagerOrganizationsAccess.html):

```
Update-EC2CapacityManagerOrganizationsAccess -OrganizationsAccess $true
```

------

## Verificação se o Capacity Manager está habilitado em sua organização
<a name="verify-organization-integration"></a>

------
#### [ Console ]

**Para verificar se o Capacity Manager está habilitado em sua organização**

1. No console do Capacity Manager, escolha **Configurações**.

1. Na seção **Acesso confiável**, verifique se **Acesso da organização** aparece como **Habilitado**.

1. Verifique se o **ID da organização** exibe o ID da sua organização.

------
#### [ AWS CLI ]

**Para verificar se o Capacity Manager está habilitado em sua organização**  
Execute o seguinte comando:

```
aws ec2 get-capacity-manager-attributes
```

A saída deve exibir:

```
{
    "CapacityManagerStatus": "enabled",
    "OrganizationsAccess": true,
    "IngestionStatus": "initial-ingestion-pending",
    "IngestionStatusMessage": "Capacity Manager is collecting historical data from 2025-10-01T00:00:00Z. Data collection is in progress and may take several hours to complete."
}
```

------
#### [ PowerShell ]

**Para verificar se o Capacity Manager está habilitado em sua organização**  
Use o cmdlet [Get-EC2CapacityManagerAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2CapacityManagerAttribute.html).

```
Get-EC2CapacityManagerAttribute
```

A saída deve exibir:

```
CapacityManagerStatus      : enabled
DataExportCount            : 0
EarliestDatapointTimestamp :
IngestionStatus            : initial-ingestion-in-progress
IngestionStatusMessage     : Capacity Manager is collecting historical data from
                              2026-03-17T16:00:00Z. Data collection is in progress and may take
                              several hours to complete.
LatestDatapointTimestamp   :
OrganizationsAccess        : True
```

------

## Considerações
<a name="organizations-considerations"></a>
+ **Criação de perfil vinculado ao serviço:** quando você habilita o acesso da organização por meio do console, o Gerenciador de Capacidade cria automaticamente o perfil vinculado ao serviço AWSServiceRoleForEC2CapacityManager em todas as contas de membro. Se você habilitar por meio da AWS CLI, deverá chamar `createServiceLinkedRole` manualmente.
+ **Agregação de dados:** depois de habilitar o acesso da organização, o Gerenciador de Capacidade preencherá 14 dias de dados históricos de todas as contas de membros. Normalmente, esse processo leva alguns minutos para ser concluído.
+ **Limitações regionais:** só é possível habilitar o Capacity Manager em uma região por organização, mas ele agregará dados de todas as regiões comerciais.
+ **Permissões:** as contas de membro não precisam realizar nenhuma ação. O Capacity Manager usa o perfil vinculado ao serviço para descobrir automaticamente os recursos em todas as contas.

# Habilitação do EC2 Capacity Manager no nível da conta
<a name="enable-capacity-manager-account"></a>

Habilite o Capacity Manager no nível da conta para monitorar e analisar o uso da capacidade do EC2 em uma única conta da AWS. Depois de habilitá-lo, o Capacity Manager coletará dados sobre suas instâncias sob demanda, instâncias spot e reservas de capacidade para ajudá-lo a identificar oportunidades de otimização e rastrear padrões de uso.

## Habilitação do Capacity Manager no nível da conta
<a name="enable-account-capacity-manager"></a>

------
#### [ Console ]

**Para habilitar o Capacity Manager para sua conta**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. No painel de navegação, selecione **Capacity Manager**.

1. Na página Capacity Manager, escolha **Habilitar na região**.

------
#### [ AWS CLI ]

**Para habilitar o Capacity Manager para sua conta**  
Execute o seguinte comando:

```
aws ec2 enable-capacity-manager
```

------
#### [ PowerShell ]

**Para habilitar o Capacity Manager para sua conta**  
Use o cmdlet [Enable-EC2CapacityManager](https://docs.aws.amazon.com/powershell/latest/reference/items/Enable-EC2CapacityManager.html).

```
Enable-EC2CapacityManager
```

------

**nota**  
Depois de habilitar o Capacity Manager, ele coletará e agregará 14 dias de dados históricos. Esse processo pode levar algumas horas.
Ao coletar seus dados históricos, um estado `initial-ingestion-in-progress` será exibido. Durante esse período de coleta, é possível observar lacunas em seus dados históricos. Quando a coleta de dados for concluída, um estado `ingestion-complete` será exibido.

# Registro de um administrador delegado
<a name="enable-capacity-manager-da"></a>

É possível registrar um administrador delegado para o Capacity Manager. Isso permite que uma conta de membro gerencie o Capacity Manager da sua organização da AWS. Somente a conta gerencial pode remover um administrador delegado na sua organização.

**nota**  
Não é possível desabilitar o Gerenciador de Capacidade para sua organização enquanto houver um administrador delegado registrado. 

**Topics**
+ [Pré-requisitos](#da-prerequisites)
+ [Registro de um administrador delegado](#add-capacity-manager-da)
+ [Para remover um administrador delegado](#remove-capacity-manager-da)

## Pré-requisitos
<a name="da-prerequisites"></a>

Sua conta gerencial deve ter habilitado o Capacity Manager no AWS Organizations. Para obter mais informações, consulte [Habilitação do EC2 Capacity Manager com o AWS Organizations](enable-capacity-manager-organizations.md).

## Registro de um administrador delegado
<a name="add-capacity-manager-da"></a>

É possível registrar um administrador delegado usando o console do Amazon EC2, a AWS CLI ou o PowerShell.

------
#### [ Console ]

**Para registrar um administrador delegado**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. No painel de navegação, selecione **Capacity Manager**.

1. Escolha a guia **Configurações**.

1. Na seção **Administrador delegado**, escolha **Adicionar**.

1. No prompt que será exibido, insira o ID da conta do membro da organização que você deseja adicionar como administrador delegado.

1. Selecione **Add delegated administrator (Adicionar administrador delegado)**.

------
#### [ AWS CLI ]

**Para registrar um administrador delegado**  
Execute o seguinte comando:

```
aws organizations register-delegated-administrator \
    --account-id 123456789012 \
    --service-principal ec2.capacitymanager.amazonaws.com
```

------
#### [ PowerShell ]

**Para registrar um administrador delegado**  
Use o cmdlet [Register-OrgDelegatedAdministrator](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-ORGDelegatedAdministrator.html).

```
Register-ORGDelegatedAdministrator `
    -AccountId "123456789012" `
    -ServicePrincipal "ec2.capacitymanager.amazonaws.com"
```

------

## Para remover um administrador delegado
<a name="remove-capacity-manager-da"></a>

É possível remover um administrador delegado usando o console do Amazon EC2, a AWS CLI ou o PowerShell.

------
#### [ Console ]

**Para remover um administrador delegado**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. No painel de navegação, selecione **Capacity Manager**.

1. Escolha a guia **Configurações**.

1. Na seção **Administrador delegado**, escolha **Gerenciar**.

1. No prompt que será exibido, escolha **Remover administrador delegado**.

------
#### [ AWS CLI ]

**Para remover um administrador delegado**  
Execute o seguinte comando:

```
aws organizations deregister-delegated-administrator \
    --account-id 123456789012 \
    --service-principal ec2.capacitymanager.amazonaws.com
```

------
#### [ PowerShell ]

**Para remover um administrador delegado**  
Use o cmdlet [Unregister-OrgDelegatedAdministrator](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-ORGDelegatedAdministrator.html).

```
Unregister-ORGDelegatedAdministrator `
    -AccountId "123456789012" `
    -ServicePrincipal "ec2.capacitymanager.amazonaws.com"
```

------

# Uso de perfis vinculados ao serviço do EC2 Capacity Manager
<a name="using-service-linked-roles-cm"></a>

O EC2 Capacity Manager usa [perfis vinculados ao serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) do AWS Identity and Access Management (IAM). Um perfil vinculado ao serviço é um tipo exclusivo de perfil do IAM vinculado diretamente ao Capacity Manager. Os perfis vinculados a serviços são predefinidos pelo Capacity Manager e incluem todas as permissões que o serviço requer para chamar outros serviços da AWS em seu nome.

Um perfil vinculado ao serviço facilita a configuração do Gerenciador de Capacidade, pois não é preciso adicionar as permissões necessárias manualmente. O Capacity Manager define as permissões dos perfis vinculados ao serviço e, exceto se definido de outra forma, somente o Capacity Manager pode assumir os perfis. As permissões definidas incluem a política de confiança e a política de permissões, que não pode ser anexada a nenhuma outra entidade do IAM.

Um perfil vinculado ao serviço poderá ser excluído somente após excluir seus atributos relacionados. Isso protege seus recursos do Capacity Manager, pois não é possível remover por engano as permissões para acessar os recursos.

Para mais informações sobre outros serviços que oferecem suporte a funções vinculadas a serviços, consulte os [serviços da AWS compatíveis com o IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) e procure os serviços que apresentam **Sim** na coluna **Perfis vinculados a serviços**. Escolha um **Sim** com um link para visualizar a documentação do perfil vinculado a esse serviço.

## Permissões dos perfis vinculados ao serviço do Capacity Manager
<a name="slr-permissions"></a>

O Capacity Manager usa o perfil vinculado ao serviço denominado **AWSServiceRoleForEC2CapacityManager** para permitir que você gerencie recursos de capacidade e se integrar ao AWS Organizations em seu nome.

O perfil vinculado ao serviço AWSServiceRoleForEC2CapacityManager confia nos serviços a seguir para assumir o perfil:
+ `ec2.capacitymanager.amazonaws.com`

A política de permissões de perfil denominada AWSEC2CapacityManagerServiceRolePolicy permite que o Capacity Manager execute as ações a seguir:
+  `organizations:DescribeOrganization` 
+  `organizations:ListAccounts` 
+  `organizations:ListChildren` 
+  `organizations:ListAWSServiceAccessForOrganization` 
+  `organizations:ListDelegatedAdministrators` 

Você deve configurar permissões para permitir que seus usuários, grupos ou perfis criem, editem ou excluam um perfil vinculado ao serviço. Para obter mais informações, consulte [Permissões do perfil vinculado a serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions) no *Guia do usuário do IAM*.

## Criar um perfil vinculado ao serviço no Capacity Manager
<a name="create-slr"></a>

Também é possível usar o console do IAM para criar um perfil vinculado ao serviço com o caso de uso **AWSEC2CapacityManagerServiceRolePolicy**. Na AWS CLI ou na API do AWS, crie um perfil vinculado a serviço com o nome de serviço `ec2.capacitymanager.amazonaws.com`. Para obter mais informações, consulte [Criar uma função vinculada ao serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#create-service-linked-role) no *Manual do usuário do IAM*. Se você excluir essa função vinculada ao serviço, será possível usar esse mesmo processo para criar a função novamente.

## Edição de um perfil vinculado a serviço no Capacity Manager
<a name="edit-slr"></a>

O Capacity Manager não permite editar o perfil vinculado ao serviço AWSServiceRoleForEC2CapacityManager. Depois que criar um perfil vinculado ao serviço, você não poderá alterar o nome do perfil, pois várias entidades podem fazer referência a ele. No entanto, será possível editar a descrição do perfil usando o IAM. Para saber mais, consulte [Editar um perfil vinculado ao serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role) no *Guia do usuário do IAM*.

## Exclusão de um perfil vinculado a serviço no Capacity Manager
<a name="delete-slr"></a>

Se você não precisar mais usar um atributo ou serviço que requer um perfil vinculado ao serviço, é recomendável excluí-lo. Dessa forma, você não tem uma entidade não utilizada que não seja monitorada ativamente ou mantida. No entanto, você deve limpar os recursos de sua função vinculada ao serviço antes de exclui-la manualmente.

**nota**  
Se o serviço do Capacity Manager estiver usando o perfil quando você tentar excluir os atributos, a exclusão poderá falhar. Se isso acontecer, espere alguns minutos e tente a operação novamente.

**Para remover recursos do Capacity Manager usados por AWSServiceRoleForEC2CapacityManager**

1. Todos os administradores delegados devem ter desabilitado o Capacity Manager antes de remover o acesso da organização.

1. É necessário excluir todas as exportações de dados ativas antes de desabilitar um Capacity Manager.

**Como excluir manualmente o perfil vinculado ao serviço usando o IAM**

Use o console do IAM, a AWS CLI ou a API da AWS para excluir o perfil vinculado ao serviço AWSServiceRoleForEC2CapacityManager. Para saber mais, consulte [Excluir um perfil vinculado ao serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role) no *Guia do usuário do IAM*.

## Regiões com suporte a perfis vinculados ao serviço do Capacity Manager
<a name="slr-regions"></a>

O Capacity Manager oferece suporte ao uso de perfis vinculados ao serviço em todas as regiões em que o serviço estiver disponível. Para obter mais informações, consulte [Regiões e endpoints da AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html).

O Capacity Manager não oferece suporte ao uso de perfis vinculados a serviços em todas as regiões em que o serviço estiver disponível. É possível usar o perfil AWSServiceRoleForEC2CapacityManager nas regiões a seguir.


| Nome da região | Identidade da região | Suporte no Capacity Manager | 
| --- | --- | --- | 
| Leste dos EUA (Norte da Virgínia) | us-east-1 | Sim | 
| Leste dos EUA (Ohio) | us-east-2 | Sim | 
| Oeste dos EUA (N. da Califórnia) | us-west-1 | Sim | 
| Oeste dos EUA (Oregon) | us-west-2 | Sim | 
| África (Cidade do Cabo) | af-south-1 | Não | 
| Ásia-Pacífico (Hong Kong) | ap-east-1 | Não | 
| Ásia-Pacífico (Jacarta) | ap-southeast-3 | Não | 
| Ásia-Pacífico (Mumbai) | ap-south-1 | Sim | 
| Ásia Pacifico (Osaka) | ap-northeast-3 | Sim | 
| Ásia-Pacífico (Seul) | ap-northeast-2 | Sim | 
| Ásia-Pacífico (Singapura) | ap-southeast-1 | Sim | 
| Ásia-Pacífico (Sydney) | ap-southeast-2 | Sim | 
| Ásia-Pacífico (Tóquio) | ap-northeast-1 | Sim | 
| Canadá (Central) | ca-central-1 | Sim | 
| Europa (Frankfurt) | eu-central-1 | Sim | 
| Europa (Irlanda) | eu-west-1 | Sim | 
| Europa (Londres) | eu-west-2 | Sim | 
| Europa (Milão) | eu-south-1 | Não | 
| Europa (Paris) | eu-west-3 | Sim | 
| Europa (Estocolmo) | eu-north-1 | Sim | 
| Oriente Médio (Barém) | me-south-1 | Não | 
| Oriente Médio (Emirados Árabes Unidos) | me-central-1 | Não | 
| América do Sul (São Paulo) | sa-east-1 | Sim | 
| AWS GovCloud (Leste dos EUA) | us-gov-east-1 | Não | 
| AWS GovCloud (Oeste dos EUA) | us-gov-west-1 | Não | 

# Organização dos seus dados no Capacity Manager
<a name="capacity-manager-data-organization"></a>

O Capacity Manager usa uma combinação de métricas, pontos de dados, dimensões, intervalos de datas e períodos para organizar seus dados de capacidade. Isso pode ajudar você a analisar padrões de uso e a tomar decisões informadas sobre seus recursos.

**Métricas e pontos de dados**

Uma métrica representa um conjunto de pontos de dados ordenados por tempo. Por exemplo, se você quiser monitorar seu uso de spot em vCPUs, você usa a métrica `SpotTotalUsageHrsVcpu`.

A cada hora, a métrica gera um ponto de dados com registro de data e hora com o uso do spot em horas de vCPU. Por exemplo, se você usou 100 vCPUs às 10h, o Capacity Manager cria um ponto de dados com um timestamp às 10h e um valor de 100.

Para obter a lista completa de métricas que o Capacity Manager analisa, consulte [Métricas do EC2 Capacity Manager](cm-metrics-units.md).

**Dimensões**

As dimensões são pares de nome e valor que ajudam você a categorizar e identificar diferentes aspectos de uma métrica. Por exemplo, o nome de uma dimensão no Capacity Manager é AccountID, em que o valor é o ID real da conta. O Capacity Manager fornece dimensões para segmentar e agrupar seus dados, como família de instâncias, ARN da reserva, tipo de reserva e locação.

Para ver a lista completa de dimensões, consulte [Métricas do EC2 Capacity Manager](cm-metrics-units.md).

**Intervalo de datas e período**

O intervalo de datas especifica quanto tempo você deseja analisar, de uma hora a 90 dias. O período determina como o Capacity Manager agrega seus dados ao longo do tempo e quantos pontos de dados devem ser retornados. Por exemplo, se seu intervalo de datas for de uma semana e seu período for de 1 dia, o Capacity Manager retornará 7 pontos de dados. Cada ponto de dados representa um dia de dados agregados. O período deve ter um intervalo de uma hora e ser dividido uniformemente no intervalo de datas.

**Topics**
+ [Métricas do EC2 Capacity Manager](cm-metrics-units.md)
+ [Agrupamento e filtragem de dados](grouping-filtering-data.md)

# Métricas do EC2 Capacity Manager
<a name="cm-metrics-units"></a>

O Capacity Manager oferece uma seleção abrangente de métricas para monitorar sua capacidade em diferentes tipos de recursos. As métricas podem ser medidas usando unidades diferentes, dependendo de suas necessidades de análise.

Os nomes das métricas no Capacity Manager usam quatro prefixos diferentes para categorizar o tipo de capacidade que está sendo medida:
+ `Reservation`: as próprias reservas de capacidade, incluindo a capacidade reservada total, as taxas de utilização, a capacidade não utilizada e as contagens de reservas. 
+ `Reserved`: o uso de instâncias sob demanda coberto por suas reservas de capacidade. 
+ `Unreserved`: o uso de instâncias sob demanda que ocorre fora de quaisquer reservas de capacidade. 
+ `Spot`: especificamente para uso de instâncias spot, incluindo o tempo de execução e custos estimados. Essas métricas são separadas da capacidade baseada em reservas.

A tabela a seguir também fornece as *dimensões disponíveis* para cada métrica. As categorias de dimensões são divididas da forma a seguir:
+ **Dimensões gerais da capacidade**: ID da conta, região, família de instâncias, zona de disponibilidade, tipo de instância, plataforma e locação
+ **Dimensões da reserva de capacidade**: ID da reserva (ID da reserva de capacidade), ARN da reserva, proprietário financeiro não utilizado, tipo de reserva (ODCR/bloco de capacidade), timestamp de criação, timestamp de início, timestamp de término, estado e critérios de correspondência de instância.
+ **Dimensões de uso reservado**: ID da reserva (CRID), ARN da reserva, tipo de reserva


| Métrica | Descrição | Dimensões disponíveis | Unidades disponíveis | 
| --- | --- | --- | --- | 
| ReservationAvgCommittedSize | A quantidade média total de capacidade em um estado ativo ou programado com um compromisso. O tamanho é somado em todas as dimensões e calculado em média ao longo do tempo. | Capacidade geral e dimensões de reserva de capacidade | vCPU, instância | 
| ReservationAvgFutureSize | A quantidade média de reservas de capacidade que estão programadas para serem iniciadas no futuro, mas que ainda não se tornaram ativas durante o período selecionado. O tamanho é somado em todas as dimensões e calculado em média ao longo do tempo. | Capacidade geral e dimensões de reserva de capacidade | vCPU, instância | 
| ReservationAvgUtilization | O percentual médio da sua capacidade reservada que foi usada durante o período selecionado. | Capacidade geral e dimensões de reserva de capacidade | vCPU, instância | 
| ReservationMaxCommittedSize | A capacidade total máxima em um estado ativo ou programado com um compromisso. O tamanho é somado entre as dimensões e o valor máximo é considerado para o período. | Capacidade geral e dimensões de reserva de capacidade | vCPU, instância | 
| ReservationMaxFutureSize | A quantidade máxima de reservas de capacidade que estão programadas para serem iniciadas no futuro, mas que ainda não se tornaram ativas durante o período selecionado. O tamanho é somado entre as dimensões e o valor máximo é considerado para o período. | Capacidade geral e dimensões de reserva de capacidade | vCPU, instância | 
| ReservationMaxSize | O tamanho máximo que sua reserva de capacidade atingiu em qualquer momento durante o período selecionado. É necessário um ID de reserva. | Capacidade geral e dimensões de reserva de capacidade | vCPU, instância | 
| ReservationMaxUnusedSize | A quantidade máxima de capacidade não utilizada em sua Reserva de Capacidade em qualquer momento durante o período selecionado. É necessário um ID de reserva. | Capacidade geral e dimensões de reserva de capacidade | vCPU, instância | 
| ReservationMaxUtilization | O percentual máximo de utilização que sua Reserva de Capacidade alcançou em qualquer momento durante o período selecionado. É necessário um ID de reserva. | Capacidade geral e dimensões de reserva de capacidade |  | 
| ReservationMinCommittedSize | A quantidade mínima total de capacidade em um estado ativo ou programado com um compromisso. O tamanho é somado entre as dimensões e o valor mínimo é considerado para o período. | Capacidade geral e dimensões de reserva de capacidade | vCPU, instância | 
| ReservationMinFutureSize | A quantidade mínima de reservas de capacidade que estão programadas para serem iniciadas no futuro, mas que ainda não se tornaram ativas a qualquer momento durante o período selecionado. O tamanho é somado entre as dimensões e o valor mínimo é considerado para o período. | Capacidade geral e dimensões de reserva de capacidade | vCPU, instância | 
| ReservationMinSize | O tamanho mínimo que sua reserva de capacidade atingiu em qualquer momento durante o período selecionado. É necessário um ID de reserva. | Capacidade geral e dimensões de reserva de capacidade | vCPU, instância | 
| ReservationMinUnusedSize | A quantidade mínima de capacidade não utilizada em sua Reserva de Capacidade em qualquer momento durante o período selecionado. É necessário um ID de reserva. | Capacidade geral e dimensões de reserva de capacidade | vCPU, instância | 
| ReservationMinUtilization | O percentual mínimo de utilização que sua Reserva de Capacidade alcançou em qualquer momento durante o período selecionado. É necessário um ID de reserva. | Capacidade geral e dimensões de reserva de capacidade |  | 
| ReservationTotalCapacityHrs | Quantidade total de capacidade que você reservou por meio de reservas de capacidade durante o período selecionado. | Capacidade geral e dimensões de reserva de capacidade | vCPU, instância | 
| ReservationTotalCount | O número total de diferentes reservas de capacidade que você teve durante o período selecionado. | Capacidade geral e dimensões de reserva de capacidade |  | 
| ReservationTotalEstimatedCost | Custo estimado do total de horas de capacidade reservadas durante o período selecionado. | Capacidade geral e dimensões de reserva de capacidade  |  | 
| ReservationUnusedTotalCapacityHrs | Quantidade total de capacidade reservada que você tinha, mas não usou, durante o período selecionado. | Capacidade geral e dimensões de reserva de capacidade | vCPU, instância | 
| ReservationUnusedTotalEstimatedCost | Custo estimado da capacidade reservada que você tinha, mas não usou, durante o período selecionado (calculado usando tarifas sob demanda). | Capacidade geral e dimensões de reserva de capacidade |  | 
| ReservedTotalEstimatedCost | Custo estimado do uso da instância sob demanda que foi coberto por uma reserva de capacidade durante o período selecionado. Isso exclui o uso de spot. | Capacidade geral e dimensões de uso reservado |  | 
| ReservedTotalUsageHrs | Total de horas de uso da instância sob demanda que foram cobertas por uma reserva de capacidade durante o período selecionado. Isso exclui o uso de spot. | Capacidade geral e dimensões de uso reservado | vCPU, instância | 
| SpotAvgRunTimeBeforeInterruption | Runtime médio, em horas, para instâncias interrompidas no período selecionado. | Somente dimensões de região, AZ e ID da conta | Instância | 
| SpotInterruptionRate | Porcentagem de instâncias spot em execução que foram interrompidas no período selecionado. | Somente dimensões de região, AZ e ID da conta | vCPU, instância | 
| SpotMaxRunTimeBeforeInterruption | Runtime máximo, em horas, para instâncias interrompidas no período selecionado. | Somente dimensões de região, AZ e ID da conta | Instância | 
| SpotMinRunTimeBeforeInterruption | Runtime mínimo, em horas, para instâncias interrompidas no período selecionado. | Somente dimensões de região, AZ e ID da conta | Instância | 
| SpotTotalCount | Número de instâncias spot ou vCPUs que foram executadas durante o período selecionado. | Somente dimensões de região, AZ e ID da conta | vCPU, instância | 
| SpotTotalEstimatedCost | Custo estimado do uso da instância spot durante o período selecionado (calculado usando taxas spot publicadas). | Dimensões gerais da capacidade |  | 
| SpotTotalInterruptions | Número de instâncias spot ou vCPUs interrompidas durante o período selecionado. | Somente dimensões de região, AZ e ID da conta | vCPU, instância | 
| SpotTotalUsageHrs | Total de horas de uso da instância spot durante o período selecionado. | Dimensões gerais da capacidade | vCPU, instância | 
| UnreservedTotalEstimatedCost | Custo estimado do uso da instância sob demanda que não foi coberto por uma reserva de capacidade durante o período selecionado. Isso exclui o uso de spot. | Dimensões gerais da capacidade |  | 
| UnreservedTotalUsageHrs | Total de horas de uso da instância sob demanda que não foram cobertas por uma reserva de capacidade durante o período selecionado. Isso exclui o uso de spot. | Dimensões gerais da capacidade | vCPU, instância | 

**nota**  
Se você incluir instâncias em suas unidades, recomendamos incluir o tipo de instância em suas dimensões.

# Agrupamento e filtragem de dados
<a name="grouping-filtering-data"></a>

O Capacity Manager agrega suas métricas com base nas dimensões e no período de datas que você escolher. Se nenhuma dimensão for selecionada, o Gerenciador de Capacidade agrega os dados e retorna um ponto de dados por período no intervalo de datas. É possível agrupar seus dados em agregações menores adicionando dimensões.
+ **Agrupamento**: divide seus dados de capacidade por dimensões, como região, família de instâncias ou ID da conta. É possível agrupar suas métricas por várias dimensões para detalhar ainda mais seus dados. Por exemplo, se você agrupar por região e zona de disponibilidade, obterá um ponto de dados para cada combinação de região e zona de disponibilidade em que você tiver utilização.
+ **Filtragem**: mostra somente subconjuntos específicos das dimensões que você selecionou. Por exemplo, se você agrupar por família de instâncias, obterá pontos de dados para todas as famílias em que você tiver utilização. No entanto, se você também filtrar por p5, verá somente pontos de dados para a família de instâncias p5.
+ **Unidades métricas**: exibe os resultados por unidades diferentes, como vCPUs, instâncias ou custos estimados. Por exemplo, depois de agrupar por região e filtrar por uma família de instâncias específica, é possível visualizar os dados de maneiras diferentes. Alterne entre o total de vCPUs usadas, o número de instâncias em execução ou os custos estimados. 

## Como agrupar e filtrar dados no console
<a name="grouping-filtering-process"></a>

**Para agrupar e filtrar dados no Capacity Manager**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. No painel de navegação, selecione **Capacity Manager**.

1. Escolha a guia do tipo de recurso que você deseja analisar: **Uso**, **Reservas** ou **Spot**.

1. Na seção **Filtro de data**, escolha um intervalo de datas, fuso horário e intervalo.

1. Na seção **Filtro de dimensão**, escolha uma dimensão no menu suspenso *Selecionar uma dimensão*.

1. Selecione as dimensões pelas quais você deseja agrupar no menu suspenso. Observe que as opções de dimensão são diferentes para cada tipo de recurso. Para obter mais informações, consulte [Métricas do EC2 Capacity Manager](cm-metrics-units.md).

   É possível adicionar várias dimensões para criar agrupamentos mais granulares.

1. Para filtrar pelas dimensões selecionadas, escolha uma opção de filtro no menu suspenso *Filtrar por dimensão*.

1. Na seção **Agregações**, escolha uma unidade para visualizar seus resultados por vCPUs, instâncias ou custos estimados.

# Navegando pelo Capacity Manager no console da AWS
<a name="capacity-manager-console"></a>

O console do Capacity Manager é organizado em guias que fornecem visualizações diferentes dos seus dados de capacidade:
+ **Painel**: fornece uma visão geral de alto nível de todas as reservas de capacidade sob demanda, do uso sob demanda e no local, incluindo as principais métricas e os principais alertas para ajudar a melhorar sua postura de capacidade.
+ **Uso**: fornece uma visão geral dos padrões de uso da sua instância para instâncias sob demanda e spot. Analise a cobertura por reservas de capacidade e identifique oportunidades de otimização por meio de agrupamento e filtragem flexíveis.
+ **Reservas**: fornece análise da utilização da reserva de capacidade, recursos de gerenciamento e métricas detalhadas de reservas em todas as contas e regiões.
+ **Spot**: monitora os padrões de uso de spot e fornece análise de custos para instâncias spot em todas as contas e regiões.
+ **Exportações de dados**: gerencia a configuração de exportação de dados para o Amazon S3, incluindo agendamento, formatação e seleção de modelos.
+ **Configurações**: fornece opções de configuração de serviços, incluindo acesso à organização e configurações regionais.

Nas guias Uso e Reservas, o Capacity Manager fornece uma estrutura de navegação hierárquica que permite detalhar desde visões gerais de alto nível até informações detalhadas sobre recursos. A compreensão desse padrão de navegação ajuda você a analisar seus dados de capacidade com eficiência e identificar oportunidades de otimização.

**Topics**
+ [Hierarquia de navegação](#navigation-hierarchy)
+ [Exibição de detalhamento e detalhes de Uso e Reservas](#navigation-page-breakdown)

## Hierarquia de navegação
<a name="navigation-hierarchy"></a>

O Capacity Manager usa uma estrutura de navegação de três níveis para Uso e Reservas:

1. **Página de visão geral**: resumo de alto nível com métricas agregadas.

1. **Página de detalhamento**: análise detalhada com opções de filtragem e agrupamento

1. **Páginas de detalhes:**
   + Detalhes de uso: informações sobre a combinação de dimensões selecionada, que fornecem estatísticas e dados de séries temporais para ajudá-lo a entender os padrões de uso. 
   + Detalhes da reserva: informações sobre uma reserva de capacidade específica, incluindo estatísticas de utilização, padrões de uso ao longo do tempo e detalhes de configuração.

**nota**  
O spot segue uma estrutura simplificada com apenas a página de visão geral.

## Exibição de detalhamento e detalhes de Uso e Reservas
<a name="navigation-page-breakdown"></a>

As guias Uso e Reservas seguem a mesma estrutura de navegação de três níveis, permitindo que você avance da visão geral às páginas de detalhamento e detalhes. Os processos para acessar as páginas de detalhamento e detalhes são semelhantes, com apenas pequenas diferenças na localização dos links de navegação em cada guia.

**Para acessar as páginas de detalhamento dos recursos**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. No painel de navegação, selecione **Capacity Manager**.

1. Escolha a guia do tipo de recurso que você deseja analisar: **Uso** ou **Reservas**.

1. Na seção **Agregações**, localize o link de detalhamento:
   + **Uso**: na coluna **Ações**, escolha **Exibir detalhamento**.
**nota**  
Dependendo do tamanho da tela ou do número de dimensões aplicadas, talvez seja necessário rolar horizontalmente pela página para encontrar o link Exibir detalhamento.
   + **Reservas**: na coluna **Reservas**, escolha o número (o número é um link) da reserva que você deseja exibir.

**Para acessar as páginas de detalhes**

1. Na página de detalhamento, navegue até a seção relevante:
   + **Uso**: a seção Combinações de dimensões exclusivas.
   + **Reservas**: a seção Reservas.

1. Na seção relevante dos recursos escolhidos, acesse a página de detalhes.
   + **Uso**: na coluna Ações, escolha **Exibir detalhes**.
**nota**  
Dependendo do tamanho da tela ou do número de dimensões aplicadas, talvez seja necessário rolar horizontalmente pela página para encontrar o link Exibir detalhes.
   + **Reservas**: na coluna ID da reserva, escolha a reserva que você deseja exibir.

# Exportação dos seus dados do Capacity Manager
<a name="exporting-cm-data"></a>

É possível exportar dados de capacidade do EC2 Capacity Manager para o Amazon S3 para permitir análises adicionais, criar relatórios personalizados ou integrar-se a outros serviços da AWS. É possível exportar seus dados no formato CSV ou Parquet. Nas seções a seguir, você encontrará informações sobre como exportar seus dados do Capacity Manager.

**nota**  
O Capacity Manager permite apenas uma exportação de dados por Conta da AWS.

**Topics**
+ [Configuração de um bucket do Amazon S3 para exportações de dados](cm-set-up-s3-export.md)
+ [Criação de uma exportação de dados para seus dados do Capacity Manager](create-cm-export.md)

# Configuração de um bucket do Amazon S3 para exportações de dados
<a name="cm-set-up-s3-export"></a>

Para receber exportações de dados do Capacity Manager, você precisa ter um bucket do Amazon S3 em sua Conta da AWS para receber e armazenar seus arquivos de exportação. Ao criar uma exportação de dados no console do Capacity Manager, é possível selecionar um bucket do Amazon S3 existente que você possui ou criar um novo bucket.

Em ambos os casos, é necessário aplicar a política de bucket necessária para permitir que o Capacity Manager forneça arquivos de exportação. Editar essa política no console do Amazon S3 ou alterar o proprietário do bucket depois de criar uma exportação de dados impedirá que o Capacity Manager entregue suas exportações.

Para criar um bucket do Amazon S3, consulte [Criação de um bucket do S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) no *Guia do usuário do Amazon Simple Storage Service*. 

A política a seguir deve ser aplicada ao seu bucket do S3 para permitir que o Capacity Manager forneça exportações de dados:

```
{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "ec2.capacitymanager.amazonaws.com"
            },
            "Action": [
                "s3:PutObject",
                "s3:GetObject",
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket",
                "arn:aws:s3:::amzn-s3-demo-bucket/*"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "111122223333"
                },
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:ec2:us-east-1:111122223333:capacity-manager-data-export/*"
                }
            }
        }
    ]
}
```

Essa política de bucket ajuda a garantir que os arquivos de exportação de dados do Capacity Manager possam ser entregues com segurança ao seu bucket. Especificamente:
+ Sempre que uma exportação de dados do Capacity Manager é entregue, a AWS primeiro confirma se o bucket ainda pertence à conta que configurou a exportação. Se a propriedade do bucket tiver sido alterada, a exportação não será entregue. Isso ajuda a garantir a segurança dos dados do Capacity Manager. Essa política de bucket permite que a AWS (`"Effect": "Allow"`) verifique qual conta é proprietária do bucket (`"Action": ["s3:ListBucket"]`).
+ A política concede ao serviço do Capacity Manager (`"Service": "ec2.capacitymanager.amazonaws.com"`) permissão para gravar arquivos de exportação (`"Action": "s3:PutObject"`) e ler objetos (`"Action": "s3:GetObject"`) para copiar dados para seu bucket.

# Criação de uma exportação de dados para seus dados do Capacity Manager
<a name="create-cm-export"></a>

Para criar uma exportação de dados, é possível usar a página Exportações de dados no console do Capacity Manager ou a AWS CLI.

## Pré-requisitos
<a name="cm-export-prerequisites"></a>

É necessário criar um bucket do Amazon Simple Storage Service (Amazon S3). Certifique-se dos pontos a seguir:
+ O bucket do S3 deve estar na mesma Região da AWS em que você habilitou o Capacity Manager. 
+ Seu bucket do S3 deve ter a política de permissões necessária para que o serviço Capacity Manager entregue arquivos. 

Para obter mais informações, consulte [Configuração de um bucket do Amazon S3 para exportações de dados](cm-set-up-s3-export.md).

## Procedimento
<a name="cm-export-procedure"></a>

Você pode exportar os dados do Gerenciador de Capacidade usando o Console da AWS, a AWS CLI ou o PowerShell.

------
#### [ Console ]

**Para criar uma exportação de dados**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. No painel de navegação, selecione **Capacity Manager**.

1. Escolha a guia **Exportações de dados**.

1. Escolha **Criar exportação de dados**.

1. Configure as propriedades de exportação, o local de entrega e as etiquetas (opcional).

1. Escolha **Criar**.

------
#### [ AWS CLI ]

**Para criar uma exportação de dados**  
Use o comando a seguir para criar uma exportação de dados com a configuração especificada:

```
aws ec2 create-capacity-manager-data-export \
    --s3-bucket-name my-exports-bucket \
    --s3-bucket-prefix capacity-data-exports \
    --schedule hourly \
    --output-format parquet/CSV \
    --tag-specifications 'ResourceType=capacity-manager-data-export,Tags=[{Key=environment,Value=production}]'
```

------
#### [ PowerShell ]

**Para criar uma exportação de dados**  
Use o cmdlet [New-EC2CapacityManagerDataExport](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2CapacityManagerDataExport.html).

```
New-EC2CapacityManagerDataExport `
    -S3BucketName "my-exports-bucket" `
    -S3BucketPrefix "capacity-data-exports" `
    -Schedule "hourly" `
    -OutputFormat "parquet" `
    -TagSpecification @([Amazon.EC2.Model.TagSpecification]@{
        ResourceType = "capacity-manager-data-export"
        Tags = @([Amazon.EC2.Model.Tag]@{
            Key   = "environment"
            Value = "production"
        })
    })
```

------