Azure Cost: consultas antes de mudanças

ANÁLISE EDITORIAL

Reduzir custo de nuvem não começa apagando recursos. Começa entendendo qual escopo será consultado, qual período faz sentido, como os valores foram agregados e quais mudanças precisam de aprovação. A Azure Cost, publicada pela Microsoft em seu repositório oficial de Skills, organiza consultas, previsões e uma revisão de oportunidades de otimização sem transformar estimativas em economia garantida.

A curadoria do Bastidores da IA fixou a Skill no commit a3d788b6b3a11e8d1347acd616cb763eb134a5f6 do repositório microsoft/skills. Em 21 de agosto de 2026, o projeto registrava exatamente 2.930 estrelas no GitHub. O SKILL.md auditado declarava versão 1.3.1, autoria Microsoft e licença MIT.

Ilustração editorial exclusiva: a capa representa uma especialista revisando fluxos abstratos de custos antes de autorizar mudanças. Não é captura de tela, interface real, relatório de uma assinatura Azure, promessa de economia ou prova de execução.

O que esta Skill faz de verdade

A Skill funciona como um roteador para três tarefas. A primeira consulta custos históricos pela API Cost Management Query. A segunda pede uma previsão pela API Forecast. A terceira combina custos, inventário e métricas para preparar recomendações de otimização. Ela ajuda o agente a escolher escopo, intervalo, granularidade, agrupamentos e filtros, construir a chamada e explicar a resposta.

Consulta e previsão usam operações de leitura. A documentação da Cost Management Query descreve o POST usado para consultar dados agregados, enquanto a referência de Forecast cobre a projeção. O verbo HTTP POST não significa, nesse caso, criar um recurso da assinatura. Ele envia a definição da consulta para obter uma resposta.

A trilha de otimização é mais ampla. Ela pode gerar relatório e comandos sugeridos para orçamento, AKS, Redis, armazenamento e outros recursos. Alguns exemplos alteram configuração ou removem recursos. Por isso, leitura e mudança não devem compartilhar a mesma autorização. O agente pode inventariar e explicar com papéis de leitura, mas toda execução de comando mutável precisa virar uma etapa separada, com diff, impacto, plano de reversão e aprovação humana explícita.

Para quem serve

Ela serve a profissionais de FinOps, administradores Azure, engenheiros de plataforma, SREs, arquitetos, gestores de produto e equipes financeiras que precisam responder perguntas concretas: quanto foi gasto por serviço, qual grupo de recursos concentrou variação, que tendência aparece para o restante do período e onde vale aprofundar a investigação.

Também é útil para quem ainda não domina o formato da API. A Skill traz esquemas de corpo, dimensões permitidas, exemplos, tratamento de erros e notas sobre escopos. Isso reduz tentativa e erro, mas não substitui o conhecimento de faturamento, contratos, reservas, benefícios, impostos, moedas, atrasos de ingestão e regras internas de rateio.

Não serve para prometer redução mensal, aprovar orçamento sozinha ou apagar o que parece ocioso. Um disco sem vínculo pode guardar uma cópia necessária. Um cache com pouca atividade pode sustentar uma janela crítica. Uma mudança de tier pode criar custo recorrente. O papel correto da Skill é preparar evidência e perguntas, não transformar heurística em ordem de execução.

Compatibilidade e pré-requisitos

O conteúdo foi estruturado para agentes capazes de carregar Agent Skills e operar ferramentas Azure. O fluxo usa Azure CLI, chamadas az rest e, em alguns cenários, Azure MCP. Para consultas básicas, você precisa de uma conta autenticada, um tenant correto, o escopo autorizado e acesso de leitura a dados de custo. A Microsoft documenta os papéis e escopos de acesso ao Cost Management.

O frontmatter recomenda Cost Management Reader, Monitoring Reader e Reader. Esse conjunto atende a revisão completa, mas não é um bloco indivisível. Cost Management Reader cobre a leitura de custos e previsões no escopo concedido. Monitoring Reader entra quando a análise precisa de métricas. Reader ajuda a inventariar propriedades dos recursos. Aplique privilégio mínimo e conceda cada papel somente no menor escopo necessário.

Confirme ainda a versão instalada do Azure CLI, a assinatura ativa e o diretório de saída. Não cole IDs, nomes confidenciais ou resultados de custo em um chat público. Custos podem revelar arquitetura, volume, regiões, fornecedores e prioridades do negócio.

Instalação recomendada

Comece pelo ZIP documental local e leia ORIGEM.md, SKILL.md e as referências da tarefa desejada. O pacote preserva os 23 arquivos Markdown necessários e a licença, sem código executável. Para instalar pela origem, fixe o commit auditado e selecione apenas azure-cost. O README do repositório documenta o padrão npx skills add microsoft/skills, mas baixar o catálogo inteiro aumenta o material que precisa ser revisado.

Instale primeiro em projeto de teste. Liste os arquivos criados e compare seus hashes com a origem. Não autorize shell irrestrito nem credenciais de produção no primeiro contato. Se o cliente não consegue limitar ferramentas por tarefa, execute manualmente a chamada de consulta e entregue somente a saída sanitizada ao agente.

Configuração antes do primeiro uso

Defina a pergunta antes do comando. Registre o escopo, por exemplo assinatura, grupo de recursos ou billing account, o período, a moeda esperada, a granularidade e o agrupamento. A página oficial de escopos do Cost Management explica onde diferentes contas e contratos podem consultar dados.

Separe três perfis operacionais. No perfil consulta, permita somente ler custos. No perfil previsão, use a mesma lógica de leitura e trate a projeção como estimativa, com premissas e horizonte visíveis. No perfil otimização, comece somente com inventário e relatório. Desabilite comandos de criação, atualização e exclusão até que uma pessoa revise cada recomendação.

