If you are using the client-server model for Hazelcast on Pega Platform™, you can use the Hazelcast Management Center to gain insight into the client-server clusters. Management Center offers information about resource usage, topology, and a variety of distributed objects such as queues, topics, and maps.
For more information about the client-server mode of the Hazelcast service, see Configuring client-server mode for Hazelcast on Pega Platform.
This topic provides supporting information about deploying Management Center specifically for Pega Platform. To deploy and start the Hazelcast Management Center for Pega Platform, follow the instructions for your version of Management Center in the manual provided on the Hazelcast website.
Deploying Management Center for Pega Platform involves the following tasks:
- Configuring the Pega application server to point to Management Center
- Setting up and using optional features
Configuring the Pega application server to point to Management Center
When installing Management Center, you must configure the Pega application server to point to Management Center.
- On the application server, navigate to the prweb/WEB-INF/classes directory, and then open the prconfig.xml configuration file.
- Add the following line to the file:
<env name="cluster/hazelcast/managementconsole/url" value="http://<mancenter host IP>:8080/hazelcast-mancenter/" />
Save and close the configuration file.
Note: When logging in to Management Center for the first time, you create a user that has administrative privileges. This user has abilities that are beyond those of basic monitoring needs, such as running garbage collection or viewing data in a distributed map, which can contain consumer information protected under HIPAA.. Pega recommends that you create new users with the Metrics Only privilege. This privilege level does not have the ability to view sensitive data in the Hazelcast cluster. For more information about creating users for Management Center, see the user manual for your version of Management Center on the Hazelcast website.
Setting up and using optional features
The following table provides information about setting up and using optional features in Management Center with Pega Platform. For more information about these features, see the documentation for your version of Management Center on the Hazelcast website.
You can use Management Center to monitor all of the clients that connect to your Hazelcast cluster.
By default, Management Center only shows basic information for clients, such as client instance name, address, type, and labels. To see more advanced information, enable client statistics before starting your clients by setting the
If you are using encryption with the Management Center, perform the following steps:
Pega recommends that you enable the Time Travel feature. When this feature is enabled, Management Center records statistics about the cluster, such as CPU usage, garbage collector, and heap usage.
|Hazelcast Diagnostic Logging|
Hazelcast diagnostic logging is enabled by default for servers and is disabled for clients. The log file pega_hazelcast-diagnostics-<IP>-<timestamp>-<ID> provides information about the state of the Hazelcast cluster and is located in the same directory as your other Pega logs. Hazelcast uses a rolling file strategy to limit the size of the diagnostic logs. By default, Pega provides for a maximum of three files with a size of up to 50 MB each.
You can change thesdefault settings for your Hazelcast instance by configuring the following properties for Hazelcast logging in the prconfig.xml configuration file: