UiPath Documentation
uipath-cli
latest
false
Guía del usuario de UiPath CLI
Importante :
Este contenido se ha traducido mediante traducción automática. La localización de contenidos recién publicados puede tardar entre una y dos semanas en estar disponible.

Grupos de carga de escenarios de rendimiento de uip tm

Sintaxis y opciones para `uip tm perf-scenario load-groups`, que vincula los casos de prueba a un escenario de rendimiento y ajusta su perfil de carga.

uip tm perf-scenario load-groups gestiona los grupos de carga vinculados a un escenario de rendimiento. Un grupo de carga es un caso de prueba vinculado a un escenario con un perfil de carga: usuarios virtuales, tiempo de aceleración/máximo/descenso, umbrales de SLO y tipo de robot.

Esta página forma parte del grupo de comandos uip tm perf-scenario : consulta esa página para ver los verbos del ciclo de vida del escenario (create, get, list, execute, stop, list-dry-run-reports) y los conceptos compartidos.

Sinopsis​

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>]
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 los verbos respetan las opciones globales y los códigos de salida estándar. Cada verbo acepta --log-level <level> (predeterminado Information).

Nota:

--project-key es opcional en add (derivado del prefijo --scenario-key cuando se omite), pero .requiredOption() es obligatorio en update, remove y list, ya que identifican su destino mediante un UUID simple con sin prefijo de proyecto derivable.

uip tm perf-scenario load-groups add​

Vincula un caso de prueba a un escenario como un nuevo grupo de carga. Establece los valores predeterminados de ejecución en seco para el perfil de carga: márcalos más tarde con update una vez que pase una ejecución en seco.

Opciones​

MarcaDescripción
--scenario-key <key>Obligatorio. Clave de objeto de escenario (por ejemplo, SP1:7).
--project-key <key>Proyecto propietario. Opcional: derivado del prefijo --scenario-key cuando se omite.
--test-case-key <key>Clave del objeto del caso de prueba para vincular (por ejemplo, SP1:602). Resuelto a su UUID a través de la API. Proporciona esto o --test-case-id.
--test-case-id <uuid>UUID del caso de prueba para vincular directamente, omitiendo la búsqueda de claves. Proporcione esto o --test-case-key.
--folder-key <uuid>Obligatorio. Clave de carpeta de Orchestrator (debe ser un GUID).
--package-name <name>Obligatorio. Nombre del paquete de Orchestrator que contiene la automatización.
--package-version <version>Versión del paquete de Orchestrator. El valor predeterminado es la última versión publicada para el paquete cuando se omite (resuelta a través de una búsqueda de Orchestrator).
--virtual-users <n>Recuento de usuarios virtuales. El valor predeterminado es 1.
--ramp-up-minutes <n>Duración del aumento en minutos. El valor predeterminado es 0.
--peak-minutes <n>Duración máxima en minutos. El valor predeterminado es 1.
--ramp-down-minutes <n>Duración de la reducción en minutos. El valor predeterminado es 0.
--delay-minutes <n>Retraso antes del inicio, en minutos. El valor predeterminado es 0.
--max-response-time-ms <ms>Tiempo de respuesta máximo SLO en ms; el servidor requiere al menos 100. El valor predeterminado es 100.
--max-error-rate <rate>Tasa de error máxima SLO (fracción, por ejemplo 0.01 para 1 %); el servidor requiere al menos 0.0001. El valor predeterminado es 0.0001.
--robot-type <type>Tipo de robot: standard, template, elasticRobotPool, cloudRobotVm, serverless. El valor predeterminado es standard.

Ejemplos​

# 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 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
# 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

Forma de datos​

{
  "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"
  }
}
{
  "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"
  }
}

Actualización de grupos de carga de escenarios de rendimiento de UIP tm​

Actualice el perfil de carga de un grupo de carga en su lugar (usuarios virtuales, minutos de rampa/pico/bajada, umbrales de SLO, tipo de robot, estado habilitado). Solo cambian los marcadores que pasas: todo lo demás se conserva. Utilízalo entre una ejecución en seco pasajera y una ejecución completa performanceTesting para marcar el perfil de carga real.

