grupos de carga de cenário de perf do uip tm

Sintaxe e opções para "uip tm perf-scenario load-groups", que vincula casos de teste a um cenário de desempenho e ajusta o perfil de carga.

uip tm perf-scenario load-groups gerencia os grupos de carga associados a um cenário de desempenho. Um grupo de carga é um caso de teste vinculado a um cenário com um perfil de carga — usuários virtuais, tempo de aceleração/pico/diminuição, limites de SLO e tipo de robô.

Esta página faz parte do grupo de comando uip tm perf-scenario — consulte aquela página para ver os verbos do ciclo de vida do cenário (create, get, list, execute, stop, list-dry-run-reports) e conceitos compartilhados.

Resumo

uip tm perf-scenario load-groups add --scenario-key <key> [--project-key <key>] (--test-case-key <key> | --test-case-id <uuid>) --folder-key <uuid> --package-name <name> [--package-version <version>] [--virtual-users <n>] [--ramp-up-minutes <n>] [--peak-minutes <n>] [--ramp-down-minutes <n>] [--delay-minutes <n>] [--max-response-time-ms <ms>] [--max-error-rate <rate>] [--robot-type <type>]
uip tm perf-scenario load-groups update --load-group-id <uuid> --project-key <key> [--virtual-users <n>] [--ramp-up-minutes <n>] [--peak-minutes <n>] [--ramp-down-minutes <n>] [--delay-minutes <n>] [--max-response-time-ms <ms>] [--max-error-rate <rate>] [--multiplexing-factor <n>] [--robot-type <type>] [--enabled <bool>]
uip tm perf-scenario load-groups remove --load-group-id <uuid> --project-key <key>
uip tm perf-scenario load-groups list --project-key <key> --execution-id <uuid> [--query <expr>]

Todos os verbos honram as opções globais e os códigos de saída padrão. Todo verbo aceita --log-level <level> (padrão Information).

Observação:

--project-key é opcional em add (herdado do --scenario-key prefixo quando omitido), mas é um .requiredOption() obrigatório update em, remove e,list uma vez que aqueles identificam seu destino por um UUID vazio com sem prefixo de projeto derivável.

uip tm perf-scenario load-groups adicionar

Associe um caso de teste a um cenário como um novo grupo de carga. Define padrões de simulação para o perfil de carga — marque-os mais tarde com update assim que a simulação for aprovada.

Opções

Bandeira	Description
--scenario-key <key>	Obrigatório. Chave do objeto do cenário (por exemplo, SP1:7).
--project-key <key>	Proprietário do projeto. Opcional — derivados do prefixo --scenario-key quando omitido.
--test-case-key <key>	Chave do objeto do caso de teste a ser vinculada (por exemplo, SP1:602). Resolvido para seu UUID por meio da API. Forneça esta opção ou --test-case-id.
--test-case-id <uuid>	UUID do caso de teste para vincular diretamente, ignorando a pesquisa de chaves. Forneça esta opção ou --test-case-key.
--folder-key <uuid>	Obrigatório. Chave da pasta do Orchestrator (deve ser um GUID).
--package-name <name>	Obrigatório. Nome do pacote do Orchestrator que contém a automação.
--package-version <version>	Versão do pacote do Orchestrator. Quando omitido, o padrão é a versão mais recente publicada para o pacote (resolvido por meio de uma pesquisa do Orchestrator).
--virtual-users <n>	Contagem de usuários virtuais. O padrão é 1.
--ramp-up-minutes <n>	Duração de aceleração em minutos. O padrão é 0.
--peak-minutes <n>	Duração de pico em minutos. O padrão é 1.
--ramp-down-minutes <n>	Duração da redução em minutos. O padrão é 0.
--delay-minutes <n>	Atraso antes do início, em minutos. O padrão é 0.
--max-response-time-ms <ms>	Tempo de resposta máximo SLO em ms; o servidor requer pelo menos 100. O padrão é 100.
--max-error-rate <rate>	Taxa de erro máxima SLO (fração, por exemplo, 0.01 para 1%); o servidor requer pelo menos 0.0001. O padrão é 0.0001.
--robot-type <type>	Tipo de robô: standard, template, elasticRobotPool, cloudRobotVm, serverless. O padrão é standard.

Exemplos

# bind by test case key
uip tm perf-scenario load-groups add \
  --scenario-key SP1:7 \
  --test-case-key SP1:602 \
  --folder-key 94821c49-ab85-49cb-94e1-f82c6d8973be \
  --package-name Checkout_Tests \
  --robot-type serverless

# bind by test case id directly (skips the key lookup)
uip tm perf-scenario load-groups add \
  --scenario-key SP1:7 \
  --test-case-id f0b7f77f-482b-0400-a9c4-0b49497eb136 \
  --folder-key 94821c49-ab85-49cb-94e1-f82c6d8973be \
  --package-name Checkout_Tests \
  --package-version 1.0.2

Formato dos dados

{
  "Code": "LoadGroupAdd",
  "Data": {
    "ScenarioKey": "SP1:7",
    "TestCaseKey": "SP1:602",
    "LoadGroupId": "8e322581-0a25-0000-738b-0b49fd936ca1",
    "PackageName": "Checkout_Tests",
    "PackageVersion": "1.0.2",
    "VirtualUsers": 1,
    "Result": "Added"
  }
}

Atualização de grupos de cargas do uip tm perf-scenario

