oo

Troubleshooting Tools and Resources

The ability to quickly diagnose and resolve technical issues is vital. Familiarize yourself with the available tools and resources for troubleshooting problems in your Liferay Cloud projects:

With these tools and resources, you can track project activities, configure services, resolve technical issues, and more.

note

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, users can track resources used by each environment service. These application metrics include memory and CPU usage, as well as network data transfer.

Metrics are available for the default Liferay Cloud stack services: Webserver, Liferay, Search, Database, and Backup. CI metrics are also available in the infra environment.

View application metrics via the Monitoring page in the Liferay Cloud console

Users 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.

View and manage alerts via the Alerts page in the Liferay Cloud console

See Real-Time Alerts for more information.

Environment Activities

Users 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.

View environment activities from the Liferay Cloud console

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 terminal.

Application, status, and build logs are provided for each Liferay Cloud Service:

  • Application Logs: These logs list runtime information generated after the application is running and accessed by users.
  • Status Logs: These logs list orchestration layer information from the Kubernetes cluster.
  • Build Logs: These logs list build information generated as the application boots up.

View logs via the Logs page in the Liferay Cloud console

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.

Use the shell access tool in the Liferay Cloud console to see what's going on inside your application.

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

The self-healing functionality of Liferay Cloud 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: This probe indicates whether the service is running.
  • Readiness Probe: This 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 will automatically route to the remaining availability zones without the need for user action.

However, in a cross-region disaster, 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.

Users 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 on Subscribe to Updates, and select your preferred method of notification.

View the status of Liferay Cloud Platform systems.

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.

Environment administrators can enable or disable Support Access in the Settings page

See Support Access for more information.

Help Center

If you have questions not answered by Liferay Cloud Documentation or would like to report an issue, sign in to the Liferay Help Center to view subscription-only resources or submit a ticket.

View subscription-only resources or submit a ticket via the Liferay Help Center page

From here, users can access the Liferay Cloud Knowledge Base, Product Support, and Announcements.

Users 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.

note

Liferay Cloud notifications are only distributed to customers with an active Liferay Enterprise Subscription.

For additional support, users 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 the actual behavior and the expected behavior.

Capability:
Deployment Approach: