Skip to main content
GET
Get Execution Time 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

start
string
required

Start of the time range as an RFC 3339 timestamp

end
string
required

End of the time range as an RFC 3339 timestamp (must not be before start)

container_id
string

Filter metrics to a specific container

resolution
string

Data resolution ('medium' or 'high' for more data points; defaults to standard)

Response

Run execution time percentile metrics for the app as a time series over the requested time range.

data
object

Metrics payload containing 'time_series' (array of datapoints with 'timestamp' in Unix seconds and 'p50' / 'p90' / 'p99' execution times in seconds), 'total_runs' (total run count in the range), and 'start_date' / 'end_date' (RFC 3339 range bounds).

status
string

Result status of the metrics query ('success' when data was retrieved).