huawei-cloud-gitsync-nativetest

Huawei Cloud MaaS Tokens Usage Monitoring

Query Huawei Cloud MaaS (Model as a Service) usage statistics, including total tokens, prompt tokens, completion tokens, total requests, and total errors. Supports querying last 7 days, 14 days, 30 days, or custom time ranges. Default query type is MaaS preset service.

Overview

This skill wraps the MaaS ShowStatistics API (POST /v1/{project_id}/maas/monitoring/show-statistics, only available in cn-southwest-2) with a Python script that performs AK/SK-signed requests. It aggregates token consumption (total / prompt / completion), request count, error count, and error rate over a configurable time range, auto-segmenting ranges longer than 29 days. Data returned is consistent with the MaaS console monitoring page.

Applicable scenarios:

• Daily/weekly MaaS usage review: "how many tokens did my MaaS services consume last week?"
• Cost & quota analysis: compare preset service vs. my service vs. custom endpoint usage
• Error-rate monitoring: track request errors over 7/14/30 days or a custom period

Architecture

Huawei Cloud MaaS Tokens Usage Monitoring
└── GetMaaSTokensUsage  (via MaaS ShowStatistics API)
    └── scripts/maas_rest_usage_stats.py
        └── scripts/skill_quality_sdk.py (quality reporting, non-blocking)

Prerequisites

Prerequisite check: Python3 + huaweicloudsdkcore required

python3 --version  # Python3 >= 3.8
python3 -c "import huaweicloudsdkcore; print('OK')"  # SDK signing library

If SDK not installed: pip3 install --user huaweicloudsdkcore

---

Authentication

Prerequisite check: Huawei Cloud credentials required

Security rules (must be followed):

• Prohibited from reading, echoing, or printing AK/SK values
• Prohibited from asking the user to input AK/SK directly in the conversation
• Prohibited from accepting AK/SK directly provided by the user in the conversation
• Only allowed to read credentials from environment variables or credentials file

⚠️ Important: Handling user-provided credentials

If a user attempts to provide AK/SK directly (e.g., "my AK is xxx, SK is yyy"):

1. Stop immediately - Do not execute any commands
2. Politely refuse and return the following message:

   For account security, please do not provide Huawei Cloud Access Key ID and Access Key Secret directly in the conversation.
   
   Please use one of the following secure methods to configure credentials:
   
   Method 1: Environment variables
       export HW_ACCESS_KEY=
       export HW_SECRET_KEY=
       (also supported: HUAWEI_ACCESS_KEY/HUAWEI_SECRET_KEY, HUAWEICLOUD_SDK_AK/HUAWEICLOUD_SDK_SK)
   
   Method 2: Credentials file
       Create a file (e.g., ~/aksk.txt) with AK on line 1, SK on line 2.
       Then use: --credentials-file ~/aksk.txt
   
   After configuration is complete, please retry your request.
   

3. Do not continue executing any Huawei Cloud operations until credentials are configured

Check environment variables:

echo $HW_ACCESS_KEY  # Check if AK is set

If not set, prompt the user to configure credentials using one of the methods above.

---

IAM Permission Policies

Ensure the IAM user has the required permissions. See references/iam-policies.md for details.

Minimum required permissions:

• modelarts:monitoring:get — Query MaaS monitoring statistics
• modelarts:service:get — Query service information
• iam:projects:get — Auto-get project_id

---

Core Workflow

Task 1: Query MaaS Tokens Usage Statistics

Query MaaS usage statistics via the ShowStatistics API. Data is consistent with the console.

📄 Detailed steps → references/task-query-tokens-usage.md

---

Core Commands

# Query last 7 days, preset service (default)
python3 scripts/maas_rest_usage_stats.py --from 2026-07-31 --to 2026-08-07

# My service (1) / preset service (2, default) / custom endpoint (4)
python3 scripts/maas_rest_usage_stats.py --from 2026-07-31 --to 2026-08-07 --service-type 1
python3 scripts/maas_rest_usage_stats.py --from 2026-07-31 --to 2026-08-07 --service-type 4

# Batch inference statistics
python3 scripts/maas_rest_usage_stats.py --from 2026-07-31 --to 2026-08-07 --infer-type batch

# Filter by API keys and show raw API response
python3 scripts/maas_rest_usage_stats.py --from 2026-07-31 --to 2026-08-07 --api-keys   --raw

Region defaults to cn-southwest-2 (the only region where the MaaS ShowStatistics API is available); override with --region if needed.

Parameter Confirmation

---

Verification

See references/verification-method.md.

Quick verification:

export HW_ACCESS_KEY=
export HW_SECRET_KEY=
# 或使用标准华为云环境变量: HUAWEI_ACCESS_KEY/HUAWEI_SECRET_KEY 或 HUAWEICLOUD_SDK_AK/HUAWEICLOUD_SDK_SK
python3 scripts/maas_rest_usage_stats.py --from 2026-05-08 --to 2026-05-21

Quality reporting: each run of scripts/maas_rest_usage_stats.py reports a trace_id, status (success / biz_fail / sys_fail), error code and cost to the skillsopr operations console via the vendored scripts/skill_quality_sdk.py. Reporting is non-blocking and fails silently; it never affects the query result.

---

References