Skip to content
Logs
Visit Logs on GitHub
Set theme to dark (⇧+D)

Log fields

The tables below describe the fields available by log category. The list of fields is also accessible directly from the API: https://api.cloudflare.com/client/v4/zones/<zone_id>/logpush/datasets/<dataset>/fields, where the dataset argument indicates the log category (such as http_requests, spectrum_events, or firewall_events).

Unless otherwise noted, fields are available in both Logpush v1 (Logpush prior to mid-2020) and Logpush v2 (all Logpush jobs after mid-2020).

HTTP requests

FieldValueType
BotScoreCloudflare Bot Score (available for Bot Management customers; please contact your account team to enable)int
BotScoreSrcUnderlying detection engine or source on where a Bot Score is calculated.
Possible values are Not Computed | Heuristics | Machine Learning | Behavioral Analysis | Verified Bot | Cloudflare Service
string
CacheCacheStatusunknown | miss | expired | updating | stale | hit | ignored | bypass | revalidatedstring
CacheResponseBytesNumber of bytes returned by the cacheint
CacheResponseStatus (deprecated)HTTP status code returned by the cache to the edge. All requests (including non-cacheable ones) go through the cache. Also see CacheCacheStatus field.int
CacheTieredFillTiered Cache was used to serve this requestbool
ClientASNClient AS numberint
ClientCountryCountry of the client IP addressstring
ClientDeviceTypeClient device typestring
ClientIPIP address of the clientstring
ClientIPClassunknown | clean | badHost | searchEngine | allowlist | greylist | monitoringService | securityScanner | noRecord | scan | backupService | mobilePlatform | torstring
ClientMTLSAuthCertFingerprintThe SHA256 fingerprint of the certificate presented by the client during mTLS authentication. Only populated on the first request on an mTLS connection. Available in Logpush v2 only.string
ClientMTLSAuthStatusThe status of mTLS authentication. Only populated on the first request on an mTLS connection. Available in Logpush v2 only.
Possible values are unknown | ok | absent | untrusted | notyetvalid | expired
string
ClientRequestBytesNumber of bytes in the client requestint
ClientRequestHostHost requested by the clientstring
ClientRequestMethodHTTP method of client requeststring
ClientRequestPathURI path requested by the clientstring
ClientRequestProtocolHTTP protocol of client requeststring
ClientRequestRefererHTTP request referrerstring
ClientRequestSchemeThe URL scheme requested by the visitor. Available in Logpush v2 only.string
ClientRequestSourceIdentifies requests as coming from an external source or another service within Cloudflare. Available in Logpush v2 only.string
ClientRequestURIURI requested by the clientstring
ClientRequestUserAgentUser agent reported by the clientstring
ClientSSLCipherClient SSL cipherstring
ClientSSLProtocolClient SSL (TLS) protocolstring
ClientSrcPortClient source portint
ClientTCPRTTMsThe smoothed average of TCP round-trip time (SRTT). For the initial request on a connection, this is measured only during connection setup. For a subsequent request on the same connection, it is measured over the entire connection lifetime up until the time that request is received. Available in Logpush v2 only.int
ClientXRequestedWithX-Requested-With HTTP headerstring
EdgeCFConnectingO2OTrue if the request looped through multiple zones on the Cloudflare edge. This is considered an orange to orange (o2o) request. Available in Logpush v2 only.bool
EdgeColoCodeIATA airport code of data center that received the requeststring
EdgeColoIDCloudflare edge colo idint
EdgeEndTimestampTimestamp at which the edge finished sending response to the clientint or string
EdgePathingOpIndicates what type of response was issued for this request (unknown = no specific action)string
EdgePathingSrcDetails how the request was classified based on security checks (unknown = no specific classification)string
EdgePathingStatusIndicates what data was used to determine the handling of this request (unknown = no data)string
EdgeRateLimitActionThe action taken by the blocking rule; empty if no action takenstring
EdgeRateLimitIDThe internal rule ID of the rate-limiting rule that triggered a block (ban) or log action. 0 if no action taken.int
EdgeRequestHostHost header on the request from the edge to the originstring
EdgeResponseBodyBytesSize of the HTTP response body returned to clients. Available in Logpush v2 only.int
EdgeResponseBytesNumber of bytes returned by the edge to the clientint
EdgeResponseCompressionRatioEdge response compression ratiofloat
EdgeResponseContentTypeEdge response Content-Type header valuestring
EdgeResponseStatusHTTP status code returned by Cloudflare to the clientint
EdgeServerIPIP of the edge server making a request to the originstring
EdgeStartTimestampTimestamp at which the edge received request from the clientint or string
EdgeTimeToFirstByteMsTotal view of Time To First Byte as measured at Cloudflare's edge. Starts after a TCP connection is established and ends when Cloudflare begins returning the first byte of a response to eyeballs. Includes TLS handshake time (for new connections) and origin response time. Available in Logpush v2 only.int
FirewallMatchesActionsArray of actions the Cloudflare firewall products performed on this request. The individual firewall products associated with this action be found in FirewallMatchesSources and their respective RuleIds can be found in FirewallMatchesRuleIDs. The length of the array is the same as FirewallMatchesRuleIDs and FirewallMatchesSources.
Possible actions are unknown | allow | block | challenge | jschallenge | log | connectionClose | challengeSolved | challengeFailed | challengeBypassed | jschallengeSolved | jschallengeFailed | jschallengeBypassed | bypass | managedChallenge | managedChallengeSkipped | managedChallengeNonInteractiveSolved | managedChallengeInteractiveSolved | managedChallengeBypassed
array[string]
FirewallMatchesRuleIDsArray of RuleIDs of the firewall product that has matched the request. The firewall product associated with the RuleID can be found in FirewallMatchesSources. The length of the array is the same as FirewallMatchesActions and FirewallMatchesSources.array[string]
FirewallMatchesSourcesThe firewall products that matched the request. The same product can appear multiple times, which indicates different rules or actions that were activated. The RuleIDs can be found in FirewallMatchesRuleIDs, the actions can be found in FirewallMatchesActions. The length of the array is the same as FirewallMatchesRuleIDs and FirewallMatchesActions.
Possible sources are unknown | asn | country | ip | ipRange | securityLevel | zoneLockdown | waf | firewallRules | uaBlock | rateLimit | bic | hot | l7ddos | validation | botFight | apiShield | botManagement | dlp | firewallManaged | firewallCustom
array[string]
OriginDNSResponseTimeMsTime taken to receive a DNS response for an origin name. Usually 0, but may be longer if a CNAME record is used. Available in Logpush v2 only.int
OriginIPIP of the origin serverstring
OriginRequestHeaderSendDurationMsTime taken to send request headers to origin after establishing a connection. Note that this value is usually 0. Available in Logpush v2 only.int
OriginResponseBytes (deprecated)Number of bytes returned by the origin serverint
OriginResponseDurationMsUpstream response time, measured from the first datacenter that receives a request. Includes time taken by Argo Smart Routing and Tiered Cache, plus time to connect and receive a response from origin servers. This field replaces OriginResponseTime. Available in Logpush v2 only.int
OriginResponseHTTPExpiresValue of the origin 'expires' header in RFC1123 formatstring
OriginResponseHTTPLastModifiedValue of the origin 'last-modified' header in RFC1123 formatstring
OriginResponseHeaderReceiveDurationMsTime taken for origin to return response headers after Cloudflare finishes sending request headers. Available in Logpush v2 only.int
OriginResponseStatusStatus returned by the origin serverint
OriginResponseTime (deprecated)Number of nanoseconds it took the origin to return the response to edgeint
OriginSSLProtocolSSL (TLS) protocol used to connect to the originstring
OriginTCPHandshakeDurationMsTime taken to complete TCP handshake with origin. This will be 0 if an origin connection is reused. Available in Logpush v2 only.int
OriginTLSHandshakeDurationMsTime taken to complete TLS handshake with origin. This will be 0 if an origin connection is reused. Available in Logpush v2 only.int
ParentRayIDRay ID of the parent request if this request was made using a Worker scriptstring
RayIDID of the requeststring
SecurityLevelThe security level configured at the time of this request. This is used to determine the sensitivity of the IP Reputation system.string
SmartRouteColoIDThe Cloudflare datacenter used to connect to the origin server if Argo Smart Routing is used. Available in Logpush v2 only.int
UpperTierColoIDThe "upper tier" datacenter that was checked for a cached copy if Tiered Cache is used. Available in Logpush v2 only.int
WAFActionAction taken by the WAF, if triggeredstring
WAFFlags (deprecated)Additional configuration flags: simulate (0x1) | nullstring
WAFMatchedVar (deprecated)The full name of the most-recently matched variablestring
WAFProfilelow | med | highstring
WAFRuleIDID of the applied WAF rulestring
WAFRuleMessageRule message associated with the triggered rulestring
WorkerCPUTimeAmount of time in microseconds spent executing a worker, if anyint
WorkerStatusStatus returned from worker daemonstring
WorkerSubrequestWhether or not this request was a worker subrequestbool
WorkerSubrequestCountNumber of subrequests issued by a worker when handling this requestint
ZoneIDInternal zone IDint
ZoneNameThe human-readable name of the zone (e.g. 'cloudflare.com'). Available in Logpush v2 only.string

