mirror of
https://github.com/apache/cloudstack.git
synced 2025-12-18 19:44:21 +01:00
12 lines
4.0 KiB
HTML
12 lines
4.0 KiB
HTML
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
||
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>5.4. Dates in the Usage Record</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Apache_CloudStack-API_Developers_Guide-4.0.0-incubating-en-US-1-" /><link rel="home" href="index.html" title="CloudStack API Developer's Guide" /><link rel="up" href="working-with-usage-data.html" title="Chapter 5. Working With Usage Data" /><link rel="prev" href="example-response-from-listUsageRecords.html" title="5.3. Example response from listUsageRecords" /><link rel="next" href="event-types.html" title="Appendix A. Event Types" /></head><body><p id="title"><a class="left" href="http://cloudstack.org"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="http://docs.cloudstack.org"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="example-response-from-listUsageRecords.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="event-types.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="dates-in-usage-record" lang="en-US"><div class="titlepage"><div><div><h2 class="title" id="dates-in-usage-record">5.4. Dates in the Usage Record</h2></div></div></div><div class="para">
|
||
Usage records include a start date and an end date. These dates define the period of time for which the raw usage number was calculated. If daily aggregation is used, the start date is midnight on the day in question and the end date is 23:59:59 on the day in question (with one exception; see below). A virtual machine could have been deployed at noon on that day, stopped at 6pm on that day, then started up again at 11pm. When usage is calculated on that day, there will be 7 hours of running VM usage (usage type 1) and 12 hours of allocated VM usage (usage type 2). If the same virtual machine runs for the entire next day, there will 24 hours of both running VM usage (type 1) and allocated VM usage (type 2).
|
||
</div><div class="para">
|
||
Note: The start date is not the time a virtual machine was started, and the end date is not the time when a virtual machine was stopped. The start and end dates give the time range within which usage was calculated.
|
||
</div><div class="para">
|
||
For network usage, the start date and end date again define the range in which the number of bytes transferred was calculated. If a user downloads 10 MB and uploads 1 MB in one day, there will be two records, one showing the 10 megabytes received and one showing the 1 megabyte sent.
|
||
</div><div class="para">
|
||
There is one case where the start date and end date do not correspond to midnight and 11:59:59pm when daily aggregation is used. This occurs only for network usage records. When the usage server has more than one day's worth of unprocessed data, the old data will be included in the aggregation period. The start date in the usage record will show the date and time of the earliest event. For other types of usage, such as IP addresses and VMs, the old unprocessed data is not included in daily aggregation.
|
||
</div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="example-response-from-listUsageRecords.html"><strong>Prev</strong>5.3. Example response from listUsageRecords</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="event-types.html"><strong>Next</strong>Appendix A. Event Types</a></li></ul></body></html>
|