기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon CloudWatch 지표 AWS Elemental MediaTailor 를 사용한 모니터링
<a name="monitoring-cloudwatch-metrics"></a>

CloudWatch를 사용하여 AWS Elemental MediaTailor 지표를 모니터링할 수 있습니다. CloudWatch는 서비스 성능에 대한 원시 데이터를 수집하고 해당 데이터를 읽기 가능하며 실시간에 가까운 지표로 처리합니다. 이러한 통계는 15개월간 보관되므로 기록 정보에 액세스하고 웹 애플리케이션 또는 서비스가 어떻게 실행되고 있는지 전체적으로 더 잘 파악할 수 있습니다. 특정 임곗값을 주시하다가 해당 임곗값이 충족될 때 알림을 전송하거나 조치를 취하도록 경보를 설정할 수도 있습니다. 자세한 내용은 [Amazon CloudWatch 사용 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)를 참조하세요.

지표는 오래된 매니페스트를 조사할 때 유용할 수 있습니다. 자세한 내용은 [지표를 사용하여 오래된 매니페스트 진단](stale-manifest-diagnose.md) 단원을 참조하십시오.

지표는 먼저 서비스 네임스페이스별로 그룹화된 다음 각 네임스페이스 내에서 다양한 차원 조합별로 그룹화됩니다.

**CloudWatch 콘솔을 사용하여 지표를 보려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **지표(Metrics)**를 선택합니다.

1. **모든 지표**에서 **MediaTailor** 네임스페이스를 선택합니다.

1. 지표 차원을 선택하여 지표를 봅니다(예: **originID**).

1. 확인할 기간을 지정합니다.

**AWS Command Line Interface (AWS CLI)를 사용하여 지표를 보려면**
+ 명령 프롬프트에서 다음 명령을 사용합니다.

  ```
  aws cloudwatch list-metrics --namespace "AWS/MediaTailor"
  ```

## AWS Elemental MediaTailor CloudWatch 지표
<a name="metrics"></a>

 AWS Elemental MediaTailor 네임스페이스에는 다음 지표가 포함됩니다. 이 지표는 기본적으로 계정으로 게시됩니다.

### 채널 어셈블리(CA) 지표
<a name="metrics.channel-assembly"></a>

다음 표에서는 채널 또는 채널 출력별로 모든 지표를 사용할 수 있습니다.


| 지표 | 설명 | 
| --- | --- | 
|  4xxErrorCount  | `4xx` 오류 수입니다. | 
|  5xxErrorCount  | `5xx` 오류 수입니다. | 
|  RequestCount  |  요청 총 수 트랜잭션 수는 주로 플레이어가 업데이트된 매니페스트를 요청하는 빈도와 플레이어 수에 따라 달라집니다. 각 플레이어 요청은 트랜잭션으로 간주됩니다. | 
|  TotalTime  | 클라이언트 및 네트워크에서 바이트를 수신하고 쓰는 데 사용된 시간을 포함하여 애플리케이션 서버가 요청을 처리하는 데 걸린 시간입니다. | 

#### 서버 측 광고 삽입(SSAI) 지표
<a name="metrics.server-side-ad-insertion"></a>

다음 표에는 서버 측 광고 삽입 지표가 나열되어 있습니다.