Spectrum events

FieldValueType
ApplicationThe unique public ID of the application on which the event occurredstring
ClientAsnClient AS numberint
ClientBytesThe number of bytes read from the client by the Spectrum serviceint
ClientCountryCountry of the client IP addressstring
ClientIPClient IP addressstring
ClientMatchedIpFirewallWhether the connection matched any IP Firewall rules. UNKNOWN = No match or Firewall not enabled for spectrum; UNKNOWN | ALLOW | BLOCK_ERROR | BLOCK_IP | BLOCK_COUNTRY | BLOCK_ASN | WHITELIST_IP | WHITELIST_COUNTRY | WHITELIST_ASNstring
ClientPortClient portint
ClientProtoTransport protocol used by client; tcp | udp | unixstring
ClientTcpRttThe TCP round-trip time in nanoseconds between the client and Spectrumint
ClientTlsCipherThe cipher negotiated between the client and Spectrum. In v1, an unknown cipher returned as "Unknown." In v2, it's returned as "UNK."string
ClientTlsClientHelloServerNameThe server name in the Client Hello message from client to Spectrumstring
ClientTlsProtocolThe TLS version negotiated between the client and Spectrum; unknown | none | SSLv3 | TLSv1 | TLSv1.1 | TLSv1.2 | TLSv1.3string
ClientTlsStatusIndicates state of TLS session from the client to Spectrum; UNKNOWN | OK | INTERNAL_ERROR | INVALID_CONFIG | INVALID_SNI | HANDSHAKE_FAILED | KEYLESS_RPCstring
ColoCodeIATA airport code of data center that received the requeststring
ConnectTimestampTimestamp at which both legs of the connection (client/edge, edge/origin or nexthop) were establishedint or string
DisconnectTimestampTimestamp at which the connection was closedint or string
Eventconnect | disconnect | clientFiltered | tlsError | resolveOrigin | originErrorstring
IpFirewallWhether IP Firewall was enabled at time of connectionbool
OriginBytesThe number of bytes read from the origin by Spectrumint
OriginIPOrigin IP addressstring
OriginPortOrigin portint
OriginProtoTransport protocol used by origin; tcp | udp | unixstring
OriginTcpRttThe TCP round-trip time in nanoseconds between Spectrum and the originint
OriginTlsCipherThe cipher negotiated between Spectrum and the origin. In v1, an unknown cipher returned as "Unknown." In v2, it's returned as "UNK."string
OriginTlsFingerprintSHA256 hash of origin certificate. In v1, an unknown SHA256 hash is returned as "0000000000000000000000000000000000000000000000000000000000000000." In v2, it's returned as an empty string.string
OriginTlsModeIf and how the upstream connection is encrypted; unknown | off | flexible | full | strictstring
OriginTlsProtocolThe TLS version negotiated between Spectrum and the origin; unknown | none | SSLv3 | TLSv1 | TLSv1.1 | TLSv1.2 | TLSv1.3string
OriginTlsStatusThe state of the TLS session from Spectrum to the origin; UNKNOWN | OK | INTERNAL_ERROR | INVALID_CONFIG | INVALID_SNI | HANDSHAKE_FAILED | KEYLESS_RPCstring
ProxyProtocolWhich form of proxy protocol is applied to the given connection; off | v1 | v2 | simplestring
StatusA code indicating reason for connection closureint
TimestampTimestamp at which the event took placeint or string

