Skip to content
Skip to search
Skip to footer

Cisco Crosswork Network Controller 7.2.x Administration Guide

Cisco Crosswork Network Controller 7.2.x Administration Guide

Monitor system health

Updated: August 14, 2026

Want to summarize with AI?

Provides an entry point to Crosswork Network Controller system health monitoring tasks.

This section provides tasks for opening Crosswork Network Controller monitoring dashboards and checking overall system health, microservices, alarms, events, installed applications, and job status.

Monitor system functions in real time

You can monitor the health of Crosswork Network Controller and any of its functions in real time, using a set of monitoring dashboards you can access from the Crosswork Manager window.

Crosswork Network Controller uses Grafana to create these dashboards. The dashboards display the graphical view of the product's infrastructure, using metrics collected in its database. You can use these dashboards to diagnose problems you may encounter with individual Crosswork Network Controller applications or their underlying services.

There are multiple monitor dashboards. Each dashboard is categorized by the type of functionality it monitors and the metrics it provides. This table lists some categories that may be available depending on which Crosswork Network Controller applications are installed.

Table 1. Monitoring dashboard categories
This dashboard category...	Monitors...
Change Automation	Playbook functions. Metrics include the number of MOP jobs executed, response latency, API calls, database activity, and so on.
Optima	Feature pack, traffic, and SR-PCE dispatcher functions.
Collection - Manager	Device-data collection functions. Metrics include telemetry collection latencies, total collection operations, memory and database activity related to telemetry, delayed collections, and so on.
Health Insights	Key Performance Indicator functions. Metrics include the number of KPI alerts, API calls, and so on.
Infra	System infrastructure messaging and database activity.
Inventory	Inventory manager functions. These metrics include total numbers of inventory change activities.
Platform	System hardware and communications usage and performance. Metrics include disk and CPU usage, database size, network and disk operations, and client/server communications.
ZTP	Zero Touch Provisioning functions.

To conserve disk space, Crosswork Network Controller maintains a maximum of 24 hours of collected metric data.

Grafana is an open-source visualization tool. This section provides general information about how to use the Crosswork Network Controller implementation of Grafana. For more information about Grafana itself, refer to https://grafana.com and http://docs.grafana.org

Procedure

1.

From the main menu, choose Administration > Crosswork Manager > System Summary.

2.

At the top right, click View More Visualizations.

The Grafana user interface appears.

3.

In the Grafana user interface, click Home. Grafana displays the list of monitoring dashboards and their categories, as shown in this example.

Grafana Dashboard list

4.

Click the dashboard you want to view. For example, when you click Platform - Summary dashboard, a view appears similar to one shown in the figure.

5.

Scroll the dashboard to display all the metrics, or select any of the functions described in the table.


Item	Description
1	Dashboard Icon : Click the icon to re-display the dashboard list and select a different dashboard.
2	Time Series Graph Zoom : You can zoom in on a specific time period within the graph of any time series data, as follows: Click a time-period starting point in the graph line and hold down the mouse. Drag the cursor to the endpoint. Light gray shading appears in the block you are selecting. When you reach the endpoint, release the mouse. To reset a zoomed time series graph to the default, click the Zoom Out icon.
3	Share Dashboard icon: Click the icon to make the dashboard you are viewing shareable with other users. Clicking this icon displays a pop-up window with tabs and options to share the dashboard in your choice of these forms: URL Link: Click the Link tab and then click Copy to copy the dashboard's URL to your clipboard. You can also choose whether to retain the current time and template settings with the URL. Local Snapshot File: Click the Snapshot tab and then click Local Snapshot. Grafana creates a local snapshot of the dashboard on the server. When the snapshot is ready, click Copy Link to copy the URL of the snapshot to your clipboard. Export to JSON File: Click the Export tab and then click Save to file. You are prompted to save or open the exported JSON file. You can also choose to turn data source names in the file into templates by selecting the Export for sharing externally checkbox before clicking Save to file. View JSON File and Copy to Clipboard: Click the Export tab and then click View JSON (you can choose to templatize data source names by selecting the Export for sharing externally checkbox before clicking View JSON). Grafana displays the exported JSON code in a popup window. Click Copy to Clipboard to copy the file to your clipboard.
4	Cycle View Mode icon: Click this icon to toggle between the default Grafana TV view mode and the Kiosk mode. The Kiosk view hides most of the Grafana menu. Press Esc to exit the Kiosk view.
5	Time/Refresh Selector: Indicates the time period for the metrics displayed in the dashboard and how often the metrics are refreshed. Click the selector to choose a different time range and refresh rate. You can specify a custom pair of time-range start and end points, or choose from one of several predefined ranges, such as Last 30 minutes or Last 3 hours. When you have finished making changes, click Apply. Note When making selections, remember only the last 24 hours of data is stored. If you select time ranges beyond that limit, the dashboard may be blank.
6	Show Application Details: Click this option to view details of the selected dashboard item.
7	Zoom Out icon: Click this icon to reset a zoomed time series graph back to the unzoomed state.
8	Refresh icon: Click this icon to immediately or choose time interval to refresh the data shown. You can choose predefined refresh rates from Off to 2 Days.

Check system health

In this example, you can navigate through the different windows and identify areas to check for a healthy Crosswork Network Controller system.

Procedure

	1.	Check overall system health. From the main menu, choose Administration > Crosswork Manager > Crosswork Summary tab. Check that all the nodes are in operational state (Up) and that the Crosswork Network Controller cluster and platform infrastructure are healthy. Figure 1. Crosswork Summary
	2.	Check and view detailed information about the microservices that run as part of the Crosswork Platform Infrastructure. Click the Crosswork Health tab. Expand the Crosswork Platform Infrastructure row, click , and select Application Details. From the Application Details window, you can check and review microservice details, restart microservices, and collect showtech information. You can also perform installation-related tasks from this window. Figure 2. Crosswork Health Figure 3. Application Details
	3.	Check and view the alarms and events related to the microservices. Click the Alarms tab. The list displays only Crosswork Platform Infrastructure alarms. You can further filter the list by viewing only active alarms. Click the Events tab. The list displays all Crosswork Platform Infrastructure events, and their corresponding alarms. Figure 4. Alarms
	4.	View which Crosswork Network Controller applications are installed. From the main menu, choose Administration > Crosswork Manager > Application Management tab and click Applications. This window displays all applications that have been installed. You can also click Add new file to install more applications by uploading another application bundle or an auto-install file.
	5.	View the status of jobs. Click the Job History tab. This window provides the information regarding the status of jobs and the sequence of events that have been executed as part of the job process.

Need help?

Open a support case

(Requires a Cisco Service Contract)

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.