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

# 搭配使用 Amazon CloudWatch 與 HealthImaging
<a name="monitoring-cloudwatch"></a>

您可以使用 CloudWatch 監控 AWS HealthImaging，這會收集原始資料並將其處理為可讀且近乎即時的指標。這些統計資料會保留 15 個月，因此您可以使用該歷史資訊，並更清楚 Web 應用程式或服務的效能。您也可以設定留意特定閾值的警示，當滿足這些閾值時傳送通知或採取動作。如需詳細資訊，請參閱 [Amazon CloudWatch 使用者指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)。

HealthImaging 會將下列類型的指標發佈至 `AWS/HealthImaging` 命名空間中的 CloudWatch：
+ **API 指標** - HealthImaging API 操作的呼叫計數
+ **HealthImaging 指標** - 資料存放區和帳戶層級資源使用量

**注意**  
大多數 HealthImaging APIs 都會回報指標。
HealthImaging 指標僅適用於 2026 年 2 月 9 日之後建立的資料存放區，或提交[支援案例](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html)。

## AWS HealthImaging API 指標
<a name="api-metrics-cloudwatch"></a>

下表列出 HealthImaging 的指標和維度。每個 都會顯示為使用者指定資料範圍的頻率計數。


**指標**  

|  指標  | Description | 
| --- | --- | 
| CallCount | 呼叫 APIs的次數。這可以針對帳戶或指定的資料存放區進行報告。 單位：Count 有效統計資料：總和、計數 維度：操作、資料存放區 ID、資料存放區類型  | 

您可以使用 AWS CLI AWS 管理主控台、 或 CloudWatch API 取得 HealthImaging 的指標。您可以透過其中一個 Amazon AWS 軟體開發套件 (SDKs) 或 CloudWatch API 工具來使用 CloudWatch API。HealthImaging 主控台會根據來自 CloudWatch API 的原始資料顯示圖形。

您必須擁有適當的 CloudWatch 許可，才能使用 CloudWatch 監控 HealthImaging。如需詳細資訊，請參閱《[CloudWatch 使用者指南》中的 CloudWatch 的 Identity and Access Management](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html)。 *CloudWatch *

## AWS HealthImaging 指標
<a name="healthimaging-metrics-cloudwatch"></a>

`AWS/HealthImaging` 命名空間包含帳戶和資料存放區層級的下列指標。

### 帳戶層級指標
<a name="account-level-metrics"></a>

帳戶層級指標可提供您帳戶中所有資料存放區的彙總可見性。


**帳戶層級指標**  

