Customize and subscribe to operations reports

更新时间:
复制 MD 格式

The operations report feature lets you query batch analytics data for accelerated domain names over different time periods. This data helps you understand the operational status of your domain names and analyze your business performance.

Prerequisites

You have added an accelerated domain name. If you have not, see Add an accelerated domain name.

Features

By default, operations reports provide statistics on user access data, such as PV/UV, Regions and ISPs, Domain Names, Popular Referer, Popular URLs, Popular Back-to-origin URLs, and Top Client IPs. You can customize and subscribe to reports as needed. After you subscribe, the system sends the reports to your specified mailbox. You can analyze the reports to understand the operational status of your accelerated domain names.

Report content

Description

PV/UV

Query PV and UV for domain names by time.

Regions and ISPs

View user access distribution by region and ISP for a specified time range. Regions include the Chinese mainland, Hong Kong (China), Macao (China), Taiwan (China), and regions outside China.

Domain Names

Displays the access ranking of accelerated domain names. The ranking includes percentage, traffic or peak bandwidth, time of peak, and number of requests.

Note

The minimum granularity for querying domain name rankings is one day. For example, after you select a date to query, the system displays the top 200 records for that date.

Popular Referer

Displays the traffic, traffic percentage, number of requests, and request percentage for popular Referers used in hotlink protection.

Note

When the operations report feature analyzes user logs, it collects statistics on the http_referer source table columns in user request logs. The statistical results include the following two cases:

  • If the Referer information in a user request is a standard URL, the operations report counts and records the domain name. For example, the following URLs are all counted as example.com.

    • http://example.com/aliyundoc/

    • https://example.com/aliyundoc/image

  • If the Referer information in a user request is not a standard URL, the operations report counts it as a hyphen (-).

Popular URLs

Query popular URLs for a specified domain name, status code, and date. The query results include traffic, traffic percentage, number of requests, and request percentage.

Note

The minimum granularity for querying popular URLs is one day. For example, after you select a date to query, the system displays the top 3,000 records for that date.

Popular Back-to-origin URLs

Query popular origin-fetch URLs for a specified domain name, status code, and date. The query results include traffic, traffic percentage, number of requests, and request percentage.

Note

The minimum granularity for querying popular origin-fetch URLs is one day. For example, after you select a date to query, the system displays the top 100 records for that date.

Top Client IPs

Query the top client IPs for a specified domain name, region, and date. You can rank the IPs by traffic or number of requests.

Note

The minimum granularity for top client IPs is one day. After you select a date to query, the system displays the top 200 records for that date if you query all regions. If you query a single region, the system displays the top 20 records for that date.

Note

After you subscribe to operations reports, Alibaba Cloud CDN periodically sends reports to your mailbox. The traffic data in these reports is measured in bytes.

Customize an operations report

Before you use the operations report feature, you must customize a report to generate data statistics. Data generation takes a long time because of delays in log integrity. Customized reports are typically available around 06:00 on Day T+1. For example, a report customized on July 16, 2025 is available around 06:00 on July 17, 2025.

Note
  • If you create an operations report on Day T, you can obtain report data for Day T+1 and later. Report data for Day T and earlier cannot be obtained. Operations report data has a latency of more than 6 hours. The data generation interval varies based on the metric and ranges from 1 to 6 hours. Therefore, you can view the report data for Day T+1 only after 06:00 on Day T+1.

  • The data generation intervals for different metrics are as follows:

    • Popular URL (sort by number of requests or traffic): 6 hours

    • Popular Referer (sort by number of requests or traffic): 1 hour

    • Popular Origin-Fetch URL (sort by number of requests or traffic): 1 hour

    • Top Client IP (sort by number of requests or traffic): 6 hours

    • Domain Name Rank (sorted by traffic only): 1

    • PV/UV: 1 hour

    • Access Region Distribution: 1 hour

    • ISP Distribution: 1 hour

  • Other report data is not displayed in the console by default. You can subscribe to reports and have them sent to a specified mailbox to view the data.

  1. Log on to the CDN console.

  2. In the left-side navigation pane, choose Statistics > Operations Reports.

  3. On the Operations Reports tab, turn on the Customize Operations Report switch.

  4. You can view detailed information for PV/UV, Regions and ISPs, Domain Name Ranking, Popular Referer Headers, Popular URLs, Popular Origin URLs, and Top Client IPs for your account.

Subscribe to an operations report

Before you subscribe to an operations report, ensure that you have customized it. Otherwise, the subscription fails. After you subscribe, the system sends the report to your specified mailbox.

