Time series collections¶
Rackspace Monitoring tracks various time-indexed data sets, such
as audits and alarm histories. When accessing a time series collection,
two parameters beyond the base paginated collection API are available:
from
and to
. These parameters take integer values, which are
interpreted as timestamps expressed in milliseconds since 00:00:00 UTC
on January 1, 1970. If the to
value is not specified it defaults to
the current time. Each time series collection specifies a default offset
from the current time, which is used when the from
value is not
supplied. For example, if no to
or from
values are specified
when retrieving an alarm history, then it will be treated as a query for
the last 7 days of data.
The standard paginated collection API is available on top of the time
series collection API. For example, performing a GET on
https://monitoring.api.rackspacecloud.com/v1.0/audits?from=1320044400000&to=1320652800000
should retrieve audits from the first 7 days of November, 2011. However,
since no limit
is supplied a default of 100 is used. Thus, if more
than 100 audits exist during that time period only the first 100 will be
returned. Further audits within the same period can be retrieved using
the next_href
URL, or by constructing a URL by using the
next_marker
value to append a marker
to your previous query. For
example, to retrieve the next 100 objects beyond the previous query, you
might use
https://monitoring.api.rackspacecloud.com/v1.0/audits?from=1320044400000&to=1320652800000&marker=16c3de00-038e-11e1-b056-d3a1a3710f94.
You can use the reverse
parameter to retrieve the objects in
reversed order. By default, objects are returned oldest first.
To convert a particular time to UTC, you can use the date +%s000
command or a website such as http://www.epochconverter.com/
.