Skip to content

Commit 58d034a

Browse files
kodster28Oxyjun
andauthored
[Brower Isolation] Changelog entry for logging (#20488)
* [Brower Rendering] Changelog entry for logging * PR feedback * Update date * Add log fields updates * Update src/content/changelog/browser-isolation/2025-03-03-user-action-logging.mdx Co-authored-by: Jun Lee <[email protected]> --------- Co-authored-by: Jun Lee <[email protected]>
1 parent ed9ff0c commit 58d034a

File tree

12 files changed

+102
-28
lines changed

12 files changed

+102
-28
lines changed
Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
---
2+
title: Gain visibility into user actions in Zero Trust Browser Isolation sessions
3+
description: User action logs for Remote Browser Isolation
4+
date: 2025-03-04T11:00:00Z
5+
---
6+
7+
We're excited to announce that new logging capabilities for [Remote Browser Isolation (RBI)](/cloudflare-one/policies/browser-isolation/) through [Logpush](/logs/reference/log-fields/account/) are available in Beta starting today!
8+
9+
With these enhanced logs, administrators can gain visibility into end user behavior in the remote browser and track blocked data extraction attempts, along with the websites that triggered them, in an isolated session.
10+
11+
```json
12+
{
13+
"AccountID": "$ACCOUNT_ID",
14+
"Decision": "block",
15+
"DomainName": "www.example.com",
16+
"Timestamp": "2025-02-27T23:15:06Z",
17+
"Type": "copy",
18+
"UserID": "$USER_ID"
19+
}
20+
```
21+
22+
User Actions available:
23+
24+
- **Copy & Paste**
25+
- **Downloads & Uploads**
26+
- **Printing**
27+
28+
Learn more about how to get started with Logpush in our [documentation](/logs/get-started/).
Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
# Code generator. DO NOT EDIT.
3+
4+
title: Browser Isolation User Actions
5+
pcx_content_type: configuration
6+
sidebar:
7+
order: 21
8+
---
9+
10+
The descriptions below detail the fields available for `biso_user_actions`.
11+
12+
## AccountID
13+
14+
Type: `string`
15+
16+
The Cloudflare account ID.
17+
18+
## Decision
19+
20+
Type: `string`
21+
22+
The decision applied ('allow' or 'block').
23+
24+
## DomainName
25+
26+
Type: `string`
27+
28+
The domain name in the URL.
29+
30+
## Timestamp
31+
32+
Type: `int or string`
33+
34+
The date and time.
35+
36+
## Type
37+
38+
Type: `string`
39+
40+
The user action type ('copy', 'paste', 'download', etc.).
41+
42+
## UserID
43+
44+
Type: `string`
45+
46+
The user ID.

src/content/docs/logs/reference/log-fields/account/dns_firewall_logs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ The ID of the cluster which handled this request.
2525

2626
Type: `string`
2727

28-
IATA airport code of data center that received the request.
28+
IATA airport code of the data center that received the request.
2929

3030
## EDNSSubnet
3131

src/content/docs/logs/reference/log-fields/account/gateway_dns.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -61,13 +61,13 @@ Resolved intermediate cname domains in reverse (for example, ['com.example.alias
6161

6262
Type: `string`
6363

64-
The name of the colo that received the DNS query (for example, 'SJC', 'MIA', 'IAD').
64+
The name of the data center that received the DNS query (for example, 'SJC', 'MIA', 'IAD').
6565

6666
## ColoID
6767

6868
Type: `int`
6969

70-
The ID of the colo that received the DNS query (for example, 46, 72, 397).
70+
The ID of the data center that received the DNS query (for example, 46, 72, 397).
7171

7272
## CustomResolveDurationMs
7373

src/content/docs/logs/reference/log-fields/account/network_analytics_logs.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -31,31 +31,31 @@ Descriptive name of the type of attack that this packet was a part of, if any. O
3131

3232
Type: `string`
3333

34-
The city where the Cloudflare datacenter that received the packet is located.
34+
The city where the Cloudflare data center that received the packet is located.
3535

3636
## ColoCode
3737

3838
Type: `string`
3939

40-
The Cloudflare datacenter that received the packet (nearest IATA airport code).
40+
The Cloudflare data center that received the packet (nearest IATA airport code).
4141

4242
## ColoCountry
4343

4444
Type: `string`
4545

46-
The country where the Cloudflare datacenter that received the packet is located (ISO 3166-1 alpha-2).
46+
The country where the Cloudflare data center that received the packet is located (ISO 3166-1 alpha-2).
4747

4848
## ColoGeoHash
4949

5050
Type: `string`
5151

52-
The latitude and longitude where the colo that received the packet is located (Geohash encoding).
52+
The latitude and longitude where the Cloudflare data center that received the packet is located (Geohash encoding).
5353

5454
## ColoName
5555

5656
Type: `string`
5757

58-
The unique site identifier of the Cloudflare datacenter that received the packet (for example, 'ams01', 'sjc01', 'lhr01').
58+
The unique site identifier of the Cloudflare data center that received the packet (for example, 'ams01', 'sjc01', 'lhr01').
5959

6060
## Datetime
6161

src/content/docs/logs/reference/log-fields/account/workers_trace_events.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ List of console messages emitted during the invocation.
5555

5656
Type: `string`
5757

58-
The outcome of the worker script invocation. <br />Possible values are <em>ok</em> \| <em>exception</em>.
58+
The outcome of the Worker script invocation. <br />Possible values are <em>ok</em> \| <em>exception</em>.
5959

6060
## ScriptName
6161

src/content/docs/logs/reference/log-fields/account/zero_trust_network_sessions.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,7 @@ Name of the client device which initiated the network session, if applicable, (f
9191

9292
Type: `string`
9393

94-
The name of the Cloudflare colo from which traffic egressed to the origin.
94+
The name of the Cloudflare data center from which traffic egressed to the origin.
9595

9696
## EgressIP
9797

@@ -127,7 +127,7 @@ Email address associated with the user identity which initiated the network sess
127127

128128
Type: `string`
129129

130-
The name of the Cloudflare colo to which traffic ingressed.
130+
The name of the Cloudflare data center to which traffic ingressed.
131131

132132
## Offramp
133133

src/content/docs/logs/reference/log-fields/zone/dns_logs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ The descriptions below detail the fields available for `dns_logs`.
1313

1414
Type: `string`
1515

16-
IATA airport code of data center that received the request.
16+
IATA airport code of the data center that received the request.
1717

1818
## EDNSSubnet
1919

src/content/docs/logs/reference/log-fields/zone/firewall_events.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -145,7 +145,7 @@ The description of the rule triggered by this request.
145145

146146
Type: `string`
147147

148-
The airport code of the Cloudflare datacenter that served this request.
148+
The airport code of the Cloudflare data center that served this request.
149149

150150
## EdgeResponseStatus
151151

src/content/docs/logs/reference/log-fields/zone/http_requests.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -253,19 +253,19 @@ String key-value pairs for Cookies. This field is populated based on [Logpush Cu
253253

254254
Type: `bool`
255255

256-
True if the request looped through multiple zones on the Cloudflare edge. This is considered an orange to orange (o2o) request.
256+
True if the request looped through multiple zones on the Cloudflare edge. This is considered an orange to orange (O2O) request.
257257

258258
## EdgeColoCode
259259

260260
Type: `string`
261261

262-
IATA airport code of data center that received the request.
262+
IATA airport code of the data center that received the request.
263263

264264
## EdgeColoID
265265

266266
Type: `int`
267267

268-
Cloudflare edge colo id.
268+
Cloudflare edge data center ID.
269269

270270
## EdgeEndTimestamp
271271

@@ -511,13 +511,13 @@ Array of security products that matched the request. The same product can appear
511511

512512
Type: `int`
513513

514-
The Cloudflare datacenter used to connect to the origin server if Argo Smart Routing is used.
514+
The Cloudflare data center used to connect to the origin server if Argo Smart Routing is used.
515515

516516
## UpperTierColoID
517517

518518
Type: `int`
519519

520-
The "upper tier" datacenter that was checked for a cached copy if Tiered Cache is used.
520+
The "upper tier" data center that was checked for a cached copy if Tiered Cache is used.
521521

522522
## WAFAttackScore
523523

@@ -559,31 +559,31 @@ WAF score for an XSS attack.
559559

560560
Type: `int`
561561

562-
Amount of time in microseconds spent executing a worker, if any.
562+
Amount of time in microseconds spent executing a Worker, if any.
563563

564564
## WorkerScriptName
565565

566566
Type: `string`
567567

568-
The worker script name that made the request.
568+
The Worker script name that made the request.
569569

570570
## WorkerStatus
571571

572572
Type: `string`
573573

574-
Status returned from worker daemon.
574+
Status returned from Worker daemon.
575575

576576
## WorkerSubrequest
577577

578578
Type: `bool`
579579

580-
Whether or not this request was a worker subrequest.
580+
Whether or not this request was a Worker subrequest.
581581

582582
## WorkerSubrequestCount
583583

584584
Type: `int`
585585

586-
Number of subrequests issued by a worker when handling this request.
586+
Number of subrequests issued by a Worker when handling this request.
587587

588588
## WorkerWallTimeUs
589589

@@ -595,4 +595,4 @@ The elapsed time in microseconds between the start of a Worker invocation, and w
595595

596596
Type: `string`
597597

598-
The human-readable name of the zone (e.g. 'cloudflare.com').
598+
The human-readable name of the zone (for example, 'cloudflare.com').

0 commit comments

Comments
 (0)