---
title: Cotas de largura de banda e add-ons
description: Como o NexCMP mede o tráfego por serviço a partir das estatísticas do CloudStack, cotas padrão, alertas de 80% e 100%, ações de excesso e add-ons.
url: https://nexcmp.com/pt/docs/catalog/bandwidth/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Cotas de largura de banda e add-ons {#bandwidth-quotas-and-add-ons}

> **Onde no admin:** Services › Bandwidth: Summary (`/bandwidth`), Add-on (`/bandwidth/addons`) e Quotas, pricing & policy (`/bandwidth/policy`). O seletor do módulo fica em System › Admin › License & updates.

## O que faz {#what-it-does}

A largura de banda concede a cada serviço metrificado uma **cota** mensal de tráfego. O NexCMP mede o uso, avisa o cliente em 80% e 100% e, quando a cota é excedida, age de acordo com a sua **política de excesso**. Os clientes podem comprar **add-ons** de terabytes extras usando a carteira; você também pode conceder add-ons gratuitamente.

| Service | Cota |
|---|---|
| Virtual Machines | Por VM por mês (padrão 2048 GB, ou seja, 2 TB) |
| Kubernetes | A cota de VM multiplicada pelo número de workers |
| Object Storage | Tráfego de download por cliente por mês (padrão 100 GB); além disso, aplica-se o preço normal de pay-as-you-go |
| VPN | Mantém a cota do seu plano; atualize a largura de banda na página de VPN |
| Private Cloud | **Sem limite** |

## Requisitos {#requirements}

