About Collectors

A collector collects tag data from various data sources.

How tag data is stored if using collectors of on-premises Proficy Historian (TLS encryption is not used):
  1. Collectors send a request to AWS Network Load Balancer (NLB) to write tag data.
  2. NLB sends the request to Data Archiver. If user authentication is needed, Data Archiver sends the request to UAA, which verifies the user credentials stored in PostgreSQL. After authentication, NLB confirms to the collectors that data can be sent.
  3. Data collected by the collector instances is sent to NLB.
  4. NLB sends the data to Data Archiver directly. After authentication, Data Archiver stores the data in EFS in .iha files.
How tag data is stored if using Historian Collectors for Cloud (TLS encryption is used):
  1. Collectors send a request to AWS NLB to write tag data. Since the request is encrypted, port 443 is used.
  2. NLB decrypts the request and sends it to Data Archiver. If user authentication is needed, Data Archiver sends the request to UAA, which verifies the user credentials stored in PostgreSQL. After authentication, NLB confirms to the collectors that data can be sent.
  3. Data collected by the collector instances is encrypted and sent to NLB using port 443.
  4. NLB decrypts the data and sends it to Data Archiver. After authentication, Data Archiver stores the data in EFS in .iha files.
How data is retrieved:
  1. Clients (that is, Excel Addin, the Web Admin console, the REST Query service, or Historian Administrator) send a request to NLB to retrieve data.
  2. NLB sends the request to Data Archiver, which retrieves data from EFS. If, however, user authentication is needed, Data Archiver sends the request to UAA, which verifies the user credentials stored in PostgreSQL. After authentication, data is retrieved from EFS.
To send data using a collector, you must:
  1. Install collectors.

    You can install collectors on multiple Windows machines. These machines can be on-premises or on a virtual private cloud (VPC).

  2. Create a collector instance.
Note: The following collectors are not supported by Proficy Historian for AWS:
  • The File collector
  • The HAB collector
  • The iFIX Alarms and Events collector
  • The OPC Classic Alarms and Events collector
  • The Windows Performance collector

What does SQ mean in the cloud output and what are the sub-quality values?

The full form of SQ is Sub Quality; the values range from 1 to 13.

The following are the sub-quality values:

ihOPCNonspecific = 0
ihOPCConfigurationError=1
ihOPCNotConnected=2
ihOPCDeviceFailure=3
ihOPCSensorFailure=4
ihOPCLastKnownValue=5
ihOPCCommFailure=6
ihOPCOutOfService=7
ihScaledOutOfRange=8
ihOffLine=9
ihNoValue=10
ihCalculationError=11
ihConditionCollectionHalted=12
ihCalculationTimeout=13