Terhelésteszt konfigurálása a YAML-ben

Megtudhatja, hogyan konfigurálhatja a terheléstesztet az Azure Load Testingben a YAML használatával. A tesztkonfigurációs YAML-fájllal terhelésteszteket hozhat létre és futtathat a folyamatos integrációs és folyamatos kézbesítési (CI/CD) munkafolyamatból.

YaML-szintaxis terheléstesztelése

A terhelésteszt-konfiguráció a következő kulcsokat használja:

Tesztkonfigurációs minta betöltése

Az alábbi YAML-kódrészlet egy példa terhelésteszt-konfigurációt tartalmaz.

version: v0.1
testId: SampleTest
displayName: Sample Test
description: Load test website home page
testPlan: SampleTest.jmx
testType: JMX
engineInstances: 1
subnetId: /subscriptions/abcdef01-2345-6789-0abc-def012345678/resourceGroups/sample-rg/providers/Microsoft.Network/virtualNetworks/load-testing-vnet/subnets/load-testing
configurationFiles:
  - 'sampledata.csv'
  - ‘testfragment.jmx’
zipArtifacts:
   - bigdata.zip
splitAllCSVs: True
failureCriteria:
  - avg(response_time_ms) > 300
  - percentage(error) > 50
  - GetCustomerDetails: avg(latency) >200
autoStop:
  errorPercentage: 80
  timeWindow: 60
secrets:
  - name: my-secret
    value: https://akv-contoso.vault.azure.net/secrets/MySecret/abc1234567890def12345
keyVaultReferenceIdentity: /subscriptions/abcdef01-2345-6789-0abc-def012345678/resourceGroups/sample-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sample-identity

failureCriteria konfiguráció

A sikertelen tesztfeltételek segítségével feltételeket határozhat meg annak megállapításához, hogy egy terheléses teszt sikeres volt-e vagy sem. Ha egy vagy több sikertelen feltétel teljesül, a teszt sikertelen teszteredményt kap. További információ a terhelésteszt sikertelenség feltételeinek használatáról.

Megadhat olyan feladatfeltételeket, amelyek a teljes terhelési tesztre vonatkoznak, vagy amelyek egy adott kérelemre vonatkoznak. A feladatfeltételek struktúrája a következő:

• Tesztelési feltételek a terhelésteszt szintjén: Aggregate_function (client_metric) condition threshold.
• Adott JMeter-kérelmekre alkalmazott tesztelési feltételek: Request: Aggregate_function (client_metric) condition threshold.

Támogatott ügyfélmetrikák

Az Azure Load Testing a következő ügyfélmetrikákat támogatja:

Hibakonfigurációs konfigurációs minta

Az alábbi kódrészlet egy terhelésteszt-konfigurációt mutat be, amely három terheléstesztelési feladatfeltételt is tartalmazza.

version: v0.1
testId: SampleTest
displayName: Sample Test
description: Load test website home page
testPlan: SampleTest.jmx
testType: JMX
engineInstances: 1
failureCriteria:
  - avg(response_time_ms) > 300
  - percentage(error) > 50
  - GetCustomerDetails: avg(latency) >200

autoStop konfiguráció

A terhelésteszt automatikus beállítása lehetővé teszi a terhelésteszt automatikus leállítását, ha a hiba százalékos értéke túllép egy adott küszöbértéket egy adott időablakban. További információ az automatikus terhelésteszt funkcióról.

Automatikus konfigurációs minta

Az alábbi kódrészlet egy terhelésteszt-konfigurációt mutat be, amely három terheléstesztelési feladatfeltételt is tartalmazza.

version: v0.1
testId: SampleTest
displayName: Sample Test
description: Load test website home page
testPlan: SampleTest.jmx
testType: JMX
engineInstances: 1
autoStop:
  errorPercentage: 80
  timeWindow: 60

properties konfiguráció

A terhelési teszthez megadhat egy JMeter felhasználói tulajdonságokat tartalmazó fájlt. A rendszer feltölti a felhasználói tulajdonságokat tartalmazó fájlt a tesztterv és más fájlok mellett. További információ a JMeter felhasználói tulajdonságainak használatáról az Azure Load Testingben.

Felhasználói tulajdonság fájlkonfigurációs mintája

Az alábbi kódrészlet egy terhelésteszt-konfigurációt mutat be, amely egy felhasználói tulajdonságfájlt határoz meg.

version: v0.1
testId: SampleTest
displayName: Sample Test
description: Load test website home page
testPlan: SampleTest.jmx
testType: JMX
engineInstances: 1
properties:
  userPropertyFile: 'user.properties'

Az alábbi kódrészlet egy terhelésteszt-konfigurációt mutat be, amely egy Locust-konfigurációs fájlt határoz meg.

version: v0.1
testId: SampleTest
displayName: Sample Test
description: Load test website home page
testPlan: SampleTest.py
testType: Locust
engineInstances: 1
properties:
  userPropertyFile: 'locust.conf'

secrets konfiguráció

Titkos értékeket tárolhat az Azure Key Vaultban, és hivatkozhat rájuk a tesztcsomagban. További információ a titkos kódok Azure Load Testing használatával való használatáról.

Titkos kulcsok konfigurációs mintája

