Get App Logs
Retrieve logs for a specific app.
Authorizations
Service Account Token authentication. To authenticate API requests:
-
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
-
Use the Token: Include the service account token in the Authorization header of API requests:
Authorization: Bearer <your-service-account-token> -
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.
Query Parameters
Retrieve logs before a specific date, in RFC3339 format.
Retrieve logs after a specific date, in RFC3339 format.
Retrieve logs for a specific container.
Retrieve logs for a specific run.
Only return log lines containing this search term.
Filter by output stream. Valid values: stdout, stderr.
Set to forward to page forward in time. Defaults to backward.
Pagination token from a previous response.
Number of log lines to return per page. Maximum: 1000. Default: 200.
Response
A page of log lines for the app.
Whether more log lines are available.
Log entries. Each item has appId, containerId, containerName, lineNumber (integer), logLine, logId, projectId, stream, timestamp, and runId fields.
Token to pass as nextToken to retrieve the next page. Omitted when there are no more results.