{"id":7354,"date":"2021-02-02T22:30:10","date_gmt":"2021-02-02T22:30:10","guid":{"rendered":"https:\/\/www.use-snip.com\/kb\/?post_type=ht_kb&p=7354"},"modified":"2021-03-09T22:50:30","modified_gmt":"2021-03-09T22:50:30","slug":"systems-logs-syslogs","status":"publish","type":"ht_kb","link":"https:\/\/www.use-snip.com\/kb\/knowledge-base\/systems-logs-syslogs\/","title":{"rendered":"Systems Logs (SysLogs)"},"content":{"rendered":"

This article provides an overview of the system logging features found in SNIP<\/strong><\/span>.\u00a0\u00a0 The logging process collects “counts” of various performance metrics as the Caster operates.\u00a0 These are then reported graphically over time periods spanning from minutes, to weeks, or years in duration. The data gathering and binning process is an automatic background task, and SNIP<\/strong><\/span> allows the operator to easily view and pan over up selected periods of time to examine past performance.<\/p>\n

This functionality is most often used to monitor Caster operations over a preceding period of interest (prior day, week, etc.)\u00a0\u00a0 The graphical reports can be saved as a file (PNG, JPG, PDF, etc.) , or printed<\/a> or eMailed<\/a> for use by others.\u00a0 The various system logs are presented in common dialog box described further below.<\/p>\n

This utility can be opened with the menu command:\u00a0 Reports\u00a0<\/strong> <\/em>\u21d2 System Logs…<\/em><\/strong><\/p>\n

Example of Use<\/h2>\n

Below is a typical plot showing the host machine CPU utilization over a span of 24 hours.\u00a0 In this image the SNIP<\/strong><\/span> process is utilizing about 22% of the available MIPS while the overall host machine is about 33%.\u00a0 Except for a noticeable short burst when the machine processing load increased to ~68% the machine is not being stressed.\u00a0 This increase was attributable to a system backup process running at the time.<\/p>\n

\"\"<\/a><\/p>\n

For a greater sense of context, here is a plot of the connected users (NTRIP Clients<\/a>) being served corrections\u00a0 over the same 24 hour period.\u00a0 This Caster is hosted on a shared 2-core AWS virtual machine, a low-cost configuration commonly used to host SNIP<\/strong><\/span> NTRIP Casters.<\/p>\n

\"\"<\/a><\/p>\n

Time Spans Control<\/h2>\n

The dialog presents the user with a drop-down combo which controls\u00a0 the span of time presented, as well as the ‘bins’ of time over which the performance counts are collected.\u00a0 The selected span of time can be moved from four hours (with data collected over one minute periods) to as much as three years (with weekly collection periods).\u00a0\u00a0\u00a0 Spans include:\u00a0 4 hours, 24 hours, 72 hours (3 days), 1 week (7 days), 2 weeks (14 days), 1 month (31 days), 1 year, and 3 years in duration.\u00a0 If a span of time is selected for which there is no data yet, the display states this (this occurs with new SNIP<\/strong><\/span> deployments which have not yet run very long).\u00a0 [Click to enlarge any image]<\/p>\n

\"\"<\/a><\/p>\n

The plotted data is shown in a dual view mode.\u00a0 The currently selected chart (the upper image in the above) displays the span of time the user has selected with mouse movements.\u00a0 The display defaults to the last 20% of the time when first shown. [Hint<\/strong><\/span>: Drag the mouse over the image to scroll and pan, use the roller button to control zooming]\u00a0 The lower chart displays the full span of data and shows the current chart in displayed perspective over the full set of data.<\/p>\n

You can control the specific set of data that is plotted by checking and unchecking the list of data items shown in the the tree view on the left side of the dialog for each chart.\u00a0 The chart will auto-scale the vertical axis as required to display the selected data.\u00a0 Each chart type presents a collection of possible data items with the most commonly used items selected.\u00a0 Tool tips (hover over a given data item) provide additional information. When hovering over the chart, the tool tips display additional data about that data point and the legend at the top displays the precise time and values for the currently selected data point displayed item.<\/p>\n

Controls<\/h2>\n

Some additional remarks about the controls follow below.<\/p>\n

\"\"<\/p>\n

Checkboxes<\/h3>\n

Show Tips<\/strong>; Disable to remove tool tips in the chart. For very large and complex charts this provides a slight time saving when rendering.<\/p>\n

Show On\/Off<\/strong>; Displays a vertical line and the data\/time in the chart whenever the SNIP Caster was taken off line.\u00a0 Useful to see when the trends in displayed data was disrupted by the Caster being offline.<\/p>\n

Remove Data Jumps<\/strong>; Applies a moving low pass filter to the each displayed data to remove corruptions that can occur due to bursts of data at the edge of the sampling (‘bin’) interval.<\/p>\n

Start Full Scale<\/strong>; When checked the display starts with the full span of data displayed.\u00a0 When UN-checked the last (most current) 20% of the data is displayed.\u00a0 The operator can also easily scale and pan the display using the mouse.<\/p>\n

Print as Landscape<\/strong>; Makes the default printing style a landscape mode. The user can also change this in the print dialog.<\/p>\n

The Report Type Tree<\/h3>\n

Provides a tree style list for each report.\u00a0 Select a report (click on it) to display it. The children items for that entry will open as well. Each report has a collection of related data items to select from.<\/p>\n

The possible data items to be shown are shown as children in the tree. Only those items with a check mark are charted.\u00a0 The default items when the dialog is first presented reflect reasonable choices about what is most commonly of interest.\u00a0 Less common data items are included in the list but not selected.\u00a0 The operator selections made are remembered when changing to other charts.\u00a0 This is to promote the ability to compare different chart types.\u00a0 The default settings are renewed each time the dialog is started. The magnitude of the selected item can vary widely. (This typically depends on the nature of your Caster. For example, some Casters have hundred of different users or IP connections, while others may have a very small user set.)\u00a0 Simply deselect any ‘large’ values to re-scale<\/em> and expose smaller ones when needed.<\/p>\n

One check box in each report type bears additional discussion.\u00a0 The Use Delta Plot Mode<\/strong> box enables (when checked) a delta<\/strong> <\/em><\/span>plot style where the difference<\/em> between the current value and the last value is plotted.\u00a0 This is useful when seeking to find and display any disjoint events and trends in the data.<\/p>\n

The buttons Save<\/strong>, Info<\/strong>, Print<\/strong> and eMail<\/strong> perform the normal functions.<\/p>\n

Chart Types<\/h2>\n

The following charts can be selected.<\/p>\n

Base Caster Use<\/h3>\n

Displays basic Caster information including average data served and client counts.<\/p>\n

Client Connections<\/h3>\n

Displays details about the number of clients serviced and their types (Rev1\/Rev2, NTRIP Clients vs Servers)<\/p>\n

Client Data User<\/h3>\n

Counts of the numbers of data served, tables served, web page served, etc.<\/p>\n

Base Station Counts<\/h3>\n

Counts of the number of Base Stations present of each connection type (Remote-Relay<\/a>, PUSH-In<\/a>, PUSH_Out<\/a>, Raw TCP\/IP<\/a>, Serial<\/a>).<\/p>\n

Connection Types Summary<\/h3>\n

Counts of the total bytes served out by each connection type (Remote-Relay<\/a>, PUSH-In<\/a>, PUSH_Out<\/a>, Raw TCP\/IP<\/a>, Serial<\/a>).<\/p>\n

Remote-Relay Use<\/h3>\n

Displays service details about the Bases and User Accounts connecting with Remote-Relay<\/a> connections.<\/p>\n

PUSH_In Use<\/h3>\n

Displays service details about the Bases and User Accounts connecting with PUSH_In<\/a> connections.<\/p>\n

PUSH_Out Use<\/h3>\n

Displays service details about the Bases sending out data to remote sites with PUSH_Out<\/a> connections.<\/p>\n

Raw TCP\/IP Use<\/h3>\n

Displays service details about the Bases and User Accounts connecting with RAW TCP\/IP<\/a> connections.<\/p>\n

Serial Port Use<\/h3>\n

Displays service details about the Bases and User Accounts connecting with Serial UART<\/a> connections.<\/p>\n

IP Use<\/h3>\n

Displays further details about the range and diversity of the different IPs which have connected to the Caster.<\/p>\n

Process Counts<\/h3>\n

Displays details about the SNIP application process (CPU use, memory use, etc.) and about the host machine it is running on.<\/p>\n

Offline Base Stations<\/h3>\n

Displays details about any Base Stations which are offline or otherwise reporting persistent connection issues.<\/p>\n","protected":false},"excerpt":{"rendered":"

This article provides an overview of the system logging features found in SNIP.\u00a0\u00a0 The logging process collects “counts” of various performance metrics as the Caster operates.\u00a0 These are then reported graphically over time periods spanning from minutes, to weeks, or years in duration. The data gathering and binning process is […]<\/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":[488,318,490,491,489],"class_list":["post-7354","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-reports","ht_kb_tag-logs","ht_kb_tag-ntrip-caster","ht_kb_tag-performance","ht_kb_tag-run-time","ht_kb_tag-system"],"_links":{"self":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/7354","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=7354"}],"version-history":[{"count":26,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/7354\/revisions"}],"predecessor-version":[{"id":7622,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/7354\/revisions\/7622"}],"wp:attachment":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/media?parent=7354"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=7354"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=7354"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}