Metadata
- Last UpdatedFeb 20, 2025
- 2 minute read
- PI System
- Adapter for DNP3 1.2
- Adapters
Metadata for data streams
Certain metadata are sent with each stream created. Metadata is only sent for streams created by the ingress components. The endpoints that persist sent metadata are CONNECT data services and Edge Data Store.
The following metadata, created by any AVEVA adapter, is available for streams:
-
datasource: This specifies the data source and corresponds to componentId in the adapter configuration.
-
AdapterType: This specifies the type of adapter and corresponds to the componentType in the adapter configuration. The componentType for this adapter is DNP3.
To add and configure a new adapter component, see Configure system components.
Note: All supported endpoints (Edge Data Store, CONNECT data services and PI Server) use datasource. However, any other metadata is only supported on Edge Data Store and CONNECT data services. If you use PI Server as the data endpoint, the Point Source field on a PI point reflects the datasource metadata value.
The following metadata is specific to this adapter:
-
Outstation: Specifies the Id of the outstation that the stream data is collected from. For example, Outstation1
-
SourceId: Specifies the information used to uniquely identify the stream on the source system. For DNP3, this is the outstation Id, the DNP Point Type, and the index. For example, Outstation1.AnalogInput.3.
-
Schedule: Specifies the schedule used to collect data for the stream. For DNP3, this correlates to the StaticScanScheduleId property of the selection item. For example, schedule1.
The metadata level in the System/General facet controls the amount of metadata written to an adapter stream and defines the amount of metadata sent to the OMF endpoints. The metadata levels are defined as follows:
Metadata Level
Description
Metadata
None
No metadata
Low
Includes only framework related information
AdapterType and datasource
Medium
Includes adapter specific information that is considered not sensitive
AdapterType, datasource, Schedule, and Outstation
High
All metadata (including potentially sensitive information and control addresses)
AdapterType, datasource, SourceId, Schedule, and Outstation
When the adapter is initially installed, the metadata level defaults to Medium. You can reconfigure the metadata level through the adapter-wide settings.
Each stream created for a given DNP point has a unique identifier (stream ID). If you specify a custom stream ID for the DNP point in data selection configuration, the adapter uses that stream ID to create the stream. If the stream ID is not specified, the adapter uses the DefaultStreamIdPattern in the data source configuration to determine the stream ID.
Note: If a scheduleId is not specified when configuring data selection items (see Configure data selection), metadata is not sent for the associated streams until the scheduleId is specified and the adapter process is restarted.
Metadata for health and diagnostics streams
If you configure a health endpoint, the adapter sends both health and diagnostics streams by default with the following metadata:
-
datasource
-
AdapterType
For more information about Health and Diagnostics, including the list of streams, see Health and diagnostics.
To manage your diagnostics and metadata settings, see Manage adapter-wide settings.