hyperpod-issue-report
/hyperpod-issue-report
Generate comprehensive issue reports from HyperPod clusters (EKS and Slurm) by collecting diagnostic logs and configurations for troubleshooting and AWS Support cases. Use when users need to collect diagnostics from HyperPod cluster nodes, generate issue reports for AWS Support, investigate node failures or performance problems, document cluster state, or create diagnostic snapshots. Triggers on requests involving issue reports, diagnostic collection, support case preparation, or cluster troubleshooting that requires gathering logs and system information from multiple nodes.
- Author
- 420company ↗
- Repository
- artemis ↗
- Licence
- MIT
- Last repository change
- 25.10.2026
Assessment and security
- Files in this package
- 5
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 2
No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/hyperpod_issue_report.py
What it does and when to use it
Generate comprehensive issue reports from HyperPod clusters (EKS and Slurm) by collecting diagnostic logs and configurations for troubleshooting and AWS Support cases. Use when users need to collect diagnostics from HyperPod cluster nodes, generate issue reports for AWS Support, investigate node failures or performance problems, document cluster state, or create diagnostic snapshots. Triggers on requests involving issue reports, diagnostic collection, support case preparation, or cluster troubleshooting that requires gathering logs and system information from multiple nodes.
Original author description
Generate comprehensive issue reports from HyperPod clusters (EKS and Slurm) by collecting diagnostic logs and configurations for troubleshooting and AWS Support cases. Use when users need to collect diagnostics from HyperPod cluster nodes, generate issue reports for AWS Support, investigate node failures or performance problems, document cluster state, or create diagnostic snapshots. Triggers on requests involving issue reports, diagnostic collection, support case preparation, or cluster troubleshooting that requires gathering logs and system information from multiple nodes.
How it works
- Prerequisites
- Workflow
- Troubleshooting
SKILL.md preview
--- name: hyperpod-issue-report description: Generate comprehensive issue reports from HyperPod clusters (EKS and Slurm) by collecting diagnostic logs and configurations for troubleshooting and AWS Support cases. Use when users need to collect diagnostics from HyperPod cluster nodes, generate issue reports for AWS Support, investigate node failures or performance problems, document cluster state, or create diagnostic snapshots. Triggers on requests involving issue reports, diagnostic collection, support case preparation, or cluster troubleshooting that requires gathering logs and system information from multiple nodes. metadata: version: "1.0.0" --- # HyperPod Issue Report Collect diagnostic logs from HyperPod cluster nodes via SSM, store results in S3. Supports both EKS and Slurm clusters with auto-detection. Uses the bundled `scripts/hyperpod_issue_report.py` for reliable parallel collection. ## Prerequisites - AWS CLI configured with permissions: `sagemaker:DescribeCluster`, `sagemaker:ListClusterNodes`, `ssm:StartSession`, `s3:PutObject`, `s3:GetObject`, `eks:DescribeCluster` - Python 3.8+ and [uv](https://docs.astral.sh/uv/) (see [uv installation docs](https://docs.astral.sh/uv/getting-started/installation/) for install options) - SSM Agent running on target nodes; node IAM roles need `s3:GetObject`/`s3:PutObject` on the report bucket - For EKS clusters: kubectl installed and configured (see Workflow step 2) ## Workflow ### 1. Gather Information Collect from the user: - **Cluster identifier** (required): accepts cluster name or full cluster ARN (e.g., `arn:aws:sagemaker:us-west-2:123456789012:cluster/abc123`) - **AWS region** (required unless extractable from ARN) - **S3 path** for report storage (required, e.g. `s3://bucket/prefix`). If the user doesn't have a bucket, create one (e.g., `s3://hyperpod-diagnostics-<account-id>-<region>`) - **Issue description** (optional) - **Target scope**: all nodes, specific instance groups, or specific node IDs (optional) - **Additional commands** to run on nodes (optional) ### 2. Verify Environment ```bash aws sts get-caller-identity aws sagemaker describe-cluster --cluster-name <name-or-arn> --region <region> ``` If the S3 bucket doesn't exist, create it: ```bash aws s3 mb s3://<bucket-name> --region <region> ``` **For EKS clusters** (check `Orchestrator.Eks` in describe-cluster output): 1. Ensure kubectl is installed (`which kubectl`). If missing, install it for the current platform. 2. Configure kubeconfig using the EKS cluster name from the describe-cluster response: ```bash aws eks update-kubeconfig --name <eks-cluster-name> --region <region> ``` ### 3. Run the Collection Script ```bash uv run scripts/hyperpod_issue_report.py \ --cluster <cluster-name-or-arn> \ --region <region> \ --s3-path s3://<bucket>[/prefix] ``` Use `--help` for all options including `--instance-groups`, `--nodes`, `--command`, `--max-workers`, and `--debug`. Note: `--instance-groups` and `--nodes` are mutually exclusive. Node identifiers accept instance IDs (`i-*`), EKS names (`hyperpod-i-*`), or Slurm names (`ip-*`). ### 4. Present Results After collection, the script shows statistics and offers interactive download. Report the S3 location and offer to: - Download the report locally - Help analyze collected diagnostics (see [references/collection-details.md](references/collection-details.md) for what's in each file) - Prepare a summary for AWS Support ## Troubleshooting See [references/troubleshooting.md](references/troubleshooting.md) for error handling, large cluster tuning, and known limitations.
Files in this package (5)
- SKILL.json 1 KB
- SKILL.md 4 KB
- references/collection-details.md 4 KB
- references/troubleshooting.md 4 KB
- scripts/hyperpod_issue_report.py 67 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · 420company/artemis | 95 | MIT |
| awslabs/agent-plugins | 100 | Apache-2.0 |
Database snapshot: 13.11.2026 · package version 721e8562e912 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 95hyperpod-ssm
Remote command execution and file transfer on SageMaker HyperPod cluster nodes via AWS Systems Manager (SSM). This is the primary interface for accessing HyperPod nodes — direct SSH is not available. Use when any skill, workflow, or user request needs to execute commands on… - 100hyperpod-ssm
Remote command execution and file transfer on SageMaker HyperPod cluster nodes via AWS Systems Manager (SSM). This is the primary interface for accessing HyperPod nodes — direct SSH is not available. Use when any skill, workflow, or user request needs to execute commands on… - 95hyperpod-version-checker
Check and compare software component versions on SageMaker HyperPod cluster nodes - NVIDIA drivers, CUDA toolkit, cuDNN, NCCL, EFA, AWS OFI NCCL, GDRCopy, MPI, Neuron SDK (Trainium/Inferentia), Python, and PyTorch. Use when checking component versions, verifying CUDA/driver… - 100sagemaker-ai
Build, train, deploy, monitor, or troubleshoot workloads on Amazon SageMaker AI. Use for SageMaker Python SDK v3, model training and customization, inference, HyperPod, Model Monitor, AutoGluon, Pipelines, or iterative training with managed warm pools. - 100coreweave-debug-bundle
Collect CoreWeave cluster diagnostics for support tickets. Use when preparing a support case, collecting GPU node status, or documenting pod failures. Trigger with phrases like "coreweave debug", "coreweave support", "coreweave diagnostics", "collect coreweave logs". - 100eks-cluster-config
Configure eks cluster config operations. Auto-activating skill for AWS Skills. Triggers on: eks cluster config, eks cluster config Part of the AWS Skills skill category. Use when configuring systems or services. Trigger with phrases like "eks cluster config", "eks config", "eks".