Difference between revisions of "Log Files"

From Wiki
(Added section 'access manually')
(Core logs, configuring log length)
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
[[Category:Support]]
+
The log files contain important information to help with troubleshooting issues. This article explains how to access these files.
−
[[Category:CPRog]]
 
−
[[Category:TinyCtrl]]
 
−
The log files contain important information to help with troubleshooting issues. This article describes how to access these files.
 
−
 
 
−
If your problem relates to a robot with embedded control please include the TinyCtrl log files!
 
  
 
= Access log files automatically =
 
= Access log files automatically =
−
CPRog and iRC can collect all relevant log files automatically starting with V902-11-018.
+
[[File:IRCSupport.png|thumb|How to access log files via CPRog/iRC]]
 +
CPRog/iRC can collect all relevant log files automatically starting with V902-11-018.
  
−
# To do this click the question mark in the bottom right corner of the 3D view, which will open the Help dialog.
+
# Connect your robot
−
# Click "Collect log files" to create an archive file containing all log files and save it to your computer or click "Contact support" to attach it to an E-Mail to our support team.
+
# Click the question mark in the bottom right corner of the 3D view or "Help" in the menu bar.
−
# Another dialog will open that lets you choose which files to collect:
+
# Click "Collect log files" to create an archive file containing relevant log and configuration files and save it to your computer or click "Contact support" to create the archive and attach it to an E-Mail to our support team.
−
#* If you use a robot with embedded control (TinyCtrl) please try to connect to the robot and include both the log files of CPRog/iRC and TinyCtrl. If you can not connect please try the approach in section "TinyCtrl" of this article.
+
# A dialog will ask whether you want to include the log files from the embedded control. Make sure this is checked. If not check the connection to the robot.
−
#*If you got configuration issues please include the robot configuration and project file.
 
  
−
[[File:LogFilesDialog.PNG]]
+
If this fails consider [[Software Updates|updating CPRog/iRC]] or follow the manual guide below.
  
 +
<br clear=all>
 
= Access log files manually =
 
= Access log files manually =
−
If the automatic approach does not work, e.g. in case of software crashes, you can access the log files manually. The following sections explain how.
+
If the automatic approach does not work, e.g. if the embedded software does not respond, you can access the log files manually. The following sections explain how.
  
 
== CPRog / iRC ==
 
== CPRog / iRC ==
Line 30: Line 26:
 
* logMessages.log.3
 
* logMessages.log.3
  
−
== TinyCtrl (embedded robot control) ==
+
If you are using V14 or newer find the logs of the simulation in folder "bin-core":
−
Use a SFTP client to copy the files from the robot to your computer. We recommend using FileZilla, this article describes how to connect it to the robot: [[FTP and putty Access]].
+
* log01.txt
 +
* log02.txt
 +
* log03.txt
 +
* log04.txt
 +
* log05.txt
 +
 
 +
The folder RemoteLogs (since V14) contains the log entries that were received while connected to real robots. Unlike the log files that are stored on the embedded control these usually start at the time of connect and therefore are incomplete. However, they are stored for a longer time and may be useful if connecting to the robot is no longer possible.
 +
 
 +
== Embedded Robot Control ==
 +
=== RobotControl Core (since V14) ===
 +
[[FTP and putty Access|Use a SFTP client]] to connect to the embedded control computer. Enter the directory "RobotControl" (absolute path: /home/robot/RobotControl/) and find the following files:
 +
 
 +
* log01.txt
 +
* log02.txt
 +
* log03.txt
 +
* log04.txt
 +
* log05.txt
 +
 
 +
Since V14-003-4 each log file contains up to 10000 entries which can be increased further in the [[Project Configuration File|project configuration file]]. Earlier versions contain up to 5000 entries and are not configurable. To change the size, e.g. to increase the logged time span, find the following line at the bottom of the project configuration file and change the value of CoreLineCnt. If the line is missing make sure you are using the correct version of the embedded software and save the project once.
 +
 
 +
<syntaxhighlight lang="XML">
 +
  <Logging CoreLineCnt="10000"/>
 +
</syntaxhighlight>
 +
 
 +
=== TinyCtrl (till V13) ===
 +
[[FTP and putty Access|Use a SFTP client]] to connect to the embedded control computer. Enter the directory "TinyCtrl" (absolute path: /home/robot/TinyCtrl/ or /home/root/TinyCtrl/) and find the following files:
 +
 
 +
* logMessages01.txt
 +
* logMessages02.txt
 +
* logMessages03.txt
 +
* logMessages04.txt
 +
* logMessages05.txt
  
−
Use it to copy the following files to your computer (do not modify any files!):
+
[[Category:Support]][[Category:CPRog]][[Category:TinyCtrl]]
−
* /home/root/TinyCtrl/logMessages01.txt
 
−
* /home/root/TinyCtrl/logMessages02.txt
 
−
* /home/root/TinyCtrl/logMessages03.txt
 

Latest revision as of 16:10, 4 November 2024

The log files contain important information to help with troubleshooting issues. This article explains how to access these files.

Access log files automatically

How to access log files via CPRog/iRC

CPRog/iRC can collect all relevant log files automatically starting with V902-11-018.

  1. Connect your robot
  2. Click the question mark in the bottom right corner of the 3D view or "Help" in the menu bar.
  3. Click "Collect log files" to create an archive file containing relevant log and configuration files and save it to your computer or click "Contact support" to create the archive and attach it to an E-Mail to our support team.
  4. A dialog will ask whether you want to include the log files from the embedded control. Make sure this is checked. If not check the connection to the robot.

If this fails consider updating CPRog/iRC or follow the manual guide below.


Access log files manually

If the automatic approach does not work, e.g. if the embedded software does not respond, you can access the log files manually. The following sections explain how.

CPRog / iRC

You can find the following log files in the directory you installed CPRog in, usually "C:\CPRog" or "C:\iRC-igusRobotControl":

  • install.log
  • startUp.log
  • logMessages.log

You might also find some older log files that were created on earlier runs of the software:

  • logMessages.log.1
  • logMessages.log.2
  • logMessages.log.3

If you are using V14 or newer find the logs of the simulation in folder "bin-core":

  • log01.txt
  • log02.txt
  • log03.txt
  • log04.txt
  • log05.txt

The folder RemoteLogs (since V14) contains the log entries that were received while connected to real robots. Unlike the log files that are stored on the embedded control these usually start at the time of connect and therefore are incomplete. However, they are stored for a longer time and may be useful if connecting to the robot is no longer possible.

Embedded Robot Control

RobotControl Core (since V14)

Use a SFTP client to connect to the embedded control computer. Enter the directory "RobotControl" (absolute path: /home/robot/RobotControl/) and find the following files:

  • log01.txt
  • log02.txt
  • log03.txt
  • log04.txt
  • log05.txt

Since V14-003-4 each log file contains up to 10000 entries which can be increased further in the project configuration file. Earlier versions contain up to 5000 entries and are not configurable. To change the size, e.g. to increase the logged time span, find the following line at the bottom of the project configuration file and change the value of CoreLineCnt. If the line is missing make sure you are using the correct version of the embedded software and save the project once. 

  <Logging CoreLineCnt="10000"/>

TinyCtrl (till V13)

Use a SFTP client to connect to the embedded control computer. Enter the directory "TinyCtrl" (absolute path: /home/robot/TinyCtrl/ or /home/root/TinyCtrl/) and find the following files:

  • logMessages01.txt
  • logMessages02.txt
  • logMessages03.txt
  • logMessages04.txt
  • logMessages05.txt
Retrieved from "http://wiki.cpr-robots.com/index.php?title=Log_Files&oldid=3759"