AWS HubAWS HubSão Paulo operando · 2 eventos no mundo

Fatura e impostosComunidade

Nível de dificuldade: Avançado (4 de 5)

Como caçar volumes EBS órfãos na AWS com um script Boto3 de FinOps

Por AWS Hub6 min de leitura

Um relato técnico publicado no dev.to mostra como volumes EBS desanexados, staging ligado 24 horas e instâncias superdimensionadas inflam a fatura da AWS sem ninguém perceber. A seguir, o passo a passo para montar sua própria auditoria com Boto3, do script básico até a limpeza segura dos recursos de teste.

Em números

  • 51%: queda na fatura mensal de uma plataforma SaaS depois da faxina de infraestrutura, de $8.400 para $4.100 por mês
  • $48.000: economia anual estimada mantendo o mesmo padrão de uso
  • 240 ms: latência média depois do cache de borda, vindo de 1,8 segundo
  • 18%: carga média do banco de dados após as otimizações, ante 85% antes

Os números vêm de um relato técnico publicado no dev.to, na coluna #aws, descrevendo uma auditoria de custos num ambiente real. O autor não identifica a empresa, mas detalha de onde saiu a gordura: volumes EBS que sobraram depois de instâncias terminadas, ambiente de staging rodando 24 horas por dia, instâncias EC2 maiores do que o necessário e queries de banco sem cache.

A parte que interessa pra quem opera a conta AWS no dia a dia não é o resultado financeiro, e sim o processo: como automatizar essa auditoria em vez de caçar desperdício manualmente no console a cada fechamento de fatura. É isso que este tutorial constrói, a partir do script que o autor publicou.

O que você vai construir

Um script em Python com boto3 que varre uma conta AWS (e, com uma extensão simples, várias contas de uma AWS Organizations) atrás de volumes EBS no estado available, ou seja, volumes que existem, estão sendo cobrados por GB-mês, mas não estão anexados a nenhuma instância EC2.

O script evolui em três camadas:

  1. Auditoria somente leitura (lista os volumes órfãos e o custo potencial)
  2. Snapshot de segurança antes de qualquer remoção
  3. Exclusão controlada, com flag explícita e confirmação

Quem fecha a fatura da AWS no fim do mês e precisa justificar pro financeiro por que o custo subiu sem motivo aparente ganha, com isso, uma rotina programada em vez de uma investigação manual.

Pré-requisitos

  • Conta AWS com acesso programático (access key ou perfil configurado via aws configure)
  • Python 3.9 ou superior e o pacote boto3 instalado
  • Uma política IAM com, no mínimo, estas ações:
  • ec2:DescribeVolumes
  • ec2:DescribeSnapshots
  • ec2:CreateSnapshot
  • ec2:DeleteVolume
  • ec2:CreateTags
  • sts:AssumeRole (só se for auditar múltiplas contas da Organizations)
  • AWS CLI instalada, para validar os achados do script com aws ec2 describe-volumes
  • Uma conta de teste ou um ambiente de sandbox: não rode a versão de exclusão pela primeira vez direto em produção

O exemplo original do autor usa a região us-east-1. Para quem opera no Brasil, o script funciona do mesmo jeito apontando para sa-east-1; o parâmetro region já existe na função por esse motivo.

Passo a passo

Passo 1. Instale o boto3 num ambiente isolado.

bash
python3 -m venv finops-audit
source finops-audit/bin/activate
pip install boto3

Passo 2. Configure um perfil de credenciais dedicado à auditoria, para não misturar com outras automações.

bash
aws configure --profile finops-audit

Passo 3. Escreva a função de auditoria. Esta é a base publicada no relato original, levemente reorganizada:

python
import boto3

def audit_unattached_ebs(region="sa-east-1"):
 ec2 = boto3.client("ec2", region_name=region)
 volumes = ec2.describe_volumes(
 Filters=[{"Name": "status", "Values": ["available"]}]
 ).get("Volumes", [])

 print(f"[{region}] Found {len(volumes)} unattached volume(s):")
 for vol in volumes:
 print(f" - {vol['VolumeId']} | {vol['Size']} GiB ({vol['VolumeType']})")
 return volumes

if __name__ == "__main__":
 audit_unattached_ebs()

O ponto central é o filtro status=available. Na API do EC2, um volume anexado aparece como in-use; available é justamente o estado de um volume que existe, ocupa espaço, é cobrado por GB-mês, e não está fazendo nada.

Passo 4. Estenda para várias regiões em loop, porque volume órfão não se limita à região default do perfil:

python
REGIONS = ["sa-east-1", "us-east-1", "us-east-2"]

def audit_all_regions():
 total = []
 for region in REGIONS:
 total.extend(audit_unattached_ebs(region))
 return total

Passo 5. Antes de apagar qualquer coisa, tire um snapshot. Isso transforma a operação de "risco" em "reversível":

python
def snapshot_before_delete(ec2, volume_id):
 snap = ec2.create_snapshot(
 VolumeId=volume_id,
 Description=f"finops-audit backup before delete: {volume_id}",
 TagSpecifications=[{
 "ResourceType": "snapshot",
 "Tags": [{"Key": "created-by", "Value": "finops-audit"}],
 }],
 )
 return snap["SnapshotId"]

