Troubleshoot the DNP3 adapter

AVEVA Adapters provide features for troubleshooting issues related to connectivity, data flow, and configuration. Resources include adapter logs and the Wireshark troubleshooting tool. If you are still unable to resolve issues or need additional guidance, contact AVEVA Technical Support through the AVEVA Customer Portal.

Logs

Messages from the System and OmfEgress logs provide information on the status of the adapter. For example, they show if a connection from the adapter to an egress endpoint exists.

Perform the following steps to view the System and OmfEgress logs:

1. Navigate to the logs directory:

   Windows: %ProgramData%\OSIsoft\Adapters\DNP3\Logs

   Linux: /usr/share/OSIsoft/Adapters/DNP3/Logs

   Example:

   A successful connection to a PI Web API egress endpoint displays the following message in the OmfEgress log:

   2020-11-02 11:08:51.870 -06:00 [Information]

   Data will be sent to the following OMF endpoint:

   Id: <omfegress id>
   Endpoint: <pi web api URL> (note: the pi web api default port is 443)
   ValidateEndpointCertificate: <true or false>

2. Optional: Change the log level of the adapter to receive more information and context. For more information, see Optional: Configure Logging.

ASP .NET Core platform log

The ASP .NET Core platform log provides information from the Kestrel web server that hosts the application. The log could contain information that the adapter is overloaded with incoming data. Perform the following steps to spread the load among multiple adapters:

3. Decrease the scan frequency.

4. Lower the amount of data selection items.

Wireshark

Wireshark is a protocol-specific troubleshooting tool that supports all current adapter protocols. Perform the following steps if you want to use Wireshark to capture traffic from the data source to the adapter or from the adapter to the OMF destination.

5. Download Wireshark (https://www.wireshark.org/) .

6. Familiarize yourself with the tool and read the Wireshark user guide (https://www.wireshark.org/docs/wsug_html_chunked/).