Lar
aws-billing-and-cost-management
aws/agent-toolkit-for-aws
Analise os custos da AWS, encontre oportunidades de economia, gerencie orçamentos, avalie Planos de Economia e Instâncias Reservadas, ajuste o tamanho adequado para EC2/Lambda/RDS/EBS com o Compute Optimizer, consulte os preços dos serviços, faça consultas ao CUR por meio do Athena, detecte anomalias de custo, restrinja os custos às visualizações de faturamento e monitore o uso da camada gratuita. Gatilhos: fatura da AWS, análise de custos, redução de despesas, plano de economia, instância reservada, ajuste de tamanho, alerta de orçamento, otimização de custos, preços, camada gratuita, anomalia de custo, CUR, auditoria de custos, visualização de faturamento e ARN da visualização de faturamento.
...Expandir tudoSobre o aws-billing-and-cost-management
Analisa, otimiza e gerencia os custos da AWS, reunindo conhecimentos especializados dos produtos de gestão de custos da plataforma, incluindo armadilhas comuns, padrões corretos de uso da API e fluxos de trabalho de otimização. É utilizado para analisar tendências de gastos e custos, configurar alertas de orçamento, avaliar Savings Plans e Reserved Instances, ajustar o tamanho adequado de recursos EC2, Lambda, RDS e EBS por meio do Compute Optimizer, consultar preços de serviços, realizar auditorias de custos ou investigar picos repentinos, buscar dados CUR com a Athena, limitar a análise a uma visualização de faturamento e verificar o uso da camada Free Tier. Os conceitos fundamentais abrangem Cost Explorer, Budgets, Billing Views, Compute Optimizer, o Cost Optimization Hub, Savings Plans e Reserved Instances, além do CUR 2.0 consultado por meio da Athena. O servidor AWS MCP é a configuração recomendada para execução em ambiente isolado e registro de auditorias, mas os comandos também funcionam com qualquer agente que tenha acesso padrão à AWS CLI.
Duas regras cruciais são destacadas. A data atual deve ser determinada por meio de uma ferramenta antes de qualquer chamada ao Cost Explorer, Budgets ou Savings Plans, pois os modelos costumam usar como referência os anos dos dados de treinamento, analisando assim informações desatualizadas. Cálculos numéricos como somas, médias, porcentagens, comparações e contagens nunca devem ser feitos diretamente na resposta; eles sempre precisam ser realizados por meio de um script ou ferramenta de cálculo, já que a aritmética realizada por LLMs em dados de custos é pouco confiável.
Um guia de decisões direciona cada pergunta à ferramenta e ao arquivo de referência adequados, enquanto uma seção com tarefas comuns fornece comandos concretos. Os custos por serviço são analisados com o comando aws ce get-cost-and-usage, agrupados por SERVICE, utilizando como valor padrão UnblendedCost, excluindo Créditos e Reembolsos por meio do filtro RECORD_TYPE e considerando a data final como exclusiva. O Compute Optimizer requer ativação prévia por meio do comando update-enrollment-status com status Active. A seção sobre Billing Views explica como limitar os dados de custo a uma determinada visualização de faturamento, indicando como adicionar --billing-view-arn às chamadas suportadas, listando as visualizações disponíveis com o comando aws billing list-billing-views (que exige a permissão billing:ListBillingViews) e mostrando como incluir o BillingViewArn em um arquivo JSON de orçamento, além de apresentar uma tabela indicando quais APIs do Cost Explorer suportam e quais não suportam o BillingView ARN. Uma tabela de solução de problemas relaciona erros como ValidationException causado por chave de dimensão incorreta, resultados filtrados vazios, AccessDenied em dados horários e a exigência de que as chamadas ao Budgets sejam realizadas na região us-east-1, indicando as soluções para cada um deles.
Perguntas Frequentes
Por que é necessário verificar a data atual antes de fazer chamadas à API de custos?
Os LLMs costumam usar como referência datas dos dados de treinamento em vez da data atual real, gerando análises com base em informações desatualizadas que, embora pareçam corretas, na verdade estão erradas. É preciso utilizar uma ferramenta para determinar a data atual antes de realizar qualquer chamada ao Cost Explorer, Budgets ou Savings Plans.
Como devem ser feitos os cálculos numéricos em dados de custos?
Nunca por meio de raciocínios na resposta. Somas, médias, porcentagens, comparações, contagens e valores mínimos ou máximos devem sempre ser calculados por meio de um script ou ferramenta de cálculo, como um script em Python que exiba o resultado, já que a aritmética realizada por LLMs em dados de custos é pouco confiável.
Como limitar a análise de custos a uma visualização de faturamento específica?
Adicione --billing-view-arn às chamadas da API suportadas e descubra as visualizações disponíveis com o comando aws billing list-billing-views (que requer a permissão billing:ListBillingViews). As chamadas suportadas incluem ce get-cost-and-usage e get-cost-forecast, enquanto as chamadas relacionadas a reservas e Savings Plans não oferecem suporte a esse recurso.
Que configuração é necessária para o Compute Optimizer?
É preciso primeiro ativar o recurso executando o comando aws compute-optimizer update-enrollment-status com status Active. Sem essa ativação, as chamadas falham com o erro Account not registered.
Por que uma chamada à API de Budgets pode falhar fora da região us-east-1?
A API de Budgets requer a região us-east-1. A solução indicada é configurar a região para us-east-1 nas chamadas ao Budgets.
Todos os Arquivos
16 arquivos references/cost-explorer.md7,3 KB View references/cost-audit.md3,2 KB View references/cur-athena.md7,0 KB View references/deterministic-calculations.md2,5 KB View references/ebs-optimization.md2,7 KB View references/ec2-rightsizing.md3,2 KB View references/pricing-lookup.md3,8 KB View references/rds-optimization.md1,8 KB View references/service-optimization.md2,9 KB View SKILL.md8,8 KB View references/budgets.md2,3 KB View references/cost-optimization-hub.md7,1 KB View references/free-tier.md1,6 KB View references/reserved-instances.md2,3 KB View references/lambda-optimization.md2,1 KB View references/savings-plans.md3,3 KB View
Overview
Analyze, optimize, and manage AWS costs. This skill encodes domain expertise from AWS's cost management products — gotchas, correct API usage patterns, and optimization workflows that models frequently get wrong.
Usage
Use this skill when:
- Analyzing AWS spending, cost trends, or cost breakdowns
- Setting up or managing budget alerts
- Evaluating Savings Plans or Reserved Instance purchases
- Right-sizing EC2, Lambda, RDS, or EBS resources
- Looking up AWS service pricing
- Running cost audits or investigating cost spikes
- Querying CUR data with Athena
- Scoping cost analysis to a specific billing view
- Checking Free Tier usage
Core Concepts
- Cost Explorer — query cost/usage data by service, account, tag, or time range
- Budgets — set spending thresholds with alerts; supports billing view scoping
- Billing Views — scope cost data to a subset of billing (custom view, billing group, or primary)
- Compute Optimizer — right-sizing recommendations for EC2, Lambda, EBS, RDS
- Cost Optimization Hub — aggregated savings recommendations across services
- Savings Plans / Reserved Instances — commitment-based discounts
- CUR 2.0 — detailed line-item billing data queryable via Athena
Recommended setup: Use the AWS MCP server for sandboxed execution, audit logging, and enterprise controls. See: https://docs.aws.amazon.com/aws-mcp/
Without AWS MCP: All commands use standard AWS CLI syntax and work with any agent that has CLI access.
Critical Rule: Always Check the Current Date
Before making ANY Cost Explorer, Budgets, or Savings Plans API call, you MUST determine the current date. Use a tool to get the current date and time — do NOT assume or guess the year. LLMs frequently default to dates from their training data instead of the actual current date, producing analyses of stale data that appear correct but are completely wrong.
Critical Rule: Deterministic Calculations
You MUST NEVER perform numerical calculations (sums, averages, percentages, comparisons, counts, min/max) by reasoning in your response. LLM arithmetic is unreliable and produces wrong answers on cost data.
You MUST ALWAYS use a script or calculator tool for any math on data returned from API calls. Write a Python script that performs the calculation and prints the result. If the AWS MCP server's run_script tool is available, use it. Otherwise, run the script locally.
Read references/deterministic-calculations.md for patterns and examples.
Decision Guide
| Question | Tool | Reference |
|---|---|---|
| What am I spending? Where are costs going up? | Cost Explorer | references/cost-explorer.md |
| How much does a service cost? | Price List API | references/pricing-lookup.md |
| Where can I save money? (start here) | Cost Optimization Hub | references/cost-optimization-hub.md |
| Should I buy Savings Plans? | CE SP Recommendations | references/savings-plans.md |
| Should I buy Reserved Instances? | CE RI Recommendations | references/reserved-instances.md |
| Deep-dive on a specific EC2/Lambda/EBS/RDS rec? | Compute Optimizer | references/ec2-rightsizing.md, references/lambda-optimization.md, references/rds-optimization.md, references/ebs-optimization.md |
| How do I set up budget alerts? | Budgets | references/budgets.md |
| What's causing a cost spike? | Cost Anomaly Detection | references/cost-explorer.md |
| Am I within Free Tier? | Free Tier API | references/free-tier.md |
| How do I reduce my bill? | Cost Audit workflow | references/cost-audit.md |
| How do I query detailed billing data? | CUR 2.0 + Athena | references/cur-athena.md |
| How do I optimize specific services? | Per-service patterns | references/service-optimization.md |
| How do I scope costs to a billing view? | Billing Views | See Billing Views below |
Common Tasks
Analyze costs by service
aws ce get-cost-and-usage \ --time-period Start=2026-03-01,End=2026-04-01 \ --granularity MONTHLY \ --metrics UnblendedCost \ --group-by Type=DIMENSION,Key=SERVICE
Default to UnblendedCost. Exclude Credits/Refunds with --filter '{"Not":{"Dimensions":{"Key":"RECORD_TYPE","Values":["Credit","Refund"]}}}'. End date is exclusive.
Run a cost audit
Read references/cost-audit.md for the full 7-step workflow: top cost drivers → month-over-month comparison → optimization recommendations → idle resources → commitment coverage → per-service quick wins → report.
Get right-sizing recommendations
Compute Optimizer requires opt-in first: aws compute-optimizer update-enrollment-status --status Active. Then read references/ec2-rightsizing.md for EC2 or the relevant resource-specific reference.
Look up service pricing
Read references/pricing-lookup.md for service codes and attribute filters. Common trap: Price List API service codes differ from Cost Explorer service names.
Billing Views
A billing view scopes cost and usage data to a specific slice of an account's billing (e.g., a billing group, custom view, or the default primary view). When the user wants to analyze costs through a particular billing view, add --billing-view-arn to supported API calls.
Discover available billing views
aws billing list-billing-views \ --billing-view-types PRIMARY CUSTOM BILLING_GROUP
Requires billing:ListBillingViews permission.
Use a billing view with Cost Explorer
aws ce get-cost-and-usage \ --time-period Start=2026-03-01,End=2026-04-01 \ --granularity MONTHLY \ --metrics UnblendedCost \ --group-by Type=DIMENSION,Key=SERVICE \ --billing-view-arn arn:aws:billing::ACCOUNT_ID:billingview/BILLING_VIEW_ID
Create a budget scoped to a billing view
In the --budget JSON, include the BillingViewArn field:
aws budgets create-budget --account-id ACCOUNT_ID \ --budget '{ "BudgetName": "TeamX-Monthly", "BudgetLimit": {"Amount": "1000", "Unit": "USD"}, "TimeUnit": "MONTHLY", "BudgetType": "COST", "BillingViewArn": "arn:aws:billing::ACCOUNT_ID:billingview/BILLING_VIEW_ID" }'
API support for --billing-view-arn
Supports --billing-view-arn | Does NOT support it |
|---|---|
ce get-cost-and-usage | ce get-reservation-coverage |
ce get-cost-and-usage-with-resources | ce get-reservation-utilization |
ce get-cost-forecast | ce get-savings-plans-coverage |
ce get-usage-forecast | ce get-savings-plans-utilization |
ce get-dimension-values | |
ce get-tags | |
ce get-cost-comparison-drivers | |
budgets create-budget (in budget JSON) |
Troubleshooting
| Error | Cause | Fix |
|---|---|---|
ValidationException on Cost Explorer | Wrong dimension key (e.g., CHARGE_TYPE instead of RECORD_TYPE) | Use RECORD_TYPE for charge type filtering |
| Empty results with filter | Filter value doesn't match exactly | Call GetDimensionValues first to get valid values |
AccessDeniedException on hourly data | Hourly granularity not enabled | Enable in Cost Explorer preferences |
Account not registered on Compute Optimizer | Not opted in | Run update-enrollment-status --status Active |
| Budgets API fails outside us-east-1 | Budgets requires us-east-1 | Set --region us-east-1 |
Cost Explorer Total empty with GroupBy | By design — totals excluded when grouping | Make separate call without GroupBy, or sum grouped results using a script |
AccessDeniedException on list-billing-views | Missing permission | User needs billing:ListBillingViews permissions |
ValidationException with --billing-view-arn | API doesn't support billing views, or malformed ARN | Check the API support table above; ARN format is arn:aws:billing::ACCOUNT_ID:billingview/VIEW_ID |
Budget shows UNHEALTHY health status | Billing view access revoked or view deleted | Check HealthStatus.StatusReason in describe-budget output; ensure billing:GetBillingViewData is granted |
Additional Resources
- AWS Cost Management User Guide: https://docs.aws.amazon.com/cost-management/
- AWS Pricing Calculator: https://calculator.aws/
- Compute Optimizer User Guide: https://docs.aws.amazon.com/compute-optimizer/
- Well-Architected Cost Optimization Pillar: https://docs.aws.amazon.com/wellarchitected/latest/cost-optimization-pillar/
Todos os arquivos
0 arquivosInstalar aws-billing-and-cost-management
Baixe e extraia os arquivos de habilidades para o seu diretório .claude/skills/.
Baixar ZIPClone o repositório e copie os arquivos da habilidade para o seu projeto.
git clone https://github.com/aws/agent-toolkit-for-aws/blob/main/skills/core-skills/aws-billing-and-cost-management/SKILL.md # Copy SKILL.md to your .claude/skills/ directory
Copiar
