本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Amazon EBS 詳細效能統計資料
<a name="nvme-detailed-performance-stats"></a>

Amazon EBS NVMe 區塊型設備為連接至 Nitro 型 Amazon EC2 執行個體的 Amazon EBS 磁碟區提供即時、高解析度 I/O 效能統計資料。這些統計資料會以彙總計數器呈現，並在磁碟區連接至執行個體的期間保留。統計資料提供有關累積操作數量、傳送和接收的位元組，以及讀取和寫入 I/O 操作所花費時間的詳細資訊。此外，統計資料包括讀取和寫入 I/O 操作的長條圖，以及應用程式超過 EBS 磁碟區或連接執行個體的佈建 IOPS 或輸送量限制的總時間。

您最多可以 1 秒間隔的精細程度收集這些統計資料。如果請求的間隔超過 1 秒，NVMe 驅動程式可能會將請求與其他管理員命令排入佇列，以便稍後處理。

**考量**
+ 所有 Amazon EBS 磁碟區類型都支援統計資料。
+ 統計資料僅支援連接至[在 AWS Nitro 系統上建置之執行個體的](https://docs.aws.amazon.com/ec2/latest/instancetypes/ec2-nitro-instances.html)磁碟區。
+ 統計資料適用於啟用 Multi-Attach 的磁碟區。檢視啟用 Multi-Attach 之磁碟區的統計資料時，統計資料專屬於該執行個體連接，並僅反映該執行個體的用量。
+ 統計資料可免費使用。

## 統計資料
<a name="nvme-stats"></a>

Amazon EBS NVMe 區塊型設備提供下列統計資料：


| 統計資料名稱 | 全名 | 類型 | 描述 | 
| --- | --- | --- | --- | 
| total\$1read\$1ops | 讀取操作總數 | 計數器 | 已完成讀取操作的總數。 | 
| total\$1write\$1ops | 寫入操作總數 | 計數器 | 已完成寫入操作的總數。 | 
| total\$1read\$1bytes | 總讀取位元組數 | 計數器 | 傳輸的讀取位元組總數。 | 
| total\$1write\$1bytes | 總寫入位元組數 | 計數器 | 傳輸的寫入位元組總數。 | 
| total\$1read\$1time | 總讀取時間 | 計數器 | 所有已完成讀取操作所花費的總時間，以微秒為單位。 | 
| total\$1write\$1time | 總寫入時間 | 計數器 | 所有已完成寫入操作所花費的總時間，以微秒為單位。 | 
| ebs\$1volume\$1performance\$1exceeded\$1iops | 總時間需求超過磁碟區佈建 IOPS | 計數器 | IOPS 需求超過磁碟區佈建 IOPS 效能的總時間，以微秒為單位。 | 
| ebs\$1volume\$1performance\$1exceeded\$1tp | 總時間需求超過磁碟區佈建輸送量 | 計數器 | 輸送量需求超過磁碟區佈建輸送量效能的總時間，以微秒為單位。 | 
| ec2\$1instance\$1ebs\$1performance\$1exceeded\$1iops | 總時間需求超過 EC2 執行個體的 IOPS 效能 | 計數器 | EBS 磁碟區超過連接之 Amazon EC2 執行個體 IOPS 效能上限的總時間，以微秒為單位。 | 
| ec2\$1instance\$1ebs\$1performance\$1exceeded\$1tp | 總時間需求超過 EC2 執行個體的輸送量效能 | 計數器 | EBS 磁碟區超過連接的 Amazon EC2 執行個體最大輸送量效能的總時間，以微秒為單位。 | 
| volume\$1queue\$1length | 磁碟區佇列長度 | 時間點 | 等待完成的讀取和寫入操作數目。 | 
| read\$1io\$1latency\$1histogram | 讀取 I/O 長條圖 | 直方圖 \$1 | 每個延遲儲存貯體內完成的讀取操作數量，以微秒為單位。 | 
| write\$1io\$1latency\$1histogram | 寫入 I/O 長條圖 | 直方圖 \$1 | 每個延遲儲存貯體內完成的寫入操作數量，以微秒為單位。 | 

**注意**  
\$1 直方圖統計資料僅代表成功完成的 I/O 操作。不包含停滯或受損的 I/O 操作，但在`volume_queue_length`統計資料中將明顯呈現為point-in-time統計資料。

## 存取統計資料
<a name="nvme-stat-access"></a>

必須直接從連接 Amazon EBS 磁碟區的執行個體存取統計資料。您可以使用下列其中一種方法來存取統計資料。

### Linux 執行個體
<a name="nvme-stat-access-linux"></a>

------
#### [ Amazon CloudWatch ]

您可以設定 Amazon CloudWatch 代理程式從執行個體收集統計資料，並將其做為 CloudWatch 中的自訂指標。然後，您可以使用 CloudWatch 中的指標來分析 I/O 模式、追蹤效能趨勢、建立自訂儀表板，並根據效能閾值設定自動警示。

如需設定 CloudWatch 代理程式的詳細資訊，請參閱下列內容：
+ [ 建立 CloudWatch 代理程式組態檔案](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html)
+ [ 收集 Amazon EBS NVMe 驅動程式指標](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Container-Insights-metrics-EBS-Collect.html)

使用 Amazon CloudWatch Observability EKS 附加元件版本 `4.1.0` 和更新版本時，會在啟用 Amazon EBS CSI 驅動程式指標時自動收集統計資料。如需詳細資訊，請參閱 [ Amazon EBS NVMe 驅動程式指標](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Container-Insights-metrics-enhanced-EKS.html#Container-Insights-metrics-EBS)。

------
#### [ ebsnvme script ]

您可以在 [ amazon-ec2-utils Github 儲存庫](https://github.com/amazonlinux/amazon-ec2-utils)中找到`ebsnvme`指令碼。

**存取統計資料**

1. 連接至磁碟區所連接的執行個體。

1. 從 `amazon-ec2-utils` Github 儲存庫下載`ebsnvme`指令碼。

   ```
   wget https://raw.githubusercontent.com/amazonlinux/amazon-ec2-utils/refs/heads/main/ebsnvme
   ```

1. 修改指令碼的許可，使其可執行。

   ```
   sudo chmod +x ./ebsnvme
   ```

1. 執行`ebsnvme`指令碼並指定磁碟區的裝置名稱。

   ```
   sudo ./ebsnvme stats /dev/nvme0n1
   ```

------
#### [ nvme-cli tool ]

**存取統計資料**

1. 連接至磁碟區所連接的執行個體。

1. 2024 年 11 月 12 日之後發行的 Amazon Linux AMIs 包含最新版本`nvme-cli`的工具。如果您使用的是較舊的 Amazon Linux AMI，請更新 `nvme-cli`工具。

   ```
   sudo yum install nvme-cli
   ```

1. 執行下列命令，並指定磁碟區的裝置名稱。

   ```
   nvme amzn stats /dev/nvme0n1
   ```

------
#### [ Prometheus ]

您可以使用開放原始碼監控應用程式 Prometheus 和 Amazon Managed Service for Prometheus 來監控統計資料。這可讓您更輕鬆地大規模監控跨容器和 Kubernetes 環境的 Amazon EBS 磁碟區。使用 Amazon EBS CSI 驅動程式 1.37.0 版及更新版本，詳細的效能統計資料會公開為 Prometheus 相容`/metrics`端點，以匯出至 Prometheus。

如需詳細資訊，請參閱[《Amazon Managed Service for Prometheus 使用者指南》中的將指標擷取至 Amazon Managed Service for Prometheus 工作區](https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-ingest-methods.html)。 **

------

### Windows 執行個體
<a name="nvme-stat-access-windows"></a>

------
#### [ nvme\$1amzn.exe tool ]

**存取統計資料**

1. 連接至磁碟區所連接的執行個體。

1. 請確定您使用的是 AWSNVMe 驅動程式版本 `1.7.0`或更新版本。如需更新 AWSNVMe 驅動程式的詳細資訊，請參閱 [AWS NVMe 驅動程式](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/aws-nvme-drivers.html)。

1. 取得 EBS 磁碟區的磁碟編號。如需詳細資訊，請參閱[將 Amazon EBS 磁碟區映射至 NVMe 裝置名稱](https://docs.aws.amazon.com/ebs/latest/userguide/identify-nvme-ebs-device.html)

1. 以管理員身分執行下列命令，並指定磁碟區的磁碟編號。

   ```
   .\nvme_amzn.exe stats disk_number
   ```

------