{"id":7815,"date":"2021-09-03T19:39:05","date_gmt":"2021-09-03T19:39:05","guid":{"rendered":"https:\/\/www.use-snip.com\/kb\/?post_type=ht_kb&#038;p=7815"},"modified":"2021-10-04T21:15:51","modified_gmt":"2021-10-04T21:15:51","slug":"automatic-error-reports","status":"publish","type":"ht_kb","link":"https:\/\/www.use-snip.com\/kb\/knowledge-base\/automatic-error-reports\/","title":{"rendered":"Automatic Error Reports"},"content":{"rendered":"<p>The <span style=\"color: #0000ff;\"><strong>SNIP<\/strong> <\/span>NTRIP <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/question-what-is-an-ntrip-caster\/\" target=\"_blank\" rel=\"noopener\">Caster<\/a> provides a wide range of error reporting mechanisms to alert both the Caster Owner\/Operator and the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/question-what-is-an-ntrip-client\/\" target=\"_blank\" rel=\"noopener\">NTRIP Clients<\/a> when various detrimental operating conditions occur including:<\/p>\n<ul>\n<li>Conditions on the Host machine, such as low memory or disk space or high MIPS use<\/li>\n<li>Persistent NTRIP Client user account log-on problems.<\/li>\n<li>Problems with Base Stations including offline detection.<\/li>\n<\/ul>\n<p>Upon detection, an eMail is sent to the Caster Operator and\/or the affected NTRIP Client user account, or the owner of a Base Station when a <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/the-pushed-streams-tab\/\" target=\"_blank\" rel=\"noopener\">Push-In reservation<\/a> is being used.\u00a0\u00a0 The settings described below are used to control the various thresholds at which these reports are triggered and issued.\u00a0 You can also control how often such eMails are re-sent if the condition persists. In order to use automatic error reporting to the best advantage, an active <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/sending-email-from-snip\/\" target=\"_blank\" rel=\"noopener\">eMail Plug-In<\/a> is required (purchase the eMail Plug-In <a href=\"https:\/\/www.use-snip.com\/downloads\/email-support\/\" target=\"_blank\" rel=\"noopener\">here<\/a>).\u00a0 This allows sending the generated reports to the correct party.\u00a0 But the various reports can also be run and viewed directly from the <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> application itself.<\/p>\n<h2>Overview<\/h2>\n<p>The automatic error reporting process provides a simple &#8220;push&#8221; method to inform the operator about the overall state of the Caster when they are away from the machine.\u00a0 It was developed to complement the &#8220;pull&#8221; methods provided by the various <a href=\"https:\/\/www.use-snip.com\/kb\/article-categories\/reports\/\" target=\"_blank\" rel=\"noopener\">SNIP report commands<\/a>, and the various graphical reports provided by the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/systems-logs-syslogs\/\" target=\"_blank\" rel=\"noopener\">system logs<\/a>.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-medium wp-image-7820 alignright\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReportsMenu-300x218.png\" alt=\"\" width=\"300\" height=\"218\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReportsMenu-300x218.png 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReportsMenu-50x36.png 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReportsMenu-320x233.png 320w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReportsMenu.png 330w\" sizes=\"auto, (max-width: 300px) 100vw, 300px\" \/><\/p>\n<p>The primary control dialog is reached from the menu command <em><strong>Misc<\/strong> <\/em>\u21d2 <em><strong>Auto Report Settings&#8230;<\/strong><\/em><\/p>\n<p>Within this dialog are over a dozen additional smaller dialogs to control the major reporting sections.\u00a0 This makes it one of the more complex controls found in <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span>, exceeded only by the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/introducing-pfat\/\" target=\"_blank\" rel=\"noopener\"><span style=\"color: #993300;\"><strong>PFAT<\/strong><\/span><\/a> <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/pfat-translate-settings-uses\/\" target=\"_blank\" rel=\"noopener\">translation<\/a> dialogs. The links below provide more detailed information for each of the sections and reports.<\/p>\n<p>The primary dialog is shown below in two states (click to enlarge).\u00a0 On the left is shown the dialog as it first appears when <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> is started.\u00a0 On the right is a representative view after the various reports have been run. Each report is summarized in one line in this dialog. The actual eMail sent contains the full report of the current event(s).\u00a0 Often sufficient information is presented there to allow tech-support staff to assist users (NTRIP Clients) without the need to access <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> itself and review the console logs or other reports.<\/p>\n<p><a href=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReports.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-7819\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReports.png?_t=1630694417\" alt=\"\" width=\"827\" height=\"400\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReports.png 1240w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReports-300x145.png 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReports-1024x495.png 1024w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReports-768x372.png 768w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReports-50x24.png 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReports-920x445.png 920w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReports-600x290.png 600w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReports-320x155.png 320w\" sizes=\"auto, (max-width: 827px) 100vw, 827px\" \/><\/a><\/p>\n<h2>Major Sections<\/h2>\n<p>The report controls are organized into three primary sections<\/p>\n<ul>\n<li><span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> and Host Machine Warnings (the <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> machine itself)<\/li>\n<li>NTRIP <strong>Client<\/strong> Related Warnings (Rover devices, end users and user accounts)<\/li>\n<li>NTRIP <strong>Server<\/strong> Related Warnings (Base Stations with Push-In connections)<\/li>\n<\/ul>\n<p>Each is summarized below and discussed further in its own pages.\u00a0 Note that each has a check box to <em>enable<\/em> or <em>disable<\/em> running that report. When the box is <strong>un<\/strong>checked, the report is not run and will not be triggered. If one of the three groups have been <strong>un<\/strong>checked, the reports in that group are not run and an informative note warning about this is placed into the full report.<\/p>\n<h3>SNIP and Host Machine Warnings<\/h3>\n<p>The <span style=\"color: #0000ff;\"><strong>SNIP<\/strong> <\/span>and Host machine section of the automatic error reporting is described in <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/snip-and-host-machine-warnings\/\" target=\"_blank\" rel=\"noopener\">greater detail here<\/a>.\u00a0 The logic involved in this section deals primarily with <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> itself and the machine on which it is hosted, rather than the Base Stations and the User Accounts which connect to it for corrections.\u00a0 The raw data which is used in trigger thresholds is gathered as part of the routine system logs and can be plotted over various time intervals ranging from hours to weeks. [See <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/systems-logs-syslogs\/\" target=\"_blank\" rel=\"noopener\">this article<\/a> for details on this topic.]\u00a0 Many of the items here evolve over a period of hours or day due to other resource demands on the host machine.<\/p>\n<p>This section consists of seven related logic areas. Click on an item below to be taken to a section dealing with the typical use and setup of that entry.<\/p>\n<ul>\n<li><a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/snip-and-host-machine-warnings#LowFreeMemory\" target=\"_blank\" rel=\"noopener\">Low Free Memory<\/a><\/li>\n<li><a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/snip-and-host-machine-warnings#LowFreeDiskSpaceforData\" target=\"_blank\" rel=\"noopener\">Low Free Disk Space, for Data<\/a><\/li>\n<li><a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/snip-and-host-machine-warnings#LowFreeDiskSpaceforSNIPbinfiles\" target=\"_blank\" rel=\"noopener\">Low Free Disk Space, for SNIP \/bin files<\/a><\/li>\n<li><a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/snip-and-host-machine-warnings#HighFileCounts\" target=\"_blank\" rel=\"noopener\">High File Counts<\/a><\/li>\n<li><a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/snip-and-host-machine-warnings#HighSNIPMemoryUse\" target=\"_blank\" rel=\"noopener\">High SNIP Memory Use<\/a><\/li>\n<li><a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/snip-and-host-machine-warnings#HighSNIPCPUUse\" target=\"_blank\" rel=\"noopener\">High SNIP CPU Use<\/a><\/li>\n<li><a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/snip-and-host-machine-warnings#HighHostMachineCPUUse\" target=\"_blank\" rel=\"noopener\">High Host Machine CPU Use<\/a><\/li>\n<\/ul>\n<h3>NTRIP Client Related Warnings<\/h3>\n<p>The NTRIP Client section of the automatic error reporting deals with detecting bad <em><a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/question-what-is-an-ntrip-client\/\" target=\"_blank\" rel=\"noopener\">NTRIP <strong>Client<\/strong><\/a> connection<\/em> attempts and reporting these (by eMail) to both the NTRIP operator and the owner of the user account.\u00a0 It is described in greater detail in <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/ntrip-client-warnings\/\" target=\"_blank\" rel=\"noopener\">this article<\/a>.\u00a0 Informing the owner provides a means to inform the remote device operators with details of the problem at any hour of the day without operator intervention and at the moment the event occurs.<\/p>\n<p>This section consists of three related logic areas. Click on an item below to be taken to a section dealing with the typical use and setup of that entry.<\/p>\n<ul>\n<li><a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/ntrip-client-warnings#GeneralConnectionIssues\" target=\"_blank\" rel=\"noopener\">General Connection Issues<\/a><\/li>\n<li><a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/ntrip-client-warnings#ClientIPBlockedEvents\" target=\"_blank\" rel=\"noopener\">Client IP Blocked Events<\/a><\/li>\n<li><a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/ntrip-client-warnings#NEARStreamConnectionIssues\" target=\"_blank\" rel=\"noopener\">NEAR Stream Connection Issues<\/a><\/li>\n<\/ul>\n<h3>NTRIP Server Related Warnings<\/h3>\n<p>The NTRIP Server section of the automatic error reporting deals with detecting bad <em><a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/question-what-is-an-ntrip-server\/\" target=\"_blank\" rel=\"noopener\">NTRIP <strong>Server<\/strong><\/a> connections<\/em> attempts (<a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/the-pushed-streams-tab\/\" target=\"_blank\" rel=\"noopener\">PUSH_in connections<\/a>) and reporting these (by eMail) to both the NTRIP operator and the owner of the Base Station.\u00a0 In the case of <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/an-open-ntrip-caster\/\" target=\"_blank\" rel=\"noopener\">closed Casters<\/a> using the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/reserving-pushed-mountpoint\/\" target=\"_blank\" rel=\"noopener\">Reservation system<\/a>, the email of the registration owner is used for this.\u00a0 Informing the Base Station owner provides a means to alert the remote device operators with details of the problem at any hour of the day without operator intervention and at the moment the event occurs.<\/p>\n<p>This section consists of three related logic areas. Click on an item below to be taken to a section dealing with the typical use and setup of that entry.\u00a0 [Links pending]<\/p>\n<ul>\n<li>Base Station Off-Line Monitoring<\/li>\n<li>Push_In Connection Issues<\/li>\n<li>Base Station IP Blocked Events<\/li>\n<\/ul>\n<h2>Primary Dialog Controls<\/h2>\n<p>The following controls apply to all the reports<\/p>\n<p style=\"padding-left: 40px;\"><strong>Run Every X hours Control<\/strong>\u00a0 &#8212; This controls how often the periodic report process is run and a summary report is created and sent out.<\/p>\n<p style=\"padding-left: 40px;\"><strong>Reset Button<\/strong>\u00a0 &#8212;\u00a0 When pressed the various trigger thresholds are reset to the last set of values saved.<\/p>\n<p style=\"padding-left: 40px;\"><strong>Show the Document checkbox<\/strong>\u00a0 &#8212;\u00a0 When checked the summary report (resulting when <em>Run Now<\/em> is pressed) will be displayed in the console log.\u00a0 When not checked, the summary report is silently eMailed to the Caster owner email.<\/p>\n<p style=\"padding-left: 40px;\"><strong>No send if all are normal checkbox<\/strong>\u00a0 &#8212;\u00a0 When checked <strong>NO<\/strong> eMail will be sent out if all the active reports are within normal bounds.\u00a0\u00a0 Enable this if you do not wish to receive periodic emails when no error thresholds have been exceeded.<\/p>\n<p style=\"padding-left: 80px;\"><span style=\"color: #008000;\"><strong>Note<\/strong><\/span>: If two or more of the report sections have been triggered, the eMail subject line starts with &#8220;URGENT:&#8221;\u00a0 If a single report have been triggered, the eMail subject line starts with &#8220;Warning:&#8221;\u00a0\u00a0 Reports where there is nothing found to be amiss start with &#8220;Routine Status Report for&#8221;\u00a0 You can use this to devise filters in your email client to route such messages to meet your needs.<\/p>\n<p style=\"padding-left: 40px;\"><strong>Textual label<\/strong>\u00a0 &#8212; This displays how many times the report has been run since <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> was last started, and the number of eMails ever sent.<\/p>\n<p style=\"padding-left: 40px;\"><strong>More info &#8220;i&#8221; Button<\/strong>\u00a0 &#8212;\u00a0 Pressing this button opens this page in the use-<span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> knowledge base.<\/p>\n<p style=\"padding-left: 40px;\"><strong>Run Now Button\u00a0<\/strong> &#8212; This button causes all the enabled reports (those with an enabled checkbox)\u00a0 to be run.\u00a0 It then updates the one-line text label display for each report that was run, and sends the report to the Caster owner email.<\/p>\n<p style=\"padding-left: 40px;\"><strong>Close Button<\/strong>\u00a0 &#8212; This button simply hides the dialog.<\/p>\n<h2>Related Topics<\/h2>\n<p>There are several other mechanisms in the <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> Caster which can be used to track the status of the Caster itself or of the Base Station data being served to the connected NTRIP Clients. For example:<\/p>\n<p style=\"padding-left: 40px;\"><a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/the-document-viewer\/\" target=\"_blank\" rel=\"noopener\">Various Reports and Documents<\/a><\/p>\n<p style=\"padding-left: 40px;\"><a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/systems-logs-syslogs\/\" target=\"_blank\" rel=\"noopener\">Systems Logs and Graphical charts<\/a><\/p>\n<p style=\"padding-left: 40px;\">Weekly Base Station Charts<\/p>\n<p style=\"padding-left: 40px;\"><a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/map-report\/\" target=\"_blank\" rel=\"noopener\">Mapping Base Stations and Users<\/a><\/p>\n<p style=\"padding-left: 40px;\"><a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/ip-most-used-report\/\" target=\"_blank\" rel=\"noopener\">Summaries of IP connections<\/a><\/p>\n<p style=\"padding-left: 40px;\"><a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/viewing-current-users\/\" target=\"_blank\" rel=\"noopener\">Current Client Connections<\/a><\/p>\n<p>&nbsp;<\/p>\n<p style=\"text-align: center;\">This article is still being created along with links to the individual reports and settings.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The SNIP NTRIP Caster provides a wide range of error reporting mechanisms to alert both the Caster Owner\/Operator and the NTRIP Clients when various detrimental operating conditions occur including: Conditions on the Host machine, such as low memory or disk space or high MIPS use Persistent NTRIP Client user account [&hellip;]<\/p>\n","protected":false},"author":13,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0,"footnotes":""},"ht-kb-category":[418],"ht-kb-tag":[510,487,508,509,201],"class_list":["post-7815","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-reports","ht_kb_tag-automatic-error-reporting","ht_kb_tag-email","ht_kb_tag-error-reports","ht_kb_tag-monitoring","ht_kb_tag-reports"],"_links":{"self":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/7815","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/users\/13"}],"replies":[{"embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/comments?post=7815"}],"version-history":[{"count":27,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/7815\/revisions"}],"predecessor-version":[{"id":7970,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/7815\/revisions\/7970"}],"wp:attachment":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/media?parent=7815"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=7815"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=7815"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}