From 8faa2e51ae99175341a7f79e1cc3b307d75f9923 Mon Sep 17 00:00:00 2001 From: CChislett Date: Fri, 9 Oct 2026 11:35:22 +0100 Subject: [PATCH 1/4] Restructure Applications into a section The Applications area is now four pages in the product nav (Applications Overview, Application Map, Application Details, Info), so split the single page to match, mirroring how Servers is organized. - Move applications.md to Applications/overview.md and reconcile the overview with the current UI: the metric cards are now a sortable Applications table (Span Name Count, Catalog/Create, Errors/s), and expanding a row reveals the five per-operation graphs. - Add the new Application Map page (server/app topology, Servers table). - Split the detail view into Application Details. - Add a redirect from the old applications URL. Info is not yet added, pending its screenshot. Co-Authored-By: Claude Opus 4.8 --- .../Applications/application-details.md | 55 ++++++++++++ .../Features/Applications/application-map.md | 54 +++++++++++ .../Features/Applications/overview.md | 51 +++++++++++ docs/Data-insights/Features/applications.md | 90 ------------------- mkdocs.yml | 6 +- 5 files changed, 165 insertions(+), 91 deletions(-) create mode 100644 docs/Data-insights/Features/Applications/application-details.md create mode 100644 docs/Data-insights/Features/Applications/application-map.md create mode 100644 docs/Data-insights/Features/Applications/overview.md delete mode 100644 docs/Data-insights/Features/applications.md diff --git a/docs/Data-insights/Features/Applications/application-details.md b/docs/Data-insights/Features/Applications/application-details.md new file mode 100644 index 00000000..02a2cbdd --- /dev/null +++ b/docs/Data-insights/Features/Applications/application-details.md @@ -0,0 +1,55 @@ +# Application Details + +The **Application Details** view shows deeper performance data for a specific application. + +Navigate to **Applications** > **Application Details** from the left-hand sidebar, or click into an application from the [Applications Overview](overview.md). + +--- + +## Filters + +| Filter | Description | +|---|---| +| **Application** | The selected application (e.g. QuoteCF) | +| **Show by** | Switch the Top 20 ranking between Throughput, Average Response Time, Max Response Time, and Error Count | +| **Status** | Filter transactions by HTTP status code | +| **Flavor** | Filter by transaction type (e.g. web request, JDBC) | +| **Min / Max Duration** | Filter transactions by duration range | +| **Adhoc Filters** | Add custom label-based filters | + +--- + +## Top 20 + +The **Top 20** panel on the left ranks individual transactions by the selected **Show by** metric, with a bar chart showing relative volume. + +--- + +## Metrics graphs + +The same metrics from the overview are shown here, scoped to the selected application: + +- Time Taken (%) +- Average Response Time +- Max Response Time +- Throughput +- Errors/s + +--- + +## Traces + +Below the graphs, a **Traces** table lists recent transactions: + +| Column | Description | +|---|---| +| **Trace ID** | Unique identifier - click to open the full trace | +| **Start time** | When the transaction began | +| **Service** | The service that handled the request | +| **Name** | HTTP method (GET, POST, etc.) | +| **Duration** | How long the transaction took | + +--- + +!!! question "Need more help?" + Contact support in the chat bubble and let us know how we can assist. diff --git a/docs/Data-insights/Features/Applications/application-map.md b/docs/Data-insights/Features/Applications/application-map.md new file mode 100644 index 00000000..ca457f95 --- /dev/null +++ b/docs/Data-insights/Features/Applications/application-map.md @@ -0,0 +1,54 @@ +# Application Map + +The **Application Map** shows how your servers and applications connect, as a topology you can pan and zoom. + +Navigate to **Applications** > **Application Map** from the left-hand sidebar. + +--- + +## Filtering the map + +A filter bar runs across the top: + +| Control | What it does | +|---|---| +| **Catalog / Label** | Switch between grouping the map by **Catalog** entry or by **Label** | +| **Select servers or apps** | Narrow the map to specific servers or applications | +| **Select Group** | Filter to a group | +| **Select Instance** | Filter to a specific instance | +| **Clear all** | Reset the filters | + +--- + +## The map + +Nodes are collected into groups - for example `Group: otlp-fr-demo · 1 server · 1 application` - with an arrow from each server to the applications running on it. Each node carries a badge for its type, **FR Server** or **FR App**, and a few live metrics: + +- A **server** node shows its instance ID, the number of **Apps**, and **Errors** per second with a sparkline +- An **application** node shows its **Spans** count and **Errors** per second + +The summary in the top-right corner counts what is on the map - servers, applications, and the total. **Left-click** to pan and **scroll** to zoom; the icons at the top-right of the panel switch to a 3D view and expand the map to full screen. + +--- + +## Servers + +Below the map, the **Servers** table lists the servers behind it, one row each: + +| Column | Description | +|---|---| +| **Group** | The group the server belongs to | +| **Job** | The job name | +| **Instance** | The instance ID - click to open it | +| **Apps** | How many applications run on the server | +| **Avg Req** | Average request time | +| **Errors/s** | Errors per second | +| **Throughput** | Requests per second | +| **CPU** | CPU usage | +| **Memory** | Memory usage | +| **Catalog** | The server's catalog status - **Create** if it is not yet in the [Catalog](../../../Admin-and-data/Catalog/catalog.md), or its badges (for example **FR Server**, **Java**) if it is | + +--- + +!!! question "Need more help?" + Contact support in the chat bubble and let us know how we can assist. diff --git a/docs/Data-insights/Features/Applications/overview.md b/docs/Data-insights/Features/Applications/overview.md new file mode 100644 index 00000000..a50cc1fc --- /dev/null +++ b/docs/Data-insights/Features/Applications/overview.md @@ -0,0 +1,51 @@ +# Applications Overview + +![Applications overview](../images/Applications/new-applications-overview.png) + +Monitor and analyze your application performance and behavior. + +Navigate to **Applications** > **Applications Overview** from the left-hand sidebar to view performance metrics across all your instrumented applications. + +--- + +## The applications table + +Your instrumented applications are listed in a single **Applications** table, one row per application with its key metrics over the selected time range. Use the **Application Filter** to search for a specific application by name. + +The metric columns show a sparkline alongside the current value: + +| Column | Description | +|---|---| +| **Application** | The application name | +| **Span Name Count** | The number of distinct span (operation) names recorded for the application | +| **Top Time Taken** | The highest time-taken percentage among the application's operations | +| **Avg Response** | Average response time across all transactions | +| **Max Response** | The slowest response time recorded in the period | +| **Throughput** | Requests per minute (c/m) | +| **Errors/s** | Errors per second | +| **Catalog** | **Create** adds the application to your [Catalog](../../../Admin-and-data/Catalog/catalog.md) | + +--- + +## Expanding an application + +Click the arrow at the start of an application's row to expand it into five graphs, each breaking a metric down by span (operation) name over the selected time range: + +- **Time Taken (%)** +- **Avg Response Time** +- **Max Response Time** +- **Throughput** +- **Errors/s** + +A legend under each graph lists the operations (for example `www.getquote.cfm` and `www.health.cfm`). Hover over any graph to see the values at a specific point in time. + +--- + +## Time range + +Use the **time picker** in the top right to adjust the time range for all graphs on the page - it defaults to the **Last 1 hour**. You can also highlight a section of a graph to zoom into that timeframe, and **Clear all** resets the filters. + +--- + +!!! question "Need more help?" + Contact support in the chat bubble and let us know how we can assist. diff --git a/docs/Data-insights/Features/applications.md b/docs/Data-insights/Features/applications.md deleted file mode 100644 index 11c791fb..00000000 --- a/docs/Data-insights/Features/applications.md +++ /dev/null @@ -1,90 +0,0 @@ -# Applications - - -![Applications overview](../../Data-insights/Features/images/Applications/new-applications-overview.png) - - -Monitor and analyze your application performance and behavior. - -Navigate to **Applications** from the left-hand sidebar to view performance metrics across all your instrumented applications. - ---- - -## Overview - -The Applications page displays an **Overview** of your applications, with two tabs: - -- **Servers** - view metrics grouped by server -- **Applications** - view metrics grouped by application - -Use the **Application Filter** to search for a specific application by name. - ---- - -## Metrics cards - -Each application is displayed as a set of metric cards showing performance data over the selected time range: - -| Metric | Description | -|---|---| -| **Time Taken (%)** | Percentage of time the application spent processing requests | -| **Average Response Time** | Average response time across all transactions | -| **Max Response Time** | The slowest response time recorded in the period | -| **Throughput** | Number of requests per minute (c/m) | -| **Error Count** | Number of errors returned by the application | - -Each card displays a time-series graph. Hover over any graph to see the values at a specific point in time. - ---- - -## Time range - -Use the **time picker** in the top right to adjust the time range for all graphs on the page. You can also highlight a specific section of a graph to zoom into that timeframe. - ---- - -## Application detail view - -Clicking into an application opens the detail view, showing deeper performance data for that specific application. - -### Filters - -| Filter | Description | -|---|---| -| **Application** | The selected application (e.g. QuoteCF) | -| **Show by** | Switch the top 20 ranking between Throughput, Average Response Time, Max Response Time, and Error Count | -| **Status** | Filter transactions by HTTP status code | -| **Flavor** | Filter by transaction type (e.g. web request, JDBC) | -| **Min / Max Duration** | Filter transactions by duration range | -| **Adhoc Filters** | Add custom label-based filters | - -### Top 20 - -The **Top 20** panel on the left ranks individual transactions by the selected **Show by** metric, with a bar chart showing relative volume. - -### Metrics graphs - -The same five metrics cards from the overview are shown here, scoped to the selected application: - -- Time Taken (%) -- Average Response Time -- Max Response Time -- Throughput -- Error Count - -### Traces - -Below the graphs, a **Traces** table lists recent transactions with: - -| Column | Description | -|---|---| -| **Trace ID** | Unique identifier - click to open the full trace | -| **Start time** | When the transaction began | -| **Service** | The service that handled the request | -| **Name** | HTTP method (GET, POST, etc.) | -| **Duration** | How long the transaction took | - ---- - -!!! question "Need more help?" - Contact support in the chat bubble and let us know how we can assist. diff --git a/mkdocs.yml b/mkdocs.yml index 1152f4aa..161f8d36 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -113,7 +113,10 @@ nav: - Info: Data-insights/Features/Servers/info.md - Crash Protection: Data-insights/Features/Servers/crash-protection.md - FAQ: Data-insights/Features/Servers/faq.md - - Applications: Data-insights/Features/applications.md + - Applications: + - Applications Overview: Data-insights/Features/Applications/overview.md + - Application Map: Data-insights/Features/Applications/application-map.md + - Application Details: Data-insights/Features/Applications/application-details.md - Database: Data-insights/Features/database.md - Services: - Overview: Data-insights/Features/Services/overview.md @@ -335,6 +338,7 @@ plugins: 'release-notes.md': 'Latest-updates/release-notes.md' 'Getting-started/DVCloud.md' : 'index.md' 'OP-billing/licenses.md' : 'Admin-and-data/Billing/Cloud/overview.md' + 'Data-insights/Features/applications.md' : 'Data-insights/Features/Applications/overview.md' markdown_extensions: From 2ebdc63b05414aeea6888e54098df57c0f684ef0 Mon Sep 17 00:00:00 2001 From: CChislett Date: Fri, 9 Oct 2026 11:41:27 +0100 Subject: [PATCH 2/4] Reconcile Application Details with the current UI Correct the carried-over detail page against the live view: the filter bar (Catalog/Label, Application, Show by, Status, Flavor, Duration), the Top 20 ranking operations by the chosen metric, the Metrics panel, and the Traces table's real columns (Service, Span Name, Spans, Services, Trace ID, Timestamp, Duration). Note the Overview/Info tabs. Co-Authored-By: Claude Opus 4.8 --- .../Applications/application-details.md | 51 +++++++++++-------- 1 file changed, 30 insertions(+), 21 deletions(-) diff --git a/docs/Data-insights/Features/Applications/application-details.md b/docs/Data-insights/Features/Applications/application-details.md index 02a2cbdd..e0483ae8 100644 --- a/docs/Data-insights/Features/Applications/application-details.md +++ b/docs/Data-insights/Features/Applications/application-details.md @@ -1,54 +1,63 @@ # Application Details -The **Application Details** view shows deeper performance data for a specific application. +The **Application Details** view breaks a single application down by operation, with ranked operations, per-operation metric graphs, and the traces behind them. -Navigate to **Applications** > **Application Details** from the left-hand sidebar, or click into an application from the [Applications Overview](overview.md). +Navigate to **Applications** > **Application Details** from the left-hand sidebar. The view has two tabs, **Overview** and **Info** - this page covers **Overview**. --- ## Filters -| Filter | Description | +A filter bar runs across the top: + +| Control | What it does | |---|---| -| **Application** | The selected application (e.g. QuoteCF) | -| **Show by** | Switch the Top 20 ranking between Throughput, Average Response Time, Max Response Time, and Error Count | -| **Status** | Filter transactions by HTTP status code | -| **Flavor** | Filter by transaction type (e.g. web request, JDBC) | -| **Min / Max Duration** | Filter transactions by duration range | -| **Adhoc Filters** | Add custom label-based filters | +| **Catalog / Label** | Group by **Catalog** entry or by **Label** | +| **Application** | Select the application to inspect | +| **Show by** | Choose the metric the Top 20 is ranked by (for example **Throughput**) | +| **Select Status** | Filter transactions by HTTP status code | +| **Select Flavor** | Filter by transaction type (for example a web request or JDBC) | +| **Duration** | Filter transactions by duration | +| **Clear all** | Reset the filters | --- ## Top 20 -The **Top 20** panel on the left ranks individual transactions by the selected **Show by** metric, with a bar chart showing relative volume. +The **Top 20** panel on the left ranks the application's operations by the selected **Show by** metric - its heading reflects the choice, for example **Top 20 - Throughput**. Each row shows the operation (such as `www/getquote.cfm`), its total, and a bar for relative volume. --- -## Metrics graphs +## Metrics + +The **Metrics** panel shows five graphs for the application, each broken down by operation over the selected time range: -The same metrics from the overview are shown here, scoped to the selected application: +- **Time Taken (%)** +- **Avg Response Time** +- **Max Response Time** +- **Throughput** +- **Errors/s** -- Time Taken (%) -- Average Response Time -- Max Response Time -- Throughput -- Errors/s +A legend under each graph lists the operations. Collapse the panel with the **Metrics** tab on its left edge. --- ## Traces -Below the graphs, a **Traces** table lists recent transactions: +Search by **Trace ID** above the table, or browse the **Traces** list of recent transactions: | Column | Description | |---|---| +| **Service** | The service that handled the request - an error icon marks a trace that contains errors | +| **Span Name** | The operation, such as `GET` or `POST`; a trace whose root span has not arrived yet reads *<root span not yet received>* | +| **Spans** | Number of spans in the trace | +| **Services** | Number of services the trace touched | | **Trace ID** | Unique identifier - click to open the full trace | -| **Start time** | When the transaction began | -| **Service** | The service that handled the request | -| **Name** | HTTP method (GET, POST, etc.) | +| **Timestamp** | When the transaction occurred | | **Duration** | How long the transaction took | +The table loads the most recent 100 traces and fetches more as you scroll. + --- !!! question "Need more help?" From 74b7ccf5dc16bc608bf241ecd589d846e6d422b6 Mon Sep 17 00:00:00 2001 From: CChislett Date: Fri, 9 Oct 2026 11:47:55 +0100 Subject: [PATCH 3/4] Add the Applications Info page Document the Info tab: it shows an application's catalog information (owner, tier, dependencies), with an empty state and Add to catalog button when the application has no catalog entry. Adds it as the fourth page in the Applications nav section. Co-Authored-By: Claude Opus 4.8 --- .../Features/Applications/info.md | 18 ++++++++++++++++++ mkdocs.yml | 1 + 2 files changed, 19 insertions(+) create mode 100644 docs/Data-insights/Features/Applications/info.md diff --git a/docs/Data-insights/Features/Applications/info.md b/docs/Data-insights/Features/Applications/info.md new file mode 100644 index 00000000..896f5019 --- /dev/null +++ b/docs/Data-insights/Features/Applications/info.md @@ -0,0 +1,18 @@ +# Info + +The **Info** tab shows an application's catalog information - its owner, tier, and dependencies. + +Navigate to **Applications** > **Info** from the left-hand sidebar, or open the **Info** tab in [Application Details](application-details.md). Use the **Catalog / Label** toggle and the **Application** selector to choose an application. + +--- + +## Catalog information + +When the selected application has a [Catalog](../../../Admin-and-data/Catalog/catalog.md) entry, Info shows what the catalog holds for it - its **owner**, **tier**, and **dependency** information. + +If the application is not yet catalogued, Info shows an empty state - *"This application has no catalog entry, so there is no owner, tier or dependency information for it"* - with an **Add to catalog** button to create one. + +--- + +!!! question "Need more help?" + Contact support in the chat bubble and let us know how we can assist. diff --git a/mkdocs.yml b/mkdocs.yml index 161f8d36..6374cfd4 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -117,6 +117,7 @@ nav: - Applications Overview: Data-insights/Features/Applications/overview.md - Application Map: Data-insights/Features/Applications/application-map.md - Application Details: Data-insights/Features/Applications/application-details.md + - Info: Data-insights/Features/Applications/info.md - Database: Data-insights/Features/database.md - Services: - Overview: Data-insights/Features/Services/overview.md From 13cfa3a5acab6abbcef79f4e80756af59a1e4527 Mon Sep 17 00:00:00 2001 From: CChislett Date: Mon, 12 Oct 2026 09:23:53 +0100 Subject: [PATCH 4/4] Remove the stale Applications overview screenshot The header image predated the table/expandable-row redesign, so drop the reference for now rather than show an out-of-date layout. The image file is left in place for a future refresh. Co-Authored-By: Claude Opus 4.8 --- docs/Data-insights/Features/Applications/overview.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/Data-insights/Features/Applications/overview.md b/docs/Data-insights/Features/Applications/overview.md index a50cc1fc..98bc4947 100644 --- a/docs/Data-insights/Features/Applications/overview.md +++ b/docs/Data-insights/Features/Applications/overview.md @@ -1,7 +1,5 @@ # Applications Overview -![Applications overview](../images/Applications/new-applications-overview.png) - Monitor and analyze your application performance and behavior. Navigate to **Applications** > **Applications Overview** from the left-hand sidebar to view performance metrics across all your instrumented applications.