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

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.

Path Parameters

NameTypeDescription

commit*

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

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.

{
    "code": 200,
    "data": "Rebuilding Cloud Usage For All Providers"
}

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.

Path Parameters

NameTypeDescription

window*

String

The applicable window for repair by the Cloud Store. See Using window parameter for more details.

provider

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.

{
    "code": 200,
    "data": "Cloud Usage Repair process has begun for [<window>) for all providers"
}

Reconciliation APIs

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.

Path Parameters

NameTypeDescription

commit*

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

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.

{
    "code": 200,
    "data": "Reconciliation Assets For All Providers"
}

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.

Path Parameters

NameTypeDescription

window*

string

The applicable window for repair by the Cloud Store. See Using window parameter for more details.

provider

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.

{
    "code": 200,
    "data": "Reconciliation Repair process has begun for [<window>) for all providers"
}

ETL Status API

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.

Last updated