2. Tracing, Logging and Troubleshooting
• Provide an understanding of how to setup logging in Neuron ESB
• Learn how to use logging in Business Processes and Workflows
• Learn how to troubleshoot Neuron ESB Installations
Goals
3. Tracing, Logging and Troubleshooting
• Configure logging in Neuron ESB
• View Neuron Event and Trace logs
• Using Code Editors to log from Business Processes and Workflows
• Learn how to troubleshoot Neuron ESB installations
Lesson Plan
4. Tracing, Logging and Troubleshooting
Configuration
Configuration
• Located on the “Logging” tab
of the Configure Server dialog
box.
• This sets the AppSettings and
system.diagnostics section in
esbservice.exe.config
• Corresponding
system.diagnostics settings in
Neuron ESB Explorer and Test
Client app.config files
• Default Logging level is Verbose
6. Tracing, Logging and Troubleshooting
Event Logs
Neuron ESB Event Log
• Usually the first place you go if start up issues are encountered
• Provides you an indication of what is wrong and what subsystem
generated the issue
• In most cases, more detailed information will be found in the
Neuron ESB Trace Logs
• Honors the Logging level set for the Neuron ESB runtime via
Configure Server
Application Event Log
• Commonly written to by the Neuron ESB Test Client
• Messaging API writes here if externally hosted
• SCM writes service crashes here
7. Tracing, Logging and Troubleshooting
Event Logs
Neuron ESB Event Log
• Neuron ESB Runtime
• Endpoint Hosts
• Discovery Service
• Source
• “ESBv3_”<Instance name>
• NeuronDiscoveryService
• Task Categories
• Visible through Neuron ESB Explorer
• Menu: Deployment -> Servers
Application Event Log
• Neuron ESB Client API (only if NOT hosted by Neuron
ESB Runtime)
8. Tracing, Logging and Troubleshooting
Neuron ESB Trace Logs
Neuron ESB Trace Logging
• Contains everything in Neuron ESB Event Log
• Collects meta data and other information not
reported in
Event Logs
• Used by product team to diagnose
• Each instance will have its own master Log Folder
• Default Location:
C:Program FilesNeudesicNeuron ESB
v3logs<InstanceName>
• Logs written to sub folder. Named format is
“YYYYmmddhhmmss”
• New sub-folder is created every time the Neuron
ESB Runtime is recycled
9. Tracing, Logging and Troubleshooting
Neuron ESB Trace Logs
Neuron ESB Trace Logging
• Each Log folder contains log file for:
• Each Adapter Endpoint
• Each Service Endpoint
• Auditing Service
• Each Topic
• Master
• Configuration Service
• Management Service
• Control Service
• Each Endpoint Host
• Each Workflow Endpoint
• Endpoint Host Manager
10. Logging and Tracing : Demo
Purpose:
To familiarize users with Neuron ESB Event logs and Neuron ESB Trace Logs
Objectives:
To acquaint users with the following:
• Changing the Logging Level
• Enabling WCF tracing
• Comparing Event Logs to Neuron ESB Trace Logs
11. Tracing, Logging and Troubleshooting
Business Process Logging
Neuron ESB Process Business
• Can Write to Neuron ESB Trace Log
• Respects configured Logging level
• Trace Process Step
and API
• Trace statements write to the
output window at design time and
the Neuron ESB Trace Logs at
runtime.
12. Tracing, Logging and Troubleshooting
Workflow Logging
Neuron ESB Workflow
• Can Write to Neuron ESB Trace Log
• Respects configured Logging level
• Logging API
13. Tracing, Logging and Troubleshooting
WCF Tracing
• Provides internal WCF logging for each
Neuron service (e.g. *.svclog file)
• Separate WCF log file for each
corresponding Neuron ESB Trace log file
• Provides WCF connection and error
details at channel level
• Sometimes WCF doesn’t bubble up error
information….this captures that!
• Do not run this for an extended period of
time – Generates LOTS of data
• Open with Microsoft Service Trace Viewer
• Captures the body of the message (can be
disabled in the Neuron ESB config)
14. Tracing, Logging and Troubleshooting
Common Configuration
Centralize Neuron ESB Logging
• Sometimes beneficial to centralize all
Neuron ESB Trace Logging to a central file
share if more than 1 server in a farm
• Use Registry setting
• HKEY_LOCAL_MACHINESOFTWARENeudesic
Neuron ESB v3SystemLogFolder
• HKEY_LOCAL_MACHINESOFTWAREWow6432
NodeNeudesicNeuron ESB
v3SystemLogFolder
Auto clean up of old trace log files
• Use Configure Server dialog box options
• Set the number of days to hold on to log files
before cleaning them up
15. Tracing, Logging and Troubleshooting
Installation Troubleshooting
Common Issues when Installing Neuron ESB
• Invalid License Key Error
• Setup Fails on copy
• Failed to start services
16. Tracing, Logging and Troubleshooting
Installation Troubleshooting
Invalid License Key
• Will Generate a log file in the user’s Temp directory
• If License key IS Valid, most likely FIPS is enabled on
machine
• Solution: Temporarily disable
FIPS via Group Policy
17. Tracing, Logging and Troubleshooting
Installation Troubleshooting
• Setup Fails on copy
• Failed to start services
• In both cases, log file is created in Temp
directory
• Issue could be that user running setup or
the assigned Neuron ESB service
account lacks sufficient rights
• Detailed Log file can be produced by
running MSI at command line:
msiexec.exe /i
NeuronESB_v3_x64_Release.msi /lvx*
install.log
18. Tracing, Logging and Troubleshooting
Review
• What are the 2 ways I can modify the logging level for the Neuron ESB Runtime service?
• How can I centralize Neuron ESB Trace logging to a central server?
• What information is contained within the WCF Trace log?
• What steps must I do to change the logging level and have it take effect?
• What 2 things would I look at the Neuron ESB runtime failed to start?
• If my license key is valid, why would a license key error occur in the Setup screen?
• Where is the log file generated when running the Neuron ESB Setup program?
• How can I force the Neuron ESB Installation process to generate a more verbose log file?
Editor's Notes
The goals of this lesson are to provide users with an understanding of how to setup logging inside of Neuron ESB as well ahs how to use logging in both business processes and workflow definitions. We will also be looking at how to troubleshoot installations of Neuron ESB that may encounter errors.
To facilitate our goals this lesson has been broken down into four sections to make the information easier to understand. The sections that we will be covering are
Configure logging in Neuron ESB
View Neuron Event and Trace logs
Using Code Editors to log from Business Processes and Workflows
Learn how to troubleshoot Neuron ESB installations
The logging level used by the Neuron ESB instance can be configured via the logging tab of the configure server dialog window in the Neuron ESB Explorer. By default the Trace Level value is set to Verbose, but can be changed using the Trace Level drop down list. Changing these values will set the appsettings and system.diagnotics section of the esbservice.exe.config file as well as the corresponding system.diagnotics setting in the Neuron ESB Explorer and Test Client app.config files.
On the left you will see the values for logging as they appear in the appsettings section of the esbservice.exe.config file. Notice that all the same values that appear in the configure server dialog window appear here except the Trace Level. That value is contained in the system.diagnotics section as shown on the right. Each numerical value corresponds to a Trace Level in the Neuron ESB Explorer, which is outlined in the comments section.
The Neuron ESB Event log is usually the first place you will go when you notice that an error has occurred in your Neuron ESB instance. This log usually provides a summary of the issue that is occurring and points you in the direction of which log file to look at for more detailed information about the error.
The application event log is most commonly written to by any application implementing the Neuron Client API, such as the Test Client or custom .NET applications. You will also find service crashes written by SCM appear in this log file as well.
Both the Neuron ESB event log and the Application Event log can be accessed via the Servers selection of the Deployment tab of the Neuron ESB Explorer.
The Neuron ESB event log will contain information regarding the Neuron ESB runtime, Neuron ESB endpoint hosts, the Neuron ESB discovery service as well as other information such as when a subscriber is not online to receive a message, an error occurred on a topic or endpoint etc.
The Neuron ESB trace logs contain detailed information about the entities in your Neuron ESB solution. These files contain everything that appears in the Neuron ESB event log, along with additional information, depending on your configured logging level. These files are most commonly used by the product team to diagnose errors in a solution, and it is a good idea to become familiar with them and the information they contain. While there is a single logs folder, each instance of Neuron ESB installed an a machine will have it’s own master folder inside the logs folder where these log files can be found. The logs folder is located at <Neuron Install Folder>\Neuron ESB v3\logs.
Nearly every entity in your Neuron ESB solution will have it’s own log file. From adapter endpoints, to service endpoints, to every topic and every service that Neuron ESB relies on to operate, such as the discovery service, the configuration service and the management service. While it might seem a bit overwhelming at first, it is far easier to locate an error which occurred in an adapter endpoint in a file dedicated to that adapter, then it would be to locate it in a file which contained information about every adapter in your solution.
In addition to the base logging provided by Neuron ESB, it is possible to write your own custom information to the Neuron ESB log files from a business process. This is achieved either via the Trace process step, or in the language editor process steps.
The trace process step writes the body of the message as an information level record. At design time it will put that information in the output window of the Neuron ESB Explorer Business Process Designer. At runtime these records will be written to the log file of the endpoint hosting the party which hosts the business process. Neuron ESB will respect the logging level when considering whether or not to write a trace step record to the log file. Meaning that if your instance is set to record errors and warnings only, the trace step records will not appear in the log files, but will still output to the output window at design time.
Trace methods called from inside the language editors operate in much the same way as the trace process step. The major difference being that you can set what level the record is considered, where as the trace process step records are always considered informational. Trace methods used in the language editors write to the output window and log files the same as the trace process step and respect the logging level of the instance in the same manner as well.
Like business processes workflows also allow for messages to be written to the log files using language editors. The Log methods of the workflow language editors works in the exact same way as the trace methods of the business processes language editors, writing both to the output window or appropriate log file, and respecting the logging level of the Neuron ESB instance.
WCF Tracing, which is configured on the logging tab of the configure server dialog window, provides internal WCF logging for each Neuron service. When turned on a separate WCF log file will be generated for each corresponding Neuron ESB trace log file. These WCF log files provide information on the WCF connection as well as error details at the channel level. Though rare, sometimes WCF does not bubble up error information to a level where it can be captured by Neuron ESB and written to the trace log files and these WCF log files will capture that information. However, the WCF log files generate an enormous amount of data very quickly and so it is recommended that you not leave this option selected for too long a period of time.
Sometimes it is necessary to centralize all the Neuron ESB trace logs to a central file share. For example if you are running multiple instances of Neuron in a farm, all with the same solution you may want all the log files for that solution in the same place and not spread out across the farm. In order to do this you will need to change a few registry settings on each machine to the location where you want the logs to be placed. Once you have the logs going to the desired location, whether that be the default location or one of your choosing, you should decide how often, in days, you would like Neuron to clean out the old log files.
While Neuron ESB is incredibly easy to install, from time to time one might encounter and issue with the installation process. The most common issues to run into are an invalid license key error, the setup files fail to copy to the machine, or the services fail to start up. Each of these is easy to troubleshoot and resolve in their own right.
If you receive an invalid license key error, the first thing to do is ensure that the license key is correct and the one provided to you by the Neuron ESB team. If after having done that, you are still receiving the same error look at your group policies and see if FIPS is enabled on your machine. Disable FIPS and retry the Neuron ESB installation.
In the case of the setup files failing to copy or the services failing to start, Neuron ESB generates a log file in the Temp directory during installation that will inform you of any errors that it encountered during the installation. Look at the log file to determine what the cause of the error was. To generate a detailed log file during installation to help you track down any errors that occur you can run the MSI command line provided.
