Visualizando seu uso

Você pode visualizar os detalhes de uso do IBM Cloud® no painel de faturamento e uso, na página de uso e na página de análise de custos no console. Seus detalhes de uso incluem um resumo das cobranças estimadas para todos os serviços e recursos que são usados por mês em suas organizações.

Você também pode visualizar o uso do dispositivo e as compras de serviços para dispositivos e serviços de infraestrutura clássica acessando Gerenciar > Faturamento e uso.

Antes de Iniciar

Certifique-se de que você tenha o acesso necessário para visualizar os dados de uso dos recursos. O acesso pode ser atribuído no nível da conta ou a grupos de recursos individuais.

Para visualizar o uso de todos os recursos da conta, você precisa de uma política de acesso com a função de Administrador no serviço de gerenciamento de contas de faturamento.
Para visualizar o uso apenas para recursos específicos do IBM Cloud® Identity and Access Management (IAM), você precisa da função Visualizador no grupo de recursos.

Você pode limitar o acesso para visualizar o uso de um grupo de recursos específico atribuindo a função de visualizador ou superior em todos os serviços ativados de Identidade e Acesso dentro desse grupo de recursos.

Para obter mais informações sobre funções de acesso, consulte Acesso ao IAM.

Exibição de detalhes de uso do serviço usando o console

O widget de resumo de uso fornece uma visão geral dos gastos do mês até a data, dos gastos do último mês, dos gastos médios mensais e do uso previsto para o próximo mês. Para obter uma visão mais detalhada de seu uso e dos custos específicos associados aos serviços, veja seu uso na página de uso.

Exibição de detalhes de uso no widget de resumo de uso

No widget de resumo de uso no painel de faturamento e uso, você tem uma visão de suas tendências de gastos reais e previstas.

O uso previsto para o próximo mês é calculado encontrando a tendência do uso dos últimos três meses, incluindo o mês atual. Por exemplo, se for agosto, o uso previsto é calculado com base nas tendências de uso em junho, julho e agosto para encontrar o uso previsto para setembro.

Digamos que o uso seja de US$ 950950.00 para junho, US$1000.00 para julho e US$1012.50 para agosto. A diferença é calculada entre o mês atual e o último mês, e entre o último mês e o anterior. Em seguida, é calculada a média dos dois cálculos para encontrar a tendência. Esse valor de tendência de US$ 10431043.75 é o uso previsto para o próximo mês, com os seguintes cálculos:

Variação entre agosto e julho =1012.50-1000.00 = $1212.50 USD
Mudança entre julho e junho =1000.00- $950950.00 = $5050.00 USD
Mudança média (tendência) = ($1212.50 + $5050.00) / 2 = $3131.25 USD

Uso em agosto (1012.50) + Variação média ($3131.25) = Uso previsto para o próximo mês Setembro ($10431043.75 USD)

Exibição de detalhes de uso na página de uso

Na seção Serviços, é possível ver uma lista de seus serviços e os custos estimados associados a eles. Para visualizar um resumo dos encargos estimados para todas as instâncias de um recurso específico, execute as etapas a seguir:

No console do IBM Cloud®, acesse Gerenciar > Faturamento e uso e selecione Uso.
Clique em Visualizar planos para visualizar todas as instâncias de um tipo específico de recurso.
Para visualizar um resumo detalhado dos encargos estimados para cada instância de um tipo de recurso específico, clique em Visualizar detalhes. Também é possível visualizar as métricas de uso mensal detalhadas para a instância selecionada.

Se você tem uma conta Pré-paga que não é faturada em dólares americanos ou uma conta de Assinatura, o uso para todos os serviços é finalizado até o 20º dia do mês seguinte. Se você tem uma conta Pré-paga que é faturada em dólares americanos, o uso para todos os serviços é finalizado até o 3º dia do mês seguinte.

A conta é faturada pelo uso total incorrido em todos os grupos e organizações no final de cada ciclo de faturamento. Cada ciclo de faturamento dura um mês.

É possível filtrar o resumo de uso por grupo e selecionar o período para o uso. Os encargos mostrados representam o valor cobrado da conta naquele mês específico.

Se você selecionar uma organização específica na lista Filtrar por grupo, será possível ver o uso total dessa organização, incluindo qualquer uso como parte de um nível gratuito. O uso da camada grátis é mostrado como gratuito no nível da conta, mas não no nível organizacional. Ao visualizar o uso organizacional, você vê o uso real dessa organização, que inclui tanto o uso gratuito quanto o cobrado. Todo o uso organizacional é acumulado para o uso da conta depois que o nível gratuito é removido.

O proprietário de uma conta faturável pode definir notificações de gastos em relação ao custo total da conta, para tempo de execução, serviços e para serviços individuais, excluindo serviços de terceiros. Para obter mais informações, consulte Configurando notificações de gastos.

Visualização de detalhes de uso na página de análise de custos

Na página de análise de custos, você pode visualizar o uso de suas contas comparando os custos de vários meses, bem como filtrar o uso para visualizar o custo por região, serviço, plano, instância, ID da instância e grupo de recursos.

