Enable debug and creating support file

Enable debug and creating support file

Debug mode is enabled when we need more logs to analyze any issue. In this article we shall enable debug for a Job.

Debugging via GUI

Enabling Debug

(1) Admin -> System -> Debug Logs -> (2) Start debug -> (3) OK 
      

Create a Job

Create a Job  (Recommended to perform in a duplicate/another browser tab) for which the debug logs to be viewed.                                          

Viewing Debug logs

Goto (1) Admin -> System -> Debug Logs -> Refer to the file with <job_id>_debug.log (In this case 0524_0003_debug.log)
Below are different ways to view debug logs
 View -> Opens a pop-up window and displays the full file,
 Follow ->  Opens a pop-up file and displays as and when the new lines are created     
      

Disabling debug

When the Job is completed we can can disable debugging by clicking Stop Debug (Admin -> System -> Debug Logs -> Stop Debug)


Creating Support File

Often we have to share debug logs to the support team for further investigation.  This can be done by clicking Create Support File at the bottom of the page as below.  This generates an encrypted file that can be shared.
(1) Admin -> System -> Debug Logs -> (2) Scroll to the bottom of the page to access "Create Support File" -> (3) download 
   

Debugging via CLI

Enabling debug

Debugging can be enabled with the command "go set dev" in the CLI 
      
After this we will create the Job that we want to debug.  

Viewing debug logs

To access the debug logs, "go logs" and refer to the <job_id>_debug.log file
      

Disabling debug

Debugging can be disabled with "go clr dev" from the CLI
      

Creating support file

If debug logs needs to be sent to support team for further investigation, we need to create a support file. The mk_debug_set.pl script is the cli version of the support file creating function.  
      
An encrypted file is generated in the /var/opt/yce/logs directory as below, which can be sent to the support team.



    • Related Articles

    • Downloading and Creating system archives

      NetYCE system is backed up in two files named YCE archive Backup(NCCM) archive With these two files we can restore the system back to its previous state.  Or we can replicate the system. This article is about creating, downloading the archive. Steps ...
    • Creating custom reports

      We can create custom reports and schedule them for periodic execution.  These are basically created using the SQL queries from various NetYCE databases. NetYCE databases Below are the  5 distinct NetYCE databases that are available each for specific ...
    • Enabling Job Approvals

      Knowing different User Roles Below is the table that defines users levels and their group names. User-level name remark 0 disabled cannot login 1 browser cannot submit jobs 2 operator 3 engineer 4 modeler aka designer 5 manager 6 system same as ...
    • Setting up High Availability

      In this article we would be setting up two instances of NetYCE that would act as Master-master relationship. Pre conditions It is assumed we already have cloned the primary server or set up a new one. If you have installed a new system (VM), make ...
    • How to setup forwarding syslog messages to another syslog server

      In this article I will show the changes you can make to your syslog-ng.conf file in order to forward syslog messages to one or more remote syslog servers. Start by adding the desired amount of destinations, in this example we add two syslog machines ...