Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Include PageNot_Applicable_to_CloudNativeNot_Applicable_to_CloudNative

Getting Started with Local Logs

The Diagnostics tab displays a listing of log files stored locally on the

Spacevars
0company
SBC 2000, SBC 1000 v2 equipped with eUSB, and
Spacevars
0series3
 file systems.
Spacevars
0company
System logs can record every internal and external action the systems perform, including user visible actions (such as placing calls), as well as internal parsing and messaging operations. The actual level of logging detail is configurable by Setting the Local Log Level.

Preview

Locally stored log files can be directly viewed from the

Spacevars
0company
Web interface. To do so, simply click the expand () icon next to the log file you wish to preview the log in place, or click the popup () icon to preview in a separate window.

Note

Previewing logs files larger than 2 Megabytes is not recommended as this may slow down your browser. Please consider downloading the logs instead.

Download

To download a copy of any local log file (or Web Access/Error log), simply click the Download button located under the Actions column.

Rotate

Anchor
Rotate
Rotate

Aside from automatic log rotation, you can directly rotate the current webui.log from memory to disk from the

Spacevars
0company
SBC 2000, SBC 1000 v2 equipped with eUSB, and 
Spacevars
0series3
Web interface. To do so, click the Rotate button located under the Actions column.

Note that the system can store up to 6 local log files. When rotating the current log file, the 6th local log file on disk is deleted to make way for the newly rotated file.

Working with Local Logs

Note

Local logging is supported on SBC 2000, SBC 1000 v2, and 

Spacevars
0series3
models.

The Local logging facility maintains two differently named log files:

  • webui.log: This file contains the current log messages being sent by the
    Spacevars
    0company
    SBC 2000, SBC 1000 v2 equipped with eUSB, and 
    Spacevars
    0series3
    Systems. Once the log is written to a file, it is no longer present in the memory; this is to reduce the I/O overhead on the overall Ribbon SBC 2000, SBC 1000 v2 equipped with eUSB, and 
    Spacevars
    0series3
    systems This log file gets automatically rotated, refer to Understanding Local Log Rotation Rules.
  • nvwebui_<timestamp>.log: When the webui.log file is rotated manually (or automatically) its contents are copied from memory to the local
    Spacevars
    0company
    SBC disk. The file is then named nvwebui_<timestamp>.log where <timestamp> represents the time when webui.log was rotated. The system stores a maximum of 6 local log files on disk.
Excerpt

Access Local Logs as follows:

  1. In the WebUI, click the Diagnostics tab.
  2. In the Logs page, click the Logs > Local System Logs tab.

    Panel
    borderStylenone


    Caption
    0Figure
    1Local System Logs



Working with Web Access and Web Error Logs

Note

Web Access and Web Error Logs are supported on all 

Spacevars
0product
models (SBC 1000/2000 and
Spacevars
0series3
).

The

Spacevars
0company
 
Spacevars
0product
system keeps exclusive tracking of the internal and external actions strictly having to do with the system's Web Server. The Web Server on the 
Spacevars
0product
is responsible for serving requests to and from the Web Interface and the REST API. These logs are typically used only when troubleshooting issues with the 
Spacevars
0product
that do not have to do with telephony traffic.

Similarly to the Local logging facility, the automatic log rotation rules applies, and user are able to Preview, Download, and Rotate those files.

Pagebreak

To access Local Logs:

  1. In the WebUI, click the Diagnostics tab.
  2. In the Logs page, click the Logs > Web Access Logs OR Web Error Logs.

Panel
borderStylenone


Caption
0Figure
1Web Access Logs



Panel
borderStylenone


Caption
0Figure
1Web Error Logs


Working with Security Logs

Panel
borderStylenone


Caption
0Figure
1Security Logs



Working with System Vitals Logs

The System Vitals Log contains system statistics crucial for understanding the overall health of the system. The SBC retains the current system vitals log, plus the previous five archived as tar.gz files.  When a new current file is generated the oldest archive is rotated out of the list. 

Each file, current and archived, is downloadable from the WebUI.

To access the System Vitals Logs:

  1. Click the Diagnostics tab at the top of the WebUI.
  2. In the left navigation pane, go to: Logs > System Vitals Logs.
Panel
borderStylenone


Caption
0Figure
1System Vitals Logs


Generating System Vitals Logs

To generate a System Vitals Log:

  1. Click the Diagnostics tab at the top of the WebUI.
  2. In the left navigation pane, go to: Logs > System Vitals Logs.
  3. Click Run System Vitals at the top of the page.

Downloading System Vitals Logs

To download a System Vitals Log:

  1. In the System Vitals Logs table, click the Download link in the row for the log you wish to download.
  2. Browse for the location in which to save the downloaded log.
  3. Click Save.