uip tm perf-szenario load-groups

Syntax und Optionen für „uip tm perf-scenario load-groups“, die Testfälle an ein Leistungsszenario binden und deren Lastprofil anpassen.

uip tm perf-scenario load-groups verwaltet die an ein Leistungsszenario gebundenen Lastgruppen. Eine Lastgruppe ist ein Testfall, der an ein Szenario mit einem Lastprofil gebunden ist – virtuelle Benutzer, Hochfahren/Peak/Herunterfahren, SLO-Schwellenwerte und Robotertyp.

Diese Seite ist Teil der Befehlsgruppe uip tm perf-scenario – auf dieser Seite finden Sie Szenariolebenszyklus-Verben (create, get, list, execute, stop, list-dry-run-reports) und gemeinsame Konzepte.

Zusammenfassung

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

Alle Verben berücksichtigen die globalen Optionen und die Standardaustrittscodes. Jedes Verb akzeptiert --log-level <level> (Standard: Information).

Hinweis:

--project-key ist optional bei add (abgeleitet vom Präfix --scenario-key, wenn es weggelassen wird), aber ein erforderliches .requiredOption() bei update, remove und list, da diese ihr Ziel anhand einer leeren UUID mit identifizieren Kein abgeleitetes Projektpräfix.

UIP-TM perf-szenario load-groups hinzufügen

Binden Sie einen Testfall als neue Lastgruppe an ein Szenario. Legt Schreibtischtest-Standardeinstellungen für das Lastprofil fest – wählen Sie sie später mit update aus, sobald ein Schreibtischtest erfolgreich ist.

Optionen

Markieren	Beschreibung
--scenario-key <key>	Erforderlich. Szenarioobjektschlüssel (z. B. SP1:7).
--project-key <key>	Besitz des Projekts. Optional – abgeleitet vom Präfix --scenario-key, wenn es weggelassen wird.
--test-case-key <key>	Testfallobjektschlüssel, der gebunden werden soll (z. B. SP1:602). Wird über die API auf seine UUID aufgelöst. Geben Sie dies oder --test-case-id an.
--test-case-id <uuid>	Testfall-UUID zur direkten Bindung und zum Überspringen der Schlüsselsuche. Geben Sie dies oder --test-case-key an.
--folder-key <uuid>	Erforderlich. Orchestrator-Ordnerschlüssel (muss eine GUID sein).
--package-name <name>	Erforderlich. Name des Orchestrator-Pakets, der die Automatisierung enthält.
--package-version <version>	Orchestrator-Paketversion. Standardmäßig die neueste veröffentlichte Version für das Paket, wenn sie weggelassen wird (aufgelöst über eine Orchestrator-Suche).
--virtual-users <n>	Anzahl der virtuellen Benutzer. Die Standardeinstellung ist 1.
--ramp-up-minutes <n>	Hochfahren-Dauer in Minuten. Die Standardeinstellung ist 0.
--peak-minutes <n>	Peak-Dauer in Minuten. Die Standardeinstellung ist 1.
--ramp-down-minutes <n>	Herunterfahren-Dauer in Minuten. Die Standardeinstellung ist 0.
--delay-minutes <n>	Verzögerung vor dem Start in Minuten. Die Standardeinstellung ist 0.
--max-response-time-ms <ms>	SLO für max. Antwortzeit in ms; der Server benötigt mindestens 100. Die Standardeinstellung ist 100.
--max-error-rate <rate>	Max. Fehlerquote SLO (Bation, z. B. 0.01 für 1 %); Der Server benötigt mindestens 0.0001. Die Standardeinstellung ist 0.0001.
--robot-type <type>	Robotertyp: standard, template, elasticRobotPool, cloudRobotVm, serverless. Die Standardeinstellung ist standard.

Beispiele

# 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

Datenform

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

Aktualisierung der UIP-TM-Perf-Scenario Load-Groups

Aktualisieren Sie das Lastprofil einer Lastgruppe (virtuelle Benutzer, Minuten für Hochfahren/Peak/Herunterfahren, SLO-Schwellenwerte, Robotertyp, aktivierter Status). Nur die Flags, die Sie übergeben, ändern sich – alles andere bleibt erhalten. Verwenden Sie dies zwischen einem vorübergehenden Schreibtischtest und einem vollständigen performanceTesting -Lauf, um das echte Lastprofil einzustellen.

