{"id":1114,"date":"2019-08-13T15:03:54","date_gmt":"2019-08-13T22:03:54","guid":{"rendered":"https:\/\/portal.staylinked.com\/sl\/kb\/?post_type=ht_kb&#038;p=1114"},"modified":"2024-02-14T10:56:14","modified_gmt":"2024-02-14T18:56:14","slug":"log-files","status":"publish","type":"ht_kb","link":"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/log-files\/","title":{"rendered":"Log Files &#8211; Introduction"},"content":{"rendered":"\n<p>StayLinked includes many different log files. This article is an overview of the most common files, a little information about what they contain and some examples of how you might use them to get a clear picture of the transactions taking place.<\/p>\n\n\n\n<p>Different logs will show different parts of the communication. Optional logging, such as statistics and the session-specific logs (session, handler and socket) are disabled by default. When reviewing log files, the various log files must consider the segment in which they are capturing data. For example, the handler log is often used to recreate the screens sent to clients, but will not be usable if the client-server encryption is enabled as the screen contents cannot be unencrypted from the log file contents.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img loading=\"lazy\" width=\"774\" height=\"587\" src=\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Flowchart.jpg\" alt=\"\" class=\"wp-image-1115\" srcset=\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Flowchart.jpg 774w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Flowchart-300x228.jpg 300w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Flowchart-768x582.jpg 768w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Flowchart-50x38.jpg 50w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Flowchart-60x46.jpg 60w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Flowchart-100x76.jpg 100w\" sizes=\"(max-width: 774px) 100vw, 774px\" \/><\/figure>\n\n\n\n<p>The log files listed in the following sections do not include the entire list of available logs. Various features will have their own additional log files. This article is designed to describe the most common files and the issues they may help diagnose.<\/p>\n\n\n\n<p>Additional guides are available for more information on other logging uses, such as the<a href=\"..\/knowledge-base\/statistics-logging\/\"> Statistics Log<\/a> and <a href=\"..\/knowledge-base\/client-server-connectivity-2\/\">Client-Server Connectivity<\/a> Articles.<\/p>\n\n\n\n<p>Please be sure to contact StayLinked technical support for any issues. These logs can contain abbreviations and references that are misleading to the untrained user. For example, references in the socket log to \u2018DATA LOSS\u2019 are a reference to the <strong>L<\/strong>ast <strong>O<\/strong>bserved <strong>S<\/strong>erver <strong>S<\/strong>equence and do not actually represent the loss of any data or transactions.<\/p>\n\n\n\n<h2>Enable Session-Specific Logging<\/h2>\n\n\n\n<p>Session-specific log files are disabled by default. Enable these logs in the Server Configuration &gt; Server Settings section of the StayLinked Administrator.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img loading=\"lazy\" width=\"404\" height=\"427\" src=\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Server-Settings.jpg\" alt=\"\" class=\"wp-image-1116\" srcset=\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Server-Settings.jpg 404w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Server-Settings-284x300.jpg 284w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Server-Settings-47x50.jpg 47w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Server-Settings-57x60.jpg 57w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Server-Settings-95x100.jpg 95w\" sizes=\"(max-width: 404px) 100vw, 404px\" \/><\/figure>\n\n\n\n<p>Setting the logging level includes the log\nfiles above the selected level. This means that a setting of Socket Level would\ninclude session, handler and socket log files for each client connection in the\nIP range. Leaving the range blank will create log files for all connections.\nThis means that a server with 100 sessions and socket logging would create 300\nnew files. Disk storage space may be impacted by log files on systems that\ngenerate large file size and\/or quantity.<\/p>\n\n\n\n<p>Server systems that have operating system\nlimits on threads_process or open_files may be impacted by these additional log\nfiles. Servers reaching their configured limits may result in poor performance\nor be unable to start new connections. Please review the Server Tuning Guide\nfor more detailed information on these parameters.<\/p>\n\n\n\n<p>StayLinked Client-Server Encryption in the\nlower right corner of this dialogue should typically be set to \u2018None\u2019 during\nlogging. Using Level 1 encryption will generate encrypted log files that will\nbe generally unusable.<\/p>\n\n\n\n<p>Once enabled, these log files will be\ngenerated for all new StayLinked sessions. Devices that have an existing\nsession will not be logged until the session is ended and a new one has been\nstarted. Likewise, sessions that are generating logs will continue to do so if\nlogging is disabled until a new session is started. You can confirm the start\ntime of each session in the Administrator\u2019s list of all connections.<\/p>\n\n\n\n<p>Note the ability to enable\/disable the StdErr and StdOut logs. You can set the number of days to clean up old log files, but this will not affect general server logs.<\/p>\n\n\n\n<h2>Viewing Log Files<\/h2>\n\n\n\n<p>Files viewed using the StayLinked Administrator will open in a \u2018File Viewer\u2019 window. <strong>This viewer will only display the tail 64k of any file.<\/strong> Attempting to copy and paste data from this window may lose important details, depending on what application the data is pasted to. For these reasons, it is recommended that the original files are opened using Notepad or a similar text editing program that does not process formatting codes.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img loading=\"lazy\" width=\"541\" height=\"31\" src=\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/File-Viewer-for-handler-Log.png\" alt=\"\" class=\"wp-image-1117\" srcset=\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/File-Viewer-for-handler-Log.png 541w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/File-Viewer-for-handler-Log-300x17.png 300w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/File-Viewer-for-handler-Log-50x3.png 50w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/File-Viewer-for-handler-Log-60x3.png 60w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/File-Viewer-for-handler-Log-100x6.png 100w\" sizes=\"(max-width: 541px) 100vw, 541px\" \/><\/figure>\n\n\n\n<p>General server log files can be opened from\nthe Logs pulldown menu across the top of the Administrator. Individual session\nlogs can be accessed from the Administrator\u2019s connections list using the View\ncontext menu by right clicking a session.<\/p>\n\n\n\n<p>Some logs, like the proxy log can only be accessed from the StayLinked server\u2019s logs subdirectory.<\/p>\n\n\n\n<h2>Retrieving Files<\/h2>\n\n\n\n<p>If you want StayLinked support to help review log files, it\u2019s important that you do not cut-and-paste from the File Viewer used by the Administrator. You\u2019ll want to get a copy of the actual log file. All log files may be retrieved from their source location with the exception of the Analysis log, which is created by the StayLinked Administrator from the Handler log. Server and session-specific logs can be found in the Server\u2019s logs subdirectory.<\/p>\n\n\n\n<p>The best way to collect log files is from the right-click menu option to '<strong>Zip All Logs<\/strong>'. This menu option appears for both the Server and Session-Specific files, depending on the location of your click. Older Administrator versions will only offer the specific files, while the zip option collects them all and places them in a ZIP of your desired location.<\/p>\n\n\n\n<p>If a file is opened using the Administrator, a copy is downloaded from the server and placed on the Administrator PC. There are multiple possible locations for the storage of these copies, depending on the version and <a href=\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/administrator-installation\/#storage-modes\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">storage mode<\/a> of the Administrator:<\/p>\n\n\n\n<ol type=\"1\"><li><strong>If the Administrator is being run in Windows \u2018as Administrator\u2019<\/strong> the files will be stored in the Program Files\\StayLinked Administrator subdirectories. This should not to be confused with logging into the Administrator with the administrator user account, but in Windows by right clicking and selecting the \u2018run as Administrator\u2019 option or changing the compatibility properties with the same option.<\/li><li><strong>Starting with v15.1 build 208 the Administrator<\/strong> files can be written to the current Windows user directory. C:\\Users\\<em>username<\/em>\\AppData\\Local\\StayLinked\\Stay-Linked Administrator<\/li><li><strong>Starting with v15.2 build 210 of the Administrator<\/strong> the storage mode is configurable allowing for files to be in either of the above directories or the Windows Virtual Store C:\\Users\\<em>username<\/em>\\AppData\\Local\\VirtualStore\\Program Files\\Stay-Linked Administrator\\<\/li><\/ol>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"alignright\"><img loading=\"lazy\" width=\"374\" height=\"398\" src=\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Tips-for-sending-files.jpg\" alt=\"\" class=\"wp-image-1119\" srcset=\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Tips-for-sending-files.jpg 374w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Tips-for-sending-files-282x300.jpg 282w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Tips-for-sending-files-47x50.jpg 47w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Tips-for-sending-files-56x60.jpg 56w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Tips-for-sending-files-94x100.jpg 94w\" sizes=\"(max-width: 374px) 100vw, 374px\" \/><\/figure><\/div>\n\n\n\n<p>Some portions of this file path may be hidden directories. You can manually type the path names into your address bar if the directory does not appear or change your view options to show hidden files and directories. <\/p>\n\n\n\n<p>The Administrator copies are a snapshot of when\neach file was collected. The server copy will continue to update with new\ninformation, but only gathering a new copy at the Administrator will update the\nlocal copy.<\/p>\n\n\n\n<p>For easy access, the file viewer includes options in the File menu that will open the file in Notepad, Open the standard administrator logs directory or open the current virtual store directory. Depending on the authority level of the Administrator program, the local copies of any file displayed by the viewer will be stored in one of these locations. This includes the analysis log when created as described later in this article.<\/p>\n\n\n\n<p>New with Administrator and Server v15.1 build 208 are options to collect related log files in a single ZIP file. This gathers and compresses the entire set of files, bypassing the file viewer.<\/p>\n\n\n\n<h3>General Server Logs<\/h3>\n\n\n\n<p>General Server logs can be packaged from the Logs pulldown menu at the top of the Administrator.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"444\" height=\"312\" src=\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/08\/LogFileRetrieval.01.jpg\" alt=\"\" class=\"wp-image-2712\" srcset=\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/08\/LogFileRetrieval.01.jpg 444w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/08\/LogFileRetrieval.01-300x211.jpg 300w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/08\/LogFileRetrieval.01-50x35.jpg 50w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/08\/LogFileRetrieval.01-60x42.jpg 60w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/08\/LogFileRetrieval.01-100x70.jpg 100w\" sizes=\"(max-width: 444px) 100vw, 444px\" \/><\/figure>\n\n\n\n<h3>Session Specific Logs<\/h3>\n\n\n\n<p>Session-specific logs can be gathered from the Connections List under the View context menu when right clicking on a session.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"643\" height=\"538\" src=\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/08\/LogFileRetrieval.02.jpg\" alt=\"\" class=\"wp-image-2713\" srcset=\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/08\/LogFileRetrieval.02.jpg 643w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/08\/LogFileRetrieval.02-300x251.jpg 300w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/08\/LogFileRetrieval.02-50x42.jpg 50w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/08\/LogFileRetrieval.02-60x50.jpg 60w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2020\/08\/LogFileRetrieval.02-100x84.jpg 100w\" sizes=\"(max-width: 643px) 100vw, 643px\" \/><\/figure>\n\n\n\n<h2>Log Snapshot<\/h2>\n\n\n\n<p> An option exists in the keyboard map for any device type to save a log snapshot. This allows users to press a key combination to immediately set aside the current sessions-specific log files for that device. This allows users to save a snapshot as soon as an issue takes place, allowing support to review the end of the current log for the event and without having to worry about the files rolling over and losing the event. <\/p>\n\n\n\n<figure class=\"wp-block-image\"><img loading=\"lazy\" width=\"342\" height=\"134\" src=\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Update-entry-key.jpg\" alt=\"\" class=\"wp-image-1120\" srcset=\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Update-entry-key.jpg 342w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Update-entry-key-300x118.jpg 300w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Update-entry-key-50x20.jpg 50w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Update-entry-key-60x24.jpg 60w, https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Update-entry-key-100x39.jpg 100w\" sizes=\"(max-width: 342px) 100vw, 342px\" \/><\/figure>\n\n\n\n<p>Each time this key is invoked, the session, handler and socket logs will be zipped into a log package and stored in the Server\u2019s log directory. This makes the log files pre-packaged for sending to StayLinked and makes sure that the files take place right after the event. This prevents the files from being lost in the time between the event and the user notifying you of the event.<\/p>\n\n\n\n<h2><a href=\"..\/knowledge-base\/general-server-logs\/\">General Server Logs<\/a><\/h2>\n\n\n\n<h2><a href=\"..\/knowledge-base\/session-specific-log-files\/\">Session-Specific Log Files<\/a><\/h2>\n","protected":false},"excerpt":{"rendered":"<p>StayLinked includes many different log files. This article is an overview of the most common files, a little information about what they contain and some examples of how you might use them to get a clear picture of the transactions taking place. Different logs will show different parts of the&#8230;<\/p>\n","protected":false},"author":7,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":[],"ht-kb-category":[24],"ht-kb-tag":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v16.5 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Log Files - Introduction &ndash; StayLinked<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.staylinked.com\/knowledge-base\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Log Files - Introduction &ndash; StayLinked\" \/>\n<meta property=\"og:description\" content=\"StayLinked includes many different log files. This article is an overview of the most common files, a little information about what they contain and some examples of how you might use them to get a clear picture of the transactions taking place. Different logs will show different parts of the...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/log-files\/\" \/>\n<meta property=\"og:site_name\" content=\"StayLinked\" \/>\n<meta property=\"article:modified_time\" content=\"2024-02-14T18:56:14+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Flowchart.jpg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"8 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebSite\",\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/#website\",\"url\":\"https:\/\/portal.staylinked.com\/sl\/kb\/\",\"name\":\"StayLinked Knowledge Base\",\"description\":\"Partner Portal Resources and Support\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":\"https:\/\/portal.staylinked.com\/sl\/kb\/?s={search_term_string}\",\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/log-files\/#primaryimage\",\"inLanguage\":\"en-US\",\"url\":\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Flowchart.jpg\",\"contentUrl\":\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/08\/Flowchart.jpg\",\"width\":774,\"height\":587},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/log-files\/#webpage\",\"url\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/log-files\/\",\"name\":\"Log Files - Introduction &ndash; StayLinked\",\"isPartOf\":{\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/log-files\/#primaryimage\"},\"datePublished\":\"2019-08-13T22:03:54+00:00\",\"dateModified\":\"2024-02-14T18:56:14+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/log-files\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/log-files\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/log-files\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/portal.staylinked.com\/sl\/kb\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Articles\",\"item\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Log Files &#8211; Introduction\"}]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","_links":{"self":[{"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb\/1114"}],"collection":[{"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/comments?post=1114"}],"version-history":[{"count":2,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb\/1114\/revisions"}],"predecessor-version":[{"id":4815,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb\/1114\/revisions\/4815"}],"wp:attachment":[{"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/media?parent=1114"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=1114"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=1114"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}