Document Tree
Document Properties
Kbid
M27696
Last Modified
05-Apr-2022
Added to KB
20-Jul-2016
Public Access
Everyone
Status
Online
Doc Type
References
Product
  • ICM 7.10
  • ICM 11
  • ICM 12
Reference - System Monitoring

Introduction

This reference lists the monitoring options provided with the monitoring module of the System Management application. It is addressed to system administrators or DevOps who configure, maintain and monitor Intershop Commerce Management instances.

Info

Prior to Intershop version 7.7 the information provided in this document were part of the Administration and Configuration Guide that can be found in the Knowledge Base.

The System Management monitoring module is the main system monitoring tool. Using this module, system administrators can monitor the properties, process information, current threads and requests of all server components in the Intershop Commerce Management system. This information can be used for advanced debugging, profiling and troubleshooting purposes in an Intershop Commerce Management installation.

For details about accessing and using the monitoring module, refer to the System Management online help.

For additional monitoring options, refer to Guide - JMX and MBean Support.

The following tables outline the available monitoring options, sub-section by sub-section.

Prometheus Metrics

Prometheus metrics are introduced step by step starting with ICM 7.10

Servlet Metrics

MetricTypeFilterDescription
servlet_metrics_bucket
histogram
  • path
  • method
  • le
Request handler execution times
servlet_metrics_count

  • path
  • method

servlet_metrics_sum

  • path
  • method

Database Connection Metrics

MetricTypeFilter
intershop_jdbc_datasource_created
counter

intershop_jdbc_datasource_current
gauge

intershop_jdbc_datasource_closed
counter

intershop_jdbc_connections_created
counter

intershop_jdbc_connections_closed
counter

intershop_jdbc_pool
gauge
  • name
  • state

Number of connection in database connection pool for given states:

  • active
  • idle
  • minIdle
  • maxIdle
  • maxTotal

Caches

MetricTypeFilter
intershop_cacheclear_ignoredkeys_total
counter
  • cache

intershop_cacheclear_processing_count
gauge
  • cache

intershop_cacheclear_processing_sum
gauge
  • cache

intershop_objectcache_hit_total
counter
  • cache

intershop_objectcache_miss_total
counter
  • cache

intershop_objectcache_requests_total
counter
  • cache

intershop_objectcache_hit_ratio
gauge
  • cache

intershop_objectcache_size
gauge
  • cache

Messaging

MetricTypeFilter
intershop_messaging_messages_sent_total
counter
  • channel
  • type

intershop_messaging_messages_received_total
counter
  • channel
  • type

intershop_messaging_messages_processing_count
counter
  • channel
  • type

intershop_messaging_messages_processing_sum
counter
  • channel
  • type

intershop_messaging_protocol_messages_received_total
counter
  • channel
  • type

intershop_messaging_protocol_bytes_sent_total
counter
  • channel
  • type

intershop_messaging_protocol_bytes_received_total
counter
  • channel
  • type

intershop_messaging_protocol_messages_rejected_total
counter
  • channel
  • type

intershop_messaging_protocol_threads_spawned_total
counter
  • channel
  • type

JVM Metrics

JVM metrics contain information about. The following table contains provided standard metrics of Prometheus library.

MetricFilter
jvm_info

jvm_gc_collection_seconds_count
  • gc
jvm_gc_collection_seconds_sum
  • gc
jvm_memory_bytes_used
  • area
jvm_memory_bytes_committed
  • area
jvm_memory_bytes_max
  • area
jvm_memory_bytes_init
  • area
jvm_memory_pool_bytes_used
  • pool
jvm_memory_pool_bytes_committed
  • pool
jvm_memory_pool_bytes_max
  • pool
jvm_memory_pool_bytes_init
  • pool
jvm_memory_pool_allocated_bytes_total
  • pool
jvm_threads_current 

jvm_threads_daemon 

jvm_threads_peak 

jvm_threads_started_total 

jvm_threads_deadlocked

jvm_threads_deadlocked_monitor 

jvm_threads_state
  • state

SMC Monitoring Pages

Application Server

Monitoring Item

Description

Process Information

Displays general information about the application server (process ID, startup date, cluster ID, server groups), and about its Web front service (port, handler thread number, etc.)

Resource Usage

Displays information about the current server process (CPU usage, total process size, in-memory size, used system threads).

