Collecting ARM Log Information in SAS OLAP Servers

Overview

By default, SAS OLAP Servers collect log information in a SAS system log and an ARM log. The system log is displayed in the Log tab of the Server Manager when you select a SAS OLAP Server. The system log is also stored in a file that is refreshed daily. The ARM log is stored in a file that is created at server start. To change the default logging behavior, see Initial Logging Configuration for SAS Servers.
The ARM log receives no messages under normal operation, because the logger (Perf.ARM.OLAP_Server) is set to the WARN level.
During the testing and tuning of cubes, you change the logging level from WARN to INFO so that the ARM log begins to receive messages.
The Aggregation Tuning plug-in in SAS OLAP Cube Studio reads ARM logs to generate aggregations for common queries, as described in the SAS OLAP Cube Studio: User's Guide.
Be sure to truncate or delete large log files as necessary to maintain free space on disk.
CAUTION:
To ensure that you capture accurate log information, configure load-balancing clusters of SAS OLAP Servers so that each server writes to a separate ARM log file.
For information about configuring ARM logs in load-balancing clusters, see the “Understanding Load Balancing” chapter of the SAS Intelligence Platform: Application Server Administration Guide.

Collect ARM Log Information without Restarting the SAS OLAP Server

Follow these steps to enable ARM logging without restarting the SAS OLAP Server:
Prerequisite
Required OLAP server system option: ARMAGENT=LOG4SAS. This value is set by default when you installed the server.
  1. Start SAS Management Console and select a connection profile that has Administer permission. Authenticate yourself as directed to connect to a metadata server.
  2. Expand the Server Manager node, the SAS Application Server node (for example, SASApp), the node for the logical OLAP server, and the OLAP server instance.
  3. Right-click the OLAP server instance and select Connect. Tabs appear in the right pane.
  4. In the Loggers tab, right-click the Perf.ARM.OLAP_Server logger and select Properties.
  5. In the Properties window, select the Assigned radio button.
  6. In the Assigned field, click the down arrow and select Information.
  7. Click OK to close the Properties window and begin logging.
  8. Submit test queries to collect information in the ARM log file.
  9. To disable logging, change the Assigned field back to the Warning level.