Firewall events

FieldValueType
ActionThe code of the first-class action the Cloudflare Firewall took on this request.
Possible actions are unknown | allow | block | challenge | jschallenge | log | connectionclose | challengesolved | challengefailed | challengebypassed | jschallengesolved | jschallengefailed | jschallengebypassed | bypass | managedchallenge | managedchallengeskipped | managedchallengenoninteractivesolved | managedchallengeinteractivesolved | managedchallengebypassed
string
ClientASNThe ASN number of the visitorint
ClientASNDescriptionThe ASN of the visitor as stringstring
ClientCountryCountry from which request originatedstring
ClientIPThe visitor's IP address (IPv4 or IPv6)string
ClientIPClassThe classification of the visitor's IP address, possible values are: unknown | clean | badHost | searchEngine | allowlist | greylist | monitoringService | securityScanner | noRecord | scan | backupService | mobilePlatform | torstring
ClientRefererHostThe referer hoststring
ClientRefererPathThe referer path requested by visitorstring
ClientRefererQueryThe referer query-string was requested by the visitorstring
ClientRefererSchemeThe referer URL scheme requested by the visitorstring
ClientRequestHostThe HTTP hostname requested by the visitorstring
ClientRequestMethodThe HTTP method used by the visitorstring
ClientRequestPathThe path requested by visitorstring
ClientRequestProtocolThe version of HTTP protocol requested by the visitorstring
ClientRequestQueryThe query-string was requested by the visitorstring
ClientRequestSchemeThe URL scheme requested by the visitorstring
ClientRequestUserAgentVisitor's user-agent stringstring
DatetimeThe date and time the event occurred at the edgeint or string
EdgeColoCodeThe airport code of the Cloudflare datacenter that served this requeststring
EdgeResponseStatusHTTP response status code returned to browserint
KindThe kind of event, currently only possible values are: firewallstring
MatchIndexRules match index in the chainint
MetadataAdditional product-specific information. Metadata is organized in key:value pairs. Key and Value formats can vary by Cloudflare security product and can change over timeobject
OriginResponseStatusHTTP origin response status code returned to browserint
OriginatorRayIDThe RayID of the request that issued the challenge/jschallengestring
RayIDThe RayID of the requeststring
RuleIDThe Cloudflare security product-specific RuleID triggered by this requeststring
SourceThe Cloudflare security product triggered by this request.
Possible sources are unknown | asn | country | ip | iprange | securitylevel | zonelockdown | waf | firewallrules | uablock | ratelimit | bic | hot | l7ddos | validation | botfight | apishield | botmanagement | dlp | firewallmanaged | firewallcustom
string