Overview
Media Type
The API uses JSON to communicate with clients.
You should add the following accept header to your requests:
Accept: application/json
When you send JSON data with a POST or PUT request, you must add the following content type header:
Content-Type: application/json
JSON format
The server does not include null or empty entity properties in JSON representations.
// Metric with data
{
"id": "paris01.web001.example.com.cpu.usage",
"data": [
{"timestamp": 10101010101, "value": 25.73}
]
}
// Metric without data
{
"id": "paris01.web001.example.com.cpu.usage"
}
Tenant Header
Hawkular Metrics is a multi-tenant time-series data store. Your requests to tenant-dependent resources must include a tenant header:
Hawkular-Tenant: my-tenant
Timestamps
The API understands all timestamps as milliseconds since January 1, 1970, 00:00:00 UTC.
Response codes
Resources in the API follow response codes conventions, listed below.
| Response code | Meaning |
|---|---|
200 Ok |
The operation completed successfully. |
201 Created |
A |
204 No Content |
The operation completed successfully but result entity is null ( |
400 Bad Request |
The operation could not be processed. It could be due to:
|
404 Not Found |
Resource denoted by the URI does not exist. |
405 Method Not Allowed |
Resource denoted by the URI does not support the operation type. |
406 Not Acceptable |
Cannot reply in a format accepted by the client (specified in |
409 Conflict |
A |
415 Unsupported Media Type |
Invalid request entity format. For example, |
500 Internal Server Error |
Resource operation failed unexpectedly. |
503 Service Unavailable |
The server failed to initialize or the storage backend is not ready yet. |
Error responses
Error responses may include an ApiError entity in the body.
{"errorMsg":"Tenant is not specified. Use 'Hawkular-Tenant' header."}
Time ranges
Many resource operations need a time range restriction to be processed.
Such operations accept two timestamp query parameters:
-
start: the beginning of the time range, inclusive -
end: the end of the time range, exclusive
Either or both of them can be omitted. start defaults to now minus 8 eight hours. end defaults to now.
end must be strictly bigger than start otherwise the resource operation returns a 400 Bad Request response.
# Implicit time range
/hawkular/metrics/gauges/paris01.web001.example.com.cpu.usage/data
# Implicit time range
/hawkular/metrics/gauges/paris01.web001.example.com.cpu.usage/data?start=10101010
# Explicit time range
/hawkular/metrics/gauges/paris01.web001.example.com.cpu.usage/data?start=10101010&end=20202020
# Implicit time range
/hawkular/metrics/gauges/paris01.web001.example.com.cpu.usage/data?end=20202020
Bucket parameters
The API offers the ability to retrieve statistics on gauges, counter and availability metrics. To compute these statistics, Hawkular Metrics slices a given time range into buckets.
The size of buckets is configurable. This allows to send a query to get, for example, monthly statistics over a year of data, or hourly statistics over a week of data.
Bucket size is configured with either the buckets or the bucketDuration query parameter, exclusively:
-
bucketsindicates the desired number of buckets over the specified timerange -
bucketDurationforces bucket size to the specified amount of time
bucketDuration is a duration-formatted string.
If both parameters are specified, the resource operation returns a 400 Bad Request response.
# Desired number of buckets
/hawkular/metrics/gauges/paris01.web001.example.com.cpu.usage/data?start=10101010&end=20202020&buckets=10
# Desired bucket size
/hawkular/metrics/gauges/paris01.web001.example.com.cpu.usage/data?start=10101010&end=20202020&bucketDuration=1mn
Custom string formats
Some path or query parameters in the Metrics REST API use custom string formats.
Tags list
The parameter represents a list of tags, comma separated. A tag has the form name:value.
Name and values cannot contain commas or colons.
Throughout this document, this string format is identified as tag-list.
/hawkular/metrics/metrics?tags=host:web001.example.com,dc:paris01,type:system
Duration
The parameter represents an amount of time. Duration is formed of a length and a unit.
Length is a long integer (int64).
Allowed units are the following:
-
msfor milliseconds -
sfor seconds -
mnfor minutes -
hfor hours -
dfor days
Throughout this document, this string format is identified as duration.
/hawkular/metrics/gauges/paris01.web001.example.com.cpu.usage/data?bucketDuration=1h
Base Path
/hawkular/metrics/
REST APIs
Availability
Endpoint POST /availability
|
Note
|
Create availability metric. Same notes as creating gauge metric apply. |
Body
| Required | Description | Data Type |
|---|---|---|
Yes |
- |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
201 |
Metric created successfully |
- |
400 |
Missing or invalid payload |
|
409 |
Availability metric with given id already exists |
|
500 |
Metric creation failed due to an unexpected error |
Endpoint POST /availability/data
|
Note
|
Add metric data for multiple availability metrics in a single call. |
Body
| Required | Description | Data Type |
|---|---|---|
Yes |
List of availability metrics |
array of Availability |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Adding data succeeded. |
- |
400 |
Missing or invalid payload |
|
500 |
Unexpected error happened while storing the data |
Endpoint GET /availability/{id}
|
Note
|
Retrieve single metric definition. |
Path parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
- |
string |
- |
- |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Metric’s definition was successfully retrieved. |
|
204 |
Query was successful, but no metrics definition is set. |
- |
500 |
Unexpected error occurred while fetching metric’s definition. |
Endpoint GET /availability/{id}/data
|
Note
|
Retrieve availability data. When buckets or bucketDuration query parameter is used, the time range between start and end will be divided in buckets of equal duration, and availability statistics will be computed for each bucket. |
Path parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
- |
string |
- |
- |
Query parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
start |
No |
Defaults to now - 8 hours |
integer |
int64 |
- |
end |
No |
Defaults to now |
integer |
int64 |
- |
buckets |
No |
Total number of buckets |
integer |
int32 |
- |
bucketDuration |
No |
Bucket duration |
string |
duration |
- |
distinct |
No |
Set to true to return only distinct, contiguous values |
boolean |
- |
- |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Successfully fetched availability data. |
array of AvailabilityDataPoint |
204 |
No availability data was found. |
- |
400 |
buckets or bucketDuration parameter is invalid, or both are used. |
|
500 |
Unexpected error occurred while fetching availability data. |
Endpoint POST /availability/{id}/data
|
Note
|
Add data for a single availability metric. |
Path parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
- |
string |
- |
- |
Body
| Required | Description | Data Type |
|---|---|---|
Yes |
List of availability datapoints |
array of AvailabilityDataPoint |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Adding data succeeded. |
- |
400 |
Missing or invalid payload |
|
500 |
Unexpected error happened while storing the data |
|
Note
|
Retrieve tags associated with the metric definition. |
Path parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
- |
string |
- |
- |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Metric’s tags were successfully retrieved. |
object |
204 |
Query was successful, but no metrics were found. |
- |
500 |
Unexpected error occurred while fetching metric’s tags. |
|
Note
|
Update tags associated with the metric definition. |
Path parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
- |
string |
- |
- |
Body
| Required | Description | Data Type |
|---|---|---|
Yes |
- |
object |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Metric’s tags were successfully updated. |
- |
500 |
Unexpected error occurred while updating metric’s tags. |
|
Note
|
Delete tags associated with the metric definition. |
Path parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
- |
string |
- |
- |
tags |
Yes |
Tag list |
string |
tag-list |
- |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Metric’s tags were successfully deleted. |
- |
400 |
Invalid tags |
|
500 |
Unexpected error occurred while trying to delete metric’s tags. |
Counter
Endpoint POST /counters
|
Note
|
Create counter metric. This operation also causes the rate to be calculated and persisted periodically after raw count data is persisted. Clients are not required to explicitly create a metric before storing data. Doing so however allows clients to prevent naming collisions and to specify tags and data retention. |
Body
| Required | Description | Data Type |
|---|---|---|
Yes |
- |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
201 |
Metric created successfully |
- |
400 |
Missing or invalid payload |
|
409 |
Counter metric with given id already exists |
|
500 |
Metric creation failed due to an unexpected error |
Endpoint POST /counters/data
|
Note
|
Add data points for multiple counters. |
Body
| Required | Description | Data Type |
|---|---|---|
Yes |
List of metrics |
array of Counter |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Adding data points succeeded. |
- |
400 |
Missing or invalid payload |
|
500 |
Unexpected error happened while storing the data points |
Endpoint GET /counters/{id}
|
Note
|
Retrieve a counter definition. |
Path parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
- |
string |
- |
- |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Metric’s definition was successfully retrieved. |
|
204 |
Query was successful, but no metrics definition is set. |
- |
500 |
Unexpected error occurred while fetching metric’s definition. |
Endpoint GET /counters/{id}/data
|
Note
|
Retrieve counter data points. When buckets or bucketDuration query parameter is used, the time range between start and end will be divided in buckets of equal duration, and metric statistics will be computed for each bucket. |
Path parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
- |
string |
- |
- |
Query parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
start |
No |
Defaults to now - 8 hours |
integer |
int64 |
- |
end |
No |
Defaults to now |
integer |
int64 |
- |
buckets |
No |
Total number of buckets |
integer |
int32 |
- |
bucketDuration |
No |
Bucket duration |
string |
duration |
- |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Successfully fetched metric data. |
array of CounterDataPoint |
204 |
No metric data was found. |
- |
400 |
buckets or bucketDuration parameter is invalid, or both are used. |
|
500 |
Unexpected error occurred while fetching metric data. |
Endpoint POST /counters/{id}/data
|
Note
|
Add data for a single counter. |
Path parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
- |
string |
- |
- |
Body
| Required | Description | Data Type |
|---|---|---|
Yes |
List of data points containing timestamp and value |
array of CounterDataPoint |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Adding data succeeded. |
- |
400 |
Missing or invalid payload |
|
500 |
Unexpected error happened while storing the data |
Endpoint GET /counters/{id}/rate
|
Note
|
Retrieve counter rate data points. When buckets or bucketDuration query parameter is used, the time range between start and end will be divided in buckets of equal duration, and metric statistics will be computed for each bucket. |
Path parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
- |
string |
- |
- |
Query parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
start |
No |
Defaults to now - 8 hours |
integer |
int64 |
- |
end |
No |
Defaults to now |
integer |
int64 |
- |
buckets |
No |
Total number of buckets |
integer |
int32 |
- |
bucketDuration |
No |
Bucket duration |
string |
duration |
- |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Successfully fetched metric data. |
array of GaugeDataPoint |
204 |
No metric data was found. |
- |
400 |
buckets or bucketDuration parameter is invalid, or both are used. |
|
500 |
Unexpected error occurred while fetching metric data. |
|
Note
|
Retrieve tags associated with the metric definition. |
Path parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
- |
string |
- |
- |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Metric’s tags were successfully retrieved. |
object |
204 |
Query was successful, but no metrics were found. |
- |
500 |
Unexpected error occurred while fetching metric’s tags. |
|
Note
|
Update tags associated with the metric definition. |
Path parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
- |
string |
- |
- |
Body
| Required | Description | Data Type |
|---|---|---|
Yes |
- |
object |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Metric’s tags were successfully updated. |
- |
500 |
Unexpected error occurred while updating metric’s tags. |
|
Note
|
Delete tags associated with the metric definition. |
Path parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
- |
string |
- |
- |
tags |
Yes |
Tag list |
string |
tag-list |
- |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Metric’s tags were successfully deleted. |
- |
400 |
Invalid tags |
|
500 |
Unexpected error occurred while trying to delete metric’s tags. |
Gauge
Endpoint POST /gauges
|
Note
|
Create gauge metric. Clients are not required to explicitly create a metric before storing data. Doing so however allows clients to prevent naming collisions and to specify tags and data retention. |
Body
| Required | Description | Data Type |
|---|---|---|
Yes |
- |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
201 |
Metric created successfully |
- |
400 |
Missing or invalid payload |
|
409 |
Gauge metric with given id already exists |
|
500 |
Metric creation failed due to an unexpected error |
Endpoint GET /gauges/data
|
Note
|
Find stats for multiple metrics. Fetches data points from one or more metrics that are determined using either a tags filter or a list of metric names. The time range between start and end is divided into buckets of equal size (i.e., duration) using either the buckets or bucketDuration parameter. Functions are applied to the data points in each bucket to produce statistics or aggregated metrics. |
Query parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
start |
No |
Defaults to now - 8 hours |
integer |
int64 |
- |
end |
No |
Defaults to now |
integer |
int64 |
- |
buckets |
No |
Total number of buckets |
integer |
int32 |
- |
bucketDuration |
No |
Bucket duration |
string |
duration |
- |
tags |
No |
List of tags filters |
string |
tag-list |
- |
metrics |
No |
List of metric names |
array |
- |
- |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Successfully fetched metric data. |
array of NumericBucketPoint |
204 |
No metric data was found. |
- |
400 |
The tags parameter is required. Either the buckets or the bucketDuration parameter is required but not both. |
|
500 |
Unexpected error occurred while fetching metric data. |
Endpoint POST /gauges/data
|
Note
|
Add data for multiple gauge metrics in a single call. |
Body
| Required | Description | Data Type |
|---|---|---|
Yes |
List of metrics |
array of Gauge |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Adding data succeeded. |
- |
400 |
Missing or invalid payload |
|
500 |
Unexpected error happened while storing the data |
Endpoint GET /gauges/{id}
|
Note
|
Retrieve single metric definition. |
Path parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
- |
string |
- |
- |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Metric’s definition was successfully retrieved. |
|
204 |
Query was successful, but no metrics definition is set. |
- |
500 |
Unexpected error occurred while fetching metric’s definition. |
Endpoint GET /gauges/{id}/data
|
Note
|
Retrieve gauge data. When buckets or bucketDuration query parameter is used, the time range between start and end will be divided in buckets of equal duration, and metric statistics will be computed for each bucket. |
Path parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
- |
string |
- |
- |
Query parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
start |
No |
Defaults to now - 8 hours |
integer |
int64 |
- |
end |
No |
Defaults to now |
integer |
int64 |
- |
buckets |
No |
Total number of buckets |
integer |
int32 |
- |
bucketDuration |
No |
Bucket duration |
string |
duration |
- |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Successfully fetched metric data. |
array of GaugeDataPoint |
204 |
No metric data was found. |
- |
400 |
buckets or bucketDuration parameter is invalid, or both are used. |
|
500 |
Unexpected error occurred while fetching metric data. |
Endpoint POST /gauges/{id}/data
|
Note
|
Add data for a single gauge metric. |
Path parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
- |
string |
- |
- |
Body
| Required | Description | Data Type |
|---|---|---|
Yes |
List of datapoints containing timestamp and value |
array of GaugeDataPoint |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Adding data succeeded. |
- |
400 |
Missing or invalid payload |
|
500 |
Unexpected error happened while storing the data |
Endpoint GET /gauges/{id}/periods
|
Note
|
Find condition periods. Retrieve periods for which the condition holds true for each consecutive data point. |
Path parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
- |
string |
- |
- |
Query parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
start |
No |
Defaults to now - 8 hours |
integer |
int64 |
- |
end |
No |
Defaults to now |
integer |
int64 |
- |
threshold |
Yes |
A threshold against which values are compared |
number |
double |
- |
op |
Yes |
A comparison operation to perform between values and the threshold. |
string |
- |
ge, gte, lt, lte, eq, neq |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Successfully fetched periods. |
array of object |
204 |
No data was found. |
- |
400 |
Missing or invalid query parameters |
|
Note
|
Retrieve tags associated with the metric definition. |
Path parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
- |
string |
- |
- |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Metric’s tags were successfully retrieved. |
object |
204 |
Query was successful, but no metrics were found. |
- |
500 |
Unexpected error occurred while fetching metric’s tags. |
|
Note
|
Update tags associated with the metric definition. |
Path parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
- |
string |
- |
- |
Body
| Required | Description | Data Type |
|---|---|---|
Yes |
- |
object |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Metric’s tags were successfully updated. |
- |
500 |
Unexpected error occurred while updating metric’s tags. |
|
Note
|
Delete tags associated with the metric definition. |
Path parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
- |
string |
- |
- |
tags |
Yes |
Tag list |
string |
tag-list |
- |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Metric’s tags were successfully deleted. |
- |
400 |
Invalid tags |
|
500 |
Unexpected error occurred while trying to delete metric’s tags. |
Metric
Endpoint GET /metrics
|
Note
|
Find tenant’s metric definitions. Does not include any metric values. |
Query parameters
| Parameter | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
type |
No |
Queried metric type |
string |
- |
gauge, availability, counter |
tags |
No |
List of tags filters |
string |
tag-list |
- |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Successfully retrieved at least one metric definition. |
array of Metric |
204 |
No metrics found. |
- |
400 |
Invalid type parameter type. |
|
500 |
Failed to retrieve metrics due to unexpected error. |
Endpoint POST /metrics
|
Note
|
Create metric. Clients are not required to explicitly create a metric before storing data. Doing so however allows clients to prevent naming collisions and to specify tags and data retention. |
Body
| Required | Description | Data Type |
|---|---|---|
Yes |
- |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
201 |
Metric created successfully |
- |
400 |
Missing or invalid payload |
|
409 |
Metric with given id already exists |
|
500 |
Metric creation failed due to an unexpected error |
Endpoint POST /metrics/data
|
Note
|
Add data for multiple metrics in a single call. |
Body
| Required | Description | Data Type |
|---|---|---|
Yes |
List of metrics |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
200 |
Adding data succeeded. |
- |
400 |
Missing or invalid payload. |
|
500 |
Unexpected error happened while storing the data |
Tenant
Endpoint POST /tenants
|
Note
|
Create a new tenant. Clients are not required to create explicitly create a tenant before starting to store metric data. It is recommended to do so however to ensure that there are no tenant id naming collisions and to provide default data retention settings. |
Body
| Required | Description | Data Type |
|---|---|---|
Yes |
- |
Response
Status codes
| Status Code | Reason | Response Model |
|---|---|---|
201 |
Tenant has been succesfully created. |
- |
400 |
Missing or invalid retention properties. |
|
409 |
Given tenant id has already been created. |
|
500 |
An unexpected error occured while trying to create a tenant. |
Data Types
ApiError
| Name | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
errorMsg |
Yes |
Detailed error message of what happened |
string |
- |
- |
Availability
| Name | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
data |
No |
Availability data points |
array of AvailabilityDataPoint |
- |
- |
id |
Yes |
Identifier of the metric |
string |
- |
- |
AvailabilityDataPoint
| Name | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
timestamp |
Yes |
- |
integer |
int64 |
- |
value |
Yes |
- |
string |
- |
up, down, unknown |
Counter
| Name | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
data |
No |
Counter data points |
array of CounterDataPoint |
- |
- |
id |
Yes |
Identifier of the metric |
string |
- |
- |
CounterDataPoint
| Name | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
timestamp |
Yes |
- |
integer |
int64 |
- |
value |
Yes |
- |
integer |
int64 |
- |
Gauge
| Name | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
data |
No |
Gauge data points |
array of GaugeDataPoint |
- |
- |
id |
Yes |
Identifier of the metric |
string |
- |
- |
GaugeDataPoint
| Name | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
timestamp |
Yes |
- |
integer |
int64 |
- |
value |
Yes |
- |
number |
double |
- |
Metric
| Name | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
dataRetention |
No |
How long, in days, a data point of this metric stays in the system after it is stored |
integer |
int32 |
- |
id |
Yes |
Identifier of the metric |
string |
- |
- |
tags |
No |
Metric tags |
object |
- |
- |
tenantId |
No |
Identifier of the tenant |
string |
- |
- |
type |
No |
Metric type |
string |
- |
gauge, availability, counter |
MixedMetricsRequest
| Name | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
availabilities |
No |
- |
array of Availability |
- |
- |
counters |
No |
- |
array of Counter |
- |
- |
gauges |
No |
- |
array of Gauge |
- |
- |
NumericBucketPoint
| Name | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
avg |
No |
- |
number |
double |
- |
empty |
No |
- |
boolean |
- |
- |
end |
No |
- |
integer |
int64 |
- |
max |
No |
- |
number |
double |
- |
median |
No |
- |
number |
double |
- |
min |
No |
- |
number |
double |
- |
percentile95th |
No |
- |
number |
double |
- |
start |
No |
- |
integer |
int64 |
- |
Tenant
| Name | Required | Description | Type | Format | Allowable Values |
|---|---|---|---|---|---|
id |
Yes |
Identifier of the tenant |
string |
- |
- |
retentions |
No |
Retention settings for metrics, expressed in days |
object |
- |
- |