Load Balancing logs

Overview

Load Balancing logs provide a historical view of status changes to your origins and how those status changes affect pool health.

Load Balancing only logs events that represent a status change for an origin, from healthy to unhealthy or vice versa.


Properties

Health check event objects have the following properties:

Name / type Description / example Constraints
id

integer

Integer identifier that uniquely represents the health check event.

2

Default value: 1
origins

array

An array of objects representing the origin servers associated with the pool.

[

{

"name": "some-origin",

"address": "198.51.100.4",

"ip": "198.51.100.4",

"enabled": true,

"healthy": true,

"failure_reason": "No failures",

"changed": true

}

]

pool

object

An object that represents the pool for which the health check event was generated.

{

"id": "74bc6a8b9b0dda3d651707a2928bad0c",

"name": "some-pool",

"healthy": true,

"changed": true,

"minimum_origins": 1

}

timestamp

string (date-time)

The time at which the event was recorded

"2014-01-01T05:20:00.12345Z"


Accessing Load Balancing Logs from the Cloudflare dashboard

Load Balancing Logs are available from the Traffic app of the Cloudflare dashboard within the Load Balancing Analytics tab under the Logs submenu. You can filter the logs by Date, Pool Health, Pool, Origin Health, and/or Origin.

Click the expansion arrow at the far right of the event to expose more detail, including a list of healthy origins for the pool that was the subject of the event, the health threshold for that pool, Pool ID, and the origin address. Failure events include a reason for the failure and a list of failed origins.


Accessing Load Balancing Logs via the Cloudflare API

Commands

To list health check events, use the List Health Check Events API endpoint:

GET user/load_balancing_analytics/events

For a list of optional parameters, which are useful for filtering log results, see Cloudflare API v4 Documentation: Health Check Events.