Tools → CMC Logs Manager

About the CMC Logs Manager

The Cluster Management Console (CMC) Logs Manager enables you to view, download, and summarize log files for all of the activities done in Incorta clusters.

Starting with release 5.2.3, the CMC Logs Manager enables you to download a generated thread dump for a specific cluster.

CMC Logs Manager Access Rights

Only a CMC administrator can view the logs by selecting the Logs tab in the navigation bar of the CMC.

Types of Log Files

There are different types of logs:

Service/Node Logs

The node log files are specific to a service or a node.
Such files contain logs for notifications, alerts, scheduled events, and synchronizations between the loader and the analytics services.

Incorta stores these files at the following location:
<incorta_installation_directory>/IncortaAnalytics/IncortaNode/services/<serviceID>/logs/incorta/

The log file name format in the CMC Logs Manager is:
localNode_<service_name>_incorta.<date>.log
For example, localNode_analyticsService_incorta.2021-03-23.log.

System Logs

The System log files are internal tenant log files that contain the startups and shutdowns logs.

Note

You can find the Default Tenant Configurations page in CMC under Clusters > <cluster_name> > Configurations.

The System log file name format in the CMC Logs Manager is:
localNode_<service_name>_system_incorta.<date>.log
For example, localNode_analyticsService_system_incorta.2021-03-23.log.

Tenant Logs

The Tenant log files contain all of the activities done for a certain Tenant, such as login, loading schemas, and opening dashboards.

Incorta stores these files at the following location:
<incorta_installation_directory>/IncortaAnalytics/IncortaNode/services/<serviceID>/logs/incorta/<tenant>/

The Tenant log file name format in the CMC Logs Manager is:
localNode_<service_name>_<tenant_name_>_incorta.<date>.log. For example, localNode_loaderService_tenant_incorta.2021-03-23.log.

Catalina Logs

The Catalina log files contain all of the activities in Tomcat server and all activities done outside of Incorta, such as APIs and .jar files. Incorta stores these files at the following location:
<incorta_installation_directory>/IncortaAnalytics/IncortaNode/services/<serviceID>/logs/

he Catalina log file name format in the CMC Logs Manager is:
localNode_<service_name_>_catalina.<date>.log
For example, localNode_loaderService_catalina.2021-03-23.log.

SQLi Logs

The SQLi log files contain all of the interaction logs of a third-party tool with the analytics service database.

Incorta stores these files at the following location:
<installation_directory>/IncortaAnalytics/IncortaNode/services/<serviceID>/logs/incorta/sqli/

The SQLi log file name format in the CMC Logs Manager is:
localNode_<service_name_>_sqli_incorta.<date>.log
For example, localNode_analyticsService_sqli_incorta.2021-03-23.log.

Thread Dump

A thread dump is a snapshot of the state of all threads that are part of the cluster. The state of each thread is presented with a stack trace, which shows the contents of a thread's stack. The Thread Dump files are not automatically generated. You must first generate them through the CMC Nodes Manager page using the following steps:

  • In the Nodes Manager page, for a certain node, select the More Options (⋮ vertical ellipsis icon)
  • Select Generate Thread Dump
    Note

    You cannot generate a thread dump file if the node is stopped or terminated unexpectedly.

Incorta stores these files at the following location:
<installation_directory>/IncortaAnalytics/IncortaNode/services/<serviceID>/logs/threadDump/

The thread dump file name format in the CMC Logs Manager is:
localNode_analyticsService_threadDump.<date>.txt
For example, localNode_analyticsService_threadDump.2022-10-10.log.

CMC Logs Manager Anatomy

The CMC Logs Manager consists of the following:

Context Bar

The context bar consists of two tabs:

  • Logs, which contains all of the log files created.
  • Logs Summary History, which contains summarized log files.

The Logs search bar consists of the following fields that you can use to filter your search results:

ControlTypeDescription
DatecalendarSpecify a start and end date.
Cluster Namedrop-down listSelect a cluster name.
Service Namedrop-down listSelect a service name.
Tenant Namedrop-down listSelect a tenant name.
Get FilesbuttonSelect get files to display log files based on the search criteria you selected.
Note

The Get Files button is disabled by default until you choose a cluster.

The Logs Summary History search bar consists of the following:

ControlTypeDescription
DatecalendarSpecify a start and end date.
Cluster Namedrop-down listSelect a cluster.
Get FilesbuttonSelect get files to display all summary log files based on the search criteria you selected.

Use these fields to display the Logs Summary History fields for a specific date range, that cannot be more than one month, or a certain cluster.

List View

The list view for Logs and Logs Summary History are different from each other. The Logs list view displays the individual log files based on your search criteria.

The Logs Summary History list view displays a list of Log Summary files. You must first create a Log Summary to view the Log Summary History list.

Logs List View

By default, the Logs list view is empty and the Get Files button is disabled.

When you specify the search criteria and select the Get Files button, the CMC Logs Manager displays a list of all of the log files based on your search criteria.

To sort the logs by a column value in either ascending or descending order, select the column header.

For the Logs tab, the list view consists of the following properties:

