SysOM diagnostic Skill

更新时间:
复制 MD 格式

The SysOM diagnostic Skill (alibabacloud-sysom-diagnosis) is an official operating system diagnostic tool from Alibaba Cloud, available on the Alibaba Cloud Agent Skills Portal. This Skill is designed to help operations and development professionals quickly diagnose system-level issues on Linux instances, including issues related to memory, network, I/O, and load.

Overview

The SysOM diagnostic Skill is an intelligent diagnostic tool released by the Alibaba Cloud operating system team and is available through the Alibaba Cloud Agent Skills Portal. This tool packages operating system diagnostic capabilities into a standardized Skill interface, enabling automated system diagnosis through an AI assistant.

Prerequisites

To use the SysOM diagnostic Skill, you must complete the following:

  1. Install and configure Aliyun CLI

    Ensure that you have Aliyun CLI version 3.3.3 or later installed. If not, see Install Alibaba Cloud CLI.

  2. Configure access credentials

    Configure your AccessKey ID and AccessKey secret as access credentials for calling the Alibaba Cloud OpenAPI. See Configure credentials.

  3. Grant permissions

    Ensure that your account or RAM user is granted the AliyunSysomFullAccess system policy. This policy includes all permissions required to use the SysOM diagnostic Skill.

  4. Install the Skill

    In the Alibaba Cloud Agent Skills Portal, search for and install alibabacloud-sysom-diagnosis.

Diagnostic capabilities

Once installed, the SysOM diagnostic Skill provides the following diagnostic capabilities. The results are output in a structured JSON format.

Type

Item

Description

Memory diagnosis

Panoramic memory analysis

Use when memory usage is high, but the source of the consumption is unclear.

Java memory diagnosis

Combines application-layer (JVM) and operating system-level memory views to quickly locate the root cause of abnormal memory usage and OOMKilled events in containerized Java applications.

OOM diagnosis

Analyzes the cause of an Out-of-Memory (OOM) event in the operating system.

Network diagnosis

Packet loss diagnosis

Analyzes packet loss at the operating system kernel level and recommends solutions.

Network jitter diagnosis

Analyzes network jitter on an ECS instance to determine its cause.

I/O diagnosis

I/O traffic analysis

Analyzes the source of I/O traffic in the system. Suitable for resolving I/O burst issues.

One-click I/O diagnosis

For common issues like high I/O latency, I/O bursts, and I/O wait, this tool automatically identifies the problem type and runs sub-tools for analysis.

Load diagnosis

Scheduling jitter diagnosis

Analyzes why user-space processes are not scheduled for long periods, which occurs when the CPU fails to switch tasks.

System load diagnosis

Analyzes the cause of an abnormal one-minute average system load (the load1 metric) and provides recommended actions.

Crash diagnosis

Crash diagnosis

Analyzes the cause of a system crash by using system logs and dump files.

Usage

Once installed, you can use the SysOM diagnostic Skill in the following ways:

  1. In an AI assistant that supports Alibaba Cloud Agent Skills, describe a system issue in natural language. The assistant will automatically invoke the SysOM diagnostic Skill for analysis.

  2. Call the Skill API directly from the Aliyun CLI by passing the instance ID and diagnosis type to run a diagnosis.

Note
  • The diagnostic process is read-only and does not modify your system configuration or data.

  • Diagnosis results are returned in a structured JSON format for programmatic processing and integration.