Skip to content

Commit f8fd0b7

Browse files
authored
[Radar] Add DNS insights changelog and release note entry (#20357)
1 parent 369553e commit f8fd0b7

File tree

5 files changed

+70
-35
lines changed

5 files changed

+70
-35
lines changed

public/_redirects

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -991,6 +991,7 @@
991991
# radar
992992
/fundamentals/radar/ /radar/ 301
993993
/fundamentals/radar/glossary/ /radar/glossary/ 301
994+
/radar/changelog/ /radar/release-notes/ 301
994995

995996
# railgun
996997
/railgun/user-guide/increase-logging/ /railgun/user-guide/troubleshooting/increase-logging/ 301
Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
title: DNS Insights in Cloudflare Radar
3+
description: Expanded DNS insights with new API endpoints for 1.1.1.1 resolver aggregated traffic data
4+
products:
5+
- radar
6+
date: 2025-02-27T15:00:00Z
7+
---
8+
9+
[**Radar**](/radar/) has expanded its DNS insights, providing visibility into aggregated traffic and usage trends observed by our [1.1.1.1](/1.1.1.1/) DNS resolver.
10+
In addition to global, location, and ASN traffic trends, we are also providing perspectives on protocol usage, query/response characteristics, and DNSSEC usage.
11+
12+
Previously limited to the [`top`](/api/resources/radar/subresources/dns/subresources/top/) locations and ASes endpoints, we have now introduced the following endpoints:
13+
14+
- [`timeseries`](/api/resources/radar/subresources/dns/subresources/timeseries/): Retrieves DNS query volume over time.
15+
- [`summary`](/api/resources/radar/subresources/dns/subresources/summary/): Retrieves summaries of DNS query distribution across ten different dimensions.
16+
- [`timeseries_group`](/api/resources/radar/subresources/dns/subresources/timeseries_groups/): Retrieves timeseries data for DNS query distribution across ten different dimensions.
17+
18+
For the `summary` and `timeseries_groups` endpoints, the following dimensions are available, displaying the distribution of DNS queries based on:
19+
20+
- `cache_hit`: Cache status (hit vs. miss).
21+
- `dnsssec`: DNSSEC support status (secure, insecure, invalid or other).
22+
- `dnsssec_aware`: DNSSEC client awareness (aware vs. not-aware).
23+
- `dnsssec_e2e`: End-to-end security (secure vs. insecure).
24+
- `ip_version`: IP version (IPv4 vs. IPv6).
25+
- `matching_answer`: Matching answer status (match vs. no-match).
26+
- `protocol`: Transport protocol (UDP, TLS, HTTPS or TCP).
27+
- `query_type`: Query type (`A`, `AAAA`, `PTR`, etc.).
28+
- `response_code`: Response code (`NOERROR`, `NXDOMAIN`, `REFUSED`, etc.).
29+
- `response_ttl`: Response TTL.
30+
31+
32+
Learn more about the new Radar DNS insights in our [blog post](https://blog.cloudflare.com/new-dns-section-on-cloudflare-radar/), and check out the [new Radar page](https://radar.cloudflare.com/dns).

src/content/docs/radar/glossary.mdx

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ Learn more about our route leak detection system design and usages in [How we d
5050

5151
## BGP origin hijacks
5252

53-
[BGP origin hijack](https://en.wikipedia.org/wiki/bgp_hijacking) is one type of BGP anomaly where networks falsely announce
53+
[BGP origin hijack](https://www.cloudflare.com/learning/security/glossary/bgp-hijacking/) is one type of BGP anomaly where networks falsely announce
5454
ownership for groups of IP addresses (prefixes) that they do not own, control, or route to. A BGP origin hijack can redirect Internet traffic to the hijacker from its
5555
legitimate destination, causing data loss with potential leak of private/confidential information.
5656

@@ -90,7 +90,7 @@ Cloudflare Speed Test measures latency multiple times over the course of the tes
9090

9191
## Content categories
9292

93-
Cloudflare uses a variety of data sources to categorize domains. Using Cloudflare Radar, you can view the content categories associated with a given domain. Cloudflare customers using Cloudflare Gateway or [1.1.1.1 for Families](https://one.one.one.one/family/) can decide to block certain categories, like "Adult Content", in addition to security threats like malware and phishing.
93+
Cloudflare uses a variety of data sources to categorize domains. Using Cloudflare Radar, you can view the content categories associated with a given domain. Cloudflare customers using Cloudflare Gateway or [1.1.1.1 for Families](/1.1.1.1/setup/#1111-for-families) can decide to block certain categories, like "Adult Content", in addition to security threats like malware and phishing.
9494

9595
In some cases, a domain may be miscategorized. For example, a social media site might be categorized as "Shopping & Auctions". If you believe a domain is miscategorized, or a domain has not yet been categorized, please provide your suggested category using [this form](https://radar.cloudflare.com/domains/feedback) to bring it to our attention.
9696

@@ -99,11 +99,11 @@ In some cases, a domain may be miscategorized. For example, a social media site
9999
The [Domain Name System (DNS)](https://www.cloudflare.com/learning/dns/what-is-dns/) is a network service that is most commonly used to translate human-readable domain names into numerical IP addresses that computers can use to talk to each other.
100100
It is an essential Internet service, and is also used to look up other network-related information.
101101

102-
The data displayed on Radar for DNS is based on aggregated and anonymized DNS lookups to Cloudflare's [1.1.1.1](https://one.one.one.one/dns/) public resolver service.
102+
The data displayed on Radar for DNS is based on aggregated and anonymized DNS lookups to Cloudflare's [1.1.1.1](/1.1.1.1/) public resolver service.
103103

104104
## Domain rankings
105105

106-
Domain Rankings is based on our anonymized and aggregated [1.1.1.1 resolver](https://one.one.one.one/dns/) data, complies with our [privacy policy](https://www.cloudflare.com/en-gb/privacypolicy/), and aims to identify the top most popular domains that reflect how people use the Internet globally. Domain Rankings’ popularity metric is best described as the estimated number of unique users that access a domain over some period of time.
106+
Domain Rankings is based on our anonymized and aggregated [1.1.1.1 DNS resolver](/1.1.1.1/) data, complies with our [privacy policy](https://www.cloudflare.com/en-gb/privacypolicy/), and aims to identify the top most popular domains that reflect how people use the Internet globally. Domain Rankings’ popularity metric is best described as the estimated number of unique users that access a domain over some period of time.
107107

108108
Trending domains are domains which are currently experiencing an increase in popularity. Domains Trending Today are domains spiking in popularity, reflecting increased interest potentially related to a particular event or a topic. Domains Trending This Week are domains that have steadily grown in popularity, reflecting an increase of their user base over the week.
109109

@@ -119,7 +119,7 @@ An early warning signal that an Internet outage may be underway on a given netwo
119119

120120
## Internet services ranking
121121

122-
Internet services ranking is based on our anonymized and aggregated [1.1.1.1 resolver](https://one.one.one.one/dns/) data, complies with our [privacy policy](https://www.cloudflare.com/en-gb/privacypolicy/), and aims to identify the top most popular Internet services that reflect how people use the Internet globally. A service represents one or more domains aggregated together. Ranking popularity metric is best described as the estimated number of unique users that access domains associated with a service, over some period of time.
122+
Internet services ranking is based on our anonymized and aggregated [1.1.1.1 DNS resolver](/1.1.1.1/) data, complies with our [privacy policy](https://www.cloudflare.com/en-gb/privacypolicy/), and aims to identify the top most popular Internet services that reflect how people use the Internet globally. A service represents one or more domains aggregated together. Ranking popularity metric is best described as the estimated number of unique users that access domains associated with a service, over some period of time.
123123

124124
## Internet traffic trends
125125

src/content/docs/radar/changelog.mdx renamed to src/content/docs/radar/release-notes.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
pcx_content_type: changelog
3-
title: Changelog
2+
pcx_content_type: release-notes
3+
title: Release notes
44
release_notes_file_name:
55
- radar
66
sidebar:

src/content/release-notes/radar.yaml

Lines changed: 30 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,14 @@
11
---
2-
link: "/radar/changelog/"
2+
link: "/radar/release-notes/"
33
productName: Radar
44
productLink: "/radar/"
55
productArea: Developer platform
66
productAreaLink: /workers/platform/changelog/platform/
77
entries:
8+
- publish_date: "2025-02-27"
9+
title: Add DNS endpoints
10+
description: |-
11+
* Added [DNS endpoints](/api/resources/radar/subresources/dns/).
812
- publish_date: "2025-02-04"
913
title: Add Internet services ranking, robots.txt, and AI inference endpoints
1014
description: |-
@@ -22,28 +26,28 @@ entries:
2226
title: Add more meta information's
2327
description: |-
2428
* Added meta.lastUpdated to all summaries and top endpoints (timeseries and timeseriesGroups already had this).
25-
* Fix meta.dateRange to return date ranges for all requested series.
29+
* Fixed meta.dateRange to return date ranges for all requested series.
2630
- publish_date: "2023-11-16"
27-
title: Add new Layer 3 endpoints and Layer 7 dimensions
31+
title: Add new layer 3 endpoints and layer 7 dimensions
2832
description: |-
29-
* Added Layer 3 [top origin locations](/api/resources/radar/subresources/attacks/subresources/layer3/subresources/top/subresources/locations/methods/origin/)
33+
* Added layer 3 [top origin locations](/api/resources/radar/subresources/attacks/subresources/layer3/subresources/top/subresources/locations/methods/origin/)
3034
and [top target location](/api/resources/radar/subresources/attacks/subresources/layer3/subresources/top/subresources/locations/methods/target/).
31-
* Added Layer 7 Summaries by `http_method`, `http_version`, `ip_version`, `managed_rules`, `mitigation_product`.
32-
* Added Layer 7 Timeseries Groups by `http_method`, `http_version`, `ip_version`, `managed_rules`, `mitigation_product`, `industry`, `vertical`.
33-
* Added Layer 7 Top by `industry`, `vertical`.
34-
* Deprecated Layer 7 timeseries groups without dimension.
35+
* Added layer 7 Summaries by `http_method`, `http_version`, `ip_version`, `managed_rules`, `mitigation_product`.
36+
* Added layer 7 Timeseries Groups by `http_method`, `http_version`, `ip_version`, `managed_rules`, `mitigation_product`, `industry`, `vertical`.
37+
* Added layer 7 Top by `industry`, `vertical`.
38+
* Deprecated layer 7 timeseries groups without dimension.
3539
* To continue getting this data, switch to the new
3640
[timeseries group by mitigation_product](/api/resources/radar/subresources/attacks/subresources/layer7/subresources/timeseries_groups/methods/mitigation_product/)
3741
endpoint.
38-
* Deprecated Layer 7 summary without dimension.
42+
* Deprecated layer 7 summary without dimension.
3943
* To continue getting this data, switch to the new
4044
[summary by mitigation_product](/api/resources/radar/subresources/attacks/subresources/layer7/subresources/summary/methods/mitigation_product/)
4145
endpoint.
4246
* Added new [Error codes](/radar/get-started/error-codes/).
4347
- publish_date: "2023-10-31"
44-
title: Add new Layer 3 direction parameter
48+
title: Add new layer 3 direction parameter
4549
description: |-
46-
* Added a `direction` parameter to all Layer 3 endpoints. Use together with `location` parameter to filter by origin or
50+
* Added a `direction` parameter to all layer 3 endpoints. Use together with `location` parameter to filter by origin or
4751
target location [timeseries groups](/api/resources/radar/subresources/attacks/subresources/layer3/subresources/timeseries_groups/methods/vector/).
4852
- publish_date: "2023-09-08"
4953
title: Add Connection Tampering endpoints
@@ -56,35 +60,35 @@ entries:
5660
* Added Regional Internet Registry (see field `source` in response)
5761
to [get asn by id](/api/resources/radar/subresources/entities/subresources/asns/methods/get/)
5862
and [get asn by ip](/api/resources/radar/subresources/entities/subresources/asns/methods/ip/) endpoints.
59-
* Stopped collecting data in the old Layer 3 data source.
60-
* Updated Layer 3
63+
* Stopped collecting data in the old layer 3 data source.
64+
* Updated layer 3
6165
[timeseries](/api/resources/radar/subresources/attacks/subresources/layer3/methods/timeseries/) endpoint
62-
to start using the new Layer 3 data source by default, fetching the old data source now requires sending the parameter
66+
to start using the new layer 3 data source by default, fetching the old data source now requires sending the parameter
6367
`metric=bytes_old`.
64-
* Deprecated Layer 3 summary endpoint, this will stop receiving data after 2023-08-14.
68+
* Deprecated layer 3 summary endpoint, this will stop receiving data after 2023-08-14.
6569
* To continue getting this data, switch to the
6670
new [timeseries group protocol](/api/resources/radar/subresources/attacks/subresources/layer3/subresources/summary/methods/protocol/)
6771
endpoint.
68-
* Deprecated Layer 3 timeseries groups endpoint, this will stop receiving data after 2023-08-14.
72+
* Deprecated layer 3 timeseries groups endpoint, this will stop receiving data after 2023-08-14.
6973
* To continue getting this data, switch to the
7074
new [timeseries group protocol](/api/resources/radar/subresources/attacks/subresources/layer3/subresources/timeseries_groups/methods/protocol/)
7175
endpoint.
7276
- publish_date: "2023-07-31"
73-
title: Fix HTTP timeseries endpoint urls
77+
title: Fix HTTP timeseries endpoint URLs
7478
description: |-
75-
* Updated HTTP `timeseries` endpoints urls
76-
to `timeseries_groups` ([example](/api/resources/radar/subresources/http/subresources/timeseries_groups/methods/browser_family/))
79+
* Updated HTTP `timeseries` endpoints URLs
80+
to [`timeseries_groups`](/api/resources/radar/subresources/http/subresources/timeseries_groups/)
7781
due to consistency. Old timeseries endpoints are still available, but will soon be removed.
7882
- publish_date: "2023-07-20"
7983
title: Add URL Scanner endpoints
8084
description: |-
81-
* Added [urlscanner endpoints](/api/resources/url_scanner/). For more information, refer to [URL Scanner](/radar/investigate/url-scanner/).
85+
* Added [URL Scanner endpoints](/api/resources/url_scanner/). For more information, refer to [URL Scanner](/radar/investigate/url-scanner/).
8286
- publish_date: "2023-06-20"
83-
title: Add Quality endpoints
87+
title: Add Internet quality endpoints
8488
description: |-
85-
* Added [quality endpoints](/api/resources/radar/subresources/quality/).
89+
* Added [Internet quality endpoints](/api/resources/radar/subresources/quality/).
8690
- publish_date: "2023-06-07"
87-
title: Add BGP stats, pfx2as and moas endpoint
91+
title: Add BGP stats, pfx2as and moas endpoints
8892
description: |-
8993
* Added BGP [stats](/api/resources/radar/subresources/bgp/subresources/routes/methods/stats/),
9094
[pfx2as](/api/resources/radar/subresources/bgp/subresources/routes/methods/pfx2as/)
@@ -107,13 +111,11 @@ entries:
107111
- publish_date: "2023-01-11"
108112
title: Add new layer 3 dataset
109113
description: |-
110-
* Added new Layer 3 data source and related endpoints.
111-
* Updated Layer 3
114+
* Added new layer 3 data source and related endpoints.
115+
* Updated layer 3
112116
[timeseries](/api/resources/radar/subresources/attacks/subresources/layer3/methods/timeseries/) endpoint
113117
to support fetching both current and new data sources. For retro-compatibility
114118
reasons, fetching the new data source requires sending the parameter `metric=bytes` else the current data
115119
source will be returned.
116-
* Deprecated old Layer 3 endpoints
117-
[TimeseriesGroups](/api/resources/radar/subresources/attacks/subresources/layer3/subresources/timeseries_groups/methods/get/) and
118-
[Summary](/api/resources/radar/subresources/attacks/subresources/layer3/subresources/summary/methods/get/).
120+
* Deprecated old layer 3 endpoints timeseries_groups and summary.
119121
Users should upgrade to newer endpoints.

0 commit comments

Comments
 (0)