GetCpuUsageData
Monitor and retrieve CPU usage data for AlibabaCloud ECS instances by specifying region and instance IDs, enabling efficient resource management and performance tracking.
Instructions
获取ECS实例的CPU使用率数据
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| InstanceIds | Yes | AlibabaCloud ECS instance ID List | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
Implementation Reference
- Handler function for the GetCpuUsageData tool (named CMS_GetCpuUsageData). Fetches CPU total usage metrics from Alibaba Cloud CMS for given ECS instance IDs and region. Includes input schema via Pydantic Fields.@tools.append def CMS_GetCpuUsageData( InstanceIds: List[str] = Field(description='AlibabaCloud ECS instance ID List'), RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou') ): """获取ECS实例的CPU使用率数据""" return _get_cms_metric_data(RegionId, InstanceIds, 'cpu_total')
- Core helper function that performs the actual API call to retrieve metric data (e.g., CPU usage) using Alibaba Cloud CMS DescribeMetricLast API.def _get_cms_metric_data(region_id: str, instance_ids: List[str], metric_name: str): client = create_client(region_id) dimesion = [] for instance_id in instance_ids: dimesion.append({ 'instanceId': instance_id }) describe_metric_last_request = cms_20190101_models.DescribeMetricLastRequest( namespace='acs_ecs_dashboard', metric_name=metric_name, dimensions=json.dumps(dimesion), ) describe_metric_last_resp = client.describe_metric_last(describe_metric_last_request) logger.info(f'CMS Tools response: {describe_metric_last_resp.body}') return describe_metric_last_resp.body.datapoints
- Helper function to create the CMS client configured for the metrics endpoint in the specified region.def create_client(region_id: str) -> cms20190101Client: config = create_config() config.endpoint = f'metrics.{region_id}.aliyuncs.com' return cms20190101Client(config)
- src/alibaba_cloud_ops_mcp_server/server.py:84-85 (registration)Registration of all CMS tools (including CMS_GetCpuUsageData) to the FastMCP server instance.for tool in cms_tools.tools: mcp.tool(tool)