Properties

Displays the properties that are currently known by the application. This list contains aggregated properties from a number of *.properties files, for example the global and local appserver.properties, orm.properties, all cartridge *.properties files, and staging.properties.

Note

Sensitive properties may be hidden (seeSensitive Properties Settings).

Sessions and Requests

Displays information about the session management options and session and request statistics for the server.

Configuration Values

Enables the retrieval of configuration data from an application server. Configuration values can be retrieved from the scope, domain, application and key (displaying all of the values for each instance of a particular key).

Java VM

Monitoring Item

Description

Resource Usage

Displays information about the Java Virtual Machine (total heap size, used heap size, used/total heap ratio)

Threads

Displays all threads that currently exist in the Java Virtual Machine

System Properties

Displays all the system properties of the application server's JVM

OR Mapping

Monitoring Item

Description

ORM Cache

Displays general information about the ORM cache such as number of cached instances, cache synchronization information, or persistent objects in the cache

Persistent Object Information

Displays information about the selected persistent object on the monitored server (number of instances in cache, default reference type)

JDBC

Monitoring Item

Description

Drivers

Displays information about the registered JDBC drivers

Data Sources

Displays general data source information and Oracle connection cache information

Cartridges

Monitoring Item

Description

Loaded Cartridges

Lists all cartridges loaded on the server and shows basic cartridge information (name, display name, version, build, cartridge directory, JAR files)

Loaded Pipelets

Lists all pipelets loaded on the server

Duplicated Pipelets

Generates a list of duplicate pipelets on the server

Performance

Monitoring Item

Description

Configuration

Configures and activates/deactivates the Performance Monitor types (request, pipeline, class, managed service, object path, pagelet, pipelet, query, SQL and template) and displays the current monitoring state (active/inactive)

You can also set values to be written to a log.

Compare Performance Monitoring Results

Select a sensor and base report data to make a performance comparison to another report (across all sites).

A sensor is a Request, Pipeline, Class, Managed Service, Object Path, Pagelet, Pipelet, Query, SQL or Template.

Performance by Domain and Site

Select a specific site and display request performance.

Values are returned for hits, total time, effective time, average time minimum time and maximum time.

Performance by Type

Select a specific type of performance measurement and display the values across all sites.

Background

Monitoring Item

Description

Configuration

Displays the current background monitoring state and allows for switching it on or off and adjusting the timeout between two measurement cycles

Memory Charts

Shows the memory usage of the running server (process memory, JVM memory, ORM cache memory) in graphs

Session Charts

Displays graphical information about the sessions of the running server (total sessions, active sessions, active requests)

Performance Charts

Displays detailed information about the performance of the running server (average response time, CPU usage, load factor, thread count)

Note

The Configuration dialog allows for specifying a new monitor pipeline. Intershop strongly recommends to keep the default settings. Unless you have implemented a custom monitor pipeline or added a custom start node to the existing one.

Database Status

Before you can monitor the database status, you have to execute the script DBMonitorGrants.sql, located in <IS.INSTANCE.LOCAL>/bin.

Monitoring Item

Description

Database Status

Displays detailed information about database configuration and performance. Select one of the reports from the list box to display the corresponding information.

Locking

Monitoring Item

Description

Named Resources

Displays information about named resources

Named resources are virtual entities. Every named resource is identified by a unique name. Named resources can have a hierarchical structure.

Instance Resources

Displays information about instance resources

Instance resources are created dynamically. Every instance resource represents an instance of a PersistentObject.

Processes

Displays information about Intershop Commerce Management processes, such as data replication processes, import processes and scheduled jobs

Locking Conflicts

Displays information about resource acquisition problems

Resource acquisitions problems occur if a process tries to acquire a resource that is already locked by another process.

Services

This section summarizes the service providers that are integrated into your system. The overview page lists the services and their statuses in the site and application server contexts, grouped by service type.

Clicking a service name opens a detail view, which is divided into two tabs. The Monitoring tab shows more, fine-grained operation details, whereas the Maintenance tab provides options to enable/disable, ping or test the current service.

Disclaimer
The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.
Home
Knowledge Base
Product Releases
Log on to continue
This Knowledge Base document is reserved for registered customers.
Log on with your Intershop Entra ID to continue.
Write an email to supportadmin@intershop.de if you experience login issues,
or if you want to register as customer.