Collecting information for troubleshooting: Difference between revisions
From OPC Labs Knowledge Base
(Created page with "Category:How to Category:Troubleshooting This article describes the assets that you need to collect for a successful "deep" troubleshooting. == Preparations == # For...") |
|||
| (6 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
[[Category:How to]] [[Category:Troubleshooting]] | [[Category:How to]] [[Category:OPC Analyzer]] [[Category:Troubleshooting]] [[Category:Wireshark]] | ||
This article describes the assets that you need to collect for a successful "deep" troubleshooting. | This article describes the assets that you need to collect for a successful "deep" troubleshooting. | ||
== Preparations == | == Preparations == | ||
Find the simplest case that shows first symptoms of a problem, and use that in a test. The logs are tedious to analyze even if they are short; any unnecessary communication adds tremendously to the complexity of the investigation. | |||
# For OPC Classic, install OPC Analyzer. For OPC UA, install Wireshark. | # For OPC Classic, install OPC Analyzer. For OPC UA, install Wireshark. | ||
# | # Enable extended tracing (mainly for OPC UA; see [[QuickOPC: How to enable extended tracing]]). Configure it so that the information is logged to a file, and contains timestamps and other details. | ||
# | # Instrument your code so that EasyDAClient.LogEntry, EasyAEClient.LogEntry, EasyUAClient.LogEntry or EasyUASubscriber.LogEntry notifications are logged to a file, together with their timestamps and other details. | ||
# Instrument your code so that it collects and logs relevant application-specific occurrences, together with their timestamps and other details. | # Instrument your code so that it collects and logs relevant application-specific occurrences, together with their timestamps and other details. | ||
# Enable logging on the side of the OPC server, if possible. | # Enable logging on the side of the OPC server, if possible. | ||
== Learning material == | |||
* [[How to use OPC Analyzer]] | |||
* Analyzing OPC UA Communications with Wireshark: http://opcconnect.opcfoundation.org/2017/02/analyzing-opc-ua-communications-with-wireshark/ | |||
* OPC UA & Wireshark: https://www.prosysopc.com/blog/opc-ua-wireshark/ | |||
== Assets to collect == | == Assets to collect == | ||
| Line 14: | Line 20: | ||
We will need following files from you: | We will need following files from you: | ||
# Trace files from OPC Analyzer (for OPC Classic) or Wireshark (for OPC UA). | # Trace files from OPC Analyzer (for OPC Classic) or Wireshark (for OPC UA). | ||
# Extended tracing output (for OPC UA | # Extended tracing output (mainly for OPC UA). | ||
# | # EasyXXClient.LogEntry records (mainly for OPC UA). | ||
# A log of relevant occurrences in your own application. | # A log of relevant occurrences in your own application. | ||
# OPC server log(s), if available. | # OPC server log(s), if available. | ||
It is important that all logs contain timestamps (with milliseconds precision, or at least the highest precision achievable), so that we can correlate them properly. | |||
In addition, please include any relevant observations and explanations as to what has been attempted and how the test ran. | In addition, please include any relevant observations and explanations as to what has been attempted and how the test ran. | ||
Latest revision as of 15:55, 24 November 2021
This article describes the assets that you need to collect for a successful "deep" troubleshooting.
Preparations
Find the simplest case that shows first symptoms of a problem, and use that in a test. The logs are tedious to analyze even if they are short; any unnecessary communication adds tremendously to the complexity of the investigation.
- For OPC Classic, install OPC Analyzer. For OPC UA, install Wireshark.
- Enable extended tracing (mainly for OPC UA; see QuickOPC: How to enable extended tracing). Configure it so that the information is logged to a file, and contains timestamps and other details.
- Instrument your code so that EasyDAClient.LogEntry, EasyAEClient.LogEntry, EasyUAClient.LogEntry or EasyUASubscriber.LogEntry notifications are logged to a file, together with their timestamps and other details.
- Instrument your code so that it collects and logs relevant application-specific occurrences, together with their timestamps and other details.
- Enable logging on the side of the OPC server, if possible.
Learning material
- How to use OPC Analyzer
- Analyzing OPC UA Communications with Wireshark: http://opcconnect.opcfoundation.org/2017/02/analyzing-opc-ua-communications-with-wireshark/
- OPC UA & Wireshark: https://www.prosysopc.com/blog/opc-ua-wireshark/
Assets to collect
We will need following files from you:
- Trace files from OPC Analyzer (for OPC Classic) or Wireshark (for OPC UA).
- Extended tracing output (mainly for OPC UA).
- EasyXXClient.LogEntry records (mainly for OPC UA).
- A log of relevant occurrences in your own application.
- OPC server log(s), if available.
It is important that all logs contain timestamps (with milliseconds precision, or at least the highest precision achievable), so that we can correlate them properly.
In addition, please include any relevant observations and explanations as to what has been attempted and how the test ran.
