{"id":7904,"date":"2021-09-13T19:51:47","date_gmt":"2021-09-13T19:51:47","guid":{"rendered":"https:\/\/www.use-snip.com\/kb\/?post_type=ht_kb&#038;p=7904"},"modified":"2021-10-04T21:15:07","modified_gmt":"2021-10-04T21:15:07","slug":"ntrip-server-warnings","status":"publish","type":"ht_kb","link":"https:\/\/www.use-snip.com\/kb\/knowledge-base\/ntrip-server-warnings\/","title":{"rendered":"NTRIP Server Warnings"},"content":{"rendered":"<p>This article covers the <em><strong>NTRIP Server <\/strong><\/em>sections of the automatic error reporting in greater detail.\u00a0 Instructions regarding how to set the trigger thresholds for the needs for your own Caster are provided below.\u00a0\u00a0 The <strong><span style=\"color: #0000ff;\">SNIP<\/span><\/strong> 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 range of automatic error reporting mechanisms to alert the Caster Owner\/Operator when various detrimental operating conditions occur.\u00a0 A higher level overview of these functional sections is provided in <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/automatic-error-reports\/\" target=\"_blank\" rel=\"noopener\">this article<\/a>.<\/p>\n<h2 style=\"text-align: left;\">Overview<\/h2>\n<p>The logic involved in this section deals primarily 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.\u00a0 This complements other sections that deal with <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> itself or NTRIP Client connections.\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 sending reports as well.\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 of the dialog consists of the three related logic areas highlighted below.<\/p>\n<p><a href=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReports-Part3.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-7832 size-full\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReports-Part3.png?_t=1631398316\" alt=\"\" width=\"640\" height=\"160\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReports-Part3.png 640w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReports-Part3-300x75.png 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReports-Part3-50x13.png 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReports-Part3-600x150.png 600w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/AutoEmailReports-Part3-320x80.png 320w\" sizes=\"auto, (max-width: 640px) 100vw, 640px\" \/><\/a><\/p>\n<p>Each functional area can be<em> enabled \/ disabled<\/em> by <em>checking \/ <strong>un<\/strong>checking<\/em> the associated check box.\u00a0 Each <strong>SetUp<\/strong> button brings up a control dialog where the threshold behavior of that function can be set.\u00a0 For this group of functions the triggering moment is related to when the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/question-what-is-an-ntrip-server\/\" target=\"_blank\" rel=\"noopener\">NTRIP Server<\/a> connection occurs.\u00a0 Every time an NTRIP Server connects to the Caster, the logs are checked for prior connections and any limits which have been exceeded.\u00a0 This may result in sending a warning eMail out.\u00a0 The Run button causes a summary report to be created. The <strong>Run Now<\/strong> button (at the bottom of the dialog) can be used to process all the active functions and send a report.<\/p>\n<p>Each functional area is discussed in turn.<\/p>\n<h3>Base Station Off-Line Monitoring<\/h3>\n<p>This area deals with the detecting and reporting when a Base Station is offline.\u00a0 Only the Base Stations which are listed are tracked and reported on.\u00a0 If a listed Base Station has NEVER been present since <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> started, it will not be tracked.\u00a0 Only listed station which have been active in the past (since the last restart) are tracked, this prevents false positive reports, in particular during the initial start up phase of operations.<\/p>\n<p>The <strong>Monitored Base Station<\/strong> dialog is similar but slightly more complex than many of the other error reporting threshold dialogs.<\/p>\n<p><a href=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/server_Tracked.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-7912 size-full\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/server_Tracked.png?_t=1631403089\" alt=\"\" width=\"520\" height=\"280\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/server_Tracked.png 520w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/server_Tracked-300x162.png 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/server_Tracked-50x27.png 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/server_Tracked-320x172.png 320w\" sizes=\"auto, (max-width: 520px) 100vw, 520px\" \/><\/a><\/p>\n<p>Here you can create a list of all the Base Stations that are to be tracked and reported when offline.\u00a0\u00a0 Not every Base Station requires this, and it can be counter productive to add more than are wanted.<\/p>\n<p>The dialog also has the normal inputs to <strong>a)<\/strong> control how often the event must occur (in this case the time interval during which the Base must be offline, in seconds) and <strong>b)<\/strong> control if the operator is CCed in the eMail (applicable only to <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/registration-details\/\">PUSH-In reservation<\/a> uses).<\/p>\n<p>The value selected for <em>time offline before triggering<\/em> is a judgement call.\u00a0 A range from 15 to 7200 seconds (2 hours) is supported.\u00a0 In the above example, a time of 10 minutes (600 seconds) was used. Very short times (~15 seconds) reliably report what occurred, but often the NTRIP protocol itself has reconnected and resumed before the operator can react to such events.\u00a0 Very long times (&gt;30 minutes to 2 hours) can be advantageous if the Base Stations have unreliable internet connections and the operator only wishes to be informed of more major events.\u00a0 The default time is 300 seconds (5 minutes).<\/p>\n<p>A drop-down combo box provides a list of all active MountPts from which the operator can select which is to be added.\u00a0 The usual hints showing additional content details about that mountPt are provided for the entries.\u00a0 The MountPts to be tracked are added by selecting them from the list.\u00a0 Once added, they are shown in the dialog.\u00a0 If over 50 mountPts have been selected, the visual list is truncated (you can use the Print command to see the members).<\/p>\n<p>In addition, the following additional controls provide the ability to create and manage the list of Base Stations (mountPts) which is to be tracked.<\/p>\n<h4 style=\"padding-left: 40px;\">Clear All<\/h4>\n<p style=\"padding-left: 40px;\">Pressing this button removes all the list members, producing an empty list.\u00a0 This has the same effect as unchecking the check box for this function on the main dialog.<\/p>\n<h4 style=\"padding-left: 40px;\">Add All<\/h4>\n<p style=\"padding-left: 40px;\">Pressing this button adds every member of the combo box to the list.<\/p>\n<p style=\"padding-left: 40px;\">Unless all of your Base Stations connections are unusually reliable, or you have set the off-line period to be large (&gt;1hr), or you are simply monitoring things for debug, such a list is often not suitable.\u00a0 This can result in many eMails being sent if the off-line trigger time is set to be short.<\/p>\n<h4 style=\"padding-left: 40px;\">Print<\/h4>\n<p style=\"padding-left: 40px;\">Pressing this button lists every mountPt that is to be tracked to the console list for further review.<\/p>\n<h4 style=\"padding-left: 40px;\">Load All Push-In Reservations<\/h4>\n<p style=\"padding-left: 40px;\">This checkbox controls how the combo list is loaded.\u00a0 When <strong>un<\/strong>checked only the active mountPt are loaded (regardless of the<a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/stream-types\/\" target=\"_blank\" rel=\"noopener\"> type of connection<\/a> they come from).\u00a0 When checked, all active mountPts are loaded as well as all mountPts in the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/reserving-pushed-mountpoint\/\" target=\"_blank\" rel=\"noopener\">PUSH_In reservations<\/a> list.\u00a0 This allows selecting Base Stations which connect by way of a PUSH_In (NTRIP Server) connection when they are not present at that moment in time.<\/p>\n<p style=\"padding-left: 40px;\">Recall that before any tracked mountPts is reported as offline it must first be present for a short period of time.\u00a0 This prevents false triggering on any tracked mountPts that have never connected to your <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> Caster.<\/p>\n<h4 style=\"padding-left: 40px;\">eMail on data Resume<\/h4>\n<p style=\"padding-left: 40px;\">This checkbox controls the sending of an eMail when the data has resumed.\u00a0 When <strong>un<\/strong>checked no eMail is sent, when checked an eMail is sent when the tracked Base Station data stream resumes and has been declared stable again.<\/p>\n<p>&nbsp;<\/p>\n<h3>Push_In Connection Issues<\/h3>\n<p>This area deals with the most common NTRIP Server connection problems (PUSH_In connections).\u00a0 Issues such as using the wrong password, capitalization problems, NTRIP Revision (<a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/ntrip-rev1-versus-rev2-formats\/\" target=\"_blank\" rel=\"noopener\">Rev1 vs Rev2<\/a>), missing or incorrect mountPts, and violating various <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/user-accounts-adding-restrictions\/\" target=\"_blank\" rel=\"noopener\">User Account restrictions<\/a> are all handled here.\u00a0 Ill-formed connections attempts are also reported if they use the POST or SOURCE keywords defined in NTRIP.<\/p>\n<p>The setup dialog allows you to set the number of bad connections which must occur before eMail is sent (in the spin box).\u00a0 You can also set how often another email wold be sent to any connection which continues to make this error (in the combo drop down).\u00a0 You can also CC the operator (or not) on these emails.<\/p>\n<p><a href=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/server_BadConnects.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-7914 size-full\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/server_BadConnects.png?_t=1631403089\" alt=\"\" width=\"480\" height=\"280\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/server_BadConnects.png 480w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/server_BadConnects-300x175.png 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/server_BadConnects-50x29.png 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/server_BadConnects-320x187.png 320w\" sizes=\"auto, (max-width: 480px) 100vw, 480px\" \/><\/a><\/p>\n<h3>Base Station IP Blocked Events<\/h3>\n<p>This area deals with sending an eMail when the offending IP has just been blocked.\u00a0 The actual thresholds for blocking are set in the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/banning-abusive-users-editing\/\" target=\"_blank\" rel=\"noopener\">IP blocking<\/a> dialog.\u00a0 Note the NTRIP Server multiplier control on the IP blocking dialog as well.<\/p>\n<p>The setup dialog does not allow you to set the number of bad connections which must occur before eMail is sent.\u00a0 This value is set in the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/banning-abusive-users-editing\/\" target=\"_blank\" rel=\"noopener\">IP blocking<\/a> dialog.\u00a0\u00a0 The only option provided is that you can CC the operator (or not) on these emails.<\/p>\n<p><a href=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/server_IPblock.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-7913 size-full\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/server_IPblock.png?_t=1631403089\" alt=\"\" width=\"340\" height=\"200\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/server_IPblock.png 340w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/server_IPblock-300x176.png 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/server_IPblock-50x29.png 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2021\/09\/server_IPblock-320x188.png 320w\" sizes=\"auto, (max-width: 340px) 100vw, 340px\" \/><\/a><\/p>\n<h2>Typical Examples of use<\/h2>\n<p>Here we provide two common NTRIP Client connection problems as examples of use. <strong><br \/>\n<\/strong><\/p>\n<ul>\n<li>An NTRIP Server Connection (a Base Station) with a bad user password<\/li>\n<li>An Base Station which has been off-line longer then the allowed time threshold<\/li>\n<\/ul>\n<h3>NTRIP Server Connection (a Base) with a bad user password<\/h3>\n<p>NTRIP Server Connection (a Base) with a bad user password is similar to the example given when an NTRIP Client connects with bad credentials.\u00a0 [See the example <em>NTRIP Client Connection with a bad user password<\/em> ]\u00a0 Based on the current multiplier set in the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/banning-abusive-users-editing\/\" target=\"_blank\" rel=\"noopener\">IP Blocking Dialog<\/a>, the owner of any incorrect connecting\u00a0 Base Station (or the operator) may be alerted to the bad connection <strong>very<\/strong> quickly.\u00a0 As a general design rule, <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> presumes Base Station devices are better behaved than Client devices.\u00a0\u00a0 This is effectively enforced by the ratio set in the IP blocking dialog.\u00a0 Once correctly set up, this sort of event should not occur. The settings used here were:<\/p>\n<p style=\"text-align: center;\">image of how was set here, to be supplied<\/p>\n<p>The first step in this event was when the connecting base itself incorrectly connected for the Nth time reaching the trigger threshold. The console entry for this looks like:<\/p>\n<pre>console here, to be supplied<\/pre>\n<p>The report eMail which was sent looks like this:<\/p>\n<pre>offline email report here, to be supplied<\/pre>\n<p>&nbsp;<\/p>\n<h3>An offline Base Station report<\/h3>\n<p>Here we make use of the base &#8220;<strong>AZU1<\/strong>&#8221; &#8211; a Base Station sending legacy RTCM3 close to our California offices nicknamed &#8220;old unfaithful&#8221; for its tendency to briefly\u00a0 go off-line two or more times a day at different times.\u00a0 The reason for this odd behavior is a lack of real time data capacity in the local network which operates it.\u00a0 Twice a day this station will go off-line for all the real time users so it can provide an FTP transfer of the prior ~12 hours of raw data to its owner.\u00a0 This ensures that the UNAVCO RINEX <a href=\"https:\/\/www.unavco.org\/data\/gps-gnss\/ftp\/ftp.html\" target=\"_blank\" rel=\"noopener\">file sets<\/a> are complete.\u00a0 A few minutes thereafter, it then returns to an operational state.\u00a0 The precise time at which this occurs varies depending on the time required by similar downloads collected from nearby stations.\u00a0 If it happens to be on-line when you are reading this, you can get a quick status summary from one of our <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> Casters at\u00a0 <a href=\"http:\/\/ntrip.use-snip.com:2101\/SNIP::MOUNTPT?NAME=AZU1_RTCM3\" target=\"_blank\" rel=\"noopener\">this link<\/a>.<\/p>\n<p>For this example we set the time threshold to be fairly short, <strong>180 seconds<\/strong>.\u00a0 The value selected is always a compromise between a short value (tell me about any problems right NOW!) and a longer value to avoid <em>false positives<\/em> that often correct themselves before any action can be taken to correct things.\u00a0 When this Base goes offline the <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> console log displays the normal warning messages.<\/p>\n<p>And the email which was sent to the <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> operator contains the below.\u00a0 Note that the state of any other Base Stations that are also big monitored can also be reported here.<\/p>\n<pre>This is an automatic report from the <b>XXXNode<\/b> NTRIP Caster machine <b> at 192.168.2.105:2101<\/b>\r\n\r\n<span style=\"color: red;\"><b>WARNING:<\/b><\/span>\r\nIssued at Wed September 8 2021 at 16:15:17 Pacific Daylight Time\r\nThe remote-relay mountPt <b>AZU1<\/b> has been offline for the past <b>03:05 MIN:SEC<\/b>, have tried to reconnect 20\/15 times.<\/pre>\n<p>In the case of this Base Station, it typically resumes sending which results in the following &#8216;up again&#8217; eMail being sent (if the <em>eMail on data Resume<\/em> checkbox is checked) after a short period of stable operation was observed.<\/p>\n<pre>This is an automatic report from the <b>XXXNode<\/b> NTRIP Caster machine <b> at 192.168.2.105:2101<\/b>\r\n\r\n<span style=\"color: green;\"><b>NOTICE:<\/b><\/span>\r\nIssued at Wed September 8 2021 at 16:29:23 Pacific Daylight Time\r\nThe Base Station <b>AZU1<\/b> has <span style=\"color: green;\"><b>resumed sending data<\/b><\/span> to the Caster.\r\n\r\nThe Base Station was first declared offline at: Wed September 8 2021 at 16:15:17 Pacific Daylight Time\r\nThe outage lasted for about: <b>14:06 MIN:SEC<\/b>\r\n\r\nWhen the Base is operational, you can review the current status with the below link:\r\n\u00a0\u00a0\u00a0<span style=\"color: #0000ff;\">AZU1 Current Status<\/span> (link removed) \r\n\r\nIf the Base Station goes offline for more than <b>180<\/b> seconds, you will be sent a new alert email.<\/pre>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>This article covers the NTRIP Server sections of the automatic error reporting in greater detail.\u00a0 Instructions regarding how to set the trigger thresholds for the needs for your own Caster are provided below.\u00a0\u00a0 The SNIP NTRIP Caster provides a range of automatic error reporting mechanisms to alert the Caster Owner\/Operator [&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,118],"class_list":["post-7904","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-ntrip-client"],"_links":{"self":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/7904","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=7904"}],"version-history":[{"count":18,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/7904\/revisions"}],"predecessor-version":[{"id":7967,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/7904\/revisions\/7967"}],"wp:attachment":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/media?parent=7904"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=7904"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=7904"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}