Upnetix Labs · protocolo de experimento
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.
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.
- 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
