5.7. Logs

This chapter explains the log reports available within the Web Management Interface. The following topics are covered in this chapter:

5.7.1. Viewing logs

Log information provided on this page are split into events that occur against the different PxM service types. Each tab contains information for a specific service, allowing you to easily target your search.

Logs can be downloaded for each individual tab using the Download button. The downloaded file is saved as <something>.log on your local workstation and can be viewed in an external text editor.

The following is a view of the Server log tab.

WebUI logs

The following is a view of the Server log downloaded and viewed in an editor. Server Log view

The following describes each of the services and what they do, to help you pinpoint the right log when troubleshooting issues.

Heading Description
Server Handles the XML remote procedure calls (RPC) from the Web Management Interface and loads device templates, when device tasks are being executed.
Proxy Handles the connections between the user’s workstation to the end device, when a device is accessed through the PxM Client. It’s responsible for injecting the authentication requirements to enable the user to connect to the device.
Proxy Channels Lists all successful proxy connections with corresponding channel IDs. Proxy connections act as the middle-man throughout the connection life cycle, so users never have to know the device login credentials.

Used to authenticate the user logging onto the PxM Client and produces the device and task list the user has permission to. Any device permissions are dynamically published and device monitor states updated.

This service will also manage the authentication for users that are authenticated against RADIUS or Active Directory.

Userauth Logs PxM user login attempts and failures based on the users auth type (local, RADIUS, ACtive Directory or multi-factor).
Rest Used to handle requests and receive responses via HTTP protocols from the Web Management Interface.
HA proxy Used to manage and load balance high availability of device connections.
Session recording Used to receive screenshots sent from the users workstation to the PxM Virtual Appliance, stores them and creates a database record for each.
Task tracker Used to maintain an accurate record of the system tasks that are run in the background.
MAP Server Logs MAP sessions and which device template script was used.
Key Verifier Logs fingerprint verifications associated with a device when a connection is made to a device tool through the PxM Client.
API Logs all the API calls that are made and shows you the client that made the call and which API call was used. API logs can be found in: /var/log/osirium/rest-api.log
SMTP Email Logs listed are from the SMTP debug log file. It shows the communication between PxM and the configured SMTP server. It will show any issues the PxM has sending emails through error messages that come back from the SMTP server. Logging levels

The PxM event occurrences are given a logging level of either: Debug, Info, Warning, or Error.

The table below describes when logging is used:

Level Description

Provides detailed information to help with diagnosing problems.

By default debugging is turned off. To enable the debug logging mode. See Debug task logging.

Info Information to confirm that the service is working as expected.
Warning Gives an indication that something unexpected happened. The service is still working as expected but something to be aware of.
Error Indicates an exception has occurred and there maybe a problem. Log file directory

All log files are stored in plain text on the virtual appliance local filestore and can be found in the /var/log/osirium/server directory. They can be accessed using a BASH command and logging in as the osirium_support account. See Support account.

Logs are rotated automatically once a day and kept for a maximum of 84 rotated logs, after which they are deleted. Rotated logs are archived as compressed GZ files.

The following is an unfiltered view of the log files found in the /var/log/osirium/server directory.

Command line all log view

The following is a filtered view for the external log files found in the /var/log/osirium/server directory.

Command line external log view Log file Techout

A techout is a TGZ archive file that gathers system and configuration information. A techout task can be run against the virtual appliance which will include all the log files. Alternatively, you can create a custom techout which will allow you to select:

  • Include all: which will include logs that are upto 84 days old.
  • Include recent: which will only include logs that are 10 days old.

Create custom techout window

5.7.2. Troubleshooting

A number of troubleshooting scripts are available through the PxM console screen to help you manage system and service tasks.

To view the console window:

  1. Logon to your existing infrastructure and open the console window of the PxM Virtual Appliance.

  2. Within the blue screen console window, select Troubleshooting.

    Blue console screen

  3. Now enter the username and password of a superadmin account.

    Console Superadmin logon

  4. You will now see the list of troubleshooting scripts. These are the tasks that can be run on the server to help resolve issues.

    Console troubleshooting scripts list