From aab4d93db182fd6830c7cc90a6a4be8c3b5d590c Mon Sep 17 00:00:00 2001 From: data-entities-bot Date: Tue, 16 Jun 2026 13:55:05 +0000 Subject: [PATCH] [Logs] Update Logpush dataset field definitions (2026-06-16) --- .../logs/2026-06-16-log-fields-updated.mdx | 18 +++ .../datasets/account/email_security_alerts.md | 30 +++++ .../datasets/account/websocket_analytics.md | 112 ++++++++++++++++++ .../datasets/zone/websocket_analytics.md | 112 ++++++++++++++++++ 4 files changed, 272 insertions(+) create mode 100644 src/content/changelog/logs/2026-06-16-log-fields-updated.mdx create mode 100644 src/content/docs/logs/logpush/logpush-job/datasets/account/websocket_analytics.md create mode 100644 src/content/docs/logs/logpush/logpush-job/datasets/zone/websocket_analytics.md diff --git a/src/content/changelog/logs/2026-06-16-log-fields-updated.mdx b/src/content/changelog/logs/2026-06-16-log-fields-updated.mdx new file mode 100644 index 00000000000..bf3b7c93043 --- /dev/null +++ b/src/content/changelog/logs/2026-06-16-log-fields-updated.mdx @@ -0,0 +1,18 @@ +--- +title: New Logpush datasets and updated fields in Email Security Alerts Logpush dataset in Cloudflare Logs +description: New Logpush datasets are now available, and fields have been updated in the Email Security Alerts Logpush dataset in Cloudflare Logs. +date: 2026-06-16 +--- + +Cloudflare has updated [Logpush datasets](/logs/logpush/logpush-job/datasets/): + +### New datasets + +- **WebSocket Analytics**: A new dataset with fields including `BytesReceivedClient`, `BytesReceivedOrigin`, `BytesSentClient`, `BytesSentOrigin`, `ClientASN`, `ClientIP`, `ClientRequestHost`, `ClientRequestPath`, `ClientRequestUserAgent`, `ColoCode`, `ConnectionCloseReason`, `ConnectionCloseSource`, `ConnectionID`, `ConnectionTransportCloseCode`, `EdgeEndTimestamp`, `EdgeStartTimestamp`, and `RayID`. +- **WebSocket Analytics**: A new dataset with fields including `BytesReceivedClient`, `BytesReceivedOrigin`, `BytesSentClient`, `BytesSentOrigin`, `ClientASN`, `ClientIP`, `ClientRequestHost`, `ClientRequestPath`, `ClientRequestUserAgent`, `ColoCode`, `ConnectionCloseReason`, `ConnectionCloseSource`, `ConnectionID`, `ConnectionTransportCloseCode`, `EdgeEndTimestamp`, `EdgeStartTimestamp`, and `RayID`. + +### Updated fields in existing datasets + +- **Email Security Alerts** (added): `BCC`, `DKIMResult`, `DMARCPolicy`, `DMARCResult`, and `SPFResult`. + +For the complete field definitions for each dataset, refer to [Logpush datasets](/logs/logpush/logpush-job/datasets/). diff --git a/src/content/docs/logs/logpush/logpush-job/datasets/account/email_security_alerts.md b/src/content/docs/logs/logpush/logpush-job/datasets/account/email_security_alerts.md index 03cb3c8655b..384dc377add 100644 --- a/src/content/docs/logs/logpush/logpush-job/datasets/account/email_security_alerts.md +++ b/src/content/docs/logs/logpush/logpush-job/datasets/account/email_security_alerts.md @@ -27,6 +27,12 @@ Type: `array[object]` List of objects containing metadata of attachments contained in this message (for example, [{"Md5": "91f073bd208689ddbd248e8989ecae90", "Sha1": "62b77e14e2c43049c45b5725018e78d0f9986930", "Sha256": "3b57505305e7162141fd898ed87d08f92fc42579b5047495859e56b3275a6c06", "Ssdeep": "McAQ8tPlH25e85Q2OiYpD08NvHmjJ97UfPMO47sekO:uN9M553OiiN/OJ9MM+e3", "Name": "attachment.gif", "ContentTypeProvided": "image/gif", "ContentTypeComputed": "application/x-msi", "Encrypted": true, "Decrypted": true}, ...]). +## BCC + +Type: `array[string]` + +Email address portions of the BCC header provided by the sender, if present (for example, 'firstlast@cloudflare.com'). + ## CC Type: `array[string]` @@ -39,6 +45,24 @@ Type: `array[string]` Email address portions of the CC header provided by the sender (for example, 'First Last'). +## DKIMResult + +Type: `string` + +Summary DKIM authentication result for the message.
Possible values are pass \| neutral \| fail \| error \| permerror \| temperror \| none. + +## DMARCPolicy + +Type: `string` + +Effective DMARC policy for the sending domain.
Possible values are none \| quarantine \| reject \| undefined. + +## DMARCResult + +Type: `string` + +Overall DMARC authentication result for the message.
Possible values are pass \| fail \| none. + ## FinalDisposition Type: `string` @@ -141,6 +165,12 @@ Type: `string` Hostname provided by the SMTP HELO server. +## SPFResult + +Type: `string` + +Summary SPF authentication result for the message.
Possible values are pass \| neutral \| fail \| softfail \| permerror \| temperror \| none. + ## Subject Type: `string` diff --git a/src/content/docs/logs/logpush/logpush-job/datasets/account/websocket_analytics.md b/src/content/docs/logs/logpush/logpush-job/datasets/account/websocket_analytics.md new file mode 100644 index 00000000000..686b93fa28f --- /dev/null +++ b/src/content/docs/logs/logpush/logpush-job/datasets/account/websocket_analytics.md @@ -0,0 +1,112 @@ +--- +# Code generator. DO NOT EDIT. + +title: WebSocket Analytics +pcx_content_type: configuration +sidebar: + order: 21 +--- + +The descriptions below detail the fields available for `websocket_analytics`. + +## BytesReceivedClient + +Type: `int` + +Number of bytes received from the client. + +## BytesReceivedOrigin + +Type: `int` + +Number of bytes received from the origin. + +## BytesSentClient + +Type: `int` + +Number of bytes sent to the client. + +## BytesSentOrigin + +Type: `int` + +Number of bytes sent to the origin. + +## ClientASN + +Type: `int` + +The client's autonomous system number (ASN). + +## ClientIP + +Type: `string` + +The client IP address. + +## ClientRequestHost + +Type: `string` + +The host requested by the client in the WebSocket upgrade request. + +## ClientRequestPath + +Type: `string` + +The path requested by the client in the WebSocket upgrade request. + +## ClientRequestUserAgent + +Type: `string` + +The user agent reported by the client. + +## ColoCode + +Type: `string` + +IATA airport code of the data center that handled the connection. + +## ConnectionCloseReason + +Type: `string` + +The reason the WebSocket connection ended. Possible values are none \| unspecifiedError \| timedOut \| peerReset \| upstreamReset \| protocolViolation \| peerNoError. + +## ConnectionCloseSource + +Type: `string` + +Which side initiated the connection close; upstream \| downstream \| me \| both, or the raw internal value if unrecognized. + +## ConnectionID + +Type: `string` + +Unique identifier of the WebSocket connection, hex-encoded. + +## ConnectionTransportCloseCode + +Type: `int` + +The first transport-level close code observed. For TLS connections this is the TLS alert code; for plain TCP connections (no TLS) it is always 0. The most significant bit indicates the source: 0 = proxy-initiated, 1 = eyeball-initiated. + +## EdgeEndTimestamp + +Type: `int or string` + +Timestamp at which the WebSocket connection closed. + +## EdgeStartTimestamp + +Type: `int or string` + +Timestamp at which the WebSocket connection was established. + +## RayID + +Type: `string` + +The Ray ID of the WebSocket upgrade request. diff --git a/src/content/docs/logs/logpush/logpush-job/datasets/zone/websocket_analytics.md b/src/content/docs/logs/logpush/logpush-job/datasets/zone/websocket_analytics.md new file mode 100644 index 00000000000..686b93fa28f --- /dev/null +++ b/src/content/docs/logs/logpush/logpush-job/datasets/zone/websocket_analytics.md @@ -0,0 +1,112 @@ +--- +# Code generator. DO NOT EDIT. + +title: WebSocket Analytics +pcx_content_type: configuration +sidebar: + order: 21 +--- + +The descriptions below detail the fields available for `websocket_analytics`. + +## BytesReceivedClient + +Type: `int` + +Number of bytes received from the client. + +## BytesReceivedOrigin + +Type: `int` + +Number of bytes received from the origin. + +## BytesSentClient + +Type: `int` + +Number of bytes sent to the client. + +## BytesSentOrigin + +Type: `int` + +Number of bytes sent to the origin. + +## ClientASN + +Type: `int` + +The client's autonomous system number (ASN). + +## ClientIP + +Type: `string` + +The client IP address. + +## ClientRequestHost + +Type: `string` + +The host requested by the client in the WebSocket upgrade request. + +## ClientRequestPath + +Type: `string` + +The path requested by the client in the WebSocket upgrade request. + +## ClientRequestUserAgent + +Type: `string` + +The user agent reported by the client. + +## ColoCode + +Type: `string` + +IATA airport code of the data center that handled the connection. + +## ConnectionCloseReason + +Type: `string` + +The reason the WebSocket connection ended. Possible values are none \| unspecifiedError \| timedOut \| peerReset \| upstreamReset \| protocolViolation \| peerNoError. + +## ConnectionCloseSource + +Type: `string` + +Which side initiated the connection close; upstream \| downstream \| me \| both, or the raw internal value if unrecognized. + +## ConnectionID + +Type: `string` + +Unique identifier of the WebSocket connection, hex-encoded. + +## ConnectionTransportCloseCode + +Type: `int` + +The first transport-level close code observed. For TLS connections this is the TLS alert code; for plain TCP connections (no TLS) it is always 0. The most significant bit indicates the source: 0 = proxy-initiated, 1 = eyeball-initiated. + +## EdgeEndTimestamp + +Type: `int or string` + +Timestamp at which the WebSocket connection closed. + +## EdgeStartTimestamp + +Type: `int or string` + +Timestamp at which the WebSocket connection was established. + +## RayID + +Type: `string` + +The Ray ID of the WebSocket upgrade request.