Connection Health
The Connection Health feature provides a high-level view of connection stability by evaluating the status of the most recent job run. It helps identify unhealthy connections, categorize failure types, and improve error visibility.
We classify connection job failures into three categories based on responsibility for resolution:
- Leen: Issues originating from Leen’s infrastructure or code. We prioritize these failures and work to resolve them as quickly as possible.
- Customer: Failures due to invalid or expired credentials. Customer must update credentials to resolve the failure.
- Vendor: Failures caused by the Vendor’s API, such as network issues or 5xx errors. These failures are often temporary and may resolve automatically in subsequent runs.
How to find Connection Health
You can use List Connections or Get Connection by ID. Here is an example response with connection health value:
Connection Health Statuses
Name | Status | Resolution Owner | Description |
---|---|---|---|
HEALTHY | HEALTHY | LEEN | Connection is healthy |
EXECUTION_TIMEOUT | UNHEALTHY | LEEN | Execution timeout |
RATE_LIMIT_EXCEEDED | UNHEALTHY | LEEN | Rate limit exceeded |
VENDOR_CLIENT_ERROR | UNHEALTHY | LEEN | Vendor returned a 4xx client error |
INTERNAL_ERROR | UNHEALTHY | LEEN | Internal error |
VENDOR_SERVER_ERROR | UNHEALTHY | VENDOR | Vendor returned a 5xx server error |
UNAUTHORIZED | UNHEALTHY | CUSTOMER | Connection is unauthorized |
Resolving Unauthorized Connections
Unauthorized connections occur when Leen cannot pull data from a vendor due to invalid, insufficient, or revoked permissions or credentials.
Here are two important scenarios for connections that can show up as UNAUTHORIZED
in your dashboard.
-
Partial Data Access: Some connections involve multiple types of data exports. An “unauthorized” status may occur if one or more data types lack the necessary permissions.
-
Post-Creation Authorization Changes: Even after a successful initial connection, a connection can become unauthorized. This may happen if the user revokes access to the service account/ API Token or if the credentials expire.
Follow the steps below to identify and resolve Unauthorized connections in your environments.
Step 1: Identify Unauthorized Connections
Retrieve all connections with an unauthorized status using the following API request:
Example Response
Step 2: Update Connection Credentials
To fix an unauthorized connection, update its credentials using the connection ID from the previous response.
If the request is successful, it means the credentials are valid, and the connection will become healthy in the subsequent connection job.