Note
  • This subscription feature is in beta. Each Alibaba Cloud account, including its Resource Access Management (RAM) users, can create a maximum of five subscription tasks.

  • Because of delays in log integrity, data generation takes a long time. The system sends reports only after all data is collected.

  1. Log on to the CDN console.

  2. In the left-side navigation pane, choose Statistics > Operations Reports.

  3. On the Operations Reports page, click the Tracking Tasks tab.

  4. Click Tracking Tasks and configure the subscription settings.

    Parameter

    Description

    Task Name

    Enter a name for the tracking task.

    Report Type

    The report frequency. Valid values: Daily, Weekly, and Monthly.

    • Daily: After the log data from the previous day is fully collected and processed, the system sends the report to your email address.

    • Weekly: The report is calculated by calendar week. After a week of log data is fully collected and processed, the system sends the report to your email address. The report for the previous week is typically sent on the following Monday morning.

    • Monthly: The report is calculated by calendar month. After a month of log data is fully collected and processed, the system sends the report to your email address.

    Email Address

    The recipient's email address. To add multiple addresses, separate them with commas (,).

    Domain Names

    Select the accelerated domain names for which you want to subscribe to operations reports.

    Report Metrics

    Select the report metrics to which you want to subscribe.

  5. Click OK. A "The tracking task is created." message appears.

    Note
    • After you create a tracking task, if you delete a report metric from a customized operations report, the deleted metric is displayed with an error (as its report ID) when you click Modify for the task. This indicates that the metric is no longer customized and you cannot track it. For the mapping between report IDs and report names, see Report Mappings.

    • In the reports, traffic data is measured in bytes.

  6. Optional: Modify a Tracking Tasks.

    To modify a tracking task, select it, click Modify, update the settings as described in Step 4, and then click OK.

Report ID to metric mapping

This table maps report IDs to their corresponding metric names.

Report ID

English name

Metric name

Calculation method

1

TopUrlByAcc

popular URLs (ranked by number of requests)

Ranked by the number of requests for each URL.

3

TopUrlByTraf

popular URLs (ranked by traffic)

Ranked by traffic. The traffic value includes the TCP packet header overhead. For more information, see Why do traffic values differ among monitoring, usage query, and log statistics?.

5

TopReferByAcc

popular referers (ranked by number of requests)

Based on the number of requests.

7

TopReferByTraf

popular referers (ranked by traffic)

Ranked by traffic. The traffic value includes the TCP packet header overhead. For more information, see Why do traffic values differ among monitoring, usage query, and log statistics?.

9

OriginTopUrlByAcc

popular origin URLs (ranked by number of requests)

Based on the number of requests for each URL.

11

OriginTopUrlByTraf

popular origin URLs (ranked by traffic)

Ranked by traffic. The traffic value includes the TCP packet header overhead. For more information, see Why do traffic values differ among monitoring, usage query, and log statistics?.

13

TopIpByAcc

top client IPs (ranked by number of requests)

Ranked by the number of requests from each client IP.

15

TopIpByTraf

top client IPs (ranked by traffic)

Ranked by traffic. The traffic value includes the TCP packet header overhead. For more information, see Why do traffic values differ among monitoring, usage query, and log statistics?.

17

DomainByTraf

domain name ranking (ranked by traffic)

Ranked by the traffic of each domain name.

19

DomainPvUv

PV/UV

  • PV: Counted by the number of daily terminal accesses.

  • UV: Counted by the number of unique IP addresses. Each IP address is counted only once.

21

AreaTrafStat

Visitor distribution by region

Calculates the distribution of requests for a domain name across different regions.

23

IspTrafStat

Distribution by ISP

Calculates the distribution of requests for a domain name across different ISPs.

Disable a customized operations report

When you disable Customize Operations Report, all tracking tasks stop generating data, but the Tracking Tasks remain. If you no longer need a tracking task, you can manually delete it on the Tracking Tasks tab. For more information, see Delete a tracking task.

  1. Log on to the CDN console.

  2. In the left navigation pane, choose Operations Reports.

  3. On the Operations Reports page, turn off the Disable Operations Report switch.

  4. Click OK to disable the customized operations report.

Delete a tracking task

  1. Log on to the CDN console.

  2. In the left navigation pane, choose Operations Reports.

  3. On the Tracking Tasks tab, find the task that you want to delete and click Delete in the Actions column.

  4. Click OK to delete the tracking task.

FAQ

No data in customized reports

Due to delays in log collection, data generation takes time. A report customized on a specific day is typically generated on the next day. For example, a report customized on August 1, 2021, is generated at around 06:00 on August 2, 2021.

If the console still shows no data on the next day, one of the following issues may have occurred:

  • The domain name that you added when customizing the operations report has no traffic. Click Customize Operations Report, check the Selected Domain Names to confirm that the target domain name is correct and has traffic. If the domain name is incorrect, you must customize the report again for the correct domain name and wait for data generation.

  • You did not select the required report metrics when you customized the report. For example, if you want to view the Popular URLs report but did not select the Popular URLs metric during customization, no data is generated for the report. In this case, you must select the report metrics again for the domain name and wait for data generation.

Tracking task limit

Each Alibaba Cloud account, including its RAM users, can create up to five tracking tasks. You must customize an operations report before creating a tracking task; otherwise, the subscription will fail.

Viewing real-time data

Operations reports provide data aggregated daily and are typically generated around 06:00 on the following day (T+1). Therefore, you cannot use them to view the current day's access data. To view today's CDN access data in real time, such as access URLs and the number of requests, you can enable the real-time log delivery feature. This feature delivers CDN logs to Simple Log Service (SLS) for real-time querying and analysis. Real-time log delivery is a paid feature. For more information, see Configure real-time log delivery.

Related documents

For API operations related to operations reports, see Operations reports.