Explain usage
amberflo_explain_usageRead-only
Explain/drill into the raw meter events behind a meter's usage over a time range — useful to debug why a number looks off. API: POST /usage/explain.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filter | No | Dimension filter: map of dimension name -> allowed values. | |
| group_by | No | Dimension names to group by, e.g. ["customerId"]. | |
| take_limit | No | Return only the top N records. | |
| aggregation | No | Aggregation function: SUM | COUNT | MIN | MAX. | |
| meter_api_name | Yes | The meterApiName to explain (from amberflo_list_meters). | |
| end_time_in_seconds | No | Range end, unix epoch seconds. Defaults to now if omitted. | |
| start_time_in_seconds | Yes | Range start, unix epoch seconds (inclusive). |