Az alábbi kódrészlet egy terhelésteszt-konfigurációt mutat be, amely egy titkos kódra my-secret hivatkozik az Azure Key Vaultban.

version: v0.1
testId: SampleTest
displayName: Sample Test
description: Load test website home page
testPlan: SampleTest.jmx
testType: JMX
engineInstances: 1
secrets:
  - name: my-secret
    value: https://akv-contoso.vault.azure.net/secrets/MySecret/abc1234567890def12345

env konfiguráció

Megadhatja a környezeti változókat, és hivatkozhat rájuk a teszttervben. További információ a környezeti változók Azure Load Testing használatával való használatáról.

Környezeti változó konfigurációs mintája

Az alábbi kódrészlet egy terhelésteszt-konfigurációt mutat be, amely környezeti változót my-variable és értéket my-valuehatároz meg.

version: v0.1
testId: SampleTest
displayName: Sample Test
description: Load test website home page
testPlan: SampleTest.jmx
testType: JMX
engineInstances: 1
env:
  - name: my-variable
    value: my-value

certificates konfiguráció

Az ügyféltanúsítványokat átadhatja a terheléses tesztnek. A tanúsítvány tárolása az Azure Key Vaultban történik. További információ az ügyféltanúsítványok Azure Load Testing használatával való használatáról.

Tanúsítványkonfigurációs minta

Az alábbi kódrészlet egy terhelésteszt-konfigurációt mutat be, amely az Azure Key Vaultban található ügyféltanúsítványra hivatkozik.

version: v0.1
testId: SampleTest
displayName: Sample Test
description: Load test website home page
testPlan: SampleTest.jmx
testType: JMX
engineInstances: 1
certificates:
  - name: my-certificate
    value: https://akv-contoso.vault.azure.net/certificates/MyCertificate/abc1234567890def12345

JSON-fájl kérése

Ha URL-alapú tesztet használ, A JMeter-tesztszkript használata helyett megadhatja a HTTP-kéréseket egy JSON-fájlban. Ügyeljen arra, hogy a testType tesztkonfigurációs YAML-fájlban állítsa be a beállítást URL , és hivatkozzon a kérések JSON-fájlra.

HTTP-kérések

A requests JSON-fájl a következő tulajdonságokat használja a kérelem meghatározásához a requests tulajdonságban:

A következő JSON-kódrészlet egy példakérési JSON-fájlt tartalmaz:

{
    "version": "1.0",
    "scenarios": {
        "requestGroup1": {
            "requests": [
                {
                    "requestName": "add",
                    "responseVariables": [],
                    "queryParameters": [
                        {
                            "key": "param1",
                            "value": "value1"
                        }
                    ],
                    "requestType": "URL",
                    "endpoint": "https://www.contoso.com/orders",
                    "headers": {
                        "api-token": "my-token"
                    },
                    "body": "{\r\n  \"customer\": \"Contoso\",\r\n  \"items\": {\r\n\t  \"product_id\": 321,\r\n\t  \"count\": 50,\r\n\t  \"amount\": 245.95\r\n  }\r\n}",
                    "method": "POST",
                    "requestBodyFormat": "JSON"
                },
                {
                    "requestName": "get",
                    "responseVariables": [],
                    "requestType": "CURL",
                    "curlCommand": "curl --request GET 'https://www.contoso.com/orders'"
                },
            ],
            "csvDataSetConfigList": []
        }
    },
    "testSetup": [
        {
            "virtualUsersPerEngine": 1,
            "durationInSeconds": 600,
            "loadType": "Linear",
            "scenario": "requestGroup1",
            "rampUpTimeInSeconds": 30
        }
    ]
}

Konfiguráció betöltése

A requests JSON-fájl a következő tulajdonságokat használja a tulajdonság terheléskonfigurációjának testSetup meghatározásához:

Regionális terhelésteszt konfigurációja

A terhelés régiók közötti elosztásával jobban szimulálhatja a valós forgalmi mintákat. Megadhatja azokat a régiókat, amelyekből a terhelést létre szeretné hozni, valamint az egyes régiókból szimulálni kívánt terhelés mennyiségét. Ezt a régió nevének és a régióban használni kívánt motorpéldányok számának megadásával teheti meg. További információ a terhelés több régióból történő generálásáról.

Regionális terhelésteszt konfigurációs mintája

Az alábbi kódrészlet egy terhelésteszt-konfigurációt mutat be, amely két Azure-régiót eastus és eastasia az egyes régiókhoz tartozó motorpéldányok számát határozza meg.

displayName: Sample Test
testPlan: sampleScript.jmx
description: 'Load test website home page'
engineInstances: 4
testId: SampleTest
testType: Locust
splitAllCSVs: False
regionalLoadTestConfig:
- region: eastus
  engineInstances: 2
- region: eastasia
  engineInstances: 2
failureCriteria:
- p90(response_time_ms) > 10000
autoStop:
  errorPercentage: 90
  timeWindow: 60

Kapcsolódó tartalom

• Megtudhatja, hogyan hozhat létre automatizált regressziós tesztelést a CI/CD-munkafolyamatban.
• Megtudhatja, hogyan paraméterezheti a terheléses teszteket titkos kódokkal és környezeti változókkal.
• Megtudhatja, hogyan töltheti be a teszt által védett végpontokat.