| Item | Requisito |
|---|---|
| Módulo | **Bandwidth** está ativado por padrão. Desative-o em License & updates para ocultá-lo. |
| Fonte de medição | Com a fonte padrão, **CloudStack VM statistics**. Mantenha a coleta de estatísticas de VM ativada no CloudStack; a retenção padrão de 720 minutos é suficiente. |
| Proxmox VE | As VMs no Proxmox VE **não são medidas**. |
| Taxa de câmbio | O preço do complemento é inserido em VND. Consulte [Currency and exchange rates](https://nexcmp.com/pt/docs/catalog/currency-and-exchange-rates/). |
| Depende de | [CloudStack](https://nexcmp.com/pt/docs/infrastructure/cloudstack/) para tráfego de VM e Kubernetes, [S3](https://nexcmp.com/pt/docs/infrastructure/s3/) para downloads de armazenamento. |

## Preparar a infraestrutura {#prepare-the-infrastructure}

Não é necessário além de o CloudStack estar conectado. O NexCMP lê `listVirtualMachinesUsageHistory` para todas as VMs da conta em uma única chamada, a cada 5 minutos, em janelas de no máximo duas horas. Cada amostra cobre um minuto e é **somada**. As amostras são obtidas com três minutos de atraso para que tenham tempo de chegar. Uma lacuna maior que a retenção do CloudStack (cerca de 12 horas) é ignorada e registrada.

::: info O que os números significam
O uso é contabilizado na interface de rede de cada VM, portanto inclui o tráfego entre VMs, e não apenas o tráfego para a Internet. Pode ser um pouco maior do que um roteador de borda contabilizaria.
:::

## Conectar no NexCMP {#connect-in-nexcmp}

1. Abra **Services › Bandwidth › Quotas, pricing & policy**.
2. Defina os valores e clique em **Save**; um motivo será solicitado e registrado. O worker aplica a alteração em cerca de 30 segundos.

   | Campo | Padrão | Significado |
   |---|---|---|
   | Habilitar largura de banda (menu do cliente e compra de complementos) | on | A chave para o lado de vendas do módulo. |
   | VM, GB/mês (Kubernetes = este valor × workers) | 2048 | Cota por VM por período. |
   | S3, download em GB/mês por cliente | 100 | Além disso, aplica-se o preço padrão de S3 pay-as-you-go. |
   | Direção da cota (VM, Kubernetes) | In + out | Ou **Outbound only**. |
   | Preço de +1 TB (VND) | 100,000 | Convertido em centavos à taxa de cotação. |
   | Máximo por compra (TB) | 50 | |
   | Política de excedente | suspend | **notify**, **throttle** ou **suspend** (abaixo). |
   | Aplicar suspensão real a partir de | data de migração + 24 horas | Antes desta data, nada é suspenso; os clientes recebem apenas avisos. |
   | Limite de taxa de throttling (Mbps) | | Usado apenas pelo throttle. |

      ![Política de largura de banda: cotas padrão, preço de complementos e política de excedente](https://nexcmp.com/pt/docs/images/catalog/bandwidth-01-policy.webp)

### Políticas de excedente {#overage-policies}

| Política | O que acontece quando um serviço ultrapassa 100% |
|---|---|
| **notify** | O cliente é notificado. Nada mais. |
| **throttle** | Como notify por enquanto: o limitador de velocidade não está conectado nesta versão. |
| **suspend** (padrão) | A VM, o cluster ou a conta S3 é suspenso até que o cliente compre um complemento ou o próximo período comece. Só é efetivo a partir da data de **suspend-from**. |

Os alertas de 80% e 100% (sino e e-mail) são sempre executados, uma vez por limite, período e serviço. Se você desbloquear um serviço que foi suspenso por largura de banda enquanto ele ainda estiver acima da cota, a próxima verificação (dentro de 5 minutos) o suspenderá novamente. Para mantê-lo funcionando, **conceda um complemento**.

### Monitor o uso e conceda complementos {#watch-usage-and-grant-add-ons}

Abra **Services › Bandwidth › Summary**. A listagem exibe cada serviço com seu uso no período atual, cota incluindo complementos, cota restante e as marcas de 80% e 100%. Os blocos de KPI mostram o número de serviços, complementos vendidos nos últimos 30 dias e o estado do coletor (em execução, cursor). A tabela **Daily** mostra o período atual dia a dia.

![Resumo de largura de banda com o estado do coletor e o uso por serviço](https://nexcmp.com/pt/docs/images/catalog/bandwidth-02-summary.webp)

Para dar margem a um cliente, use **Grant** em um serviço (um complemento de terabytes inteiros sem custo). Abra **Add-on** para ver o histórico de compras e concessões, do mais recente para o mais antigo, com filtro por tipo.

![Histórico de complementos mostrando compras e concessões gratuitas](https://nexcmp.com/pt/docs/images/catalog/bandwidth-03-addons.webp)

### O que os clientes veem {#what-customers-see}

O portal do cliente ganha um menu **Bandwidth** com o uso, a cota restante e uma ação **buy +1 TB** paga com a carteira (até o seu limite máximo por compra). Os complementos são válidos para o período atual.

## Verificar {#verify}

1. O coletor em **Summary** está em execução e o seu cursor avança a cada poucos minutos.
2. Uma VM com tráfego mostra uso após cerca de 10 a 15 minutos.
3. Para ver os alertas, reduza a cota da VM para alguns GB em uma instalação de **teste** e gere algum tráfego. Não faça isso em produção: a cota se aplica a todas as VMs.

## Limites e observações {#limits-and-notes}

- O uso é contado por período (um mês). Complementos e cotas aplicam-se ao período atual.
- "Enforce actual suspend from" protege você contra a suspensão de clientes no momento em que o módulo é ativado pela primeira vez.
- A política de limitação apenas envia notificações nesta versão.
- Alterar a cota se aplica a todos os sites, incluindo sites de revendedores. Os preços de varejo e atacado dos complementos dos revendedores seguem seus descontos ou margens.
- A largura de banda para **Dedicated servers** é um assunto separado; consulte [Dedicated servers](https://nexcmp.com/pt/docs/infrastructure/dedicated/).

## Resolução de problemas {#troubleshooting}

| Sintoma | Causa | Correção |
|---|---|---|
| O uso permanece em zero para uma VM em execução | O worker está parado, o CloudStack está desconectado ou as estatísticas da VM estão desativadas | Verifique `sudo nexcmp status` e **Test connection** em [CloudStack](https://nexcmp.com/pt/docs/infrastructure/cloudstack/); ative as estatísticas de VM do CloudStack. |
| O uso apresenta falhas | A retenção do CloudStack foi excedida ou o worker ficou inativo por mais de 12 horas | Não recuperável; a lacuna é registrada. |
| O uso está um pouco acima do esperado | O tráfego entre VMs e outro tráfego de interface está incluído | Esperado; explique isso aos clientes. |
| Um serviço suspenso retorna como suspenso após você desbloqueá-lo | Ele ainda está acima da cota | Conceda um complemento ou aumente a cota. |
| Nada é suspenso, embora a política seja **suspend** | A data de início da suspensão está no futuro | Defina-a para o momento atual (a página exibe "ACTIVE" quando em vigor). |
| "bw_over_policy deve ser notify, throttle ou suspend" | Política inválida enviada por meio da API | Use um dos três valores. |
| As VMs do Proxmox não mostram uso | Elas não são monitoradas | Esperado. |
| Os clientes não conseguem comprar complementos | A largura de banda está desativada ou a carteira está vazia | Verifique a chave e a carteira. |