- Category: service
- Alibaba Cloud Performance Testing Service (PTS)
- Purpose
- Use Alibaba Cloud PTS OpenAPI to support:
- test scene inventory and inspection
- pressure test planning and lifecycle automation
- report and metrics retrieval for verification and troubleshooting
- Prerequisites
- Configure least-privilege Alibaba Cloud credentials.
- Install Python SDKs (virtual environment recommended):
- python3
- -m
- venv .venv
- .
- .venv/bin/activate
- python
- -m
- pip
- install
- -U
- alibabacloud_pts20201020 alibabacloud_tea_openapi
- Prefer environment variables:
- ALICLOUD_ACCESS_KEY_ID
- ALICLOUD_ACCESS_KEY_SECRET
- optional
- ALICLOUD_REGION_ID
- Before mutating operations, run read-only API discovery and current-state checks.
- AccessKey Priority
- Environment variables:
- ALICLOUD_ACCESS_KEY_ID
- /
- ALICLOUD_ACCESS_KEY_SECRET
- /
- ALICLOUD_REGION_ID
- Shared credentials file:
- ~/.alibabacloud/credentials
- If region/environment is unclear, confirm with user before mutating operations.
- Workflow
- Identify target region, test scene identifiers, and operation scope.
- Run API discovery to confirm API names and required parameters.
- Execute read-only APIs first (
- List*
- /
- Get*
- /
- Describe*
- ).
- Execute mutating operations only after confirming rollback and change window.
- Save outputs and evidence to
- output/alicloud-observability-pts/
- .
- API Discovery
- Product code:
- PTS
- Default API version:
- 2020-10-20
- Metadata source:
- https://api.aliyun.com/meta/v1/products/PTS/versions/2020-10-20/api-docs.json
- Minimal Executable Quickstart
- python skills/observability/pts/alicloud-observability-pts/scripts/list_openapi_meta_apis.py
- Optional arguments:
- python skills/observability/pts/alicloud-observability-pts/scripts/list_openapi_meta_apis.py
- \
- --product-code PTS
- \
- --version
- 2020
- -10-20
- \
- --output-dir output/alicloud-observability-pts
- List scenes (read-only):
- python skills/observability/pts/alicloud-observability-pts/scripts/list_pts_scenes.py
- \
- --region
- cn-hangzhou
- \
- --page-number
- 1
- \
- --page-size
- 10
- \
- --output
- output/alicloud-observability-pts/scenes.txt
- Start one scene (mutating):
- python skills/observability/pts/alicloud-observability-pts/scripts/start_pts_scene.py
- \
- --region
- cn-hangzhou
- \
- --scene-id
- <
- scene-id
- >
- \
- --wait
- \
- --output
- output/alicloud-observability-pts/start-result.json
- Stop one scene (mutating):
- python skills/observability/pts/alicloud-observability-pts/scripts/stop_pts_scene.py
- \
- --region
- cn-hangzhou
- \
- --scene-id
- <
- scene-id
- >
- \
- --wait
- \
- --output
- output/alicloud-observability-pts/stop-result.json
- Common Operation Map
- Scene inventory:
- ListPtsScene
- ,
- GetPtsScene
- ,
- ListOpenJMeterScenes
- ,
- GetOpenJMeterScene
- Scene lifecycle:
- CreatePtsScene
- ,
- SavePtsScene
- ,
- ModifyPtsScene
- ,
- DeletePtsScene
- ,
- DeletePtsScenes
- Test execution control:
- StartPtsScene
- ,
- StopPtsScene
- ,
- StartTestingJMeterScene
- ,
- StopTestingJMeterScene
- Debug control:
- StartDebugPtsScene
- ,
- StopDebugPtsScene
- ,
- StartDebuggingJMeterScene
- ,
- StopDebuggingJMeterScene
- Reports/metrics:
- ListPtsReports
- ,
- GetPtsReportDetails
- ,
- GetPtsSceneRunningData
- ,
- GetPtsSceneRunningStatus
- See
- references/api_quick_map.md
- for grouped API lists.
- Script Catalog
- scripts/list_openapi_meta_apis.py
-
- fetch metadata and generate API inventory files.
- scripts/list_pts_scenes.py
-
- list PTS scenes with pagination.
- scripts/start_pts_scene.py
-
- start a scene and optionally poll running status.
- scripts/stop_pts_scene.py
- stop a scene and optionally poll until non-running.
Output Policy
Write generated files and execution evidence to:
output/alicloud-observability-pts/
Validation
mkdir
-p
output/alicloud-observability-pts
for
f
in
skills/observability/pts/alicloud-observability-pts/scripts/*.py
;
do
python3
-m
py_compile
"
$f
"
done
echo
"py_compile_ok"
output/alicloud-observability-pts/validate.txt Pass criteria: command exits 0 and output/alicloud-observability-pts/validate.txt is generated. Output And Evidence Save artifacts, command outputs, and API response summaries under output/alicloud-observability-pts/ . Include key parameters (region/resource id/time range) in evidence files for reproducibility. References Source list: references/sources.md API quick map: references/api_quick_map.md request/response templates: references/templates.md
alicloud-observability-pts
安装
npx skills add https://github.com/cinience/alicloud-skills --skill alicloud-observability-pts