Spezifikation der MCP-Tools - Verteilte Lasttests auf AWS

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Spezifikation der MCP-Tools

Die Distributed Load Testing-Lösung bietet eine Reihe von MCP-Tools, mit denen KI-Agenten mit Testszenarien und Ergebnissen interagieren können. Diese Tools bieten umfassende, abstrakte Funktionen, die auf die Art und Weise abgestimmt sind, wie KI-Agenten Informationen verarbeiten, sodass sie sich auf Analysen und Erkenntnisse konzentrieren können, anstatt sich auf detaillierte API-Verträge zu konzentrieren.

Anmerkung

Alle MCP-Tools bieten nur Lesezugriff auf die Daten der Lösung. Über die MCP-Schnittstelle werden keine Änderungen an Testszenarien oder Konfigurationen unterstützt.

list_scenarios

Description

Das list_scenarios Tool ruft eine Liste aller verfügbaren Testszenarien mit grundlegenden Metadaten ab.

Endpoint

GET /scenarios

Parameters

Keine

Antwort

Name Description

testId

Eindeutiger Bezeichner für das Testszenario

testName

Name des Testszenarios

status

Aktueller Status des Testszenarios

startTime

Wann der Test erstellt oder zuletzt ausgeführt wurde

testDescription

Beschreibung des Testszenarios

get_scenario_details

Description

Das get_scenario_details Tool ruft die Testkonfiguration und den letzten Testlauf für ein einzelnes Testszenario ab.

Endpoint

GET /scenarios/<test_id>?history=false&results=false

Parameter anfordern

test_id
  • Die eindeutige Kennung für das Testszenario

    Typ: Zeichenfolge

    Erforderlich: Ja

Antwort

Name Description

testTaskConfigs

Aufgabenkonfiguration für jede Region

testScenario

Testdefinition und Parameter

status

Aktueller Teststatus

startTime

Zeitstempel für den Teststart

endTime

Endzeitstempel des Tests (falls abgeschlossen)

list_test_runs

Description

Das list_test_runs Tool ruft eine Liste von Testläufen für ein bestimmtes Testszenario ab, sortiert vom neuesten zum ältesten. Gibt maximal 30 Ergebnisse zurück.

Endpoint

GET /scenarios/<testid>/testruns/?limit=<limit>

oder

GET /scenarios/<testid>/testruns/?limit=30&start_date=<start_date>&end_date=<end_date>

Anforderungsparameter

test_id
  • Der eindeutige Bezeichner für das Testszenario

    Typ: Zeichenfolge

    Erforderlich: Ja

limit
  • Maximale Anzahl zurückzugebender Testläufe

    Typ: Ganzzahl

    Standard: 20

    Maximum: 30

    Erforderlich: Nein

start_date
  • ISO 8601-Zeitstempel zum Filtern von Läufen ab einem bestimmten Datum

    Typ: Zeichenfolge (Datums-/Uhrzeitformat)

    Erforderlich: Nein

end_date
  • Der ISO 8601-Zeitstempel zum Filtern läuft bis zu einem bestimmten Datum

    Typ: Zeichenfolge (Datums-/Uhrzeitformat)

    Erforderlich: Nein

Antwort

Name Description

testRuns

Eine Reihe von Zusammenfassungen der Testläufe mit Leistungskennzahlen und Perzentilen für jeden Lauf

get_test_run

Description

Das get_test_run Tool ruft detaillierte Ergebnisse für einen einzelnen Testlauf mit regionalen und Endpunktaufschlüsselungen ab.

Endpoint

GET /scenarios/<testid>/testruns/<testrunid>

Anforderungsparameter

test_id
  • Die eindeutige Kennung für das Testszenario

    Typ: Zeichenfolge

    Erforderlich: Ja

test_run_id
  • Die eindeutige Kennung für den spezifischen Testlauf

    Typ: Zeichenfolge

    Erforderlich: Ja

Antwort

Name Description

results

Vollständige Testlaufdaten, einschließlich Aufschlüsselung der regionalen Ergebnisse, endpunktspezifischer Metriken, Leistungsperzentile (p50, p90, p95, p99), Erfolgs- und Fehlschlagzahlen, Reaktionszeiten und Latenz sowie der für den Testlauf verwendeten Testkonfiguration

get_latest_test_run

Description

Das get_latest_test_run Tool ruft den letzten Testlauf für ein bestimmtes Testszenario ab.

Endpoint

GET /scenarios/<testid>/testruns/?limit=1

Anmerkung

Die Ergebnisse werden anhand eines Global Secondary Index (GSI) nach Zeit sortiert, sodass sichergestellt wird, dass der letzte Testlauf zurückgegeben wird.

Anforderungsparameter

test_id
  • Die eindeutige Kennung für das Testszenario

    Typ: Zeichenfolge

    Erforderlich: Ja

Antwort

Name Description

results

Aktuelle Testlaufdaten mit demselben Format wie get_test_run

get_baseline_test_run

Description

Das get_baseline_test_run Tool ruft den Basistestlauf für ein bestimmtes Testszenario ab. Die Baseline wird zu Leistungsvergleichszwecken verwendet.

Endpoint

GET /scenarios/<test_id>/baseline

Anforderungsparameter

test_id
  • Die eindeutige Kennung für das Testszenario

    Typ: Zeichenfolge

    Erforderlich: Ja

Antwort

Name Description

baselineData

Basisdaten des Testlaufs zu Vergleichszwecken, einschließlich aller Metriken und Konfigurationen aus dem angegebenen Baselinelauf

get_test_run_artifacts

Description

Das get_test_run_artifacts Tool ruft Amazon S3 S3-Bucket-Informationen für den Zugriff auf Testartefakte wie Protokolle, Fehlerdateien und Ergebnisse ab.

Endpoint

GET /scenarios/<testid>/testruns/<testrunid>

Anforderungsparameter

test_id
  • Die eindeutige Kennung für das Testszenario

    Typ: Zeichenfolge

    Erforderlich: Ja

test_run_id
  • Die eindeutige Kennung für den spezifischen Testlauf

    Typ: Zeichenfolge

    Erforderlich: Ja

Antwort

Name Description

bucketName

Name des S3-Buckets, in dem Artefakte gespeichert werden

testRunPath

Pfadpräfix für den aktuellen Artefaktspeicher (Version 4.0+)

testScenarioPath

Pfadpräfix für älteren Artefaktspeicher (vor Version 4.0)

Anmerkung

Alle MCP-Tools nutzen bestehende API-Endpunkte. Zur Unterstützung der MCP-Funktionalität APIs sind keine Änderungen am Basisprodukt erforderlich.