本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在 中記錄和監控 AWS Elemental MediaPackage
監控是維護 AWS Elemental MediaPackage 和其他 AWS 解決方案的可靠性、可用性和效能的重要部分。 AWS 提供下列監控工具來監看 MediaPackage、在發生錯誤時回報，以及適時採取自動動作：
+ *Amazon CloudWatch* AWS 會即時監控您的 AWS 資源和您在 上執行的應用程式。您可以收集和追蹤指標、建立自訂儀板表，以及設定警示，在特定指標達到您指定的閾值時通知您或採取動作。例如，您可以讓 CloudWatch 追蹤 CPU 使用量或其他 Amazon EC2 執行個體指標，並在需要時自動啟動新的執行個體。如需詳細資訊，請參閱 [Amazon CloudWatch 使用者指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)。
+ *Amazon CloudWatch Events* 提供近乎即時的系統事件串流，描述 AWS 資源的變更。CloudWatch Events 可啟用自動事件驅動型運算，因為您可以撰寫規則來監看特定事件，並在發生這些事件 AWS 時觸發其他服務中的自動動作。如需詳細資訊，請參閱 [Amazon CloudWatch Events 使用者指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/)。
+ *AWS CloudTrail* 會擷取由您的帳戶或代表 AWS 您的帳戶發出的 API 呼叫和相關事件，並將日誌檔案交付至您指定的 Amazon S3 儲存貯體。您可以識別呼叫的使用者和帳戶 AWS、進行呼叫的來源 IP 地址，以及呼叫的時間。如需詳細資訊，請參閱[「AWS CloudTrail 使用者指南」](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)。
+ *AWS Elemental MediaPackage 存取日誌*提供對頻道提出之請求的詳細記錄。存取日誌對許多應用程式來說，都是個很有用的資料。舉例來說，存取記錄資訊在安全與存取稽核中相當實用。如需詳細資訊，請參閱[存取記錄](access-logging.md)。
+ *MediaPackage 資訊清單更新標頭*指出服務上次在不使用動態廣告插入的工作流程中更新資訊清單和區段序列的時間。MediaPackage 會在播放回應中包含這些自訂標頭。這些標頭在疑難排解與過時資訊清單相關的問題時很有幫助。如需詳細資訊，請參閱[監控資訊清單更新時間](monitoring-manifest-last-updated.md)。
**Topics**
+ [AWS Elemental MediaPackage 使用 Amazon CloudWatch 指標進行監控](monitoring-cloudwatch.md)
+ [AWS Elemental MediaPackage 使用 CloudWatch Events 進行監控](monitoring-cloudwatch-events.md)
+ [使用 記錄 AWS Elemental MediaPackage API 呼叫 AWS CloudTrail](logging-using-cloudtrail.md)
+ [存取記錄](access-logging.md)
+ [監控資訊清單更新時間](monitoring-manifest-last-updated.md)
+ [使用工作流程監控來監控 AWS 媒體服務](monitor-with-workflow-monitor.md)
# AWS Elemental MediaPackage 使用 Amazon CloudWatch 指標進行監控
您可以使用 AWS Elemental MediaPackage CloudWatch 進行監控，這會收集原始資料並將其處理為可讀且近乎即時的指標。這些統計資料會保留 15 個月，以便您存取歷史資訊，並更清楚 Web 應用程式或服務的執行效能。您也可以設定留意特定閾值的警示，當滿足這些閾值時傳送通知或採取動作。如需詳細資訊，請參閱 [Amazon CloudWatch 使用者指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)。
**使用 MediaPackage 主控台檢視指標**
MediaPackage 會在主控台中顯示指標。
1. 在 https：//[https://console.aws.amazon.com/mediapackage/](https://console.aws.amazon.com/mediapackage/) 開啟 MediaPackage 主控台。
1. 前往適當的頁面查看指標：
+ 如需 中所有頻道和端點的指標 AWS 區域，請前往**頻道**頁面。
+ 如需特定頻道及其所有端點上的指標，請前往頻道的詳細資訊頁面。
+ 如需特定端點及其頻道上的指標，請前往端點的詳細資訊頁面。
1. （選用） 若要精簡指標檢視，請選擇在 ** CloudWatch 中開啟**。
**使用 CloudWatch 主控台檢視指標**
指標會先依服務命名空間分組，再依各命名空間內不同的維度組合分類。
1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 的 CloudWatch 主控台。
1. 在導覽窗格中，選擇 **指標**。
1. 在 **All metrics** (所有指標) 下，選擇 **AWS/MediaPackage** 命名空間。
1. 選擇指標維度，以檢視指標 (例如，選擇 `channel` 以檢視每個頻道的指標)。
**使用 檢視指標 AWS CLI**
在命令提示中，使用下列命令：
```
aws cloudwatch list-metrics --namespace "AWS/MediaPackage"
```
**Topics**
+ [AWS Elemental MediaPackage 即時內容指標](metrics.md)
+ [AWS Elemental MediaPackage VOD 內容指標](metrics-vod.md)
# AWS Elemental MediaPackage 即時內容指標
`AWS/MediaPackage` 命名空間包含即時內容的下列指標。如果不是更快， 每分鐘都會將指標 AWS Elemental MediaPackage 發佈至 CloudWatch。
| 指標 | Description |
| --- | --- |
| ActiveInput | 指出輸入是否已用作 MediaPackage 中端點的來源 （已處於作用中狀態）。數值為 1 表示輸入啟用中，0 (零) 表示未啟用。單位：無有效維度：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics.html) |
| EgressBytes | MediaPackage 為每個請求成功傳送的位元組數。如果 MediaPackage 在指定的間隔內未收到任何輸出請求，則不會提供任何資料。單位：位元組有效的統計資訊：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics.html)有效維度：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics.html) |
| EgressRequestCount | AWS Elemental MediaPackage 接收的內容請求數量。如果 MediaPackage 在指定的間隔內未收到任何輸出請求，則不會提供任何資料。單位：Count有效的統計資訊：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics.html)有效維度：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics.html) |
| EgressResponseTime | MediaPackage 處理每個輸出請求所需的時間。如果 MediaPackage 在指定的間隔內未收到任何輸出請求，則不會提供任何資料。單位：毫秒有效的統計資訊：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics.html)有效維度：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics.html) |
| IngressBytes | 針對每個輸入請求 AWS Elemental MediaPackage 接收的內容位元組數。如果 MediaPackage 在指定的間隔內未收到任何輸入請求，則不會提供任何資料。單位：位元組有效的統計資訊：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics.html)有效維度：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics.html) |
| IngressResponseTime | MediaPackage 處理每個輸入請求所需的時間。如果 MediaPackage 在指定的間隔內未收到任何輸入請求，則不會提供任何資料。單位：毫秒有效的統計資訊：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics.html)有效維度：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics.html) |
## AWS Elemental MediaPackage 即時維度
您可以使用以下維度篩選 `AWS/MediaPackage` 資料。
| 維度 | Description |
| --- | --- |
| 無維度 | 彙總指標並顯示所有頻道的端點，或者狀態碼。 |
| `Channel` | 只需為指定的頻道顯示指標。 數值：頻道的自動產生 GUID。 可以單獨使用，也可以與其他維度一起使用： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics.html) |
| `IngestEndpoint` | 指標僅會為管道上指定的擷取端點顯示。 數值：擷取端點的自動產生 GUID。 可以與下列維度搭配使用： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics.html) |
| `OriginEndpoint` | 為指定的頻道與端點組合顯示指標。 數值：端點的自動產生 GUID。 必須搭配 `channel` 維度使用。 |
| `StatusCodeRange` | 為指定的狀態碼範圍顯示指標。 數值：`2xx`、`3xx`、`4xx` 或 `5xx`。 可以單獨使用，也可以與其他維度一起使用： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics.html) |
# AWS Elemental MediaPackage VOD 內容指標
`AWS/MediaPackage` 命名空間包含下列隨需視訊 (VOD) 內容的指標。如果不是更快， 每分鐘會將指標 AWS Elemental MediaPackage 發佈至 CloudWatch。
| 指標 | Description |
| --- | --- |
| EgressBytes | MediaPackage 為每個請求成功傳送的位元組數。如果 MediaPackage 在指定的間隔內未收到任何輸出請求，則不會提供任何資料。單位：位元組有效的統計資訊：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics-vod.html)有效維度：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics-vod.html) |
| EgressRequestCount | MediaPackage 收到的內容請求數量。如果 MediaPackage 在指定的間隔內未收到任何輸出請求，則不會提供任何資料。單位：Count有效的統計資訊：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics-vod.html)有效維度：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics-vod.html) |
| EgressResponseTime | MediaPackage 處理每個輸出請求所需的時間。如果 MediaPackage 在指定的間隔內未收到任何輸出請求，則不會提供任何資料。單位：毫秒有效的統計資訊：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics-vod.html)有效維度：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics-vod.html) |
## AWS Elemental MediaPackage VOD 維度
您可以使用以下維度篩選 `AWS/MediaPackage` 資料。
| 維度 | Description |
| --- | --- |
| 無維度 | 指標會彙總並對所有封裝組態和狀態代碼顯示。 |
| `PackagingConfiguration` | 指標僅會對指定的封裝組態顯示。 數值：組態的自動產生 GUID。 可以單獨使用，也可以與其他維度一起使用： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics-vod.html) |
| `StatusCodeRange` | 為指定的狀態碼範圍顯示指標。 數值：`2xx`、`3xx`、`4xx` 或 `5xx`。 可以單獨使用，也可以與其他維度一起使用： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediapackage/latest/ug/metrics-vod.html) |
# AWS Elemental MediaPackage 使用 CloudWatch Events 進行監控
Amazon CloudWatch Events 可讓您自動化您的 AWS 服務，並自動回應系統事件，例如應用程式可用性問題或錯誤條件。 AWS 服務會以近乎即時的方式將事件交付至 CloudWatch Events。您可編寫簡單的規則，來指示您在意的事件，以及當事件符合規則時所要自動執行的動作。可以自動觸發的動作如下：
+ 叫用 AWS Lambda 函數
+ 叫用 AWS Systems Manager 執行命令
+ 將事件轉傳至 Amazon Kinesis Data Streams
+ 啟用 AWS Step Functions 狀態機器
搭配 MediaPackage 使用 CloudWatch Events 的範例是在達到最大串流輸入時通知 Amazon SNS 主題。MediaPackage 會盡最大努力發出事件。
如需在 CloudWatch Events 中建立規則的詳細資訊，請參閱 [Amazon CloudWatch Events 使用者指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/)。
如需 MediaPackage 發出的事件清單，請參閱 [AWS Elemental MediaPackage 事件](cloudwatch-events-example.md)。
# AWS Elemental MediaPackage 事件
AWS Elemental MediaPackage 與 Amazon CloudWatch Events 整合，以通知您影響頻道和端點的特定事件。在[JSON (JavaScript 物件標記法)](http://json.org) 中代表的每個事件和包含事件名稱、事件發生時的日期和時間、受影響的頻道或端點等等。MediaPackage 會盡最大努力發出事件。您可以使用 CloudWatch Events 收集這些事件並設定規則，將它們路由到一或多個*目標*，例如 AWS Lambda 函數、Amazon SNS 主題、Amazon SQS 佇列、Amazon Kinesis Data Streams 中的串流或內建目標。
如需將 CloudWatch Events 與其他類型事件搭配使用的詳細資訊，請參閱 [Amazon CloudWatch Events 使用者指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/)。
下列主題說明 MediaPackage 建立的 CloudWatch Events。
**Topics**
+ [輸入通知事件](#input-state-events)
+ [金鑰提供者通知事件](#key-provider-state-events)
+ [收集任務通知事件](#hj-status-events)
## 輸入通知事件
您會收到即時和隨選視訊 (VOD) 內容的輸入通知事件。當 MediaPackage 擷取發生問題時，這些事件會通知您。以下是您可能會收到的輸入通知事件：
+ 超過最大輸入串流
+ 輸入切換
+ VOD 擷取狀態變更
+ VOD 播放準備程度
下列各節描述其中每一個事件。
** 超過最大輸入串流事件 **
對於即時內容，MediaPackage 中的頻道超過輸入串流數量的配額。如需配額的詳細資訊，請參閱 [中的配額 AWS Elemental MediaPackage](quotas.md)。
**Example**
```
{
"id": "7bf73129-1428-4cd3-a780-95db273d1602",
"detail-type": "MediaPackage Input Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2015-11-11T21:29:54Z",
"region": "us-west-2",
"resources":[
"arn:aws:mediapackage:us-west-2:aws_account_id:channels/262ff182d46d4b399fcabea1364df682"
],
"detail":{
"event": "MaxIngestStreamsError",
"message": "Parent Manifest [%s] has [23] streams, more than [20] allowed: (index_1.m3u8,index_2.m3u8,index_3.m3u8,index_4.m3u8,index_5.m3u8,index_6.m3u8,index_7.m3u8,index_8.m3u8,index_9.m3u8,index_10.m3u8,index_11.m3u8,index_12.m3u8,index_13.m3u8,index_14.m3u8,index_15.m3u8,index_16.m3u8,index_17.m3u8,index_18.m3u8,index_19.m3u8,index_20.m3u8,index_21.m3u8,index_22.m3u8,index_23.m3u8)"
}
}
```
**輸入切換事件**
針對即時內容，MediaPackage 會切換其中一個端點的輸入。
一個事件會隔 5 分鐘傳送一次。如果輸入在五分鐘內切換多次 （例如，如果 MediaPackage 切換到一個輸入，然後切換回另一個輸入），您只會收到一個事件。
如需有關輸入備援和造成輸入切換原因的資訊，請參閱 [即時輸入備援 AWS Elemental MediaPackage 處理流程](what-is-flow-ir.md)。
**Example**
```
{
"id": "8f9b8e72-0b31-e883-f19c-aec84742f3ce",
"detail-type": "MediaPackage Input Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2018-07-16T17:29:36Z",
"region": "us-east-1",
"resources":[
"arn:aws:mediapackage:us-east-1:aws_account_id:origin_endpoints/82d6b9bc04cb4612b487963d6c8d0f1a"
],
"detail":{
"event": "InputSwitchEvent",
"message": "Origin endpoint experienced an Input Switch Event",
"EventDetails": {
"Channel": "channel name",
"PreviousIngestEndpoint": "endpoint uuid before input switch",
"CurrentIngestEndpoint": "endpoint uuid after input switch",
}
}
}
```
**VOD 擷取狀態事件**
對於隨需視訊 (VOD) 內容，MediaPackage 中的資產會變更擷取狀態。您收到下列事件的通知：
+ `IngestStart`
+ `IngestError`
+ `IngestComplete`
**Example**
```
{
"id": "8f9b8e72-0b31-e883-f19c-aec84742f3ce",
"detail-type": "MediaPackage Input Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2019-05-03T17:29:36Z",
"region": "us-west-2",
"resources":[
"arn:aws:mediapackage-vod:us-west-2:aws_account_id:assets/asset_name"
],
"detail":{
"event": "IngestComplete",
"message": "message text"
}
}
```
**VOD 播放事件**
對於 VOD 內容，MediaPackage 中的資產可供播放。資產擷取完成到可播放資產有一段時間。事件`VodAssetPlayable`表示 MediaPackage 現在可滿足資產的播放請求。
您會取得封裝群組中每個封裝組態的個別`VodAssetPlayable`事件。例如，如果您的封裝群組包含一個 DASH 和一個 HLS 封裝組態，您會收到兩個`VodAssetPlayable`事件：一個用於 DASH 封裝組態，另一個用於 HLS 封裝組態。
**Example**
```
{
"id": "81e896e4-d9e5-ec79-f82a-b4cf3246c567",
"detail-type": "MediaPackage Input Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2019-11-03T21:46:00Z",
"region": "us-west-2",
"resources":[
"arn:aws:mediapackage-vod:us-west-2:aws_account_id:assets/asset_id",
"arn:aws:mediapackage-vod:us-west-2:aws_account_id:packaging_configuration/packaging_configuration_id"
],
"detail":{
"event": "VodAssetPlayable",
"message": "Asset 'asset_id' is now playable for PackagingConfiguration 'packaging_configuration_id'",
"packaging_configuration_id": "packaging_configuration_id",
"manifest_urls":[
"https://555555555555.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/b9cc115bf7f1a/b848dfb116920772aa69ba/a3c74b1cae6a451c/index.m3u8"
]
}
}
{
"id": "91e896e4-d9e5-ab80-f82a-b4cf3246c568",
"detail-type": "MediaPackage Input Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2019-11-03T21:47:00Z",
"region": "us-west-2",
"resources":[
"arn:aws:mediapackage-vod:us-west-2:aws_account_id:assets/asset_id",
"arn:aws:mediapackage-vod:us-west-2:aws_account_id:packaging_configuration/packaging_configuration_id"
],
"detail":{
"event": "VodAssetPlayable",
"message": "Asset 'asset_id' is now playable for PackagingConfiguration 'packaging_configuration_id'",
"packaging_configuration_id": "packaging_configuration_id",
"manifest_urls":[
"https://111122223333.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/1234567890abc/021345abcdef6789012345/abcdef0123456789/index.mpd"
]
}
}
```
## 金鑰提供者通知事件
當您在端點上使用內容加密，且 MediaPackage 無法聯絡金鑰提供者時，您會收到金鑰提供者通知事件。如需 DRM 與加密的詳細資訊，請參閱[https://docs.aws.amazon.com/speke/latest/documentation/](https://docs.aws.amazon.com/speke/latest/documentation/)。
**Example 即時金鑰提供者通知事件**
```
{
"id": "7bf73129-1428-4cd3-a780-98ds273d1602",
"detail-type": "MediaPackage Key Provider Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2015-11-11T21:29:54Z",
"region": "us-west-2",
"resources":[
"arn:aws:mediapackage:us-west-2:aws_account_id:origin_endpoints/endpoint_id"
],
"detail":{
"event": "KeyProviderError",
"message": "message-text"
}
}
```
**Example VOD 金鑰提供者通知事件**
```
{
"id": "7bf73129-1428-4cd3-a780-98ds273d1602",
"detail-type": "MediaPackage Key Provider Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2015-11-11T21:29:54Z",
"region": "us-west-2",
"resources":[
"arn:aws:mediapackage-vod:us-west-2:aws_account_id:packaging_configurations/packaging_group_name"
],
"detail":{
"event": "KeyProviderError",
"message": "message-text"
}
}
```
## 收集任務通知事件
當您從即時串流匯出剪輯以建立live-to-VOD播送資產時，會取得收集任務狀態事件。MediaPackage 會在收集任務成功或失敗時建立通知。如需有關收集任務和實況錄音影像隨選播放資產的資訊，請參閱 [使用 live-to-VOD送資產 AWS Elemental MediaPackage](ltov.md)。
**Example 成功的收集任務事件**
```
{
"id": "8f9b8e72-0b31-e883-f19c-aec84742f3ce",
"detail-type": "MediaPackage HarvestJob Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2019-07-16T17:29:36Z",
"region": "us-east-1",
"resources":[
"arn:aws:mediapackage:us-east-1:aws_account_id:harvest_jobs/harvest_job_id"
],
"detail":{
"harvest_job": {
"id": "harvest_job_id",
"arn": "arn:aws:mediapackage-vod:us-east-1:aws_account_id:harvest_jobs/harvest_job_id",
"status": "SUCCEEDED",
"origin_endpoint_id": "endpoint_id",
"start_time": "2019-06-26T20:30:00-08:00",
"end_time": "2019-06-26T21:00:00-08:00",
"s3_destination": {
"bucket_name": "s3_bucket_name",
"manifest_key": "path/and/manifest_name/index.m3u8",
"role_arn": "arn:aws:iam::aws_account_id:role/S3Access_role",
},
"created_at": "2019-06-26T21:03:12-08:00"
}
}
}
```
**Example 失敗的收集任務事件**
```
{
"id": "8f9b8e72-0b31-e883-f19c-aec84742f3ce",
"detail-type": "MediaPackage HarvestJob Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2019-07-16T17:29:36Z",
"region": "us-east-1",
"resources":[
"arn:aws:mediapackage:us-east-1:aws_account_id:harvest_jobs/harvest_job_id"
],
"detail":{
"harvest_job": {
"id": "harvest_job_id",
"arn": "arn:aws:mediapackage-vod:us-east-1:aws_account_id:harvest_jobs/harvest_job_id",
"status": "FAILED",
"origin_endpoint_id": "endpoint_id",
"start_time": "2019-06-26T20:30:00-08:00",
"end_time": "2019-06-26T21:00:00-08:00",
"s3_destination": {
"bucket_name": "s3_bucket_name",
"manifest_key": "path/and/manifest_name/index.m3u8",
"role_arn": "arn:aws:iam::aws_account_id:role/S3Access_role",
},
"created_at": "2019-06-26T21:03:12-08:00"
},
"message": "Message text"
}
}
```
# 建立事件通知
您可以使用 Amazon CloudWatch Events 和 Amazon Simple Notification Service (Amazon SNS) 來通知您新事件。在 CloudWatch Events 中，規則會描述您會收到通知的事件。在 Amazon SNS 中，主題說明了您會接收的通知類型。本節提供建立 事件主題和規則的高階步驟 AWS Elemental MediaPackage。如需主題和規則詳細資訊，請參閱以下：
+ 《*Amazon Simple Notification Service 開發人員指南*》中的[建立主題](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html#CreateTopic)和[訂閱主題](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html#SubscribeTopic)
+ 《[Amazon CloudWatch Events 使用者指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CWE_GettingStarted.html)*》中的 Amazon CloudWatch Events *入門
**建立 CloudWatch 事件的通知**
1. 存取 [Amazon SNS](https://console.aws.amazon.com/sns/v2/home) 並建立主題。請為主題設定一個描述性名稱，以供您稍後識別。
1. 訂閱您剛建立的主題。選擇您想要接收哪些類型的通知，以及通知應傳送至何處。例如，對於電子郵件通知，選擇 **Email (電子郵件)** 通訊協定，然後輸入接收通知端點的電子郵件地址。
1. 存取 [CloudWatch Events](https://console.aws.amazon.com/cloudwatch) 並建立使用**自訂事件模式**的規則。在模式預覽空間中，請輸入下列內容：
```
{
"source": [
"aws.mediapackage"
],
"detail-type": [
"detail-type from event"
]
}
```
針對 `detail-type`，請輸入來自事件的 `detail-type` 欄位值。您可以對 detail-type 使用下列值：
+ **MediaPackage Input Notification**
+ **MediaPackage Key Provider Notification**
如需事件類型的資訊，請參閱 [AWS Elemental MediaPackage 事件](cloudwatch-events-example.md)。
**Example**
以下範例規則會建立具有所有 detail-type 之所有事件的通知。
```
{
"source": [
"aws.mediapackage"
],
"detail-type": [
"MediaPackage Input Notification",
"MediaPackage Key Provider Notification",
"MediaPackage HarvestJob Notification"
]
}
```
1. 新增目標到您剛建立的規則。選擇 **SNS topic (SNS 主題)**，然後選擇您在步驟 1 建立的主題。
1. 設定規則的詳細資訊，並設定一個描述名稱。若要開始使用規則，請確定規則已啟用，然後加以儲存。
# 使用 記錄 AWS Elemental MediaPackage API 呼叫 AWS CloudTrail
記錄僅適用於 中的即時工作流程 AWS Elemental MediaPackage。
MediaPackage 已與 服務整合 AWS CloudTrail，此服務提供由使用者、角色或 MediaPackage 中的 AWS 服務所採取之動作的記錄。CloudTrail 會將 MediaPackage 的所有 API 呼叫擷取為事件。這些包括來自 MediaPackage 主控台的呼叫，以及對 MediaPackage API 操作的程式碼呼叫。如果您建立線索，則可以將 CloudTrail 事件持續交付至 Amazon S3 儲存貯體，包括 MediaPackage 的事件。即使您未設定追蹤，依然可以透過 CloudTrail 主控台中的**事件歷史記錄**檢視最新事件。您可以使用 CloudTrail 所收集的資訊，判斷對 MediaPackage 提出的請求、提出請求的 IP 地址、提出請求的人員、提出請求的時間，以及其他詳細資訊。
若要進一步了解 CloudTrail，請參閱[AWS CloudTrail 《使用者指南》](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)。
## AWS Elemental MediaPackage CloudTrail 中的資訊
當您建立 AWS 帳戶時，會在您的帳戶上啟用 CloudTrail。當活動在 中發生時 AWS Elemental MediaPackage，該活動會與**事件歷史記錄**中的其他服務 AWS 事件一起記錄在 CloudTrail 事件中。您可以檢視、搜尋和下載 帳戶的最新事件。如需詳細資訊，請參閱[使用 CloudTrail 事件歷史記錄檢視事件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)。
若要持續記錄您帳戶中的事件，包括 MediaPackage 的事件，請建立追蹤。*線索*能讓 CloudTrail 將日誌檔案交付至 Amazon S3 儲存貯體。依預設，當您在主控台中建立追蹤時，該追蹤會套用至所有的 AWS 區域。線索會記錄 AWS 分割區 AWS 區域 中所有 的事件，並將日誌檔案傳送到您指定的 Amazon S3 儲存貯體。此外，您可以設定其他 AWS 服務，以進一步分析和處理 CloudTrail 日誌中所收集的事件資料。如需詳細資訊，請參閱下列內容：
+ [建立追蹤的概觀](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail 支援的服務和整合](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [設定 CloudTrail 的 Amazon SNS 通知](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [接收多個區域的 CloudTrail 日誌檔案](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)和[接收多個帳戶的 CloudTrail 日誌檔案](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
CloudTrail 會記錄所有 MediaPackage 動作，並記錄在 [AWS Elemental MediaPackage API 參考](https://docs.aws.amazon.com/mediapackage/latest/apireference/)中。例如，對 `CreateChannel`、`CreateOriginEndpoint` 和 `RotateIngestEndpointCredentials` 操作的呼叫都會在 CloudTrail 日誌檔案中產生項目。
每一筆事件或日誌專案都會包含產生請求者的資訊。身分資訊可協助您判斷下列事項：
+ 該請求是否使用根使用者或 IAM 使用者憑證提出
+ 提出該請求時，是否使用了特定角色或聯合身分使用者的臨時安全憑證
+ 請求是否由其他 AWS 服務提出
如需詳細資訊，請參閱 [CloudTrail userIdentity 元素](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)。
## 了解 AWS Elemental MediaPackage 日誌檔案項目
追蹤是一種組態，能讓事件以日誌檔案的形式交付到您指定的 Amazon S3 儲存貯體。CloudTrail 日誌檔案包含一或多個日誌專案。一個事件為任何來源提出的單一請求，並包含請求動作、請求的日期和時間、請求參數等資訊。CloudTrail 日誌檔並非依公有 API 呼叫的堆疊追蹤排序，因此不會以任何特定順序出現。
以下範例顯示的 CloudTrail 日誌項目會示範 `UpdateChannel` 操作：
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "AssumedRole",
"principalId": "ABCDEFGHIJKL123456789",
"arn": "arn:aws:sts::444455556666:assumed-role/Admin/testUser",
"accountId": "444455556666",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"attributes": {
"mfaAuthenticated": "false",
"creationDate": "2018-12-18T00:50:58Z"
},
"sessionIssuer": {
"type": "Role",
"principalId": "ABCDEFGHIJKL123456789",
"arn": "arn:aws:iam::444455556666:role/Admin",
"accountId": "444455556666",
"userName": "Admin"
}
}
},
"eventTime": "2018-12-18T00:50:59Z",
"eventSource": "mediapackage.amazonaws.com",
"eventName": "UpdateChannel",
"awsRegion": "us-west-2",
"sourceIPAddress": "203.0.113.17",
"userAgent": "aws-cli/1.15.71 Python/3.6.5 Darwin/17.7.0 botocore/1.10.70",
"requestParameters": {
"description": "updated cloudtrail description",
"id": "cloudtrail-test"
},
"responseElements": {
"description": "updated cloudtrail description",
"hlsIngest": {
"ingestEndpoints": [
{
"username": "***",
"url": "https://mediapackage.us-west-2.amazonaws.com/in/v2/8d0ca97840d94b18b37ad292c131bcad/8d0ca97840d94b18b37ad292c131bcad/channel",
"password": "***",
"id": "8d0ca97840d94b18b37ad292c131bcad"
},
{
"username": "***",
"url": "https://mediapackage.us-west-2.amazonaws.com/in/v2/8d0ca97840d94b18b37ad292c131bcad/9c17f979598543b9be24345d63b3ad30/channel",
"password": "***",
"id": "9c17f979598543b9be24345d63b3ad30"
}
]
},
"id": "cloudtrail-test",
"arn": "arn:aws:mediapackage:us-west-2:444455556666:channels/8d0ca97840d94b18b37ad292c131bcad"
},
"requestID": "fc158262-025e-11e9-8360-6bff705fbba5",
"eventID": "e9016b49-9a0a-4256-b684-eed9bd9073ab",
"readOnly": false,
"eventType": "AwsApiCall",
"recipientAccountId": "444455556666"
}
```
# 存取記錄
MediaPackage 提供存取日誌，可擷取傳送至 MediaPackage 頻道或封裝群組之請求的詳細資訊。MediaPackage 會針對傳送至頻道輸入端點的請求產生*傳入存取日誌*，並針對傳送至頻道端點或封裝群組資產的請求產生*傳出存取日誌*。每個日誌包含收到請求的時間、用戶端的 IP 地址、延遲、請求路徑和伺服器回應等資訊。您可以使用這些存取日誌來分析服務效能和故障診斷問題。他們也可以協助您了解您的客戶群，並了解您的 MediaPackage 帳單。
存取記錄是 MediaPackage 的選用功能，預設為停用。啟用存取記錄後，MediaPackage 會擷取日誌，並將其儲存至您在建立或管理存取記錄時指定的 CloudWatch 日誌群組。一般 CloudWatch Logs 會收取費用。
**Topics**
+ [將存取日誌發佈至 CloudWatch 的許可](#permissions)
+ [啟用存取記錄](#enable-access-logging)
+ [停用存取記錄](#disable-access-logging)
+ [存取日誌格式](#access-log-format)
+ [讀取存取日誌](#read-access-logs)
## 將存取日誌發佈至 CloudWatch 的許可
當您啟用存取記錄時，MediaPackage 會在您的帳戶中建立 IAM 服務連結角色 `AWSServiceRoleForMediaPackage` AWS 。此角色允許 MediaPackage 將存取日誌發佈至 CloudWatch。如需有關 MediaPackage 如何使用服務連結角色的資訊，請參閱 [使用 MediaPackage 的服務連結角色](using-service-linked-roles.md)。
## 啟用存取記錄
您可以使用 AWS 管理主控台 或 啟用存取日誌 AWS CLI。
**使用主控台啟用現有頻道的存取日誌**
1. 在 https：//[https://console.aws.amazon.com/mediapackage/](https://console.aws.amazon.com/mediapackage/) 開啟 MediaPackage 主控台。
1. 選取您的頻道。
1. 在**設定存取日誌**區段中，執行下列動作：
1. 選擇**啟用輸入存取日誌**或**啟用輸出存取日誌**，或兩者。
1. 您可以指定自訂 CloudWatch **Log 群組名稱**。如果保留空白，則會使用預設群組。
**使用主控台啟用現有封裝群組的存取日誌**
1. 開啟 MediaPackage 主控台，網址為 https：//[https://console.aws.amazon.com/mediapackage/](https://console.aws.amazon.com/mediapackage/)。
1. 從導覽區段中選取**包裝群組**。
1. 選擇您的封裝群組。
1. 在導覽列中選取**編輯**。
1. 在**存取記錄**區段中，選取**啟用輸出存取日誌**。
1. 您可以指定自訂 CloudWatch **Log 群組名稱**。如果保留空白，則會使用預設群組。
1. 選擇 **Save changes** (儲存變更)。
**使用 啟用頻道的存取日誌 AWS CLI**
使用 [configure-logs](https://docs.aws.amazon.com/cli/latest/reference/mediapackage/configure-logs.html) 命令搭配 `--ingress-access-logs` 參數、 `--egress-access-logs` 參數或兩者，以啟用存取記錄。您可以包含 `--ingress-access-logs`和 `--egress-access-logs` 參數的 CloudWatch 日誌群組名稱。如果您未指定日誌群組名稱，則會使用 MediaPackage 預設日誌群組。對於傳入日誌，預設日誌群組為 `/aws/MediaPackage/IngressAccessLogs`，而對於傳出日誌，預設日誌群組為 `/aws/MediaPackage/EgressAccessLogs`。
使用以下命令，使用預設日誌群組來啟用傳入和存取日誌：
```
aws mediapackage configure-logs --id channel-name --ingress-access-logs {} --egress-access-logs {}
```
此命令沒有傳回值。
**使用 啟用封裝群組的存取日誌 AWS CLI**
使用 [configure-logs](https://docs.aws.amazon.com/cli/latest/reference/mediapackage-vod/configure-logs.html) 命令搭配 `--egress-access-logs` 參數來啟用存取記錄。您可以包含 `--egress-access-logs` 參數的 CloudWatch 日誌群組名稱。如果您未指定日誌群組名稱，則會使用 MediaPackage 預設日誌群組。對於傳入日誌，預設日誌群組為 `/aws/MediaPackage/IngressAccessLogs`，而對於傳出日誌，預設日誌群組為 `/aws/MediaPackage/EgressAccessLogs`。
使用以下命令，使用預設日誌群組啟用輸出存取日誌：
```
aws mediapackage configure-logs --id package-name --egress-access-logs {}
```
此命令沒有傳回值。
## 停用存取記錄
您可以隨時停用 MediaPackage 頻道或封裝群組的存取日誌。
**使用主控台停用存取記錄**
1. 在 https：//[https://console.aws.amazon.com/mediapackage/](https://console.aws.amazon.com/mediapackage/) 開啟 MediaPackage 主控台。
選取您的頻道或套件群組。
1. 選擇**編輯**。
1. 在**存取記錄**區段中，取消選取**輸入存取記錄**、**輸出存取記錄**或兩者。
1. 選擇 **Save changes** (儲存變更)。
**使用 停用頻道的存取記錄 AWS CLI**
使用 `configure-logs`命令來停用存取記錄。如果沒有使用 `configure-logs`命令宣告一或多個存取日誌參數，則會停用對應的存取日誌。例如，在下列命令中，會為頻道啟用輸出存取日誌，並停用輸入存取日誌：
```
aws mediapackage configure-logs --id channel-name --egress-access-logs {}
```
此命令沒有傳回值。
**使用 停用封裝群組的存取記錄 AWS CLI**
使用 `configure-logs`命令來停用存取記錄。如果沒有使用 `configure-logs`命令宣告一或多個存取日誌參數，則會停用對應的存取日誌。例如，在下列命令中`configure-logs`不包含 ，`--egress-access-logs`因此會停用輸出日誌：
```
aws mediapackage configure-logs --id package-group-name
```
此命令沒有傳回值。
## 存取日誌格式
存取日誌檔是由一系列的 JSON 格式的日誌記錄所組成，其中每個日誌記錄代表一個請求。日誌中欄位的順序可能有所不同。以下是頻道輸出存取日誌的範例：
```
{
"timestamp": "2020-07-13T18:59:56.293656Z",
"clientIp": "192.0.2.0/24",
"processingTime": 0.445,
"statusCode": "200",
"receivedBytes": 468,
"sentBytes": 2587370,
"method": "GET",
"request": "https://aaabbbcccdddee.mediapackage.us-east-1.amazonaws.com:443/out/v1/75ee4f20e5df43e5821e5cb17ea19238/hls_7_145095.ts?m=1538005779",
"protocol": "HTTP/1.1",
"userAgent": "sabr/3.0 Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US) AppleWebKit/528.18 (KHTML, like Gecko) Version/4.0 Safari/528.17",
"account": "111122223333",
"channelId": "my_channel",
"channelArn": "arn:aws:mediapackage:us-west-2:111122223333:channels/ExampleChannelID",
"domainName": "aaabbbcccdddee.mediapackage.us-east-1.amazonaws.com",
"requestId": "aaaAAA111bbbBBB222cccCCC333dddDDD",
"endpointId": "my_endpoint",
"endpointArn": "arn:aws:mediapackage:us-west-2:111122223333:origin_endpoints/ExampleEndpointID"
}
```
下列清單會依序說明日誌記錄欄位：
*timestamp*
收到請求的時間。此值是 `ISO-8601` 日期時間，且會根據服務請求之主機的系統時鐘。
*clientIp*
請求用戶端的 IP 地址。
*processingTime*
MediaPackage 處理請求所花費的秒數。此值是從收到您要求的最後位元組的時間開始，計算到回應傳送出第一組位元組的時間。
*statusCode*
回應的數字 HTTP 狀態碼。
*receivedBytes*
MediaPackage 伺服器在請求內文中接收的位元組數。
*sentBytes*
回應內文中 MediaPackage 伺服器傳送的位元組數。此值通常與伺服器回應中包含的`Content-Length`標頭值相同。
*方法*
用於請求的 HTTP 請求方法：DELETE、GET、HEAD、 OPTIONS、PATCH、POST 或 PUT。
*請求*
請求 URL。
*protocol*
用於請求的通訊協定類型，例如 HTTP。
*userAgent*
使用者代理程式字串，可識別發出請求的用戶端，以雙引號括住。字串包含一或多個產品識別符、產品/版本。如果字串超過 8 KB，則會截斷。
*account*
用於提出請求的帳戶的帳戶 AWS ID。
*channelId*
接收請求的頻道 ID。
*channelArn*
接收請求之頻道的 Amazon Resource Name (ARN)。
*domainName*
用戶端在 TLS 交握期間提供的伺服器名稱指示網域，以雙引號括住。`-` 如果用戶端不支援 SNI 或網域不符合憑證，且預設憑證會呈現給用戶端，則此值會設為 。
*requestId*
MediaPackage 產生的字串，可唯一識別每個請求。
*endpointId*
接收請求的端點 ID。
*endpointArn*
接收請求之端點的 Amazon Resource Name (ARN)。
日誌中欄位的順序可能有所不同。
## 讀取存取日誌
MediaPackage 會將存取日誌寫入 Amazon CloudWatch Logs。一般 CloudWatch Logs 會收取費用。使用 CloudWatch Logs Insights 讀取存取日誌。如需有關如何使用 CloudWatch Logs Insights 的資訊，請參閱 [CloudWatch Logs 使用者指南中的使用 CloudWatch Logs Insights 分析日誌資料](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)。 *AWS CloudWatch *
**注意**
存取日誌可能需要幾分鐘的時間才會出現在 CloudWatch 中。如果您沒有看到日誌，請等待幾分鐘，然後再試一次。
### 範例
本節包含可用來讀取 MediaPackage 除錯日誌資料的範例查詢。
**Example 檢視頻道的 HTTP 狀態碼回應。**
使用此查詢，依頻道的 HTTP 狀態碼檢視回應。您可以使用它來檢視 HTTP 錯誤碼回應，以協助您疑難排解問題。
```
fields @timestamp, @message
| filter channelId like 'my-channel'
| stats count() by statusCode
```
**Example 取得頻道上每個端點的請求數量。**
```
fields @timestamp, @message
| filter channelId like 'my-channel'
| stats count() by endpointId
```
**Example 檢視每個資產的狀態碼。**
```
fields @timestamp, @message
| filter assetArnlike 'my-asset-id'
| stats count() by statusCode
```
**Example 取得隨著時間的封裝組態的 P99 回應時間**
```
fields @timestamp, @message
| filter packagingConfigArn like 'my-dash-config'
| stats pct(processingTime, 99) by bin(5m)
```
# 監控資訊清單更新時間
AWS Elemental MediaPackage 播放回應包含下列自訂標頭，指出 MediaPackage 上次在非動態廣告插入工作流程中修改資訊清單的時間。這些標頭在故障診斷與過時資訊清單相關的問題時很有幫助。
## X-MediaPackage-Manifest-Last-Sequence
這是資訊清單中最高的區段序號。
+ 對於 DASH，這是資訊清單最低轉譯中最高的區段號碼。
+ 對於 HLS 和 CMAF，這是媒體播放清單中最高的區段號碼。
+ 對於 MSS，這是資訊清單中最高的區段號碼。
如需[資訊清單範例](#manifest-examples)，請參閱下一節。
## X-MediaPackage-Manifest-Last-Updated
當 MediaPackage 產生 中提及的區段時，epoch 時間戳記以毫秒為單位`X-MediaPackage-Manifest-Last-Sequence`。
## 資訊清單範例
### DASH 資訊清單範例
對於精簡和完整的 DASH 資訊清單，MediaPackage 會從資訊清單最低轉譯中的最高區段號碼決定`X-MediaPackage-Manifest-Last-Sequence`值。服務會根據產生 中參考的區段的時間來計算`X-MediaPackage-Manifest-Last-Updated`值`X-MediaPackage-Manifest-Last-Sequence`。
#### 持續時間數字 - 精簡資訊清單
以下是使用 數字搭配持續時間範本的精簡 DASH 資訊清單範例。MediaPackage 會從資訊清單中最低轉譯中的最高區段號碼決定`X-MediaPackage-Manifest-Last-Sequence`值。例如，在以下資訊清單中，最高的區段編號為 `index_video_5_0_175232.mp4`，因此 的值`X-MediaPackage-Manifest-Last-Sequence`為 `175232`。如需 MediaPackage 如何計算序列`$Number$`值的資訊，[`SegmentTemplate` 中的 `duration` 屬性](segtemp-format-duration.md)請參閱 。當 MediaPackage 產生 中提及的區段時， 的值`X-MediaPackage-Manifest-Last-Updated`是以毫秒為單位的 epoch 時間戳記`X-MediaPackage-Manifest-Last-Sequence`。
```
```
#### 具有時間軸的數字 - 精簡資訊清單
以下是使用數字搭配時間軸範本的精簡 DASH 資訊清單範例。MediaPackage 會從資訊清單中最低轉譯中的最高區段號碼決定`X-MediaPackage-Manifest-Last-Sequence`值。例如，在下列資訊清單中，最高的區段編號為 `index_video_1_0_7.mp4`，因此 的值`X-MediaPackage-Manifest-Last-Sequence`為 `7`。當 MediaPackage 產生 中提及的區段時， 的值`X-MediaPackage-Manifest-Last-Updated`是以毫秒為單位的 epoch 時間戳記`X-MediaPackage-Manifest-Last-Sequence`。
```