全部產品
Search

搜尋本產品

    CDN：離線日誌欄位說明

    文件中心

    CDN：離線日誌欄位說明

    更新時間：Jun 20, 2025

    阿里雲CDN按小時顆粒度記錄了網域名稱的全網訪問日誌。支援指定網域名稱在30天內的日誌下載到本地路徑進行儲存，進行分析加速網域名稱的流量訪問詳情。本文將介紹離線日誌的下載方式和格式說明。

    下載說明

    • 進入離線日誌下載頁面，具體下載路徑：日誌與報表>日誌管理>離線日誌>日誌下載，選擇需要的日期進行日誌下載即可。

    • 記錄檔延遲時間：通常情況下延遲在24小時之內，也有可能超過24小時，如果需要查看延遲小於24小時的日誌，參考即時日誌。

    • 日誌下載預設支援下載30天內的日誌資料。如果您需要儲存更長時間的日誌，可以將日誌轉存到OSS進行長期儲存。具體操作請參見通過Function Compute轉存離線日誌。

    日誌說明

    • 記錄檔命名規則：加速網域名稱_年_月_日_開始時間_結束時間[擴充欄位].gz，擴充欄位以底線（_）開頭。例如aliyundoc.com_2018_10_30_000000_010000_xx.gz。

      說明

      擴充欄位可能不存在，例如aliyundoc.com_2018_10_30_000000_010000.gz。

    • CDN日誌支援常見的IDE工具查看，如notepad++等。

    • 通過監控查詢、用量查詢功能查詢到加速網域名稱的流量資料是日誌統計的流量資料的1.1倍，詳細請參見為什麼監控查詢流量、用量查詢流量與日誌統計流量有差異。

    • 少數ISP在特定地區可能會分配私人IP地址給使用者端，導致CDN節點接收到的是使用者的私人IP地址。這個IP是從要求標頭X-Forwarded-For中提取的左邊第一個IP地址。

      說明

      私人IP位址範圍有以下三個：

      • A類私人IP地址：10.0.0.0～10.255.255.255，子網路遮罩：10.0.0.0/8

      • B類私人IP地址：172.16.0.0～172.31.255.255，子網路遮罩：172.16.0.0/12

      • C類私人IP地址：192.168.0.0~192.168.255.255，子網路遮罩：192.168.0.0/16

    格式說明

    // 樣本日誌
//       訪問時間                  用戶端IP  代理IP 回應時間        Referer               請求類型            請求URL                   HTTP狀態代碼 請求位元組數   響應位元組數     是否命中CDN節點                                                    User_Agent                                                             檔案類型            訪問IP
[8/Jan/2025:20:16:54 +0800] 139.224.XXX.XXX   -     246     "-"                          "GET    http://cdn.aliyun.cn/images/cdn.gif"    403       369        978               MISS      "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.115 Safari/537.36" "application/xml" 139.224.XXX.XXX
[8/Jan/2025:20:16:55 +0800] 139.224.XXX.XXX   -     197     "https://www.aliyun.com/"    "GET    http://cdn.aliyun.cn/images/cdn.jpg"    200       369        1143              HIT       "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.115 Safari/537.36" "application/xml" 139.224.XXX.XXX
[8/Jan/2025:20:16:53 +0800] 139.224.XXX.XXX   -     1073    "https://www.aliyun.com/"    "GET    http://cdn.aliyun.cn/"                  200       368        985               HIT       "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.115 Safari/537.36" "application/xml" 139.224.XXX.XXX
[8/Jan/2025:20:09:42 +0800] 139.196.XXX.XXX   -     233     "https://www.aliyun.com/"    "GET    http://cdn.aliyun.cn/"                  200       284        857               HIT       "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/84.0.4147.135 Safari/537.36" "text/html"       139.196.XXX.XXX
[8/Jan/2025:20:09:43 +0800] 139.196.XXX.XXX   -     42      "https://www.aliyun.com/"    "GET    http://cdn.aliyun.cn/"                  200       404        809               HIT       "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/126.0.6478.182 Safari/537.36"  "text/html"       139.196.XXX.XXX
[8/Jan/2025:20:16:54 +0800] 139.224.XXX.XXX   -     152     "https://www.aliyun.com/"    "GET    http://cdn.aliyun.cn/images/cdn.png"    200       374        1139              HIT       "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.115 Safari/537.36" "application/xml" 139.224.XXX.XXX

    欄位含義

    樣本

    欄位含義

    描述

    [8/Jan/2025:20:16:54 +0800]

    訪問時間

    使用者訪問請求的結束時間。

    139.224.XXX.XXX

    用戶端IP

    從使用者請求攜帶的要求標頭X-Forwarded-For中提取左邊第一個IP地址（即client_ip，用戶端IP，如果用戶端與CDN節點之間沒有經過代理的話，等同於用戶端與CDN節點建聯使用的IP）。

    說明

    • 要求標頭 X-Forwarded-For 的格式為X-Forwarded-For: <client_ip>, <proxy_ip>。

    • 在用戶端與CDN節點之間沒有經過代理的情境下（即x-forwarded-for裡面只有<client_ip>），可能會出現日誌中<client_ip>的值為私網IP地址的情況，其原因通常為用戶端所在的電訊廠商為其分配了私網IP地址（目的是減少公網IP地址的使用，以降低成本）。

    -

    代理IP

    從使用者請求攜帶的要求標頭X-Forwarded-For中提取左邊第二個IP地址（即proxy_ip，代理IP，如果用戶端與CDN節點之間沒有經過代理的話，提取到的空值用-表示）。

    246

    回應時間

    請求回應時間，單位為毫秒。

    "-"

    Referer

    HTTP要求標頭中的Referer。

    GET

    請求類型

    請求方式，常見於GET、POST、PUT、DELETE等。

    http://cdn.aliyun.cn/images/cdn.gif

    請求URL

    使用者請求的URL連結。

    403

    HTTP狀態代碼

    HTTP狀態代碼，常見的有200、403、404、500等。

    369

    請求位元組數

    請求大小，單位為位元組。

    978

    響應位元組數

    請求返回大小，單位為位元組。

    MISS

    是否命中CDN節點

    命中資訊。

    • HIT：使用者請求命中了CDN邊緣節點上的資源（不需要回源）。

    • MISS：使用者請求的內容沒有在CDN邊緣節點上緩衝，需要向上遊擷取資源（上遊可能是CDN L2節點，也可能是來源站點）。

    說明

    阿里雲CDN目前僅提供了CDN邊緣節點的日誌資訊，不包含CDN L2節點的回源相關資訊，因此當該欄位為MISS時，無法擷取回源資訊，因此無法直觀地從日誌裡面看到使用者請求是否回源。

    Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.115 Safari/537.36

    User_Agent

    User-Agent要求標頭資訊。

    application/xml

    檔案類型

    即網頁類型。

    說明

    開啟全球資源計劃的網域名稱日誌，不包含該欄位。

    139.224.XXX.XXX

    訪問IP

    即建立串連的IP地址，一般是用戶端IP。

    相關API

    DescribeCdnDomainLogs：查詢網域名稱的離線日誌下載地址。

    後續步驟

    離線日誌分析方法參考快速分析離線訪問日誌。