> For the complete documentation index, see [llms.txt](https://docs.catalyx.solutions/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.catalyx.solutions/catalyx-blockchain-manager/canton-network/version-2.0/console-guide-canton/applications.md).

# Applications

Application component-level health and resource usage across every validator.

<div data-with-frame="true"><figure><img src="https://2680825251-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsUGPGTcyMu8FXsdY8XQY%2Fuploads%2Fgit-blob-58fbd347000a111d7790db70421157b6cb2fc1f6%2Fimage%20(169).png?alt=media" alt=""><figcaption></figcaption></figure></div>

Where the Validators list is organised by validator, the Applications list is organised by **component**. It is the view to use when you are chasing a resource problem, a crash loop, or a configuration question about one specific workload.

{% hint style="info" %}
Applications are created and owned by the operator. Nothing on these screens changes them — to change a component, change the `Validator` resource that owns it.
{% endhint %}

## Overview

### Columns

<table><thead><tr><th width="150">Column</th><th>Contents</th></tr></thead><tbody><tr><td><strong>Name</strong></td><td>The application resource name, <code>&#x3C;validator>-&#x3C;component></code>.</td></tr><tr><td><strong>Type</strong></td><td><code>Participant</code>, <code>Validator</code>, <code>Wallet UI</code>, <code>CNS UI</code>, <code>PQS</code>, or <code>Wallet Gateway</code>.</td></tr><tr><td><strong>Validator</strong></td><td>Link to the owning validator.</td></tr><tr><td><strong>Replicas</strong></td><td><code>ready / desired</code>.</td></tr><tr><td><strong>Restarts</strong></td><td>Container restart count.</td></tr><tr><td><strong>CPU</strong></td><td>Utilisation bar and percentage, with <code>used / limit</code> beneath.</td></tr><tr><td><strong>Memory</strong></td><td>Same, in bytes.</td></tr><tr><td><strong>Status</strong></td><td><code>Ready</code>, or the operator's reason for not being ready, or <code>Unknown</code>.</td></tr><tr><td><strong>Metrics</strong></td><td>Grafana dashboard link. Participant components only.</td></tr><tr><td><strong>Logs</strong></td><td>Grafana logs link.</td></tr></tbody></table>

### States

| Situation            | What you see                                                                                             |
| -------------------- | -------------------------------------------------------------------------------------------------------- |
| No applications      | **No applications found** — *No Canton applications are deployed in this cluster.*                       |
| Filtered, none match | **No applications for this validator** — *No Canton applications are deployed for validator "`<name>`".* |
| Load failed          | **Failed to load applications**, with the error                                                          |

***

## Application details

<div data-with-frame="true"><figure><img src="https://2680825251-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsUGPGTcyMu8FXsdY8XQY%2Fuploads%2Fgit-blob-502fc24f7f3fb6ac0df8a4fb74bf4ad2e677fbb0%2Fimage%20(170).png?alt=media" alt=""><figcaption></figcaption></figure></div>

Clicking a row opens a single scrolling page.

### Overview Cards

<div data-with-frame="true"><figure><img src="https://2680825251-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsUGPGTcyMu8FXsdY8XQY%2Fuploads%2Fgit-blob-396c78af8e1cd3c557556487c5edddef77184f09%2Fimage%20(171).png?alt=media" alt=""><figcaption></figcaption></figure></div>

| Column   | Contents                                                                       |
| -------- | ------------------------------------------------------------------------------ |
| Status   | `Ready`, or the operator's reason for not being ready, or `Unknown`.           |
| Replicas | `ready / desired`.                                                             |
| Restarts | Container restart count.                                                       |
| Type     | `Participant`, `Validator`, `Wallet UI`, `CNS UI`, `PQS`, or `Wallet Gateway`. |
| Port     | The port the component's service listens on.                                   |
| CPU      | Utilisation bar and percentage, with `used / limit` beneath.                   |
| Memory   | Same, in bytes.                                                                |

### Resources by replica

<div data-with-frame="true"><figure><img src="https://2680825251-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsUGPGTcyMu8FXsdY8XQY%2Fuploads%2Fgit-blob-65444d225722fa606ad9abc525802ea519a2773b%2Fimage%20(172).png?alt=media" alt=""><figcaption></figcaption></figure></div>

| Column                                  | Contents                                       |
| --------------------------------------- | ---------------------------------------------- |
| **Replica**                             | The pod name                                   |
| **Phase**                               | The Kubernetes pod phase. `Running` is healthy |
| **Restarts**                            | Restart count for that pod                     |
| **CPU (used / limit)** · **CPU req**    | CPU usage against limit, and the request       |
| **Memory (used / limit)** · **Mem req** | Memory usage against limit, and the request    |

{% hint style="warning" %}
If a note says the cluster metrics API is not reachable, `metrics-server` is missing or unhealthy. Requests and limits still show; live usage does not.
{% endhint %}

### Endpoints

<div data-with-frame="true"><figure><img src="https://2680825251-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsUGPGTcyMu8FXsdY8XQY%2Fuploads%2Fgit-blob-d2264b8add26c83ec2b5e2259ea5c9a0e2c59750%2Fimage%20(173).png?alt=media" alt=""><figcaption></figcaption></figure></div>

**Internal** and **External** URLs, plus **Metrics** and **Logs**, which render as **Open in Grafana** links.

### Conditions

<div data-with-frame="true"><figure><img src="https://2680825251-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsUGPGTcyMu8FXsdY8XQY%2Fuploads%2Fgit-blob-f8df213bd33cf1aa37fee33a671947119a1183c3%2Fimage%20(174).png?alt=media" alt=""><figcaption></figcaption></figure></div>

The component's Kubernetes conditions — **Type**, **Status**, **Reason**, **Message**, **Last transition**. `DeploymentNotFound` means the workload has not been created yet; `DeploymentUnavailable` means it exists but has too few available replicas.

### Environment variables

<div data-with-frame="true"><figure><img src="https://2680825251-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsUGPGTcyMu8FXsdY8XQY%2Fuploads%2Fgit-blob-43cc0d5e9c13e9eac29f742bf7f03ed6dcde3614%2Fimage%20(175).png?alt=media" alt=""><figcaption></figcaption></figure></div>

Every variable the operator set on the container, sorted by name, with a **Copy all** button that copies them as `NAME=value` lines.

{% hint style="info" %}
Values sourced from a Kubernetes Secret or another reference show a **`from secret`** or **`from ref`** badge instead of the value. Secret values are never displayed in the UI.
{% endhint %}

This is the most direct way to confirm how the operator configured a component — which auth URL the participant is using, which database it connects to, which network endpoints it was given.

### Specification

<div data-with-frame="true"><figure><img src="https://2680825251-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsUGPGTcyMu8FXsdY8XQY%2Fuploads%2Fgit-blob-370646431b72e1580463386f4126a3d1b4a7e249%2Fimage%20(176).png?alt=media" alt=""><figcaption></figcaption></figure></div>

The application resource's fields as **Field** / **Value** pairs, excluding the environment variables, which have their own section.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.catalyx.solutions/catalyx-blockchain-manager/canton-network/version-2.0/console-guide-canton/applications.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.