Get hourly usage by product family
GET {{baseUrl}}/api/v2/usage/hourly_usage?filter[timestamp][start]=1961-11-25T12:45:52.211Z&filter[timestamp][end]=1961-11-25T12:45:52.211Z&filter[product_families]=esse&filter[include_descendants]=false&filter[include_breakdown]=false&filter[versions]=esse&page[limit]=500&page[next_record_id]=esse
Get hourly usage by product family.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
filter[timestamp][start] | string | (Required) Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh] for usage beginning at this hour. | |
filter[timestamp][end] | string | Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh] for usage ending before this hour. | |
filter[product_families] | string | (Required) Comma separated list of product families to retrieve. Available families are all, analyzed_logs, | |
application_security, audit_trail, serverless, ci_app, cloud_cost_management, | |||
csm_container_enterprise, csm_host_enterprise, cspm, custom_events, cws, dbm, error_tracking, | |||
fargate, infra_hosts, incident_management, indexed_logs, indexed_spans, ingested_spans, iot, | |||
lambda_traced_invocations, logs, network_flows, network_hosts, netflow_monitoring, observability_pipelines, | |||
online_archive, profiling, rum, rum_browser_sessions, rum_mobile_sessions, sds, snmp, | |||
synthetics_api, synthetics_browser, synthetics_mobile, synthetics_parallel_testing, and timeseries. | |||
The following product family has been deprecated: audit_logs. | |||
filter[include_descendants] | boolean | Include child org usage in the response. Defaults to false. | |
filter[include_breakdown] | boolean | Include breakdown of usage by subcategories where applicable (for product family logs only). Defaults to false. | |
filter[versions] | string | Comma separated list of product family versions to use in the format product_family:version. For example, | |
infra_hosts:1.0.0. If this parameter is not used, the API will use the latest version of each requested | |||
product family. Currently all families have one version 1.0.0. | |||
page[limit] | number | Maximum number of results to return (between 1 and 500) - defaults to 500 if limit not specified. | |
page[next_record_id] | string | List following results with a next_record_id provided in the previous query. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"data":[{"attributes":{"measurements":[{"usage_type":"laboris proident velit cillum","value":-4861417},{"usage_type":"voluptate ea quis incididunt","value":-91317168}],"org_name":"tempor eu quis","product_family":"incididunt laboris non enim","public_id":"in amet irure","region":"in","timestamp":"1954-01-25T15:08:04.606Z"},"id":"eu deserunt ut exercitation","type":"usage_timeseries"},{"attributes":{"measurements":[{"usage_type":"dolor sint minim est","value":-77184415},{"usage_type":"pariatur Excepteur","value":84306433}],"org_name":"non consectetur","product_family":"tempor do ipsum","public_id":"cupidatat","region":"incididunt minim","timestamp":"1961-04-17T18:27:08.743Z"},"id":"occaecat anim nisi fugiat elit","type":"usage_timeseries"}],"meta":{"pagination":{"next_record_id":"dolore"}}}