Troubleshooting Tools and Resources
When you have an issue with your site, you need tools to diagnose and resolve technical issues quickly. Liferay Cloud provides you with tools and resources for troubleshooting problems:
- Application Metrics
- Real-Time Alerts
- Environment Activities
- Environment Logs
- Shell Access
- Self-Healing
- Disaster Recovery
- Liferay Cloud Platform Status
- Support Access
- Help Center
With these tools and resources, you can track project activities, configure services, resolve technical issues, and more.
Details are subject to your legal agreement with Liferay. For information about legal agreements and services, see the Liferay Legal page.
Application Metrics
With Liferay Cloud’s built-in monitoring, you can track resources used by each environment service. These application metrics include memory, CPU usage, and network data transfer.
Metrics are available for the default Liferay Cloud stack services: Web Server, Liferay, Search, Database, and Backup. CI metrics are also available in the infra environment.
You can also integrate Dynatrace’s advanced performance monitoring with production environments.
See Application Metrics for more information.
Real-Time Alerts
Liferay Cloud can alert system administrators of unexpected behaviors in a project. Examples of unexpected behaviors include auto-scaling events, higher than expected memory consumption, reaching the allotted CPU quota, and database connection issues.
View all environment alerts and set alert preferences via the Liferay Cloud console.
See Real-Time Alerts for more information.
Environment Activities
You can monitor environment activities via the Liferay Cloud console, where they are sorted into two sections: Builds and Deployments and General Activities.
View the status of builds, deployments, service activities, and more to help troubleshoot environment issues.
See Team Activities for more information.
Environment Logs
Environment logs are crucial for diagnosing and resolving technical issues in a project. Users can access and download environment logs via the Liferay Cloud console or your OS CLI.
Application, status, and build logs are provided for each Liferay Cloud Service:
- Application Logs: runtime information generated after the application is running and accessed by users
- Status Logs: orchestration layer information from the Kubernetes cluster
- Build Logs: build information generated as the application boots up
See Log Management for more information.
Shell Access
Command line tools in the Liferay Cloud console contribute to the developer’s workflow by delivering speed, control, traceability, scripting, and automation capabilities.
When troubleshooting issues, use the shell access tool to look inside your applications and see details not easily spotted in logs.
The shell is accessible in most services, including the liferay
, search
, and webserver
services. It can be used to access the server’s file system directly and run commands for troubleshooting purposes.
For example, you can run the following command from the liferay
service’s shell to test connection to an address or external server:
curl -v [address]
See Shell Access for more information.
Self-Healing
Liferay Cloud’s self-healing functionality detects if a service or application has become unresponsive and automatically initiates procedures to recover the unresponsive service. The platform uses probes to monitor the services.
Liferay Cloud offers two probes used in conjunction to manage applications:
- Liveness Probe: indicates whether the service is running
- Readiness Probe: indicates whether the service is ready to receive requests
See Self-Healing for more information about configuring each probe.
Disaster Recovery
In the event of a disaster, Liferay Cloud offers two strategies for project recovery: Automatic and Cross-Region.
Liferay Cloud’s automatic disaster recovery strategy replicates services between three availability zones within the same region. If an availability zone becomes unavailable, the load balancer routes to the remaining availability zones automatically without the need for user action.
In a cross-region disaster, however, user intervention is required. To learn more about cross-region disaster recovery tools and processes, see Configuring Cross Region Disaster Recovery.
See Disaster Recovery Overview to learn more about both disaster recovery strategies.
Liferay Cloud Platform Status
When troubleshooting technical issues, be sure to check that all Cloud Platform systems are operational.
You can view the status of Liferay Cloud Platform systems, planned maintenance windows, and incident history from the Liferay Cloud Platform status page.
To receive notifications of changes in the Cloud Platform’s status, click Subscribe to Updates and select your preferred method of notification.
See Liferay Cloud Platform Status for more information.
Support Access
Support Access is an optional environment setting that expedites troubleshooting by giving Liferay engineers direct access to a Liferay Cloud project environment.
By default, Support Access is enabled in each project environment, though administrators can disable it from the Settings page.
See Support Access for more information.
Help Center
If you have questions not answered by Liferay Cloud Documentation or want to report an issue, sign into the Liferay Help Center to view subscription-only resources or submit a ticket.
From here, you can access the Liferay Cloud Knowledge Base, Product Support, and Announcements.
You can also subscribe to receive email notifications of the latest Liferay Cloud Help Center Updates. These updates include new platform releases, service updates, and security alerts and patches.
Liferay Cloud notifications are only distributed to customers with an active Liferay Enterprise Subscription.
For additional support, you can contact one of Liferay’s global Support Centers by phone or submit a ticket via the Help Center page.
When submitting a ticket, please provide information regarding the build images currently in use, behavior or question you are facing, steps to reproduce the issue, and a description of both actual and expected behavior.