Passo 6. Só então adicione a exclusão, atrás de uma flag explícita, nunca como comportamento padrão do script:

python
def delete_orphaned_volume(region, volume_id, confirm=False):
 ec2 = boto3.client("ec2", region_name=region)
 if not confirm:
 print(f"[dry-run] would delete {volume_id}")
 return
 snap_id = snapshot_before_delete(ec2, volume_id)
 print(f"snapshot {snap_id} created, waiting before delete...")
 ec2.delete_volume(VolumeId=volume_id)
 print(f"deleted {volume_id}")

Repare que confirm=False é o default. Quem for rodar isso num pipeline de CI precisa passar confirm=True de propósito, igual a um terraform apply sem -auto-approve por engano.

Testando

Antes de apontar o script para uma conta real, valide num ambiente controlado:

  1. Crie um volume EBS de teste sem anexar a nenhuma instância (aws ec2 create-volume --size 1 --availability-zone sa-east-1a --volume-type gp3)
  2. Rode audit_unattached_ebs("sa-east-1") e confirme que o VolumeId do teste aparece na saída
  3. Rode o mesmo filtro direto pela CLI para cruzar o resultado: aws ec2 describe-volumes --filters Name=status,Values=available --region sa-east-1
  4. Execute delete_orphaned_volume com confirm=False primeiro e confira que nada foi apagado (modo dry-run)
  5. Só então rode com confirm=True sobre o volume de teste e confirme a exclusão e o snapshot gerado

Se o volume de teste não aparecer no passo 2, o problema costuma ser região (o volume foi criado numa AZ/região diferente da que o script está consultando) ou permissão IAM faltando em ec2:DescribeVolumes.

Limpando os recursos

Todo EBS cobra por GB-mês mesmo sem estar anexado a nada: é exatamente o motivo deste tutorial existir, então não deixe sobras do próprio teste.

  • Apague o volume de teste criado no passo 1 da seção anterior, caso ainda exista: aws ec2 delete-volume --volume-id <id>
  • Liste e remova os snapshots gerados pelo script de teste, filtrando pela tag usada no exemplo: aws ec2 describe-snapshots --filters Name=tag:created-by,Values=finops-audit
  • Revogue ou desative o perfil finops-audit se ele foi criado só para este exercício
  • Se você testou a extensão multi-conta via sts:AssumeRole, remova a role temporária na conta de destino

Próximos passos

O script resolve só uma das quatro causas de desperdício que o relato original lista. As outras três pedem automações diferentes:

Causa de desperdício citada na fonteAutomação correspondente
Volumes EBS órfãosEste script, agendado via EventBridge + Lambda
Staging 24 horas no arRegra do EventBridge que para/inicia instâncias fora do horário comercial
Instâncias EC2 superdimensionadasMétricas do CloudWatch + Compute Optimizer para redimensionar
Queries de banco sem cachePerfilamento de query e camada de cache (fora do escopo de infraestrutura)

Para quem administra mais de uma conta dentro de uma AWS Organizations, o próximo passo natural é trocar o cliente boto3 direto por uma sessão assumida via sts:AssumeRole, repetindo a auditoria conta a conta a partir de uma conta de management, e agendando a execução via Lambda com um EventBridge rule diário ou semanal em vez de rodar manualmente.

O autor do relato original também menciona um pacote de código aberto no PyPI (aws-finops-auditor) e uma versão paga em Gumroad com relatórios executivos e suporte a múltiplas contas via CloudFormation StackSets. Vale olhar o repositório antes de adotar qualquer dependência de terceiros em produção, mas o ganho real, como este tutorial mostra, está em entender o que o script faz por baixo: um filtro status=available na API do EC2, rodado com disciplina, é o que separa auditoria pontual de governança de custo contínua.

Fonte: DEV Community — #aws

Serviços neste textoFatura e impostos

Leve para a sua IA

Decida com o seu assistente, com o contexto deste texto já montado.

1. O que você quer saber

Ver o prompt
Li no AWS Hub: "Como caçar volumes EBS órfãos na AWS com um script Boto3 de FinOps" (https://awshub.com.br/comunidade/como-cacar-volumes-ebs-orfaos-na-aws-com-um-script-boto3-de-finops).
Resumo: Um relato técnico publicado no dev.to mostra como volumes EBS desanexados, staging ligado 24 horas e instâncias superdimensionadas inflam a fatura da AWS sem ninguém perceber. A seguir, o passo a passo para montar sua própria auditoria com Boto3, do script básico até a limpeza segura dos recursos de teste.
Serviços: Fatura e impostos

Minha stack: [descreva em uma linha: serviços, linguagem, volume, região]

Isso muda alguma coisa na minha arquitetura? O que eu faria diferente a partir de amanhã?

Newsletter semanal

A semana da AWS, em português

Os lançamentos que importam, o que chegou à região São Paulo e o melhor tutorial da semana. Toda sexta, gratuita.