Skip to content

Commit b1a63ee

Browse files
authored
Merge branch 'cloudflare:production' into production
2 parents b91c647 + 56dbb93 commit b1a63ee

File tree

38 files changed

+1124
-145
lines changed

38 files changed

+1124
-145
lines changed

.github/CODEOWNERS

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -90,6 +90,7 @@
9090
/src/content/docs/registrar/ @dcpena @cloudflare/pcx-technical-writing
9191
/src/content/docs/rules/ @pedrosousa @cloudflare/pcx-technical-writing
9292
/src/content/docs/ruleset-engine/ @pedrosousa @cloudflare/pcx-technical-writing
93+
/src/content/docs/log-explorer/ @angelampcosta @cloudflare/pcx-technical-writing
9394

9495
# Developer Platform
9596

@@ -121,9 +122,9 @@
121122
/src/content/release-notes/r2.yaml @oxyjun @elithrar @aninibread @cloudflare/workers-docs @cloudflare/pcx-technical-writing
122123
/src/content/docs/stream/ @tsmith512 @ToriLindsay @cloudflare/pcx-technical-writing @renandincer @third774
123124
/src/content/release-notes/stream.yaml @tsmith512 @ToriLindsay @cloudflare/pcx-technical-writing
124-
/src/content/docs/workers/ @cloudflare/workers-docs @GregBrimble @irvinebroque @mikenomitch @WalshyDev @cloudflare/deploy-config @cloudflare/pcx-technical-writing @kodster28 @cloudflare/wrangler @cloudflare/workers-runtime-1
125-
/src/content/partials/workers/ @cloudflare/workers-docs @GregBrimble @irvinebroque @mikenomitch @WalshyDev @cloudflare/deploy-config @cloudflare/pcx-technical-writing @kodster28 @cloudflare/wrangler @cloudflare/workers-runtime-1
126-
/src/assets/images/workers/ @cloudflare/workers-docs @GregBrimble @irvinebroque @WalshyDev @cloudflare/deploy-config @cloudflare/pcx-technical-writing @kodster28 @cloudflare/wrangler @cloudflare/workers-runtime-1
125+
/src/content/docs/workers/ @cloudflare/workers-docs @GregBrimble @irvinebroque @mikenomitch @WalshyDev @cloudflare/deploy-config @cloudflare/pcx-technical-writing @kodster28 @cloudflare/wrangler @cloudflare/workers-runtime-1 @cloudflare/wrangler
126+
/src/content/partials/workers/ @cloudflare/workers-docs @GregBrimble @irvinebroque @mikenomitch @WalshyDev @cloudflare/deploy-config @cloudflare/pcx-technical-writing @kodster28 @cloudflare/wrangler @cloudflare/workers-runtime-1 @cloudflare/wrangler
127+
/src/assets/images/workers/ @cloudflare/workers-docs @GregBrimble @irvinebroque @WalshyDev @cloudflare/deploy-config @cloudflare/pcx-technical-writing @kodster28 @cloudflare/wrangler @cloudflare/workers-runtime-1 @cloudflare/wrangler
127128
/src/content/release-notes/workers.yaml @cloudflare/workers-docs @GregBrimble @WalshyDev @aninibread @cloudflare/deploy-config @cloudflare/pcx-technical-writing @irvinebroque @mikenomitch
128129
/src/content/docs/zaraz/ @bjesus @jonnyparris @simonabadoiu @cloudflare/pcx-technical-writing
129130
/src/content/release-notes/zaraz.yaml @bjesus @jonnyparris @simonabadoiu @cloudflare/pcx-technical-writing

public/__redirects

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -188,6 +188,7 @@
188188
/analytics/graphql-api/tutorials/build-your-own-analytics/ /analytics/graphql-api/tutorials/ 301
189189
/analytics/graphql-api/tutorials/export-graphql-to-csv/ /analytics/graphql-api/tutorials/ 301
190190
/analytics/analytics-integrations/google-cloud/ /analytics/analytics-integrations/ 301
191+
/analytics/dashboards/ /log-explorer/custom-dashboards/ 301
191192

