Get project log activity

Changed on Oct 7, 2026

Retrieve bucketed log counts for one resource type in the project. Set resource.type to function, frontend, or database. Add resource.ids to filter to one or more resources, and add resource.deployments.ids to count deployment logs instead of runtime logs for functions and frontends. Deployment logs are not supported for databases. Database logs are a SUPERAGENT feature; resource.type=database from a HOBBY project owner returns 403. The activity window is limited to the plan's retention window (HOBBY: 1 day, SUPERAGENT: 30 days); older start times are clamped to that window. Buckets are aligned to UTC clock intervals and count events in the half-open window [start_time, end_time).

post/projects/{id}/logs/activity

Request

Base URL: https://api.volcano.dev
URL: https://api.volcano.dev/projects/{id}/logs/activity
Auth: one of:
- HTTP bearer
- HTTP bearer

Path parameters

idstring uuid required

Project ID

Request body

qstring

Optional activity query. Supports quoted text, implicit AND, AND/OR/NOT, parentheses, and fields such as level, region, invocation.id, resource.id, resource.name, function, frontend, database, and body.

start_timestring date-time

Start of the window, inclusive. Defaults to 24 hours before end_time.

end_timestring date-time

End of the window, exclusive. Defaults to now.

bucket_countinteger

Maximum number of buckets. Defaults to 24. Volcano picks the smallest bucket width from 1s, 2s, 5s, 10s, 15s, 30s, 1m, 2m, 5m, 10m, 15m, 30m, 1h, 2h, 3h, 6h, 12h, 1d, or a whole number of days that covers the window in at most this many buckets. Bucket edges fall on UTC multiples of the width, so they stay fixed as the window moves, and the response can contain fewer buckets. 1 returns one bucket that spans exactly the window.

Response

Successful response

totalinteger required

Total events counted across all buckets.

Changes

Oct 7, 202623e7875e7c4c Revision changes
- ○
  the endpoint scheme security ProjectAccessToken was added to the API
- ○
  added the new optional request property /////
Sep 19, 20263a6f365f3f35 Revision changes
- ▲
  added the new path request parameter id
- ▲
  added the new required request property
- ▲
  the request's body type changed from no type to object
- ▲
  the response's body type changed from no type to object for status
- ▲
  the response's body type changed from no type to object for status
- ▲
  the response's body type changed from no type to object for status
- ▲
  the response's body type changed from no type to object for status
- ▲
  the response's body type changed from no type to object for status
- ○
  added the new optional request property
- ○
  added the new optional request property
- ○
  added the new optional request property
- ○
  added the new optional request property
- ○
  added the optional property to the response with the status
- ○
  added the optional property to the response with the status
- ○
  added the optional property to the response with the status
- ○
  added the optional property to the response with the status
- ○
  added the required property to the response with the status
- ○
  added the required property to the response with the status
- ○
  added the required property to the response with the status
- ○
  added the required property to the response with the status
- ○
  added the required property to the response with the status
- ○
  added the required property to the response with the status

Operation history (4 revisions)