CloudFront 標準ログ(v2)の CMCD と追加フィールドを CloudWatch Logs へ出力してみた

CloudFront 標準ログ(v2)の CMCD と追加フィールドを CloudWatch Logs へ出力してみた

Amazon CloudFront の標準ログ(v2)で、CMCD と追加フィールドを CloudWatch Logs へ出力しました。どちらも --record-fields で指定すると出力され、CMCD のフィールドに値が入ったのは、curl でクエリまたはヘッダーに付けて送ったリクエストだけでした。
2026.11.19

はじめに

2026年11月18日の告知で、CloudFront の標準ログ(v2)に、CMCD(Common Media Client Data)などのリアルタイムログのフィールドを含められるようになりました。以下、CloudWatch Logs 向けの既定のフィールドに含まれない、CMCD 以外のフィールドを追加フィールドと呼びます。

https://aws.amazon.com/jp/about-aws/whats-new/2026/11/cloudfront-standard-logging-cmcd-fields/

この記事では、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 が - でした。各フィールドの定義は、ドキュメントに載っています。

https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/standard-logging.html

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 などでも調整が必要になる点にご留意ください。

この記事をシェアする

AWSのお困り事はクラスメソッドへ

関連記事