Crie também um diretório de saída controlado. Os fluxos oficiais salvam JSON e Markdown para trilha de auditoria. Verifique se o local não é sincronizado publicamente e se tem política de retenção. Remova ou masque IDs quando o relatório sair do time autorizado.

Primeiro uso seguro

Escolha uma assinatura de laboratório ou um grupo de recursos pequeno. Faça uma consulta mensal simples, sem otimização, e confirme o total no portal ou em exportação oficial. Depois agrupe por serviço e compare a soma das linhas com o total. Se houver divergência, investigue arredondamento, moeda, benefícios, período incompleto e atraso de dados antes de ampliar o escopo.

1. Confirme tenant, assinatura e escopo visíveis no terminal.
2. Use uma identidade com Cost Management Reader no menor escopo possível.
3. Registre a pergunta, datas, granularidade e agrupamento.
4. Revise o corpo JSON antes de executar a consulta.
5. Salve a resposta em diretório privado e compare com fonte oficial.
6. Encerre sem aplicar nenhuma recomendação de otimização.

Somente depois de validar o caminho de leitura, experimente previsão. Exiba que se trata de projeção e não de fatura. A documentação da Microsoft também mantém um guia de automação do Cost Management para conferir autenticação, endpoints e limites.

Resultado esperado

Uma boa consulta retorna período, escopo, unidade, colunas e linhas coerentes com a pergunta. A análise deve explicar o que foi agrupado e o que ficou fora. Uma boa previsão mostra horizonte, granularidade e intervalo, sem apresentar valor futuro como fato. Uma boa revisão de otimização lista evidência, risco, dependências, dono do recurso e próximo teste.

O resultado esperado não é uma lista automática de exclusões. É um relatório priorizado que distingue observação, hipótese e ação proposta. Para cada mudança, registre custo atual confirmado, impacto técnico, requisito de negócio, janela, aprovação e mecanismo de retorno. Quando não houver evidência suficiente, a conclusão correta é investigar.

Permissões e riscos

O ZIP local é somente textual. O uso real pode acessar dados financeiros e de infraestrutura. O modo de consulta deve ficar restrito a papéis de leitura. A trilha de otimização contém exemplos que criam orçamento, atualizam cluster AKS, instalam extensão da CLI, alteram políticas de ciclo de vida e podem excluir recursos. Não execute esses exemplos como parte de uma análise automática.

As próprias referências da Skill dizem para nunca executar operações destrutivas sem aprovação explícita. Ainda assim, a presença do aviso não substitui controle técnico. Remova permissões de escrita da identidade analítica. Para uma mudança aprovada, use outra identidade, outro comando e outro registro de execução. Proteja resultados, pois custos e nomes de recursos são informação operacional sensível.

Não repita como economia real os intervalos ilustrativos encontrados nas referências de otimização. Preço varia por região, contrato, tier, quantidade, reserva e data. Valide qualquer preço na página oficial de preços do Azure e no contrato da organização.

Erros comuns

Interpretar POST como escrita. Query e Forecast usam POST para enviar o corpo da consulta, mas retornam dados. Verifique sempre o caminho do endpoint. Um POST para outro provedor pode ter efeito diferente.

Consultar o escopo errado. Um resultado vazio pode indicar falta de permissão, tenant incorreto, período sem dados ou escopo incompatível. Não conclua que não houve custo.

Comparar períodos incompletos. O mês atual e um mês fechado não têm a mesma cobertura. Normalize dias ou espere o fechamento, deixando a limitação explícita.

Tratar previsão como compromisso. Mudanças de uso, preço, reserva e arquitetura alteram o futuro. Preserve as premissas e a data da consulta.

Aplicar recomendação sem dono. Antes de reduzir ou apagar, identifique responsável, dependências e requisito de retenção. Ausência de tráfego recente não prova inutilidade.

Conceder Contributor por conveniência. A leitura de custos não precisa de autorização geral para alterar recursos. Separe identidades e escopos.

Versão auditada e download local

O recorte foi preparado a partir da versão 1.3.1 no commit a3d788b6b3a11e8d1347acd616cb763eb134a5f6. O repositório traz licença MIT, que permite redistribuição com preservação do aviso.

O ZIP local contém somente 25 arquivos textuais: o SKILL.md, 22 referências Markdown, LICENSE.md e ORIGEM.md. Ele não contém scripts, binários, dependências, resultados, tokens, cookies ou credenciais. SHA-256: 2881bc6c6f9b9f3e46a670131ddd8c2e0422825c21938b304807a4b7f6f784fa. O download local serve para auditoria. O botão do repositório oficial permanece separado para obter a origem e acompanhar atualizações.

Resultado esperado e limite final

A Azure Cost é útil quando transforma uma pergunta vaga sobre gastos em consulta reproduzível, com escopo, período e agrupamento explícitos. Ela também ajuda a estruturar uma previsão e a organizar hipóteses de otimização. O valor vem da disciplina do fluxo, não de uma promessa de corte automático.

Mantenha a análise em modo leitura, compare o total com uma fonte oficial e preserve o corpo da consulta. Trate recomendações como propostas. Qualquer criação, atualização ou exclusão deve acontecer fora do agente analítico, com aprovação, identidade adequada, janela e reversão. Essa fronteira é o que separa curadoria responsável de automação temerária.

Fontes primárias

• Repositório oficial Microsoft Skills
• Pasta Azure Cost no commit auditado
• SKILL.md versão 1.3.1
• Cost Management Query API
• Cost Management Forecast API
• Atribuir acesso aos dados do Cost Management
• Compreender escopos do Cost Management