Opciones​

MarcaDescripción
--load-group-id <uuid>Obligatorio. El UUID del grupo de carga del escenario (el campo LoadGroupId de perf-scenario get, execute o add arriba, no el ID por ejecución de list a continuación).
--project-key <key>Obligatorio. Proyecto propietario.
--virtual-users <n>Nuevo recuento de usuarios virtuales.
--ramp-up-minutes <n>Nueva duración de aceleración en minutos.
--peak-minutes <n>Nueva duración máxima en minutos.
--ramp-down-minutes <n>Nueva duración de reducción en minutos.
--delay-minutes <n>Nuevo retraso antes del inicio, en minutos.
--max-response-time-ms <ms>Nuevo tiempo de respuesta máximo SLO en ms (el servidor requiere al menos 100).
--max-error-rate <rate>Nuevo SLO de tasa de error máxima (el servidor requiere al menos 0.0001).
--multiplexing-factor <n>Factor de multiplexación: el valor recomendado se emite al final de una ejecución en seco (list-dry-run-reports → RecommendedMultiplexingFactor).
--robot-type <type>Nuevo tipo de robot: standard, template, elasticRobotPool, cloudRobotVm, serverless.
--enabled <bool>Habilitar (true) o deshabilitar (false) este grupo de carga.

Ejemplo​

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
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

Forma de datos​

{
  "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"
  }
}
{
  "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"
  }
}

Los campos que no hayas aprobado se repiten con su valor actual (sin cambios), no se omiten: la respuesta refleja el grupo de carga fusionado completo, no solo el delta.

Eliminar grupos de carga de escenarios de rendimiento de uip tm​

Elimina un grupo de carga de un escenario. Separa el caso de prueba y su perfil de carga; el propio caso de prueba y cualquier dato de ejecución anterior se dejan intactos.

Opciones​

MarcaDescripción
--load-group-id <uuid>Obligatorio. El UUID del grupo de carga del escenario (el campo LoadGroupId de perf-scenario get o add anterior).
--project-key <key>Obligatorio. Proyecto propietario.

Ejemplo​

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

Forma de datos​

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

Se trata de una eliminación definitiva sin marca de confirmación: la CLI no la bloquea detrás de -y/--yes.

Lista de grupos de carga de escenarios de rendimiento de uip tm​

Enumera los grupos de carga de una ejecución (caso de prueba, SUT, usuarios virtuales, umbrales, estado). Esto es diferente de la propia lista de grupos de carga del escenario: utiliza perf-scenario get para ver los grupos de carga configurados en el propio escenario.

Opciones​

MarcaDescripción
--project-key <key>Obligatorio. Proyecto propietario.
--execution-id <uuid>Obligatorio. ID de ejecución del escenario (el ExecutionId de perf-scenario execute).
--query <expr>filtro de estilo jq aplicado a los datos de salida.

Ejemplo​

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

Forma de datos​

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

Esta respuesta es una transferencia de PascalCase delgada de la carga útil del SDK subyacente en lugar de una forma de fila especialmente diseñada, por lo que el conjunto de campos exacto puede ser más rico que el que se muestra aquí (caso de prueba, SUT, usuarios virtuales, umbrales): inspeccionar una respuesta real o utiliza --query para darle forma. El campo Id aquí es el ID de grupo de carga por ejecución que los datos de ejecución http-errors list y automation-errors list esperan como --load-group-id.

  • uip tm perf-scenario : ciclo de vida del escenario y conceptos compartidos.
  • Datos de ejecución : inspecciona una ejecución finalizada o en curso.
  • Informes : renderiza informes creados para una ejecución o una comparación.
  • casos de prueba : link-automation es lo que le da a un caso de prueba el automationId del que dependen add y perf-scenario list-dry-run-reports .
  • uip o lista de carpetas : origen de --folder-key utilizado por add.

Ver también​

¿Te ha resultado útil esta página?

Conectar

¿Necesita ayuda? Soporte

¿Quiere aprender? UiPath Academy

¿Tiene alguna pregunta? Foro de UiPath

Manténgase actualizado