Konfigurace zátěžového testu v YAML

Zjistěte, jak pomocí YAML nakonfigurovat zátěžový test ve službě Azure Load Testing. Soubor YAML konfigurace testů použijete k vytvoření a spuštění zátěžových testů z pracovního postupu kontinuální integrace a průběžného doručování (CI/CD).

Syntaxe YAML zátěžového testu

Konfigurace zátěžového testu používá následující klíče:

Ukázka konfigurace zátěžového testu

Následující fragment kódu YAML obsahuje ukázkovou konfiguraci zátěžového testu.

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

Konfigurace failureCriteria

Kritéria selhání testu umožňují definovat podmínky, které určují, jestli bylo spuštění zátěžového testu úspěšné nebo ne. Pokud jsou splněna některá kritéria selhání, test získá neúspěšný výsledek testu. Přečtěte si další informace o použití kritérií selhání zátěžového testu.

Můžete definovat kritéria selhání, která platí pro celý zátěžový test nebo která se vztahují na konkrétní požadavek. Kritéria selhání mají následující strukturu:

• Kritéria testu na úrovni zátěžového testu: Aggregate_function (client_metric) condition threshold.
• Testová kritéria použitá pro konkrétní požadavky JMeter: Request: Aggregate_function (client_metric) condition threshold.

Podporované metriky klienta

Azure Load Testing podporuje následující metriky klienta:

Ukázka konfigurace neúspěšných kritérií

Následující fragment kódu ukazuje konfiguraci zátěžového testu, která má tři kritéria selhání zátěžového testu.

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

Konfigurace autoStop

Funkce automatického zastavování zátěžového testu umožňuje automaticky zastavit zátěžový test, pokud procento chyby překročí určitou prahovou hodnotu během daného časového intervalu. Přečtěte si další informace o funkci automatického dokončování zátěžových testů.

Ukázka konfigurace automatického zamyšlování

Následující fragment kódu ukazuje konfiguraci zátěžového testu, která má tři kritéria selhání zátěžového testu.

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

Konfigurace properties

Pro zátěžový test můžete zadat soubor vlastností uživatele JMeter. Soubor vlastností uživatele se nahraje spolu s testovacím plánem a dalšími soubory. Přečtěte si další informace o používání vlastností uživatele JMeter v Azure Load Testing.

Ukázka konfigurace souboru vlastností uživatele

Následující fragment kódu ukazuje konfiguraci zátěžového testu, která určuje soubor vlastností uživatele.

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'

Následující fragment kódu ukazuje konfiguraci zátěžového testu, která specifikuje konfigurační soubor Sady.

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'

Konfigurace secrets

Hodnoty tajných kódů můžete ukládat ve službě Azure Key Vault a odkazovat na ně v testovacím plánu. Přečtěte si další informace o používání tajných kódů s využitím zátěžového testování Azure.

Ukázka konfigurace tajných kódů

Následující fragment kódu ukazuje konfiguraci zátěžového testu, která odkazuje na tajný klíč my-secret ve službě Azure Key Vault.

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

Konfigurace env

Můžete zadat proměnné prostředí a odkazovat na ně v testovacím plánu. Přečtěte si další informace o používání proměnných prostředí s využitím zátěžového testování Azure.

Ukázka konfigurace proměnné prostředí

Následující fragment kódu ukazuje konfiguraci zátěžového testu, která určuje proměnnou my-variable prostředí a hodnotu my-value.

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

Konfigurace certificates

Klientské certifikáty můžete předat zátěžový test. Certifikát je uložený ve službě Azure Key Vault. Přečtěte si další informace o používání klientských certifikátů se službou Azure Load Testing.

Ukázka konfigurace certifikátu

Následující fragment kódu ukazuje konfiguraci zátěžového testu, která odkazuje na klientský certifikát ve službě Azure Key Vault.

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

Žádost o soubor JSON

Pokud používáte test založený na adrese URL, můžete místo testovacího skriptu JMeter zadat požadavky HTTP v souboru JSON. Nezapomeňte nastavit testType hodnotu URL v souboru YAML konfigurace testu a odkazovat na soubor JSON požadavků.

Požadavky HTTP

Soubor JSON požadavků používá pro definování požadavků ve requests vlastnosti následující vlastnosti:

Následující fragment kódu JSON obsahuje příklad požadavků na soubor JSON:

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

Konfigurace načtení

Soubor JSON požadavků používá k definování konfigurace načtení ve testSetup vlastnosti následující vlastnosti:

Konfigurace místního zátěžového testu

Zatížení můžete distribuovat napříč oblastmi a lépe simulovat vzory provozu v reálném životě. Můžete zadat oblasti, ze kterých chcete vygenerovat zatížení, a množství zatížení, které chcete simulovat z každé oblasti. Můžete to provést zadáním názvu oblasti a počtu instancí modulu, které chcete v dané oblasti. Přečtěte si další informace o generování zatížení z více oblastí.

Ukázka konfigurace místního zátěžového testu

Následující fragment kódu ukazuje konfiguraci zátěžového testu, která určuje dvě oblasti eastus Azure a eastasia počet instancí modulu pro každou oblast.

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

Související obsah

• Naučte se vytvářet automatizované regresní testování v pracovním postupu CI/CD.
• Naučte se parametrizovat zátěžové testy pomocí tajných kódů a proměnných prostředí.
• Naučte se načítat zabezpečené koncové body zátěžového testu.