Skip to main content
GET
Get Dashboard Metrics

Authorizations

Authorization
string
header
required

Service Account Token authentication. To authenticate API requests:

  1. Create a Service Account Token:

    • Go to the Cerebrium Dashboard and open the API Keys page
    • Click Create Service Account, name it (e.g., "GitHub Actions CI/CD"), choose an expiry date, and click Create
    • Copy the token generated for the desired service account
  2. Use the Token: Include the service account token in the Authorization header of API requests: Authorization: Bearer <your-service-account-token>

  3. Best Practices:

    • Create separate service accounts for different environments (dev, staging, prod)
    • Store tokens securely as secrets in consuming applications or workflows
    • Set appropriate expiry dates and rotate tokens regularly
    • Never commit tokens to source control

For CI/CD integration examples, see the CI/CD documentation.

Path Parameters

project_id
string
required
app_id
string
required

Query Parameters

month
string

Billing month to retrieve metrics for. Valid values: current, previous. Default: current.

Response

Daily request and cost metrics for the app over the selected month.

cost_totals
object

Costs summed over the period, with the same fields as each costs entry.

costs
object

Costs per interval, keyed by date. Each value has total_cost_cents, cpu_cost_cents, memory_cost_cents, gpu_cost_cents, unique_container_count, and total_running_time_ms fields.

end_date
string

End of the reporting period, in RFC3339 format.

interval
string

Time bucket size for the breakdowns.

request_totals
object

Request counts summed over the period, with the same fields as each requests entry.

requests
object

Request counts per interval, keyed by date. Each value has websocket_success, 2xx, 4xx, 5xx, websocket_error, other, and total fields.

start_date
string

Start of the reporting period, in RFC3339 format.