Usage
1. Visão Geral
A tela de Usage é o painel de FinOps da plataforma Nukk: um controle detalhado de todo o custo gerado pela sua conta, recurso por recurso, com granularidade de CPU, memória, rede, tempo de execução e até custo de tokens de IA. Em vez de descobrir o custo só na fatura no fim do mês, é possível acompanhar em tempo (quase) real o que está consumindo crédito, onde e por quê — e agir antes que o custo saia do controle.
2. Filtros e Indicadores
No topo, dois filtros recortam a visão:
| Filtro | Descrição |
|---|---|
| Month | Mês de referência do consumo (ex: 2026-07). |
| Environment | Restringe a visão a um ambiente específico, ou All environments para ver todos combinados. |
Logo abaixo, quatro indicadores resumem o período selecionado:
| Indicador | Descrição |
|---|---|
| Total this month | Custo total acumulado no mês, em créditos (cr). |
| Resources | Quantidade de recursos que geraram custo no período. |
| Tokens cost | Custo específico de consumo de tokens de IA (ex: Copilot, vibe code), em créditos. |
| vs last month | Variação percentual do custo total em relação ao mês anterior (ex: -72.3%). |
O botão Refresh atualiza os dados exibidos, e o horário do Last update mostra quando os números foram calculados pela última vez.
3. Cost Trend
Um gráfico de tendência mostra a evolução do custo total ao longo dos últimos 6 meses, permitindo enxergar rapidamente picos de consumo, crescimento gradual ou quedas — por exemplo, um pico entre 2026-05 e 2026-06 seguido de queda em 2026-07.
4. Resources — Detalhamento por Recurso
Abaixo do gráfico, a tabela Resources detalha o custo recurso a recurso, com abas de filtro por tipo:
| Aba | O que mostra |
|---|---|
| All | Todos os recursos que geraram custo. |
| Flows | Custo gerado pelos Flows. |
| Frontend | Custo gerado pelos Frontend Apps. |
| Backend | Custo gerado pelos Backend Apps. |
| Addons | Custo gerado pelos Add-ons implantados. |
| Previews | Custo gerado pelos ambientes de preview das aplicações. |
| Tokens | Custo gerado pelo uso de IA (tokens consumidos). |
Cada linha da tabela mostra:
| Coluna | Descrição |
|---|---|
| Name | Nome do recurso (ex: nukk-site). |
| Type | Tipo do recurso (ex: frontendapp, addon, preview). |
| Size | Tamanho/plano do recurso, quando aplicável. |
| Environment | Ambiente onde o recurso rodou (ex: Test). |
| CPU (core·h) | Consumo de CPU acumulado, em core-horas. |
| Memory (GiB·h) | Consumo de memória acumulado, em GiB-horas. |
| Network (GiB) | Tráfego de rede consumido, em GiB. |
| Running (h) | Tempo total que o recurso ficou em execução, em horas. |
| Credits | Custo total gerado por esse recurso no período, em créditos. |
Isso permite responder perguntas como "qual recurso está pesando mais na fatura?" (ex: comparando nukk-site, seu addon de túnel nukk-site-tunnel e o preview nukk-site lado a lado) sem precisar cruzar informações manualmente.
5. Por que isso importa
- Para quem desenvolve: mostra o impacto real de cada Flow, App ou Add-on no custo — útil para identificar recursos superdimensionados (ex: memória alocada muito acima do necessário) antes que isso vire um problema de custo recorrente.
- Para quem gerencia o projeto/squad: dá visibilidade de FinOps sem depender de planilhas ou da fatura do provedor de nuvem — comparação mês a mês, por ambiente, por tipo de recurso, tudo dentro da própria plataforma.
- Para decisões de arquitetura: separar custo de infraestrutura (CPU/memória/rede) do custo de tokens de IA ajuda a entender se o gasto vem de "rodar a aplicação" ou de "usar IA para construir/operar a aplicação" — dois tipos de custo com otimizações bem diferentes.
6. Perguntas frequentes
O que conta como "Resources" no indicador do topo? TODO: confirmar a definição exata (recursos distintos no período vs. execuções).
Dá para exportar os dados de Usage (ex: CSV) para relatórios externos? TODO: confirmar se existe exportação além da visualização na tela.
O custo de Tokens é cobrado separadamente do custo de infraestrutura? TODO: confirmar se aparecem juntos na mesma fatura ou em linhas separadas.