| 指標 | Description | 
| --- | --- | 
| DataStoreCount |  處於作用中狀態的資料存放區數目。 單位：Count 有效統計資料：總和、平均  | 
| ImageSetCount |  所有資料存放區的影像集總數。 單位：Count 有效統計資料：總和、平均  | 
| StorageBytes |  儲存在下列儲存層中所有資料存放區中的位元組資料量： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/healthimaging/latest/devguide/monitoring-cloudwatch.html) 此值的計算方式是加總所有資料存放區中所有影像集的大小。 有效的儲存層篩選條件 （請參閱 [`StorageTier`](#dimensions-cloudwatch)維度）： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/healthimaging/latest/devguide/monitoring-cloudwatch.html) 單位：位元組 有效統計資料：總和、平均  | 

### 資料存放區層級指標
<a name="datastore-level-metrics"></a>

資料存放區層級指標提供個別資料存放區的詳細可見性。


**資料存放區層級指標**  

| 指標 | Description | 
| --- | --- | 
| TotalImageSetCount |  資料存放區中的映像集總數。 單位：Count 有效統計資料：總和、平均  | 
| PrimaryImageSetCount |  資料存放區中主要影像集的數量。 單位：Count 有效統計資料：總和、平均  | 
| SmallImageSetCount |  資料存放區中的影像集數量小於 5MB。 單位：Count 有效統計資料：總和、平均  | 
| StorageBytes |  儲存在下列儲存層中所有資料存放區中的位元組資料量： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/healthimaging/latest/devguide/monitoring-cloudwatch.html) 此值的計算方式是加總資料存放區中所有影像集的大小。 有效的儲存層篩選條件 （請參閱 [`StorageTier`](#dimensions-cloudwatch)維度）： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/healthimaging/latest/devguide/monitoring-cloudwatch.html) 單位：位元組 有效統計資料：總和、平均  | 
| DICOMStudyCount |  資料存放區中的 DICOM 檢查數量。 單位：Count 有效統計資料：總和、平均  | 
| DICOMSeriesCount |  資料存放區中的 DICOM 序列數目。 單位：Count 有效統計資料：總和、平均  | 
| DICOMInstanceCount |  資料存放區中的 DICOM 執行個體數目。 單位：Count 有效統計資料：總和、平均  | 
| StructuredStorageBytes |  以資料存放區編製索引的位元組為單位的結構化儲存量。 單位：位元組 有效統計資料：總和、平均  | 

## HealthImaging CloudWatch 中的維度
<a name="dimensions-cloudwatch"></a>

下列維度用於篩選 HealthImaging 指標。


**維度**  

| 維度 | Description | 
| --- | --- | 
| AccountId |  此維度會篩選已識別 AWS 帳戶的資料。  | 
| DatastoreId |  此維度只會篩選已識別資料存放區的資料。  | 
| StorageTier |  此維度會依下列儲存層篩選資料： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/healthimaging/latest/devguide/monitoring-cloudwatch.html)  | 

## 存取 HealthImaging 指標
<a name="accessing-metrics"></a>

您可以使用下列方式存取 HealthImaging 指標：
+ **AWS 管理主控台** - 在 CloudWatch 主控台中檢視指標
+ **AWS CLI** - 使用 CloudWatch CLI 命令
+ **CloudWatch API** - 透過 AWS SDKs或 CloudWatch API 工具存取

您必須擁有適當的許可，才能使用 CloudWatch 監控 HealthImaging。如需詳細資訊，請參閱《[CloudWatch 使用者指南》中的 CloudWatch 的 Identity and Access Management](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html)。 *CloudWatch *

## 設定 HealthImaging 指標
<a name="setup-metrics"></a>

若要在您的 CloudWatch 帳戶中接收 HealthImaging 指標，您需要建立服務連結角色，以允許 HealthImaging 代表您發佈指標。如需如何建立[服務連結角色的詳細資訊，請參閱使用 HealthImaging](https://docs.aws.amazon.com/healthimaging/latest/devguide/security-iam-service-linked-roles.html) 的服務連結角色。

## 檢視 HealthImaging 指標
<a name="viewing-cloudwatch"></a>

**若要檢視指標 (CloudWatch 主控台)**

1. 登入 AWS 管理主控台 並開啟 [CloudWatch 主控台](https://console.aws.amazon.com/cloudwatch/home)。

1. 選擇**指標**，選擇**所有指標**，然後選擇 **`AWS/HealthImaging`**。

1. 選擇維度：
   + **依帳戶 ID** - 檢視帳戶層級指標
   + **依資料存放區 ID** - 檢視資料存放區層級指標

1. 選擇指標名稱，然後選擇**新增至圖形**。

1. 選擇日期範圍的值，即會顯示指標計數。

## 使用 CloudWatch 建立警示
<a name="alarms-cloudwatch"></a>

CloudWatch 警示會監看指定期間內的單一指標，並執行一或多個動作：傳送通知至 Amazon Simple Notification Service (Amazon SNS) 主題或 Auto Scaling 政策。動作是根據指標在您指定的數個期間內相對於指定閾值的值。當警示變更狀態時，CloudWatch 也可以傳送 Amazon SNS 訊息給您。

CloudWatch 警示只有在狀態變更且在您指定的期間持續存在時，才會叫用動作。如需詳細資訊，請參閱[使用 CloudWatch 警示](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)。