
CloudFront 標準ログ(v2)の CMCD と追加フィールドを CloudWatch Logs へ出力してみた
はじめに
2026年11月18日の告知で、CloudFront の標準ログ(v2)に、CMCD(Common Media Client Data)などのリアルタイムログのフィールドを含められるようになりました。以下、CloudWatch Logs 向けの既定のフィールドに含まれない、CMCD 以外のフィールドを追加フィールドと呼びます。
この記事では、S3 静的ウェブサイトがオリジンのディストリビューションへ curl でリクエストを送り、追加フィールドと CMCD の出力を CloudWatch Logs(JSON)で確かめました。
追加フィールドの出力
CloudWatch Logs に出力できるフィールドは、次の3区分です。
既定のフィールド(33個)
| フィールド |
|---|
| date |
| time |
| x-edge-location |
| sc-bytes |
| c-ip |
| cs-method |
| cs(Host) |
| cs-uri-stem |
| sc-status |
| cs(Referer) |
| cs(User-Agent) |
| cs-uri-query |
| cs(Cookie) |
| x-edge-result-type |
| x-edge-request-id |
| x-host-header |
| cs-protocol |
| cs-bytes |
| time-taken |
| x-forwarded-for |
| ssl-protocol |
| ssl-cipher |
| x-edge-response-result-type |
| cs-protocol-version |
| fle-status |
| fle-encrypted-fields |
| c-port |
| time-to-first-byte |
| x-edge-detailed-result-type |
| sc-content-type |
| sc-content-len |
| sc-range-start |
| sc-range-end |
追加フィールドのうち、今回の告知で増えたもの以外は次の13個です。
| フィールド |
|---|
| timestamp |
| DistributionId |
| timestamp(ms) |
| origin-fbl |
| origin-lbl |
| asn |
| c-country |
| cache-behavior-path-pattern |
| distributionid |
| distribution-tenant-id |
| connection-id |
| viewer-request-log-data |
| viewer-response-log-data |
今回の告知で増えたのは、次の6個です。
| フィールド |
|---|
| s-ip |
| primary-distribution-id |
| primary-distribution-dns-name |
| r-host |
| sr-reason |
| x-edge-mqcs |
選択できる CMCD のフィールドは、次の18個です。
| フィールド |
|---|
| cmcd-encoded-bitrate |
| cmcd-buffer-length |
| cmcd-buffer-starvation |
| cmcd-content-id |
| cmcd-object-duration |
| cmcd-deadline |
| cmcd-measured-throughput |
| cmcd-next-object-request |
| cmcd-next-range-request |
| cmcd-object-type |
| cmcd-playback-rate |
| cmcd-requested-maximum-throughput |
| cmcd-streaming-format |
| cmcd-session-id |
| cmcd-stream-type |
| cmcd-startup |
| cmcd-top-bitrate |
| cmcd-version |
ログ配信の作成
標準ログ(v2)の API は us-east-1 で呼び出す必要があるため、以下のコマンドは AWS CLI のリージョンを us-east-1 にして実行しました。先にロググループとリソースポリシーを作ります。
ロググループとリソースポリシーの作成
aws logs create-log-group --log-group-name cf-stdlog-cmcd-test
artifacts/log-policy.json として次の内容を保存します。
{
"Version": "2012-10-17",
"Statement": [{
"Sid": "AllowCloudFrontLogDelivery",
"Effect": "Allow",
"Principal": {"Service": "delivery.logs.amazonaws.com"},
"Action": ["logs:CreateLogStream", "logs:PutLogEvents"],
"Resource": "arn:aws:logs:us-east-1:123456789012:log-group:cf-stdlog-cmcd-test:*",
"Condition": {
"StringEquals": {"aws:SourceAccount": "123456789012"},
"ArnLike": {"aws:SourceArn": "arn:aws:logs:us-east-1:123456789012:delivery-source:*"}
}
}]
}
aws logs put-resource-policy --policy-name cf-stdlog-cmcd-test-policy --policy-document file://artifacts/log-policy.json
続けて、delivery source、delivery destination、delivery の順に作ります。
aws logs put-delivery-source --name cf-stdlog-cmcd-source --resource-arn arn:aws:cloudfront::123456789012:distribution/EDFDVBD6EXAMPLE --log-type ACCESS_LOGS --output json
aws logs put-delivery-destination --name cf-stdlog-cmcd-destination --output-format json --delivery-destination-configuration destinationResourceArn=arn:aws:logs:us-east-1:123456789012:log-group:cf-stdlog-cmcd-test --output json
追加フィールドと CMCD は、選択可能なフィールド(allowedFields)に含まれています。前掲の一覧は、次のコマンドの結果です。
aws logs describe-configuration-templates --service cloudfront --log-type ACCESS_LOGS --delivery-destination-types CWL --output json
delivery の --record-fields には、既定のフィールドから選んだ10個に加えて、追加フィールドのうち8個(timestamp(ms) を含む)と CMCD の18個を並べて指定します。
aws logs create-delivery \
--delivery-source-name cf-stdlog-cmcd-source \
--delivery-destination-arn arn:aws:logs:us-east-1:123456789012:delivery-destination:cf-stdlog-cmcd-destination \
--record-fields timestamp\(ms\) date time x-edge-location x-edge-request-id cs-method cs-uri-stem cs-uri-query sc-status x-edge-result-type cs\(User-Agent\) \
s-ip asn c-country origin-fbl origin-lbl cache-behavior-path-pattern r-host \
cmcd-encoded-bitrate cmcd-buffer-length cmcd-buffer-starvation cmcd-content-id cmcd-object-duration cmcd-deadline cmcd-measured-throughput \
cmcd-next-object-request cmcd-next-range-request cmcd-object-type cmcd-playback-rate cmcd-requested-maximum-throughput cmcd-streaming-format \
cmcd-session-id cmcd-stream-type cmcd-startup cmcd-top-bitrate cmcd-version \
--output json
出力されたレコード
今回は1件目の送信から6件のログが CloudWatch Logs に出るまで約79秒かかりました。
CMCD を付けない通常のリクエスト(Miss)のレコードです。x-edge-request-id と cmcd-* を除いて示します。cmcd-* の18個はすべて - でした。
{
"s-ip": "192.0.2.54",
"r-host": "amzn-s3-demo-bucket.s3-website-ap-northeast-1.amazonaws.com",
"timestamp(ms)": "1795051531698",
"date": "2026-11-19",
"time": "01:25:31",
"x-edge-location": "LAX54-P8",
"cs-method": "GET",
"cs-uri-stem": "/",
"cs-uri-query": "r=2",
"sc-status": "200",
"x-edge-result-type": "Miss",
"cs(User-Agent)": "curl/8.18.0",
"asn": "64496",
"c-country": "JP",
"origin-fbl": "0.272",
"origin-lbl": "0.663",
"cache-behavior-path-pattern": "*"
}
Hit のレコードでは origin-fbl、origin-lbl、r-host が - でした。各フィールドの定義は、ドキュメントに載っています。
s-ip を curl の接続先と照らし合わせるため、cs-uri-query を ip=1 から ip=3 に変えて3回リクエストを送りました。curl の %{remote_ip} は 192.0.2.193、192.0.2.54、192.0.2.140 の順で、それぞれのレコードの s-ip と同じでした。
設定変更の反映
既存の delivery にフィールドを足すには、update-delivery-configuration に --id と --record-fields を渡します。ここでは、create-delivery と同じ36個に Referer を足して指定しました。
aws logs update-delivery-configuration --id <delivery-id> --record-fields <create-delivery と同じ36個> cs\(Referer\)
今回は更新コマンドを 10:30:07(日本時間)に実行し、1秒後の 10:30:08 に Referer ヘッダーを付けた curl のリクエストを送りました。そのレコードには "cs(Referer)": "https://example.com/probe-1" が入っていました。
CMCD の出力
CMCD の送り方
CMCD は、プレイヤーがリクエストごとに付けるビットレートやバッファ長、セッション ID などの再生情報です。curl では、クエリの CMCD パラメーターか、4種類のヘッダー(CMCD-Request、CMCD-Object、CMCD-Status、CMCD-Session)で送りました。クエリは値全体を URL エンコードし、ヘッダーは bl=21300,... の形で渡しました。
curl 'https://d111111abcdef8.cloudfront.net/sample.png?CMCD=bl%3D21300%2Cbr%3D3200%2Cbs%2Ccid%3D%22c-query-default%22%2Cd%3D4004%2Cdl%3D18500%2Cmtp%3D48100%2Cnor%3D%22..%252Fnext.m4v%22%2Cnrr%3D%2212323-48763%22%2Cot%3Dv%2Cpr%3D1.08%2Crtp%3D15000%2Csf%3Dh%2Csid%3D%22s-query-default%22%2Cst%3Dv%2Csu%2Ctb%3D6000%2Cv%3D1'
curl \
-H 'CMCD-Request: bl=21300,dl=18500,mtp=48100,nor="..%2Fnext.m4v",nrr="12323-48763",su' \
-H 'CMCD-Object: br=3200,d=4004,ot=v,tb=6000' \
-H 'CMCD-Status: bs,rtp=15000' \
-H 'CMCD-Session: cid="c-header-default",pr=1.08,sf=h,sid="s-header-default",st=v,v=1' \
https://d111111abcdef8.cloudfront.net/sample.png
ログに出る値
全キーをヘッダーで送ったときのレコードの CMCD フィールドです。クエリで送ったレコードも、cmcd-content-id と cmcd-session-id(c-query-default、s-query-default)を除いて同じ値でした。
"cmcd-encoded-bitrate": "3200",
"cmcd-buffer-length": "21300",
"cmcd-buffer-starvation": "1",
"cmcd-content-id": "c-header-default",
"cmcd-object-duration": "4004",
"cmcd-deadline": "18500",
"cmcd-measured-throughput": "48100",
"cmcd-next-object-request": "..%252Fnext.m4v",
"cmcd-next-range-request": "12323-48763",
"cmcd-object-type": "v",
"cmcd-playback-rate": "1.08",
"cmcd-requested-maximum-throughput": "15000",
"cmcd-streaming-format": "h",
"cmcd-session-id": "s-header-default",
"cmcd-stream-type": "v",
"cmcd-startup": "1",
"cmcd-top-bitrate": "6000",
"cmcd-version": "1"
値を付けずに送った bs と su は、cmcd-buffer-starvation と cmcd-startup に 1 として出力されました。nor に送った ..%2Fnext.m4v は、% が再エンコードされ、..%252Fnext.m4v として出力されました。
sid のみ、または br と ot のみを送ると、送っていない bs、su、v に対応するフィールドにも値が入りました。
| 送ったもの | 値が入ったフィールド |
|---|---|
| なし | なし(cmcd-* の18個はすべて -) |
| CMCD-Session ヘッダーの sid のみ | cmcd-session-id、cmcd-buffer-starvation(0)、cmcd-startup(0)、cmcd-version(1) |
| CMCD-Object ヘッダーの br と ot のみ | cmcd-encoded-bitrate(3200)、cmcd-object-type(v)、cmcd-buffer-starvation(0)、cmcd-startup(0)、cmcd-version(1) |
ヘッダーの CMCD-Session(cid、sid、st)とクエリ(br、cid、ot、sid、st、tb)を同時に送りました。cid と sid の値は、ヘッダーとクエリで別にしました。cmcd-content-id と cmcd-session-id には、ヘッダー側の cid と sid が入りました。クエリにだけあった br、ot、tb に対応する3つのフィールドは - でした。
キャッシュポリシーとの関係
次の2つのビヘイビアで、CMCD の値を変えたリクエストの Hit / Miss を確かめました。リクエストは、ディストリビューションが Deployed になってから送りました。
- 既定のビヘイビア(
*):マネージドキャッシュポリシーの Managed-CachingOptimized。クエリ文字列をキャッシュキーに含めない。 /sample.pngのビヘイビア:自作のポリシー。すべてのクエリ文字列をキャッシュキーに含め、CMCD のヘッダーと Cookie は含めない。
クエリで送る CMCD は、cid と sid だけを変えました。
| パス | 送り方 | リクエスト | x-cache |
|---|---|---|---|
| / | クエリ | cid・sid が1つ目の値 | Hit |
| / | クエリ | cid・sid が2つ目の値 | Hit |
| /sample.png | クエリ | cid・sid が1つ目の値 | Miss |
| /sample.png | クエリ | cid・sid が2つ目の値 | Miss |
| /sample.png | クエリ | 1つ目の値を再送 | Hit |
CMCD の値は、どちらのビヘイビアでもログに出力されました。すべてのクエリ文字列をキャッシュキーに含めたビヘイビアでは、CMCD の値が変わると Miss になり、同じ値の再送は Hit でした。
使ったキャッシュポリシー
artifacts/cache-policy-qs-all.json として次の内容を保存します。
{
"Name": "cf-stdlog-cmcd-qs-all",
"Comment": "query strings (all) in cache key, no headers, no cookies",
"MinTTL": 0,
"DefaultTTL": 86400,
"MaxTTL": 31536000,
"ParametersInCacheKeyAndForwardedToOrigin": {
"EnableAcceptEncodingGzip": true,
"EnableAcceptEncodingBrotli": true,
"HeadersConfig": {"HeaderBehavior": "none"},
"CookiesConfig": {"CookieBehavior": "none"},
"QueryStringsConfig": {"QueryStringBehavior": "all"}
}
}
aws cloudfront create-cache-policy --cache-policy-config file://artifacts/cache-policy-qs-all.json --query CachePolicy.Id --output text
まとめ
CloudFront の標準ログ(v2)に、s-ip、r-host など6個のフィールドと、CMCD のフィールドを追加できるようになりました。
標準ログの項目が足りず、Kinesis Data Streams のリアルタイムログなどで補っていた場合は、今回追加できるようになったフィールドをお試しください。
ログ項目を追加すると、S3 に出力した標準ログ(v2)を解析している Athena などでも調整が必要になる点にご留意ください。







