CloudCost Diagnostic APIs

These APIs are designed to help troubleshoot and provide diagnostics for Kubecost's cloud integration features like Cloud Usage and reconciliation. For an explanation of these integration features, review Kubecost's cloud processes.

To review the provider parameter for rebuild/run APIs, see Cloud Stores.

Cloud Usage APIs

Cloud Usage Rebuild API

Using the Cloud Usage Rebuild API

GET http://<kubecost-address>/model/etl/cloudUsage/rebuild

Restarts Cloud Usage pipeline. This operation ends the currently running Cloud Usage pipeline and rebuilds historic CloudUsages in the Daily CloudUsage Store.

Table 1. Path Parameters
Name	Required	Type	Description
commit	true	boolean	Flag that acts as a safety precaution. These can be long-running processes so this endpoint should not be run arbitrarily. `true` will restart the process.
provider	false	string	Optional parameter for the `ProviderKey` of your CSP. If included, only the specified Cloud Store will run the operation. If not included, all Cloud Stores in the ETL will run the operation.

Table 2. Responses
Code	Description	Example
200	OK	`{ "code": 200, "data": "Rebuilding Cloud Usage For All Providers" }`

Cloud Usage Repair API

Using the Cloud Usage Repair API

GET http://<kubecost-address>/model/etl/cloudUsage/repair

Reruns queries for Cloud Usages in the given window for the given Cloud Store or all Cloud Stores if no provider is set.

Table 3. Path Parameters
Name	Required	Type	Description
window	true	string	The applicable window for repair by the Cloud Store. See Using `window` parameter for more details.
provider	false	string	Optional parameter for the `ProviderKey` of your CSP. If included, only the specified Cloud Store will run the operation. If not included, all Cloud Stores in the ETL will run the operation.

Table 4. Responses
Code	Description	Example
200	OK	`{ "code": 200, "data": "Cloud Usage Repair process has begun for [<window>) for all providers" }`

Reconciliation APIs

Reconciliation Run API

Using the Reconciliation Run API

GET http://<kubecost-address>/model/etl/asset/reconciliation/run

Completely restart reconciliation pipeline. This operation ends the currently running reconciliation pipeline and reconciles historic Assets in the Daily Asset Store.

Table 5. Path Parameters
Name	Required	Type	Description
commit	true	boolean	Flag that acts as a safety precaution. These can be long-running processes so this endpoint should not be run arbitrarily. `true` will restart the process.
provider	false	string	Optional parameter for the `ProviderKey` of your CSP. If included, only the specified Cloud Store will run the operation. If not included, all Cloud Stores in the ETL will run the operation.

Table 6. Responses
Code	Description	Example
200	OK	`{ "code": 200, "data": "Reconciliation Assets For All Providers" }`

Reconciliation Repair API

Using the Reconciliation Repair API

GET http://<kubecost-address>/model/etl/asset/reconciliation/repair

Reruns queries for reconciliation in the given window for the given Cloud Store or all Cloud Stores if no provider is set.

Table 7. Path Parameters
Name	Required	Type	Description
window	true	string	The applicable window for repair by the Cloud Store. See Using `window` parameter for more details.
provider	false	string	Optional parameter for the `ProviderKey` of your CSP. If included, only the specified Cloud Store will run the operation. If not included, all Cloud Stores in the ETL will run the operation.

Table 8. Responses
Code	Description	Example
200	OK	`{ "code": 200, "data": "Reconciliation Repair process has begun for [<window>) for all providers" }`

ETL Status API

GET http://<kubecost-address>/model/etl/status

Returns a status object for the ETL. This includes sections for allocation, assets, and cloud.