Environments
Your Magnolia PaaS Environments section contains critical information about your deployment’s health, response times, and overall usage. You can view Statistics about the environment by release, component, and date range or you can Manage your environments directly from your Cockpit.
The environments you see in this section of the Cockpit are those configured in your .gitlab-ci.yml file. |

Statistics
The Statistics tab reveals critical information about your Magnolia PaaS deployment and are broken down between Resources and Cache. You can find out more about each section by clicking the info icon in the Cockpit.
Select your Release, Component, and Date Range to display environment statistics.
This is found at the top of the Statistics page.

Item | Description | ||||
---|---|---|---|---|---|
Deadlocked threads |
Deadlocked threads indicate a blocked request, command, or action to Magnolia.
|
||||
Heap size |
The starting size, maximum size, and current size in
|
||||
Heap usage |
The percentage of JVM currently used by the Magnolia instance.
|
||||
Memory [MB] |
The starting size, maximum size, and current size in
|
||||
Response time & distribution |
The current average response time by quantile. The quantiles are
|
||||
Response time |
The average response time by quantile over time. The quantiles are 50%, 90%, 95%, and 99% of the measured response times.
|
Item | Description | ||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Last flush |
The date and time when the Magnolia default page cache was last flushed.
|
||||||||||||||||||||||||||||||||||
Cache hits |
Hits on the Magnolia default page cache by request category.
|
JCR content
The Environments tab displays information related to JCR content for your Magnolia PaaS project. From here, you can see metrics on the size of frontend environments within JCR workspaces as well as query or count node types on a workspace.
In this section, you need to select your desired Cluster ID, Release, and Pod as the metrics and results are related to the choices there.
The subsections below take you through all of the options from this section of the Cockpit.
JCR workspaces
In this JCR workspaces tab, you can see the number of nodes from the nt:base
type per JCR workspace. The table displays the name of the workspace and the size of the associated frontend environment.
JCR query
In the JCR query tab, you can see the most common node types in the applicable workspace including those shown below. You can also use the Query generator to county or query a certain node type per selected workspace.
-
mgnl:base
(website workspace) -
mgnl:area
(website workspace) -
mgnl:component
(website workspace) -
mgnl:asset
(dam workspace)
Query generator
To use the JCR Query generator:
-
Go to Environments > JCR content > JCR query (tab).
-
Scroll to the Query generator.
-
Select a Workspace.
-
Select a Node type.
-
Select Count or Query.
Count counts the number of node types per workspace.
Query queries the node types in a workspace to show you the paths.
-
Persistence database
The Persistence database gives you an area to quickly see the size of the database. This is displayed under Database size at the top of the page. You can also see the size per table which is shown in the table on the tab.
Here, you can see:
-
The namespace
-
The database name.
-
The number of rows in the database.
-
The size of the database.
-
The relation size.
-
The index size.
-
The total size of the database.
Frontend metrics
The Frontend metrics tab show you important information about your Frontend environment(s). You can choose the Release, Component, and Date Range to drill down to more specific details.
View the metrics
To view the Frontend metrics:
-
Go to Environments > Frontend (tab) in your Cockpit.
-
Choose the Release you want to view.
-
Choose the Component you want to view.
-
Select the Date Range for the metrics.
-
Scroll down to the desired section(s) to see the results:
Currently, those sections are:
-
Frontend request rate (req/s): The frontend request rate measures the request rate over the specified interval chosen in the Date Range dropdown.
-
Average response time (s): This is the average response time of your Frontend in seconds over the specified interval chosen in the Date Range dropdown.
-
Average response size (bytes): This is the average response size of your Frontend requests in bytes over the specified interval chosen in the Date Range dropdown.
-

Use the slider on each section to narrow down the timeframe if you want. |
Manage your environments
Manage your environments via the Cockpit by going to Environments and selecting the Manage tab. You can manage both your integration and production (prod) environments here.
Within the environment, you are able to manage your Magnolia PaaS backend and frontend separately.
The examples and descriptions below apply to both backend and frontend environments as well as both author/public instances. |

No | Item | Description | ||
---|---|---|---|---|
|
Start |
Start your environment. |
||
|
Stop |
Destroys all instances down to |
||
|
Delete indexes |
Delete the environment’s indexes. See Delete an index for instructions.
|
||
|
Scale up |
Adds a public instance.
|
||
|
Scale down |
Destroys a single public instance.
|
Delete an environment
You can delete an environment directly from the Cockpit.
This action permanently deletes the selected environment and cannot be undone. |
Reset the superuser password
In case you get stuck, locked out of the Authoring environment, or simply need to reset the superuser
password for your author environment(s), you can do that directly via the Cockpit. Once you reset the superuser
password on the author environment, you can publish the new password to the public environment.
You must have administrator privileges to perform this action. |
Instructions
-
Go to Environments.
-
Click the Manage tab.
-
Scroll to the environment where you want to reset the password.
-
On the Authors instance, click the ellipsis to the right.
-
Choose Reset superuser password. A dialog will pop up
-
Enter the new password under Create new superuser password.
-
Confirm the new password under Confirm new superuser password.
-
Click Reset superuser pass. to officially reset the password.
-

Delete an index
You may want to completely delete the index for an environment. This can be done directly through the Cockpit.
Downtime varies depending on the amount of data associated with an index. To reduce the downtime, we use the rollingUpdate approach.
|
To delete the index folders:
-
Go to Environments.
-
Click the Manage tab.
-
Click Delete indexes for the desired environment.