192193
# email-security
193194
/email-security/reporting/search/detection-search/ /email-security/reporting/search/ 301
@@ -933,6 +934,7 @@
933934
/logs/reference/logpush-api-configuration/filters/ /logs/reference/filters/ 301
934935
# Non-slashed version is being used in the Cloudflare dashboard
935936
/logs/reference/logpush-api-configuration/examples/example-logpush-curl/ /logs/tutorials/examples/example-logpush-curl/ 301
937+
/logs/log-explorer/ /log-explorer/log-search/ 301
936938

937939
# magic-firewall
938940
/magic-firewall/reference/examples/ /magic-firewall/how-to/add-rules/ 301
@@ -1533,6 +1535,11 @@
15331535
/workers/about/tips/debugging/ /workers/observability/ 301
15341536
/workers/testing/debugging-tools/ /workers/observability/dev-tools/ 301
15351537
/workers/testing/local-development/ /workers/local-development/ 301
1538+
/workers/local-development/ /workers/development-testing/#local-development 301
1539+
/workers/local-development/bindings-per-env/ /workers/development-testing/bindings-per-env/ 301
1540+
/workers/local-development/environment-variables/ /workers/development-testing/environment-variables/ 301
1541+
/workers/local-development/local-data/ /workers/development-testing/local-data/ 301
1542+
/workers/local-development/remote-data/ /workers/development-testing/#remote-bindings 301
15361543
/workers/about/using-cache/ /workers/reference/how-the-cache-works/ 301
15371544
/workers/learning/how-the-cache-works/ /workers/reference/how-the-cache-works/ 301
15381545
/workers/api/ /api/resources/workers/subresources/scripts/methods/list/ 301
50.5 KB
Loading

src/content/docs/analytics/account-and-zone-analytics/zone-analytics.mdx

Lines changed: 33 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -43,11 +43,11 @@ This section outlines the metrics available under each Analytics app tab. Before
4343

4444
Below is a summary of each Analytics app tab.
4545

46-
### Traffic
46+
### HTTP Traffic
4747

4848
#### Free plan
4949

50-
These metrics include legitimate user requests as well as crawlers and threats. The Traffic tab features the following panels: 
50+
These metrics include legitimate user requests as well as crawlers and threats. The HTTP Traffic tab features the following panels: 
5151

