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
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:
- Auditoria somente leitura (lista os volumes órfãos e o custo potencial)
- Snapshot de segurança antes de qualquer remoção
- 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
boto3instalado - Uma política IAM com, no mínimo, estas ações:
ec2:DescribeVolumesec2:DescribeSnapshotsec2:CreateSnapshotec2:DeleteVolumeec2:CreateTagssts: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.
python3 -m venv finops-audit
source finops-audit/bin/activate
pip install boto3Passo 2. Configure um perfil de credenciais dedicado à auditoria, para não misturar com outras automações.
aws configure --profile finops-auditPasso 3. Escreva a função de auditoria. Esta é a base publicada no relato original, levemente reorganizada:
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:
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 totalPasso 5. Antes de apagar qualquer coisa, tire um snapshot. Isso transforma a operação de "risco" em "reversível":
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:
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:
- 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) - Rode
audit_unattached_ebs("sa-east-1")e confirme que oVolumeIddo teste aparece na saída - Rode o mesmo filtro direto pela CLI para cruzar o resultado:
aws ec2 describe-volumes --filters Name=status,Values=available --region sa-east-1 - Execute
delete_orphaned_volumecomconfirm=Falseprimeiro e confira que nada foi apagado (modo dry-run) - Só então rode com
confirm=Truesobre 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-auditse 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 fonte | Automação correspondente |
|---|---|
| Volumes EBS órfãos | Este script, agendado via EventBridge + Lambda |
| Staging 24 horas no ar | Regra do EventBridge que para/inicia instâncias fora do horário comercial |
| Instâncias EC2 superdimensionadas | Métricas do CloudWatch + Compute Optimizer para redimensionar |
| Queries de banco sem cache | Perfilamento 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ã?