A página de análise de custos está disponível apenas para contas autônomas e contas corporativas secundárias. As contas raiz da empresa não podem visualizar a página.

Você precisa de uma política de acesso IAM com a função Operator ou superior no serviço de gerenciamento de contas de faturamento. Para visualizar a página de análise de custo, no console IBM Cloud®, vá para Gerenciar > Faturamento e uso e selecione Análise de custo.

Ao usar a página de análise de custos, você pode usar o filtro agrupar por para se aprofundar no uso de suas contas. Por exemplo, você pode selecionar Service (Serviço ) no menu suspenso Group by (Agrupar por) e o gráfico exibirá seu uso em todos os serviços da sua conta. Você pode adicionar Region (Região ) no menu suspenso group by (grupo por), e agora o gráfico exibirá seus serviços e as regiões onde há uso. Passe o mouse sobre uma das barras do mês e você poderá ver o agrupamento do serviço e da região envolvidos. Use essas informações para filtrar ainda mais o gráfico. Se você visualizar o texto ao passar o mouse e vir " us-south, por exemplo, e filtrar apenas por " us-south no menu suspenso Region (Região), obterá mais informações sobre o uso dessa região.

Visualizando seu uso usando a API

É possível visualizar programaticamente o seu uso chamando a API de Relatórios de uso do IBM Cloud. É possível basear a consulta em sua chamada da API em uma conta, organização, grupo de recursos ou instância de recurso.

Os exemplos a seguir mostram consultas que podem ser usadas para visualizar o uso do nível da conta:

curl -X GET -H "Authorization: {iam_token}" -H "Accept: application/json" "{base_url}/v4/accounts/{account_id}/usage/{billingmonth}"

ServiceCall<AccountUsage> getAccountUsage(GetAccountUsageOptions getAccountUsageOptions)

getAccountUsage(params)

get_account_usage(self,
        account_id: str,
        billingmonth: str,
        *,
        names: bool = None,
        accept_language: str = None,
        **kwargs
    ) -> DetailedResponse

(usageReports *UsageReportsV4) GetAccountUsage(getAccountUsageOptions *GetAccountUsageOptions) (result *AccountUsage, response *core.DetailedResponse, err error)

Exportação dos detalhes de uso para um arquivo CSV usando o console

É possível exportar um resumo do uso de sua conta ou informações sobre seus serviços e instâncias para um arquivo CSV. Ao exportar seu arquivo CSV, é possível localizar facilmente estimativas de informações de uso e custo de cada recurso para estornos a seus clientes ou para entender mais sobre seus custos. Como o relatório inclui dados de uso para toda a conta, o acesso de Administrador é necessário no serviço de faturamento para exportar detalhes de uso.

Essa não é uma estimativa de sua fatura final. Os custos da instância não refletem sua fatura final porque outras cobranças ou descontos podem ser aplicados à sua conta.

No console, acesse Gerenciar > Faturamento e uso e selecione Uso.
Clique em Exportar CSV e selecione uma das opções:
- Clique em Resumo para obter uma visão geral de alto nível do uso e dos custos associados de sua conta.
- Clique em Instância para obter informações detalhadas sobre o uso de cada instância de serviço.
Você pode usar as colunas relacionadas à tag no arquivo de instância CSV para ajudar a analisar os recursos em sua conta. Por exemplo, você pode ter vários projetos em uma conta, cada um com um cluster Kubernetes. É possível classificar os dados CSV de acordo com a tag do projeto em cada instância para que seja possível analisar melhor o custo dos projetos individuais. Para obter mais informações sobre marcação, consulte Trabalhado com tags.

Considere a possibilidade de criar tags como um par key:value para agrupar tags relacionadas. O key se torna uma coluna no arquivo CSV e o value é preenchido nas respectivas linhas da coluna. Se você não seguir um estilo de tag key:value, as tags aparecerão na coluna Outras tags.

Visualizando seu uso usando a CLI

Como alternativa para o console, é possível visualizar seu uso usando a interface da linha de comandos (CLI) do IBM Cloud. Use os comandos a seguir para recuperar o uso de recursos e informações de faturamento.

Efetue login e selecione a conta.
```
ibmcloud login
```
Veja o uso de recursos executando o comando ibmcloud billing, conforme mostrado nos exemplos a seguir.
- Visualizar o uso em toda a conta para o mês atual (somente para o administrador da conta).
```
ibmcloud billing account-usage
```
  Você pode visualizar o uso de um mês específico adicionando a opção -d YYYY-MM. Por exemplo, execute o seguinte comando para visualizar o uso de junho de 2025.
```
ibmcloud billing account-usage -d 2025-06
```
- Visualize o uso do grupo de recursos dev-test para maio de 2025 e envie para o formato JSON (somente para o administrador da conta ou do grupo de recursos):
```
ibmcloud billing resource-group-usage dev-test -d 2025-05 --output JSON
```
- Visualize o uso de instâncias de recursos na conta atual para março de 2025, filtrado para o grupo de recursos dev-test e gerado no formato JSON:
```
ibmcloud billing resource-instances-usage -g dev-test -d 2025-03 --output JSON
```