Preface

This guide provides an overview of the SkyFormation cloud connector's "Health Status". The different status types, what they mean, how they are determined/calculated.

To see your cloud connector "Health Status" refer to:
How-to: Check your Cloud Connector 'Health Status'

To see your cloud connector endpoint/s "Health Status" refer to:
How-to: Check the Cloud Connector Endpoint's 'Health Status'

To resolve an error in one of your cloud connectors refer to:
How-to: Resolve Error/s in a Cloud Connector

Type of "Health Status" indicators

A cloud connector could have the following 'Health Status' indicators:

- OK 

- WARNING 

- ERROR 

How the Cloud Connector "Health Status" is determined

The cloud connector's "Health Status" is determined according to it's "Worst Child" health status.
A child is a cloud connector's "endpoint" (aka audit source or APIs).
Each cloud connector communicate with one or more endpoint/s to retrieve the audit events.

"Worst Child" model means that the cloud connector "Health Status" will be according to the worst health status of its endpoints (e.g. if one endpoint report ERROR the cloud connector health is ERROR).

So the cloud connector "Health Status" will be calculated as followed:

- OK (entire end-points are OK)

- WARNING (At least one end-point is in warning state and none in error)

- ERROR (At least one end-pointy is in error state)

How the Cloud Connector's endpoint "Health-Status" is determined

Each endpoint has its unique logic of how to retrieve events from the cloud service audit source (e.g. API throttling, frequency, events model, recovery logic etc).

Each data sync task executed by the endpoint to retrieve a chunk of events will report if it succeeded or failed to retrieve the defined events. In case the endpoint failed to bring the entire events defined in the sync task the endpoint will report a sync task error. 

The endpoint "Health Status" will be calculated as followed:

- OK (last consecutive 3 sync tasks areOK)

- WARNING (One of the last 3 sync tasks reported an error)

- ERROR (More then one of the last 3 sync tasks reported an error)

DONE