Status

  1. On the navigation panel, click System.

2. This opens the status view which contains information about all running Connectware containers.

Overview

The status view contains the following information

Name

The name of the container.

State

Connectware containers can enter one of the following states:

  • running -> The container is working as expected.

  • starting -> The container is currently in the process of starting.

  • stopping -> The container is currently stopping.

  • restarting -> The container has triggered the restarting procedure.

  • exited -> The container was shut down and won’t restart automatically.

  • created -> The container was created but not yet started.

Uptime

The time the container is already running.

Controls

To restart Connectware containers, select one or more instances (1.) and click Restart (2.) on the toolbar.

Container Details View

The Container Details view contains more information about a single container. To open this view, select one of the containers displayed in the status view.

A window similar to the picture below will open.

To unfold the individual resources just click on the appropriate tab.

Configuration

The Configuration tab shows information about container settings including

  • capAdd -> Added capabilities.

  • exposedPorts -> Ports exposed by the container.

  • image -> The docker image used by the container.

  • privileged -> Shows if the container is running in privileged mode.

  • workingDir -> The working directory inside the container.

Environmental Variables

The Environmental Variables tab shows all environmental variables available to the processes inside the container at runtime.

Container Logs

The Container Logs tab shows the logging message of the selected container. In the toolbar at the top right of this section, there are the following buttons:

  • Search for log entries containing the entered keyword. This also filters the current table.

  • Download CSV to download the displayed rows of the log file as a CSV (Comma-Separated-Value) text file (Note: Log lines outside of the window are not downloaded, and the complete download is limited to the most recent 500 lines; use Download raw log for a complete log download)

  • View columns to select the columns to be shown

  • Filter table to select filter criteria to have only a subset of rows shown

  • Download raw logs to download the full log file in order to pass on this file to Cybus Support for in-depth issue resolution. See below for an explanation of the file format.

  • and Refresh to refresh (reload) the currently shown log messages.

The “Download raw logs” button returns the stream output of “docker logs” directly, whereby each log line is prepended by some control characters. The exact stream format is described in the Docker API documentation of the “Attach” endpoint, see e.g. https://docs.docker.com/engine/api/v1.41/#operation/ContainerAttach . Basically, each line is prepended by an eight byte header and another two byte marker. For text file processing, the first 10 bytes of each line should hence be ignored. A suitable Linux command line tool for that would be cut -b11- < inputfile.log where the output lines are printed from the 11th byte onwards each.

Controls

The details view offers capabilities to

  • Stop -> Stop the selected container.

  • Restart -> Restart the selected container.

  • Delete -> Delete the selected container (the container has to be stopped first).

  • Expand all Resources -> Unfold all of the tabs described above.

In addition to these global controls, each details tab provides individual controls to filter, organize, or search the data provided.

Search

../_images/search.png

Search for entries containing the entered keywords. This also filters the current table.

Show Columns

../_images/columns.png

Select the columns to be shown.

Filter

../_images/filter.png

(Not in Logs section.) Select from available options to filter the rows to be shown.

Refresh

../_images/refresh.png

Only available in the Container Logs section. This option reloads the displayed logs.

Last updated

Logo

© Copyright 2024, Cybus GmbH