Optionen

Markieren	Beschreibung
--load-group-id <uuid>	Erforderlich. Die Lastgruppen-UUID des Szenarios (das LoadGroupId -Feld aus perf-scenario get, execute oder add oben – nicht die ID pro Ausführung aus list unten).
--project-key <key>	Erforderlich. Besitz des Projekts.
--virtual-users <n>	Neue Anzahl von virtuellen Benutzern.
--ramp-up-minutes <n>	Neue Anlaufdauer in Minuten.
--peak-minutes <n>	Neue Spitzendauer in Minuten.
--ramp-down-minutes <n>	Neue Herunterfahren-Dauer in Minuten.
--delay-minutes <n>	Neue Verzögerung vor dem Start in Minuten.
--max-response-time-ms <ms>	Neues SLO für maximale Antwortzeit in ms (Server erfordert mindestens 100).
--max-error-rate <rate>	Neues SLO für maximale Fehlerquote (Server benötigt mindestens 0.0001).
--multiplexing-factor <n>	Multiplexing-Faktor – der empfohlene Wert wird am Ende eines Schreibtischtests ausgegeben (list-dry-run-reports → RecommendedMultiplexingFactor).
--robot-type <type>	Neuer Robotertyp: standard, template, elasticRobotPool, cloudRobotVm, serverless.
--enabled <bool>	Aktivieren (true) oder deaktivieren (false) diese Lastgruppe.

Beispiel

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

Datenform

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

Felder, die Sie nicht übergeben haben, werden in ihrem aktuellen (unveränderten) Wert zurückgegeben, nicht ausgelassen – die Antwort spiegelt die vollständige zusammengeführte Lastgruppe wider, nicht nur das Delta.

Entfernen der UiP-TM-Perf-Scenario-Lastgruppen

Eine Lastgruppe aus einem Szenario zu entfernen. Trennt den Testfall und sein Lastprofil; Der Testfall selbst und alle früheren Ausführungsdaten bleiben unverändert.

Optionen

Markieren	Beschreibung
--load-group-id <uuid>	Erforderlich. Die Lastgruppen-UUID des Szenarios (das LoadGroupId -Feld von perf-scenario get oder add oben).
--project-key <key>	Erforderlich. Besitz des Projekts.

Beispiel

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

Datenform

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

Dies ist eine schwierige Entfernung ohne Bestätigungsflag – die CLI schließt sie nicht hinter -y/--yes ab.

uip tm perf-szenario load-groups-Liste

Listen Sie die Lastgruppen einer Ausführung auf (Testfall, SUT, virtuelle Benutzer, Schwellenwerte, Status). Diese unterscheidet sich von der eigenen Lastgruppenliste des Szenarios: Verwenden Sie perf-scenario get um die für das Szenario selbst konfigurierten Lastgruppen anzuzeigen.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Besitz des Projekts.
--execution-id <uuid>	Erforderlich. ID der Szenarioausführung (ExecutionId aus perf-scenario execute).
--query <expr>	Ein Filter im JQ-Stil, der auf die Ausgabedaten angewendet wird.

Beispiel

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

Datenform

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

Diese Antwort ist ein Thin PascalCase-Durchlauf der zugrunde liegenden SDK-Nutzlast und keine speziell erstellte Zeilenform, sodass der genaue Feldsatz umfangreicher sein kann als hier (Testfall, SUT, virtuelle Benutzer, Schwellenwerte) – überprüfen Sie eine echte Antwort oder verwenden Sie --query, um es zu gestalten. Das Feld Id hier ist die Lastgruppen-ID pro Ausführung, die die Ausführungsdaten http-errors list und automation-errors list als --load-group-id erwarten.

Zugehörig

• uip tm perf-scenario – Szenariolebenszyklus und gemeinsame Konzepte.
• Ausführungsdaten –Inspizieren Sie eine abgeschlossene oder sich noch in Bearbeitung befindende Ausführung.
• Berichte – Rendern erstellte Berichte für eine Ausführung oder einen Vergleich.
• Testfälle – link-automation gibt einem Testfall den automationId , von dem add und perf-scenario list-dry-run-reports abhängen.
• UIP- oder Ordnerliste – Quelle von --folder-key die von add verwendet wird.

Siehe auch

• Test Manager-Übersicht