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 |
|---|---|---|
| idinteger | Integer identifier that uniquely represents the health check event.2 | Default value: 1 |
| originsarray | 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}] | |
| poolobject | 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} | |
| timestampstring (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/eventsFor a list of optional parameters, which are useful for filtering log results, see Cloudflare API v4 Documentation: Health Check Events.