PropertyControlDescription
Select Allcheck boxA header control to select all log files in the list.
DatetextThe date when the CMC logs manager created the log file.
File NametextThe name of the log file. The file name is usually composed of the cluster name, service name, service type, tenant, log type, and the file creation date.
Service NametextThe name of the service that performed the action for which the CMC created the log file. It can be either loader or analytics.
Service TypetextThe type of the service that performed the action. The service type can be either loader, analytics, or service.
Service Type Filter menudrop-down listA drop-down list that contains all of the service types. Use this drop-down list to display only the log files for a certain service type.
TenanttextThe name of the tenant that the log file belongs to.
Logs TypetextThe type of the log file. There are different log file types, such as Incorta, tenant, thread dump, and catalina.
Logs Type Filter menudrop-down listA drop-down list that contains all of the available file types in your search result. Use this drop-down list to display only the log files for a certain file.
File SizetextThe size of the log file that can either be in bytes, kilobytes, megabytes, or gigabytes.
Page Numberlink/buttonsA numbered list of pages that exists with next and previous buttons.

Logs Summary History List View

By default, the Logs Summary History list view is empty. Yet, the Get Files button is enabled as you can view the summary logs for all clusters.

When you select the Get Files button, the CMC Logs Manager will display a list of all of the logs summary history. To sort the logs by a column value in either ascending or descending order, select the column header.

For the Logs Summary History tab, the list view consists of the following properties:

PropertyControlDescription
DatetextThe date when you created logs summary history file.
File NamelinkA clickable name of the log file. The file name is usually in the following format: Logs_Summary_<timestamp>.log.
Cluster NametextThe name of the cluster that performed the action for which the CMC created the log file. It can be either loader or analytics.
Download AsbuttonTwo buttons. Each indicates the file type that you can download and save the logs summary history file to. The types are csv and json.
Page Numberlink/buttonsA numbered list of pages that exists with next and previous buttons.

Action Bar

The action bar only exists in the Logs tab and it consists of:

  • The Actions button. This button is always disabled until you select at least one log file.
  • Number of file(s) you have selected in the list view.

The Actions button opens the Actions menu that contains two options: Download and Summarize.

The Download option enables you to save the file to your local machine. While the Summarize option enables you to create a summary file for several log files.

CMC Logs Manager Actions

Using the CMC Logs Manager, you can perform the following actions:

  • Search the log files
  • Sort and filter the log files list
  • Download log files
  • Summarize log files
  • Download a summarized log file

Search the Log Files

Logs

In the Logs tab, to search for the log files you must do the following:

  • Select a date range.
Note

The date range cannot be more than five days span.

  • Choose a cluster.
  • (Optional) Choose a service.
  • (Optional) Choose a tenant.
  • Select Get Files.

Logs Summary History

In the Logs Summary History tab, to search for the summarized log files you must do the following:

  • Select a date range.
Note

The summary history files can be kept for only one month.

  • (Optional) Choose a cluster.
  • Select Get Files.

When you select Get Files, the CMC displays a list of all of the created log files according to the specified search criteria.

Sort and Filter the Log Files

In the Logs tab, you can sort the list of log files in ascending or descending order according to:

  • File creation date
  • File name
  • Service name
  • Node name
  • Service type
  • Tenant
  • Log type
  • File size

Also, you can filter the list with respect to the service type and the logs type.

In the Filter menu, you can select OK to apply the filter or select Reset to clear any filtration applied.

Download Log Files

In the Logs tab, select one or more log files to download. After viewing the log files in the list view, do the following:

  • Select one or more log files.
  • In the Action bar, select Actions, and then Download.

The CMC downloads a zipped file named logs_incorta.zip to your local machine. This file contains all of the logs you have selected to download.

Warning

You cannot download files whose size is more than 1GB.

Summarize Log Files

In the Logs tab, you must select more than one log file to summarize. If you selected only one file and tried to summarize it, an error message will appear on the screen:

[403] Cannot Summarize.

There are several file types that you can summarize, such as mySQL, Incorta, and Oracle.

Note

You cannot summarize Thread Dump or Catalina files or files that have a size of more than 1GB.

  • Select more than one log file.
  • In the Action bar, select Actions, and then Summarize.
Note

You can cancel the summarize process by selecting the cancel button from the Action bar.

  • Go to the Logs Summary History tab.
  • Select Get Files.

The CMC created a new file that summarizes all of the log files you have selected earlier.

Note

You can only run one summarization process at a time.

Logs Summary History File Details

In the Logs Summary History tab, and after you selected the Get Files button to display all of the available summary files, when you select the file name, a Log Summary pop-up window appears.

The log summary pop-up window displays two tabs:

  • Entity Mode, which groups the log summary per entity.
  • Service Mode, which groups the log summary per service.

Each tab contains a tree-based view for the entities and for each entity details.

Download Logs Summary History File

In the Logs Summary History tab, you can download the summary file as .csv or .json.

  • Select Get Files
  • Select csv or json from the Download As column.

The CMC downloads a .zip file to your local machine. This file contains the summarized logs either in .csv or in .json format.