Access Events

About this task

Historian uses AWS CloudTrail to capture the consumption of data. Using CloudTrail, you can view the following metrics:
  • The amount of tag data fetched from Data Archiver

    An event is generated every hour in CloudTrail, containing the total number of data samples (in millions) that are fetched from Data Archiver in that hour.

    For example, suppose you plot the trend chart of tag values in the past hour, and 1,045,000 samples are fetched from Data Archiver. In the event, the usageQuantity is set to 1 (indicating 1 million), and the usageDimension is set to Units_Queried (indicating that this event is for fetching data from Data Archiver). The remaining 45,000 samples are added to the ones collected in the next hour.
  • The amount of tag data written to Data Archiver

    An event is generated every hour, containing the total number of samples (in millions) that are written to Data Archiver.

    For example, if you have 1000 tags, each one set to a resolution of 1 second, 3,600,000 data samples are written to Data Archiver per hour. In the event, usageQuantity is set to 3, and usageDimension is set to Units_Stored. The remaining 600,000 samples are added to the next hour.
  • The amount of tag data exported in bulk to Amazon S3 in the Parquet or CSV file format

    An event is generated every hour, containing the total number of samples (in millions) that are exported from Data Archiver to Amazon S3 in the Parquet or CSV file format.

    For example, if 4,785,000 data samples are exported per hour, the usageQuantity is set to 4, and usageDimension is set to Bulk_Export. The remaining 785,000 samples are added to the next hour.

Events are also generated when Data Archiver is started or stopped.

Depending on the data samples written, fetched, or exported from Data Archiver, the price of using Proficy Historian for Cloud is calculated. You can then make the payment. If, however, you are using the BYOL model (that is, you have applied a Historian license), you are not required to pay for the consumption.
Note: The price for exporting data is different from that of fetching or sending data to Data Archiver. It is applicable only if you are using the consumption-based model for Proficy Historian for Cloud. Also, you must deploy the scheduled export feature separately. For more information, refer to About Sending Data to Amazon S3.

Procedure

  1. Log in to the AWS console.
  2. Under All Services > Management & Governance, select CloudTrail.
  3. In the left section, select Event history.
  4. Set the Event source to metering-marketplace.amazonaws.com.
    A list of read/write/export events appears. If needed, you can filter the events for a specific duration.
  5. Select the event whose details you want to access.
    The Meter Usage page appears, displaying the event details. In the Event Record section, the usageDimension parameter indicates whether the event is for fetching, writing, or exporting data. The usageQuantity parameter contains the number of samples that are fetched, written, or exported in that duration.