5252
* **Web Traffic** - Displays metrics for *Requests*, *Bandwidth*, and *Unique Visitors*. If you are using Cloudflare Workers, subrequests data will not be visible in zone Traffic Analytics. Instead, you can find subrequests analytics under the **Workers & Pages** tab in the **Overview** section. Refer to [Worker Analytics](/analytics/account-and-zone-analytics/analytics-with-workers/#worker-analytics) for more information.
5353
* **Web Traffic Requests by Country** - Is an interactive map that breaks down the number of requests by country.  This panel also includes a data table for **Top Traffic Countries / Regions** that display the countries with the most number of requests (up to five, if the data exists).
@@ -56,19 +56,46 @@ These metrics include legitimate user requests as well as crawlers and threats.
5656

5757
:::note
5858

59-
Privacy-first Web Traffic Analytics are available on the Pro, Business,
59+
Privacy-first HTTP Traffic Analytics are available on the Pro, Business,
6060
and Enterprise plans.
6161
:::
6262

63-
Analytics are based on Cloudflare's edge logs, with no need for third party scripts or trackers. The Traffic tab features the following metrics:
63+
Analytics are based on Cloudflare's edge logs, with no need for third party scripts or trackers. The HTTP Traffic tab features the following metrics:
6464

65-
* **Requests** - An HTTP request. A typical page view requires many requests. If you are using Cloudflare Workers, subrequests data will not be visible in zone Traffic Analytics. Instead, you can find subrequests analytics under the **Workers & Pages** tab in the **Overview** section. Refer to [Worker Analytics](/analytics/account-and-zone-analytics/analytics-with-workers/#worker-analytics) for more information.
65+
* **Requests** - An HTTP request. A typical page view requires many requests. If you are using Cloudflare Workers, subrequests data will not be visible in zone HTTP Traffic Analytics. Instead, you can find subrequests analytics under the **Workers & Pages** tab in the **Overview** section. Refer to [Worker Analytics](/analytics/account-and-zone-analytics/analytics-with-workers/#worker-analytics) for more information.
6666
* **Data Transfer** - Total HTTP data transferred in responses.
6767
* <a id="page-views" /> **Page views** - A page view is defined as a successful HTTP response with a content-type of HTML.
6868
* **Visits** - A visit is defined as a [page view](#page-views) that originated from a different website, or direct link. Cloudflare checks where the HTTP referer does not match the hostname. One visit can consist of multiple page views.
6969
* **API Requests** - An HTTP request for API data.
7070

71-
To receive more detailed metrics, **Add filter**. You can also filter each metric by **Referer**, **Host**, **Country**, **Path**, **Status code**, **Origin status code**, **Browser**, **Operating system**, or **Device type**
71+
To receive more detailed metrics, **Add filter**. You can also filter each metric by:
72+
73+
* Cache status
74+
* Data center
75+
* Source ASN
76+
* Country
77+
* Source device type
78+
* Source IP
79+
* Referer host
80+
* Host
81+
* HTTP method
82+
* HTTP version
83+
* Path
84+
* Query string
85+
* Content type
86+
* Edge status code
87+
* Origin status code
88+
* Security Action
89+
* Security Source
90+
* Source browser
91+
* Source operating system
92+
* Source user agent
93+
* X-Requested-With header
94+
95+
In addition, the following filters are available to Enterprise [Bot Management](/bots/get-started/bot-management/) customers only.
96+
97+
* Source JA4 fingerprint
98+
* Source JA3 fingerprint
7299

73100
To change the time period, use the dropdown menu on the right-hand side above the graph. You can also drag to zoom on the graph.
74101

src/content/docs/cloudflare-for-platforms/workers-for-platforms/get-started/developing-with-wrangler.mdx

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -199,3 +199,25 @@ curl http://localhost:8600
199199
```sh output
200200
# -> user worker got "intercepted a request for customer-1 by the outbound" from fetch
201201
```
202+
203+
## Remote dispatch namespaces
204+
205+
You can configure dispatch namespace bindings to connect to remote dispatch namespaces during local development by setting [`experimental_remote = true`](/workers/development-testing/#remote-bindings):
206+
207+
<WranglerConfig>
208+
```jsonc title="wrangler.jsonc"
209+
{
210+
"dispatch_namespaces": [
211+
{
212+
"binding": "DISPATCH_NAMESPACE",
213+
"namespace": "testing",
214+
"experimental_remote": true
215+
}
216+
]
217+
}
218+
```
219+
</WranglerConfig>
220+
221+
This allows you to run your [dynamic dispatch Worker](/cloudflare-for-platforms/workers-for-platforms/reference/how-workers-for-platforms-works/#dynamic-dispatch-worker) locally, while connecting it to your remote dispatch namespace binding. You can then test changes to your core dispatching logic against real, deployed [user Workers](/cloudflare-for-platforms/workers-for-platforms/reference/how-workers-for-platforms-works/#user-workers).
222+
223+
For more information about remote bindings during local development, refer to [remote bindings documentation](/workers/development-testing/#remote-bindings).

src/content/docs/d1/observability/debug-d1.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -94,4 +94,4 @@ You should include as much of the following in any bug report:
9494

9595
* Learn [how to debug Workers](/workers/observability/).
9696
* Understand how to [access logs](/workers/observability/logs/) generated from your Worker and D1.
97-
* Use [`wrangler dev`](/workers/wrangler/commands/#dev) to run your Worker and D1 locally and [debug issues before deploying](/workers/local-development/).
97+
* Use [`wrangler dev`](/workers/wrangler/commands/#dev) to run your Worker and D1 locally and [debug issues before deploying](/workers/development-testing/).

src/content/docs/durable-objects/reference/environments.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@ Local development sessions create a standalone, local-only environment that mirr
7373

7474
An existing Durable Object binding of `DB` would be available to your Worker when running locally.
7575

76-
Refer to Workers [Local development](/workers/local-development/#supported-resource-bindings-in-different-environments).
76+
Refer to Workers [Local development](/workers/development-testing/bindings-per-env/).
7777

7878
## Remote development
7979

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
---
2+
pcx_content_type: reference
3+
title: Log Explorer API
4+
sidebar:
5+
order: 5
6+
---
7+
8+
Configuration and Log searches are also available via a public API.
9+
10+
## Authentication
11+
12+
Log Explorer is available to users with the following permissions:
13+
14+
- **Logs Edit**: users with Logs Edit permissions can enable datasets.
15+
- **Logs Read**: users with Logs Read permissions can run queries via the UI or API.
16+
17+
Note that these permissions exist at the account and zone level and you need the appropriate permission level for the datasets you wish to query.
18+
19+
Authentication with the API can be done via an API token or API key with an email. Refer to [Create API token](/fundamentals/api/get-started/create-token/) for further instructions.
20+
21+
## Query data
22+
23+
Log Explorer includes a SQL API for submitting queries.
24+
25+
For example, to find an HTTP request with a specific [Ray ID](/fundamentals/reference/cloudflare-ray-id/), use the following SQL query:
26+
27+
```bash
28+
curl https://api.cloudflare.com/client/v4/zones/{zone_id}/logs/explorer/query/sql \
29+
--header "Authorization: Bearer <API_TOKEN>" \
30+
--url-query query="SELECT clientRequestScheme, clientRequestHost, clientRequestMethod, edgeResponseStatus, clientRequestUserAgent FROM http_requests WHERE RayID = '806c30a3cec56817' LIMIT 1"
31+
```
32+
33+
This command returns the following HTTP request details:
34+
35+
```json
36+
{
37+
"result": [
38+
{
39+
"clientrequestscheme": "https",
40+
"clientrequesthost": "example.com",
41+
"clientrequestmethod": "GET",
42+
"clientrequestuseragent": "curl/7.88.1",
43+
"edgeresponsestatus": 200
44+
}
45+
],
46+
"success": true,
47+
"errors": [],
48+
"messages": []
49+
}
50+
```
51+
52+
As another example, you could find Cloudflare Access requests with selected columns from a specific timeframe by performing the following SQL query:
53+
54+
```bash
55+
curl https://api.cloudflare.com/client/v4/account/{account_id}/logs/explorer/query/sql \
56+
--header "Authorization: Bearer <API_TOKEN>" \
57+
--url-query query="SELECT CreatedAt, AppDomain, AppUUID, Action, Allowed, Country, RayID, Email, IPAddress, UserUID FROM access_requests WHERE Date >= '2025-02-06' AND Date <= '2025-02-06' AND CreatedAt >= '2025-02-06T12:28:39Z' AND CreatedAt <= '2025-02-06T12:58:39Z'"
58+
```
59+
60+
This command returns the following request details:
61+
62+
```json
63+
{
64+
"result": [
65+
{
66+
"createdat": "2025-01-14T18:17:55Z",
67+
"appdomain": "example.com",
68+
"appuuid": "a66b4ab0-ccdf-4d60-a6d0-54a59a827d92",
69+
"action": "login",
70+
"allowed": true,
71+
"country": "us",
72+
"rayid": "90fbb07c0b316957",
73+
"email": "[email protected]",
74+
"ipaddress": "1.2.3.4",
75+
"useruid": "52859e81-711e-4de0-8b31-283336060e79"
76+
}
77+
],
78+
"success": true,
79+
"errors": [],
80+
"messages": []
81+
}
82+
```

0 commit comments

Comments
 (0)