lgdd / liferay-elastic-stack-demo

An example of using the Elastic Stack with Liferay and benefit from Elastic Observability features.

Liferay Elastic Stack Demo

An example of using the Elastic Stack with Liferay and benefit from Elastic Observability features.

• Components Overview
• Getting Started
  • Build
  • Customize
  • Run
  • Explore
• Screenshots
  • Elastic Observability
  • Docker Containers Metrics
  • Liferay Elastic APM

Components Overview

• Liferay: our main application
• Elasticsearch: the search engine for Liferay & the data store for our containers metrics and logs
• Elastic APM: server + agent to monitor Liferay
• Filebeat: aggregate logs from our containers
• Metricbeat: monitor usages from our containers
• Kibana: visualization tool for our data

Getting Started

Requirements

• Docker 19+

Build

docker-compose build

Customize

You can choose the Liferay image (edition and version), the Elastic APM Java Agent version and add a comma separated list of application packages for Elastic APM agent:

docker-compose build \
--build-arg LIFERAY_IMAGE=liferay/dxp:7.3.10-ga1 \
--build-arg ELASTIC_APM_AGENT_VERSION=1.21.0 \
--build-arg ELASTIC_APM_APPLICATION_PACKAGES=com.example

In the example above, it will start Liferay DXP 7.3.10 GA1, install and attach Elastic APM Java Agent 1.21.0 and track com.liferay (always included by default in docker-compose.yml) and com.example.

Run

docker-compose up -d

Explore

Explore indexes, logs and metrics on Kibana at http://localhost:5601.

Play with Liferay at http://localhost:8080 and deploy your applications under ./liferay/deploy.

Screenshots

Elastic Observability

Docker Containers Metrics

Liferay Elastic APM

License

MIT