Erstellen eines Auslastungstests in einer Azure Load Testing-Ressource

Ein Test gibt das Testskript und die Konfigurationseinstellungen zum Ausführen eines Auslastungstests an. Sie können einen oder mehrere Tests in einer Azure Load Testing-Ressource erstellen.

Die Konfiguration eines Auslastungstests besteht aus:

Der Name und die Beschreibung des Tests.
Das Apache JMeter-Testskript und die zugehörigen Daten- und Konfigurationsdateien. Zum Beispiel eine CSV-Datendatei.
Umgebungsvariablen
Geheime Parameter.
Die Anzahl der Testmodule , auf denen das Testskript ausgeführt werden soll.
Das Kriterium für das Bestehen / Nichtbestehen des Tests.
Die Liste der App-Komponenten und Ressourcenmetriken, die während der Testausführung überwacht werden sollen.

In Azure Load Testing sind die Erstellung des Auslastungstests und die Dateiuploads entkoppelt, d. h., es handelt sich um separate API-Vorgänge. In diesem Abschnitt werden die Schritte zum Erstellen eines Auslastungstests gezeigt.

Rufen Sie den Endpunkt- oder Datenebenen-URI für die Azure Load Testing-Ressource ab, wie hier erwähnt.

Erstellen eines neuen Tests

PATCH https://{Endpoint}/tests/{testId}?api-version=2022-11-01

Für einen Client, der eine Anforderung mit dieser Signatur sendet, wird der Vorgang Auslastungstestverwaltung - Test erstellen oder aktualisieren ausgeführt.

Eine erfolgreiche Antwort auf eine Anforderung, die mit dieser Signatur gestellt wurde, sieht in etwa wie folgt aus:

{
  "description": "sample description",
  "displayName": "Performance_LoadTest",
  "loadTestConfiguration": {
    "engineInstances": 6,
    "splitAllCSVs": true
  },
  "passFailCriteria": {
    "passFailMetrics": {
      "fefd759d-7fe8-4f83-8b6d-aeebe0f491fe": {
        "clientMetric": "response_time_ms",
        "aggregate": "percentage",
        "condition": ">",
        "value": 20,
        "action": "continue"
      }
    }
  },
  "secrets": {
    "secret1": {
      "value": "https://samplevault.vault.azure.net/secrets/samplesecret/f113f91fd4c44a368049849c164db827",
      "type": "AKV_SECRET_URI"
    }
  },
  "environmentVariables": {
    "envvar1": "sampletext"
  },
  "subnetId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/samplerg/providers/Microsoft.Network/virtualNetworks/samplenetworkresource/subnets/AAAAA0A0A0",
  "keyvaultReferenceIdentityType": "UserAssigned",
  "keyvaultReferenceIdentityId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/samplerg/providers/sampleprovider/sampleresourcetype/sampleresourcename"
}

Dadurch werden die Testdetails wie Testname, Beschreibung, Geheimnisse, Umgebungsvariablen, Anzahl der Module und Erfolgs-/Nichtbestehenskriterien aktualisiert.

Hochladen von Dateien in den erstellten Test
```
PUT https://{Endpoint}/tests/{testId}/files/{fileName}?api-version=2022-11-01
```
oder
```
PUT https://{Endpoint}/tests/{testId}/files/{fileName}?fileType={fileType}&api-version=2022-11-01
```
Für einen Client, der eine Anforderung mit dieser Signatur sendet, wird der Vorgang Auslastungstestverwaltung - Testdatei hochladen ausgeführt.

Hinweis

Jeder PUT-Aufruf unterstützt nur 1 Datei, die hochgeladen werden muss. Wenn mehrere Dateien im selben Aufruf hochgeladen werden, werden alle Dateien außer der ersten verworfen. Je nach Anforderung müssen Sie möglicherweise mehrere Aufrufe tätigen, einen für jeden, z. B. JMX-Skript, ZIP-Datei, CSV-Datei, user.properties usw.

Die hochgeladene JMX-Datei wird validiert, wenn sie den XML-Normen entspricht und ob es sich um ein gültiges JMeter-Skript handelt. Das Feld validationStatus zeigt den Status der Validierung an. Wenn JMeter in der Lage ist, das JMX-Skript ohne Fehler zu akzeptieren, wird es als "VALIDATION_SUCCESS" betrachtet und die Datei wird erfolgreich mit dem Auslastungstest verknüpft. Bei allen nachfolgenden Testläufen wird diese Datei verwendet.

Eine erfolgreiche Antwort auf eine Anforderung, die mit dieser Signatur gestellt wurde, sieht in etwa wie folgt aus:
```
    {
  "url": "https://dummyurl.com/testscriptresource",
  "fileName": "sample.jmx",
  "fileType": "ADDITIONAL_ARTIFACTS",
  "expireDateTime": "2021-12-05T16:43:46.072Z",
  "validationStatus": "VALIDATION_SUCCESS"
}
```

Konfigurieren Sie App-Komponenten im Test für die Überwachung serverseitiger Metriken mit den folgenden Schritten.

PATCH https://{Endpoint}/tests/{testId}/app-components?api-version=2022-11-01

Für einen Client, der eine Anforderung mit dieser Signatur sendet, wird der Vorgang Auslastungstestverwaltung – App-Komponenten erstellen oder aktualisieren ausgeführt. Der Anforderungstext sollte entweder eine testId oder eine testRunId enthalten.

Eine erfolgreiche Antwort auf eine Anforderung, die mit dieser Signatur gestellt wurde, sieht in etwa wie folgt aus:

    {
  "testId": "12345678-1234-1234-1234-123456789012",
  "components": {
    "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/samplerg/providers/microsoft.insights/components/appcomponentresource": {
      "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/samplerg/providers/microsoft.insights/components/appcomponentresource",
      "resourceType": "microsoft.insights/components",
      "resourceName": "appcomponentresource",
      "displayName": "Performance_LoadTest_Insights",
      "resourceGroup": "samplerg",
      "subscriptionId": "00000000-0000-0000-0000-000000000000",
      "kind": "web"
    }
  },
  "createdDateTime": "2021-12-05T16:43:46.072Z",
  "createdBy": "user@contoso.com",
  "lastModifiedDateTime": "2021-12-05T16:43:46.072Z",
  "lastModifiedBy": "user@contoso.com"
}

Last updated on 2025-11-07

Erstellen eines Auslastungstests in einer Azure Load Testing-Ressource

Zusätzliche Ressourcen