| 지표 | 설명 | 
| --- | --- | 
|  AdDecisionServer.Ads  | 지정한 CloudWatch 기간 내에 광고 결정 서버(ADS) 응답에 포함된 광고 수입니다. | 
|  AdDecisionServer.Duration  | 지정한 CloudWatch 기간 내에 MediaTailor가 ADS에서 수신한 모든 광고의 총 지속 시간입니다. 이 기간은 지정한 기간보다 클 수 `Avail.Duration` 있습니다. | 
|  AdDecisionServer.Errors  | 지정한 CloudWatch 기간 내에 MediaTailor가 ADS로부터 수신한 비 HTTP 200 상태 코드 응답, 빈 응답 및 시간 초과 응답 수입니다. | 
|  AdDecisionServer.FillRate  | ADS에서 응답이 해당 개별 광고 시간에 대해 지정된 시간을 채우는 비율의 단순 평균.<br />가중 평균을 얻으려면 `AdDecisionServer.Duration`을 `Avail.Duration`의 백분율로 계산합니다. 단순 및 가중 평균에 대한 자세한 내용은 [단순 및 가중 평균](#metrics-simple-average) 단원을 참조하십시오. | 
|  AdDecisionServer.Latency  | MediaTailor가 ADS에 보낸 요청에 대한 밀리초 단위의 응답 시간입니다. | 
|  AdDecisionServer.Timeouts  | 지정한 CloudWatch 기간 동안 ADS에 대한 시간 초과 요청 수입니다. | 
|  AdNotReady  | 지정한 기간 동안 내부 트랜스코더 서비스에 의해 아직 트랜스코딩되지 않은 광고에 대해 ADS가 가리킨 횟수.<br />이 지표에 대한 높은 값은 전체적으로 낮은 `Avail.FillRate`의 한 원인이 되었을지도 모릅니다. | 
|  AdsBilled  | MediaTailor가 삽입에 따라 고객에게 청구하는 광고 수입니다. | 
|  Avail.Duration  | CloudWatch 기간 내에 계획된 총 광고 시간 밀리초 수입니다. 계획된 합계는 오리진 매니페스트의 광고 가능 기간을 기반으로 합니다. | 
|  Avail.FilledDuration  | MediaTailor가 CloudWatch 기간 내에 광고로 채울 계획된 광고 가능 시간 밀리초입니다. | 
|  Avail.FillRate  | CloudWatch 기간 내에 MediaTailor가 개별 광고 시간을 채울 비율의 계획된 단순 평균입니다.<br />가중 평균을 얻으려면 `Avail.FilledDuration`을 `Avail.Duration`의 백분율로 계산합니다. 단순 및 가중 평균에 대한 자세한 내용은 [단순 및 가중 평균](#metrics-simple-average) 단원을 참조하십시오.<br />MediaTailor`Avail.FillRate`가 달성할 수 있는 최대값은에 의해 제한됩니다`AdDecisionServer.FillRate`. `Avail.FillRate`가 낮은 경우 `AdDecisionServer.FillRate`와 비교합니다. `AdDecisionServer.FillRate`가 낮은 경우 ADS가 광고 시간 지속시간에 비해 충분한 광고를 반환하지 않고 있을 수 있습니다. | 
|  Avail.Impression  | MediaTailor가 서버 측 비컨 중에 보는 노출 추적 이벤트가 있는 광고 수(노출 수가 아님). | 
|  Avail.ObservedDuration  | CloudWatch 기간 내에 발생한 광고 시간의 관측된 총 밀리초 수입니다. `Avail.ObservedDuration`는 광고 시간 종료 시 방출되며 광고 시간 동안 매니페스트에 보고된 세그먼트의 기간을 기반으로 합니다. | 
|  Avail.ObservedFilledDuration  | MediaTailor가 CloudWatch 기간 내에 광고로 채운 관찰된 광고 가능 시간 밀리초입니다. | 
|  Avail.ObservedFillRate  | MediaTailor가 CloudWatch 기간 내에 개별 광고 시간을 채운 비율의 관찰된 단순 평균입니다.<br />첫 번째 `CUE-IN` 태그에서 HLS 매니페스트에 대해서만 내보내집니다. `CUE-IN` 태그가 없는 경우 MediaTailor는이 지표를 내보내지 않습니다. | 
|  Avail.ObservedSlateDuration  | CloudWatch 기간 내에 삽입된 슬레이트의 관찰된 총 밀리초 수입니다. | 
|  GetManifest.Age  | 매니페스트의 총 수명을 밀리초 단위로 표시합니다. 오리진이 매니페스트를 생성하는 시점부터 MediaTailor가 개인화된 매니페스트를 보내는 시점까지 측정됩니다.<br />매니페스트 수명 측정을 위한 지표에 대한 자세한 내용은 섹션을 참조하세요[지표를 사용하여 오래된 매니페스트 진단](stale-manifest-diagnose.md). | 
|  GetManifest.Errors  | 지정한 CloudWatch 기간에 MediaTailor가 매니페스트를 생성하는 동안 수신된 오류 수입니다. | 
|  GetManifest.Latency  | 매니페스트 생성 요청에 대한 MediaTailor 응답 시간입니다.<br />매니페스트 수명 측정을 위한 지표에 대한 자세한 내용은 섹션을 참조하세요[지표를 사용하여 오래된 매니페스트 진단](stale-manifest-diagnose.md). | 
|  GetManifest.MediaTailorAge  | 매니페스트가 MediaTailor에 밀리초 단위로 저장된 시간입니다. MediaTailor가 오리진 응답을 수신하는 시점부터 MediaTailor가 개인화된 매니페스트를 보내는 시점까지 측정됩니다.<br />매니페스트 수명 측정을 위한 지표에 대한 자세한 내용은 섹션을 참조하세요[지표를 사용하여 오래된 매니페스트 진단](stale-manifest-diagnose.md). | 
|  Origin.Age  | 오리진에 매니페스트가 있는 밀리초 단위의 시간입니다. 오리진이 매니페스트를 생성할 때부터 MediaTailor가 오리진 요청을 보낼 때까지 측정됩니다.<br />모든 `origin.*` 지표는 오리진에서 직접 이행되는 요청에 대해 내보내집니다. 캐시된 오리진 응답에는 생성되지 않습니다.<br />매니페스트 수명 측정을 위한 지표에 대한 자세한 내용은 섹션을 참조하세요[지표를 사용하여 오래된 매니페스트 진단](stale-manifest-diagnose.md). | 
|  Origin.Errors  | 지정한 CloudWatch 기간 동안 MediaTailor가 오리진 서버에서 수신한 비 HTTP 200 상태 코드 응답 및 시간 초과 응답 수입니다.<br />모든 `origin.*` 지표는 오리진에서 직접 이행되는 요청에 대해 내보내집니다. 캐시된 오리진 응답에는 생성되지 않습니다. | 
|  Origin.ManifestFileSizeBytes  | HLS 및 DASH 모두에 대한 오리진 매니페스트의 파일 크기입니다. 일반적으로이 지표는와 함께 사용됩니다`Origin.ManifestFileSizeTooLarge`.<br />모든 `origin.*` 지표는 오리진에서 직접 이행되는 요청에 대해 내보내집니다. 캐시된 오리진 응답에는 생성되지 않습니다. | 
|  Origin.ManifestFileSizeTooLarge  | 매니페스트 크기가 구성된 양보다 큰 오리진의 응답 수입니다. 일반적으로이 지표는와 함께 사용됩니다`Origin.ManifestFileSizeBytes`.<br />모든 `origin.*` 지표는 오리진에서 직접 이행되는 요청에 대해 내보내집니다. 캐시된 오리진 응답에는 생성되지 않습니다. | 
|  Origin.Timeouts  | 지정한 CloudWatch 기간 동안 오리진 서버에 대한 시간 초과 요청 수입니다.<br />모든 `origin.*` 지표는 오리진에서 직접 이행되는 요청에 대해 내보내집니다. 캐시된 오리진 응답에는 생성되지 않습니다. | 
|  Requests  | 모든 요청 유형에서 초당 동시 트랜잭션 수입니다. 트랜잭션 수는 주로 플레이어 수와 플레이어가 업데이트된 매니페스트를 요청하는 빈도에 따라 달라집니다. 각 플레이어 요청은 트랜잭션으로 간주됩니다. | 
|  SkippedReason.DurationExceeded  | ADS가 지정된 가용 기간보다 긴 광고 기간을 반환했기 때문에 가용 시간에 삽입되지 않은 광고 수입니다. 이 지표의 값이 높으면 `AdDecisionServer.Ads` `Avail.Ads`와 지표 간의 불일치가 발생할 수 있습니다. 건너뛴 광고 이유에 대한 자세한 내용은 섹션을 참조하세요[광고 건너뛰기 문제 해결](troubleshooting-ad-skipping-overview.md). | 
|  SkippedReason.EarlyCueIn  | 초기 로 인해 건너뛴 광고 수입니다`CUE-IN`. | 
|  SkippedReason.ImportError  | 가져오기 작업의 오류로 인해 건너뛴 광고 수입니다. | 
|  SkippedReason.ImportInProgress  | 기존 활성 가져오기 작업으로 인해 건너뛴 광고 수입니다. | 
|  SkippedReason.InternalError  | MediaTailor 내부 오류로 인해 건너뛴 광고 수입니다. | 
|  SkippedReason.NewCreative  | 클라이언트가 자산을 처음 요청했기 때문에 가용성에 삽입되지 않은 광고 수입니다. 이 지표의 값이 높으면 자산이 성공적으로 트랜스코딩`Avail.FillRate`될 때까지 일시적으로 전체가 낮아질 수 있습니다. | 
|  SkippedReason.NoVariantMatch  | 광고와 콘텐츠 간에 변형이 일치하지 않아 건너뛴 광고 수입니다. | 
|  SkippedReason.PersonalizationThresholdExceeded  | 이 구성에서 **개인화 임계값** 설정을 초과하는 광고 기간입니다. | 
|  SkippedReason.ProfileNotFound  | 트랜스코딩 프로파일을 찾을 수 없어 건너뛴 광고 수입니다. | 
|  SkippedReason.TranscodeError  | 트랜스코딩 오류로 인해 건너뛴 광고 수입니다. | 
|  SkippedReason.TranscodeInProgress  | 광고가 아직 트랜스코딩되지 않았기 때문에 가능 구간에 삽입되지 않은 광고 수입니다. 이 지표의 값이 높으면 자산이 성공적으로 트랜스코딩`Avail.FillRate`될 때까지 일시적으로 전체가 낮아질 수 있습니다. | 
|  GetAssets.Requests  | CloudWatch 기간 내에 HLS Interstitials 세션에 대해 수신된 자산 목록 요청 수입니다. 이 지표를 사용하여 지연 바인딩 광고 결정 볼륨을 모니터링하고 HLS Interstitials 사용량의 규모를 이해할 수 있습니다. | 
|  GetAssets.Latency  | HLS Interstitials 세션의 자산 목록 요청에 대한 밀리초 단위 응답 시간입니다. 이 지표를 모니터링하여 최적의 광고 결정 성능을 보장하고 지연 바인딩 워크플로에서 잠재적 병목 현상을 식별합니다. | 

**참고**  
HLS Interstitials 세션의 경우 광고 결정의 지연 바인딩 특성으로 인해 일부 지표가 다르게 동작합니다.  
`Avail.ObservedFilledDuration` MediaTailor`Avail.FilledDuration`는 실제 클라이언트 측 재생 동작을 관찰할 수 없으므로가 일치합니다.
`Avail.ObservedSlateDuration`는 관찰된 재생이 아닌 자산 목록 응답의 계획된 슬레이트 기간을 보고합니다.
"Observed" 접두사가 붙은 지표는 HLS Interstitials 세션의 예상 값을 제공합니다.

### 함수 지표
<a name="metrics.functions"></a>

함수를 재생 구성과 함께 사용하면 [다음 지표가](monetization-functions.html) 게시됩니다. 이러한 지표는 함수가 수명 주기 후크에 구성된 경우 항상 내보내집니다. 옵트인 또는 로그 구성은 필요하지 않습니다.

**후크 수준 지표 -** 수명 주기 후크 실행당 하나의 데이터 포인트:


| 지표 | 설명 | 
| --- | --- | 
|  PreSessionInitHook.Invocations  | 세션 전 초기화 후크가 호출된 횟수입니다. | 
|  PreSessionInitHook.Errors  | 오류가 발생한 세션 전 초기화 후크 실행 수입니다. | 
|  PreSessionInitHook.Latency  | 세션 전 초기화 후크의 밀리초 단위 실행 시간입니다. | 
|  PreAdsRequestHook.Invocations  | 사전 광고 요청 후크가 호출된 횟수입니다. | 
|  PreAdsRequestHook.Errors  | 오류가 발생한 사전 광고 요청 후크 실행 수입니다. | 
|  PreAdsRequestHook.Latency  | 사전 광고 요청 후크의 밀리초 단위 실행 시간입니다. | 

**함수 수준 지표 -** 개별 함수 실행당 하나의 데이터 포인트입니다. 이러한 지표에는 추가 차원(`FunctionId`, `FunctionType`, `HookType`)이 포함되어 있으므로 느리거나 실패한 특정 함수를 식별할 수 있습니다.


| 지표 | 설명 | 
| --- | --- | 
|  Function.Invocations  | 개별 함수가 실행된 횟수입니다. | 
|  Function.Errors  | 오류가 발생한 개별 함수 실행 수입니다. | 
|  Function.Latency  | 개별 함수의 밀리초 단위 실행 시간입니다. | 

### 단순 및 가중 평균
<a name="metrics-simple-average"></a>

ADS에서 MediaTailor의 광고 요청에 대한 응답과 MediaTailor가 광고 시간을 채우는 방법에 대한 단순 평균 및 가중 평균을 검색할 수 있습니다.
+ *단순 평균*이 `AdDecisionServer.FillRate`와 `Avail.FillRate`에 제공됩니다. 해당 기간 동안의 개별 광고 시간의 채움 비율(백분율)의 평균입니다. 단순 평균은 개별 광고 시간의 지속시간 간 차이를 감안하지 않습니다.
+ *가중 평균*은 모든 광고 시간 지속시간의 합계에 대한 채움 비율(백분율)입니다. 단순 평균과 가중 평균은 (`AdDecisionServer.Duration`\*100)/`Avail.Duration`과 (`Avail.FilledDuration`\*100)/`Avail.Duration`으로 계산됩니다. 이러한 평균은 각 광고 시간의 지속 시간의 차이를 감안하여 지속시간이 길수록 더 많은 가중치를 부여합니다.

단 하나의 광고 시간이 포함된 기간의 경우 `AdDecisionServer.FillRate`로 제공되는 단순 평균은 (`AdDecisionServer.Duration`\*100/`Avail.Duration`)으로 계산되는 가중 평균과 동일한 값입니다. `Avail.FillRate`로 제공되는 단순 평균은 (`Avail.FilledDuration`\*100)/`Avail.Duration`으로 계산되는 가중 평균과 동일한 값입니다.

**예제**

지정한 기간에 다음과 같이 2가지 광고 시간이 있다고 가정합니다.
+ 첫 번째 광고 시간의 지속시간은 90초입니다.
  + 광고 시간에 대한 ADS 응답은 45초의 광고를 제공합니다(50% 채움).
  + MediaTailor는 45초 분량의 광고 시간을 채웁니다(50% 채워짐).
+ 두 번째 광고 시간의 지속시간은 120초입니다.
  + 광고 시간에 대한 ADS 응답은 120초의 광고를 제공합니다(100% 채움).
  + MediaTailor는 90초 분량의 광고 시간을 채웁니다(75% 채워짐).

지표는 다음과 같습니다.
+ `Avail.Duration`은 두 광고 시간 지속시간의 합인 201입니다(90 \+ 120).
+ `AdDecisionServer.Duration`은 두 응답 지속시간의 합인 165입니다(45 \+ 120).
+ `Avail.FilledDuration`은 두 채워진 지속시간의 합인 135입니다(45 \+ 90).
+ `AdDecisionServer.FillRate`는 각 광고 시간에 대한 백분율의 평균인 75%입니다((50% \+ 100%) / 2). 이것은 단순 평균입니다.
+ ADS 채움 비율의 가중 평균은 `AdDecisionServer.Duration`으로서 `Avail.Duration`의 평균인 78.57%입니다((165\*100) / 210). 이 계산을 통해 지속시간 간의 차이를 설명할 수 있습니다.
+ `Avail.FillRate`는 각 광고 시간에 대한 채움 백분율의 평균인 62.5%입니다((50% \+ 75%) / 2). 이것은 단순 평균입니다.
+ MediaTailor 가용 채우기 속도의 가중 평균은 64.29%이며, 이는 `Avail.Duration`: (135\*100) / 210의 백분율`Avail.FilledDuration`입니다. 이 계산을 통해 지속시간 간의 차이를 설명할 수 있습니다.

MediaTailor`Avail.FillRate`가 모든 광고 가능 구간에 대해 달성할 수 있는 가장 높은 값은 100%입니다. ADS는 가용 영역에서 사용 가능한 시간보다 더 많은 광고 시간을 반환할 수 있지만 MediaTailor는 사용 가능한 시간만 채울 수 있습니다.

## AWS Elemental MediaTailor CloudWatch 차원
<a name="dimensions"></a>

다음 차원을 사용하여 AWS Elemental MediaTailor 데이터를 필터링할 수 있습니다.


| 차원 | 설명 | 
| --- | --- | 
| `ConfigurationName` | 지표가 속하는 구성을 나타냅니다. 모든 지표에서 사용할 수 있습니다. | 
| `FunctionId` | 함수의 식별자입니다. `Function.*` 지표에서만 사용할 수 있습니다. | 
| `FunctionType` | 함수 유형: `CUSTOM_OUTPUT`, `HTTP_REQUEST``SEQUENTIAL_EXECUTOR`, 또는 `CONCURRENT_EXECUTOR`. `Function.*` 지표에서만 사용할 수 있습니다. | 
| `HookType` | 함수를 트리거한 수명 주기 후크: `PRE_SESSION_INITIALIZATION` 또는 `PRE_ADS_REQUEST`. `Function.*` 지표에서만 사용할 수 있습니다. |