Protocolo: Qual o impacto do número de conexões simultâneas no tempo de resposta da API REST do NetBox?

Este protocolo avalia como o tempo de resposta da API REST do NetBox varia conforme o número de conexões simultâneas. O objetivo é medir a escalabilidade do serviço sob carga controlada.

Ligado ao treinamento Gestão de ativos de redes ISP com NetBox

Roteiro para estudo em ambiente de laboratório ou de teste. Execute apenas em equipamentos, redes e contas que você tenha autorização para usar, com backup e homologação próprios. Comandos podem causar indisponibilidade ou perda de dados. Software e marcas citados pertencem aos seus titulares. Termos de Uso.

Protocolo, não resultado. Esta página descreve como medir. Execução pela engenharia Upnetix: ainda não realizada. Nenhum valor aqui é resultado de medição da Upnetix; os números que valem são os que você obtém na sua bancada.

Pergunta

Como o tempo de resposta da API REST do NetBox se comporta ao variar o número de conexões simultâneas?

Hipótese

Aumentar o número de conexões simultâneas eleva o tempo médio de resposta da API REST do NetBox.

Variáveis

Independentes (o que varia)	número de conexões simultâneas
Dependentes (o que se mede)	tempo médio de resposta da API (ms); taxa de erro (%)
Controladas (o que fica fixo)	versão do NetBox; hardware do servidor; banco de dados PostgreSQL local; tipo de requisição (GET em /api/dcim/devices/); rede local dedicada

Ambiente

Servidor NetBox instalado em VM dedicada, banco PostgreSQL local, rede isolada, ferramenta k6 (código aberto) para simulação de carga.

Procedimento

Preparar ambiente
Certifique-se de que o NetBox está rodando com o banco PostgreSQL local e sem outras cargas externas.
Configurar k6
Crie um script k6 para executar requisições GET autenticadas em /api/dcim/devices/.
```
consulte a documentação do k6 para exemplos de scripts
```
Executar teste com 10 conexões
Execute o teste por 60 segundos com 10 conexões simultâneas.
```
k6 run --vus 10 --duration 60s script.js
```
Registrar resultados
Anote o tempo médio de resposta e a taxa de erro.
Repetir para 50, 100, 200 conexões
Repita o teste para 50, 100 e 200 conexões simultâneas, sempre por 60 segundos cada.
Repetir cada cenário
Repita cada cenário 5 vezes para obter dados confiáveis.

Planilha de coleta

conexoes_simultaneas (unidades)	tempo_medio_resposta_ms (ms)	taxa_erro_percentual (%)
EXEMPLO: 50, 220, 0.5

Repetições recomendadas: 5. Baixe a planilha vazia em CSV: colunas prontas.

Análise

Calcule a média e o desvio padrão do tempo de resposta e da taxa de erro para cada nível de conexões. Compare os resultados entre os cenários. Observe em que ponto o tempo de resposta ou a taxa de erro aumentam significativamente.

Critérios de decisão

O tempo médio de resposta não deve ultrapassar 500 ms em até 100 conexões simultâneas.
A taxa de erro deve permanecer abaixo de 1% em todos os cenários.

Fontes de erro e mitigação

Variações de carga no servidor podem interferir; isole o ambiente.
A latência de rede deve ser mínima e constante; use rede local dedicada.
Certifique-se de que o banco de dados não está realizando tarefas de manutenção durante o teste.

Verificação editorial

Publicado: 09/09/2026
Última revisão: 09/09/2026
Versão do conteúdo: 1.0
Referências: 0 oficiais
Revisão técnica: redação e revisão por IA, URLs conferidas na publicação
Status: Atual

Encontrou um erro? Escreva para comercial@upnetix.com.br com o endereço da página. A revisão semestral por IA nunca altera comandos ou configurações sem passar pela fila de revisão.