Wyniki testów

Pobieranie listy wyników testów

Aby otrzymać listę wyników testów należy wysłać wiadomość GET na adres /api/user/results/.
W odpowiedzi powinniśmy otrzymać wiadomość o treści z taką strukturą danych:
{
    "count": 2,
    "next": "http://$host_url/api/user/results/?limit=100&offset=100",
    "previous": null,
    "results": [
        {
            "id": 132899,
            "stage_group": 119577,
            "run_group": 67279,
            "cloud_location": null,
            "uuid": "e94f5129-db71-4837-87d8-f38b427f6fb7",
            "timestamp_created": "2021-04-23T15:33:00.998595+02:00",
            "timestamp_updated": "2021-04-23T15:33:01.397874+02:00",
            "status": 7,
            "result": {
                "result": {
                    "list": [
                        {
                            "rtt": 37.62,
                            "sequence": 1,
                            "succeeded": true
                        }
                    ],
                    "max_rtt": 37.62,
                    "min_rtt": 37.62,
                    "mean_rtt": 37.62,
                    "succeeded_count": 1
                },
                "finished": true,
                "parameters": {
                    "count": 1,
                    "address": "www.netrsr.com",
                    "interval": 1
                }
            },
            "threshold_exceeded": null,
            "test_block": 706,
            "block_group": 145780,
            "test_agent": 93
        },
        {
            "id": 132868,
            "stage_group": 119546,
            "run_group": 67248,
            "cloud_location": null,
            "uuid": "5fbf051f-64cf-48d6-973e-160a7e0252fc",
            "timestamp_created": "2021-04-22T14:38:14.741417+02:00",
            "timestamp_updated": "2021-04-22T14:38:16.425810+02:00",
            "status": 7,
            "result": {
                "result": {
                    "code": "200 OK",
                    "time_ms": 1556.903600692749,
                    "succeeded": true
                },
                "finished": true,
                "parameters": {
                    "url": "https://netrsr.com",
                    "cred": [
                        "root",
                        "netrsr123"
                    ],
                    "method": "head",
                    "auth_method": "none",
                    "allow_redirects": 1
                }
            },
            "threshold_exceeded": null,
            "test_block": 704,
            "block_group": 145749,
            "test_agent": 82
        }
    ]
}

Filtrowanie wyników

Jest również możliwość pobrania przefiltrowanych danych. Aby pobrać filtrowane dane należy do adresu wiadomości dopisać odpowiedni parametr: /api/user/results/?test_agent=1&test_suite=1.
Dostępne filtry:
  • test_agent - id test agenta (możliwość podania wielu wartości),

  • test_suite – id scenariusza,

  • run_group – id jednej grupy uruchomienia scenariusza,

  • stage_group – id jednego kroku jednego scenariusza,

  • stage_no – numer kroku,

  • test_block – id bloczka scenariusza,

  • threshold_exceeded – oznacza przekroczenie zadeklarowanego progu alarmowego (dostępne wartości true i false),

  • status – status zadania (możliwe liczby 4-8, możliwość podania wielu wartości):
    • 4 – zadanie wysłane do test agenta,

    • 5 – zadanie otrzymane przez test agenta,

    • 6 – zadanie uruchomione,

    • 7 – zadanie zakończone,

    • 8 – zadanie zakończone błędem.

Możliwe jest również podanie do filtra test agentów i/lub statusów wielu wartości. Aby to zrobić należy poszczególne wartości oddzielić znakiem:
  • „,” w przypadku gdy chcemy połączyć je operatorem logicznym „i”,

  • „|” w przypadku gdy chcemy połączyć je operatorem logicznym „lub”,

Pobieranie rezultatów testów wykonanych na test agencie o id 1, 2 lub 3: /api/user/results/?test_agent=1|2|3.

Sortowanie wyników

Możliwe jest również sortowanie wyników po dacie lub po nazwie. Należy to zrobić poprzez dopisanie do adresu wiadomości parametru ordering:
  • /api/user/results/?ordering=timestamp_updated dla sortowania wyników od tych z najstarszą datą aktualizacji do najnowszej,

  • /api/user/results/?ordering=-timestamp_updated dla sortowania wyników od tych z najnowszą datą aktualizacji do najstarszej,

  • /api/user/results/?ordering=timestamp_created dla sortowania wyników od tych z najstarszą datą utworzenia do najnowszej,

  • /api/user/results/?ordering=-timestamp_created dla sortowania wyników od tych z najnowszą datą utworzenia do najstarszej.

Pobieranie pojedynczego wyniku testu

Aby otrzymać dane szczegółowe lokalizacji należy wysłać wiadomość GET na adres /api/user/results/<id>/, gdzie <id> jest id wyniku, którego chcemy pobrać.
W odpowiedzi powinniśmy otrzymać wiadomość o treści z taką strukturą danych:
{
    "id": 132899,
    "stage_group": 119577,
    "run_group": 67279,
    "cloud_location": null,
    "uuid": "e94f5129-db71-4837-87d8-f38b427f6fb7",
    "timestamp_created": "2021-04-23T15:33:00.998595+02:00",
    "timestamp_updated": "2021-04-23T15:33:01.397874+02:00",
    "status": 7,
    "result": {
        "result": {
            "list": [
                {
                    "rtt": 37.62,
                    "sequence": 1,
                    "succeeded": true
                }
            ],
            "max_rtt": 37.62,
            "min_rtt": 37.62,
            "mean_rtt": 37.62,
            "succeeded_count": 1
        },
        "finished": true,
        "parameters": {
        "count": 1,
        "address": "www.netrsr.com",
        "interval": 1
        }
    },
    "threshold_exceeded": null,
    "test_block": 706,
    "block_group": 145780,
    "test_agent": 93
}