Atualize o perfil de carga de um grupo de carga no local (usuários virtuais, minutos de aceleração/pico/RAMP, limites de SLO, tipo de robô, estado habilitado). Apenas os sinalizadores que você passa mudam — todo o resto é preservado. Use isso entre uma simulação de passagem e uma execução performanceTesting completa para marcar o perfil de carga real.

Opções

Bandeira	Description
--load-group-id <uuid>	Obrigatório. O UUID do grupo de carga do cenário (o campo LoadGroupId de perf-scenario get, execute ou add acima — não o ID por execução de list abaixo).
--project-key <key>	Obrigatório. Proprietário do projeto.
--virtual-users <n>	Nova contagem de usuários virtuais.
--ramp-up-minutes <n>	Nova duração de aceleração em minutos.
--peak-minutes <n>	Nova duração de pico em minutos.
--ramp-down-minutes <n>	Nova duração de redução em minutos.
--delay-minutes <n>	Novo atraso antes do início, em minutos.
--max-response-time-ms <ms>	Novo tempo de resposta máximo SLO em ms (o servidor requer pelo menos 100).
--max-error-rate <rate>	Novo SLO de taxa de erro máxima (o servidor requer pelo menos 0.0001).
--multiplexing-factor <n>	Fator de multiplexação — o valor recomendado é emitido no final de uma simulação (list-dry-run-reports → RecommendedMultiplexingFactor).
--robot-type <type>	Novo tipo de robô: standard, template, elasticRobotPool, cloudRobotVm, serverless.
--enabled <bool>	Habilite (true) ou desabilite (false) este grupo de carga.

Exemplo

uip tm perf-scenario load-groups update \
  --load-group-id 8e322581-0a25-0000-738b-0b49fd936ca1 \
  --project-key SP1 \
  --virtual-users 50 \
  --ramp-up-minutes 2 \
  --peak-minutes 10

Formato dos dados

{
  "Code": "LoadGroupUpdate",
  "Data": {
    "LoadGroupId": "8e322581-0a25-0000-738b-0b49fd936ca1",
    "VirtualUsers": 50,
    "RampUpMinutes": 2,
    "PeakMinutes": 10,
    "RampDownMinutes": 0,
    "DelayMinutes": 0,
    "MaxResponseTimeMs": 100,
    "MaxErrorRate": 0.0001,
    "MultiplexingFactor": null,
    "Enabled": true,
    "RobotType": "standard",
    "Result": "Updated"
  }
}

Os campos que você não aprovou são retornados para seu valor atual (inalterado), não omitidos — a resposta reflete o grupo de carga completo mesclado, não apenas o delta.

uip tm perf-scenario load-groups remova

Remover um grupo de carga de um cenário. Desassocia o caso de teste e seu perfil de carga; o próprio caso de teste e quaisquer dados de execução anteriores são deixados intactos.

Opções

Bandeira	Description
--load-group-id <uuid>	Obrigatório. O UUID do grupo de carga do cenário (o campo LoadGroupId de perf-scenario get ou add acima).
--project-key <key>	Obrigatório. Proprietário do projeto.

Exemplo

uip tm perf-scenario load-groups remove \
  --load-group-id 8e322581-0a25-0000-738b-0b49fd936ca1 \
  --project-key SP1

Formato dos dados

{
  "Code": "LoadGroupRemove",
  "Data": {
    "LoadGroupId": "8e322581-0a25-0000-738b-0b49fd936ca1",
    "Result": "Removed"
  }
}

Esta é uma remoção forçada sem sinalizador de confirmação — a CLI não a coloca atrás de -y/--yes.

lista de grupos de carga do uip tm perf-scenario

Liste os grupos de carga de uma execução (caso de teste, SUT, usuários virtuais, limites, status). Isso é diferente da lista de grupos de carga do próprio cenário: use perf-scenario get para ver os grupos de carga configurados no próprio cenário.

Opções

Bandeira	Description
--project-key <key>	Obrigatório. Proprietário do projeto.
--execution-id <uuid>	Obrigatório. ID de execução do cenário (o ExecutionId de perf-scenario execute).
--query <expr>	filtro no estilo jq aplicado aos dados de saída.

Exemplo

uip tm perf-scenario load-groups list \
  --project-key DEMO \
  --execution-id 80694766-5a44-0000-0985-0b49fd93832d

Formato dos dados

{
  "Code": "PerfLoadGroupsList",
  "Data": {
    "Data": [
      {
        "Id": "082486b0-8d51-0000-b54a-0b4a1388f850",
        "Status": "Finished"
      }
    ]
  }
}

Essa resposta é uma passagem fina de PascalCase da carga útil do SDK subjacente, em vez de um formato de linha criado para esse fim. Portanto, o conjunto de campos exato pode ser mais rico do que o mostrado aqui (caso de teste, SUT, usuários virtuais, limites). — inspecione uma resposta real ou use --query para moldá-lo. O campo Id aqui é o ID do grupo de carga por execução que os dados de execução http-errors list e automation-errors list esperam como --load-group-id.

Relacionado

• uip tm perf-scenario — ciclo de vida do cenário e conceitos compartilhados.
• Dados de execução — inspecione uma execução finalizada ou em andamento.
• Relatórios — renderize relatórios criados para uma execução ou uma comparação.
• casos de teste — link-automation é o que dá a um caso de teste o automationId do qual add e perf-scenario list-dry-run-reports dependem.
• uip ou lista de pastas — origem do --folder-key usada por add.

Veja também

• Visão geral do Test Manager