Guides you through checking the health status of Embedded Collectors in Cisco Crosswork, including viewing pod and application health, collecting logs and metrics, tracking Showtech jobs, adjusting log levels, and performing collector lifecycle actions such as install, upgrade, activate, and uninstall.
View the operational health and status of all embedded collectors in Cisco Crosswork.
The CW Embedded Collectors and Offload Components tile provides the operations and health summary of Embedded Collectors. You can find information about the health of pods running on the Crosswork container on this page. The overall health of the Embedded Collectors application depends on the health of each individual pod service.
Figure 1. Crosswork Embedded Collector and Offload Component
Procedure
1.
From the main menu, choose Administration > Crosswork Manager > CW Embedded Collectors and Offload Components.
You can see the health and status summary of embedded collectors, along with detailed pod health information, in the displayed pane.
2.
Optionally, use the Showtech Options drop-down to:
Request All: Collects both logs and metrics for the embedded collectors. To view the logs, navigate to Crosswork Manager > Application Management > Showtech Requests.
Request Metrics: Collects only metrics information.
Request Logs: Collects only log information.
View Showtech Jobs: Displays the progress and status of Showtech jobs. You can also see job details from Crosswork Manager > Application Management > Showtech Requests.
Change Log Level: Changes the log level of selected Embedded Collector components, such as collectors (e.g., cli-collector) and infrastructure services (e.g., oam-manager). The change affects only the targeted collector.
3.
Optionally, use the Application Actions drop-down to:
Install: Installs a new collector with profile, hostname, and management interface details from previous collectors.
Upgrade: Upgrades the collector to a newer version.
Activate: Activates selected collectors.
Uninstall: Removes the collector application. Uninstalling the application may interrupt ongoing collection jobs and cause data loss for current operations.
You have reviewed the current health status, accessed logs and metrics as needed, and can take corrective actions.
Monitor the collector's pod health
Ensure the health of the collector pod to maintain optimal collection performance. Take timely corrective action to prevent service disruption.
In the Embedded Collector and Offload Component pane, you can view a detailed overview of the health status of pods hosting collectors or microservices. We recommend regularly monitoring the health of the collector pods in your network. This helps avoid overloading and enables proactive corrective measures, such as adding more resources or reducing the load on the collector in a timely manner.
Figure 2. Microservices Tab
Procedure
1.
Go to Administration > Crosswork Manager > CW Embedded Collectors and Offload Components.
2.
Expand CW Embedded Collectors and Offload Components, then select Microservices.
3.
(Optional) In the Microservices tab, type the collector name in the Name field to locate the collector pod.
4.
(Optional) From this page, click under the Actions column to perform these actions:
Restart: restarts the collector pod. Restarting a pod disrupts the ongoing collection process. If you need to restart, start, or stop a process, we strongly advise consulting the Cisco TAC team.
Showtech Requests: displays the showtech jobs executed for the corresponding collector pod. To view the logs, go to Crosswork Manager > Application Management > Showtech Requests.
Request All: collects both logs and metrics of the pod. To view the logs, go to Crosswork Manager > Application Management > Showtech Requests.
Request Metrics: collects the metrics of the pod.
Request Logs: collects the logs of the pod.
View collector alarms and events
Enable users to monitor collector alarms and events to identify and remediate potential data collection issues.
Embedded Collectors in the Crosswork Network Controller generate alarms when anomalies prevent data collection. By monitoring these alarms, you can detect issues that affect collector performance and take necessary action.
Procedure
1.
From the Crosswork Network Controller UI, go to Administration > Crosswork Manager > CW Embedded Collectors and Offload Components.
The Alarms tab provides a consolidated list of all collector alerts and events.
Figure 3. Events
2.
Toggle between the Alarms and Events subtabs to view the respective details.
3.
Filter the alarms or events list by:
adjusting column filters,
changing the Active Alarms Only slider, and
adding or removing columns using the icon.
You can view all current collector alarms and events. This enables timely detection and troubleshooting of potential data collection issues.
under the Actions column to perform these actions:
icon.