You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

On this Page:

You can only inspect the details of Node.js services of the node instance the used Bridge is running on. If you have aggregated multiple node instances into a Bridge domain, you need to use the Bridge of the specific node instance the Node.js service is running on.

Switch to the Logging tab in the information/working area.
All users have access to logged information that is categorized as follows:

LogTechnical NameDescription
Installation Lognpm-installContains errors and warnings that have been written during npm install.
Start LogstartContains information about the selected Node.js service, environment variables, and errors logged by the Bridge process at startup.
Error LogstderrContains errors that have been written by the Node.js service to stderr.
Service Log stdoutContains messages that have been written by the Node.js service to stdout.
Custom Logs<your name>

The Bridge can also display custom logfiles. To be able to access this custom logfiles via the Bridge, they must meet the following conditions:

ConditionDescription
Save LocationCustom log files of a service must be saved to the /logs folder of the service data directory.
Naming Scheme

Names of custom log files must conform to the following naming scheme:

<custom name part>.logfor logs that do not rotate
<custom name part>_yyyy-mm-dd.logfor logs that rotate per day
<custom name part>_yyyy-mm-dd-hh.logfor logs that rotate per hour

The custom name part of the logfile must not contain underscores and must not be one of the reserved log types mentioned above.

Log File Content Format

The log files can be in text or in JSON (Bridge 7.7.0) format. If the log files are in JSON format, they must contain the following properties which will be displayed:

  • timestamp: Timestamp
  • message: Log message

Log files in JSON format can be filtered in the same way as text log files. See Filtering the Log Entries below.


Filtering the Log Entries

Logs may contain big amounts of data and in these cases it may be difficult to find the peace of information you are looking for. Therefore, you can filter the logfile entries by a regular expression, and - depending on the log type - by log level and date/time.

Filter ElementDescriptionDefault
Search for

Insert a string or a valid regular expression to search the log entries for. Only log entries that match the expression will be displayed.
Refer to Java Regular Expressions for more information on which regular expressions you can use here.

Pressing Enter in this field triggers the search.		empty
type

Select the type of logfile you want to display: npm-install, start, stderr, stdout, custom log types. See top of this page for more information on the log types.

The log types are displayed in this list in alphabetical order and the first log type of this list will be the default. So, if you added a custom log named aa.log, this log will be displayed on going to the Logging page.		first available log type
log levelThis filter is not available for Node.js services.
from

Select the date/time range you want to inspect.

  • From is set to now - 10 minutes upon opening the logging tab. You can remove the time part of the from field to display all log entries of the given day.
  • You can enter the date/time manually or by using the date/time picker next to the field.
  • An empty to field displays all log entries from the from date/time until the most recent entries.
    An empty from field triggers a search backwards until the first entries are found.
  • You can remove the time part of the to field to search until the end of the day, and of the from field to search from the beginning of the day.
This filter is available only for the error log, service log and for custom logs, if they feature timestamps. Pressing Enter in these fields triggers the search.		actual timestamp - 10 min
toempty

Click View to update the displayed logging information.
As per default, for logs with a time stamp the log entries are displayed latest first in the search results. Click the tiny arrow in the table header to change the order to oldest first.

The date filter settings will be kept as long as your Browser tab is open. They will be reset to default as soon as you open the Logging tab in a new Browser tab.

If you close your Browser with the Logging tab open, and start your Browser again with restoring all recent tabs (session restore), your date filter settings will be reloaded from your previous search.

The results according to your search conditions are displayed in a paged list:

  • You can define how many results should be displayed on one page by selecting on of 20, 50, 100, 250 and 1000 from the Show entries dropdown.
  • At the bottom of the log table, you can see how many log entries have been found and how many of them are displayed: Showing 1 to 20 of 78 entries.
  • Multi-line log messages are collapsed to not clutter the list of results. You can expand those multipart lines by clicking the plus sign at the end of the visible message part.
  • Use the buttons Previous and Next to browse through the results, or select a result page by clicking on a page number.

Installation Log

The npm-install log contains the output of the npm install command.
Select npm-install from the Type drop-down list to view the installation log. You cannot select a date range, as the npm-install log will be overwritten each time the command is executed.

Figure: The Node.js Service npm-install Log

Start Log

Select start from the Type drop-down list. Selecting a date has no effect, as the start log will be overwritten each time the Node.js service is started.

The start log contains the following information:

Figure: The Node.js Service Start Log

Error Log

Select stderr from the Type drop-down list and filter the log by date, if necessary.
The error log contains errors that have been written by the Node.js service to stderr.

Figure: The Node.js Service Error Log

Service Log

Select stdout from the Type drop-down list.
The service log contains messages that have been written by the Node.js service to stdout.

Figure: The Node.js Service Log

  • No labels