---
title: "Host Template: Infrastructure - Cisco UCS - Blade"
description: ""
url: "https://docs.itrsgroup.com/docs/opsview/6.11.7/opspacks/infrastructure-cisco-ucs-opspack/infrastructure-cisco-ucs-blade-host-template/index.html"
---## Overview

Monitor your Cisco UCS Blade server with metrics for overall health, usage information and a detailed summary of faults.

This Host Template includes the following Service Checks:

| Service&nbsp;Check&nbsp;Name | Description | Default&nbsp;Thresholds (Metric:&nbsp;Warning,&nbsp;Critical) | UOM |
|:-----------------------------|:------------|:------------------------------------------------:|:---:|
| UCS - Blade - Adaptors | Information on the adaptors connected to this Blade | N/A | N/A |
| UCS - Blade - Admin Power | Admin power of the Blade | N/A | N/A |
| UCS - Blade - Admin State | Admin State of the Blade | N/A | N/A |
| UCS - Blade - Association State | Association State of the Blade | N/A | N/A |
| UCS - Blade - Checkpoint | Latest checkpoint of the Blade | N/A | N/A |
| UCS - Blade - Connection Path | Connection Path of the Blade | N/A | N/A |
| UCS - Blade - Connection State | Connection State of the Blade | N/A | N/A |
| UCS - Blade - Discovery State | Discovery State of the Blade | N/A | N/A |
| UCS - Blade - Faults | Fault information for the Blade Server | blade_critical_faults: &#8203;N/A,`0`
blade_major_faults: &#8203;N/A,`0`
blade_minor_faults: &#8203;`0`,N/A
blade_warning_faults: &#8203;`0`,N/A
blade_info_faults: &#8203;N/A,N/A
blade_cleared_faults: &#8203;N/A,N/A | N/A |
| UCS - Blade - HBAs | Number of HBAs for the Blade | N/A | N/A |
| UCS - Blade - Local Storage Health | Health information for the Local Storage on this Blade | N/A | N/A |
| UCS - Blade - Local Storage Usage | Usage information for the Local Storage on this Blade | N/A | N/A |
| UCS - Blade - Managing Instance | Managing Instance of the Blade | N/A | N/A |
| UCS - Blade - Memory Unit Health | Information on the Memory Units connected to this Blade | N/A | N/A |
| UCS - Blade - NICs | Number of NICs for the Blade | N/A | N/A |
| UCS - Blade - Operability | Operability of the Blade | N/A | N/A |
| UCS - Blade - Operational State | Operational State of the Blade | N/A | N/A |
| UCS - Blade - Operational State Qualifier | Operational State Qualifier of the Blade | N/A | N/A |
| UCS - Blade - Power State | Power State of the Blade | N/A | N/A |
| UCS - Blade - Presence | Presence of the Blade | N/A | N/A |
| UCS - Blade - Processor Health | Information on the Processors connected to this Blade | N/A | N/A |
| UCS - Blade - Processor Usage | Processor usage of the Blade | cpu_usage: &#8203;N/A,N/A
cores_enabled: &#8203;N/A,`1:` | N/A |
| UCS - Blade - Revision | Revision number of the Blade | N/A | N/A |
| UCS - Blade - Threads | Number of Threads of the Blade | N/A | N/A |


**Note**


See details about [Monitoring Plugin thresholds here](https://www.monitoring-plugins.org/doc/guidelines.html#THRESHOLDFORMAT).



## Usage Instructions

Please review the overall [Infrastructure - Cisco UCS Opspack](https://docs.itrsgroup.com/docs/opsview/6.11.7/opspacks/infrastructure-cisco-ucs-opspack/infrastructure-cisco-ucs-opspack/index.html) documentation for details on prerequisites, known issues, and other necessary configurations that apply to all Host Templates in the Opspack.

### Add this Host Template

Add the **Infrastructure - Cisco UCS - Blade** Host Template to your Opsview Monitor host.
If the resource you're monitoring has no hostname or public IP, then open the **Advanced** settings pane and change **Host Check Command** to **Always assumed to be UP**.


**Note**


For more information, refer to the documentation on [Adding Host Templates to Hosts](https://docs.itrsgroup.com/docs/opsview/6.11.7/host/index.html#host-templates).



### Add and configure Variables

The Service Checks in this Host Template use the following variables, and they will be added to your Opsview Monitor instance alongside the Host Template:

- [**UCS_CREDENTIALS**](#ucs_credentials)
- [**UCS_BLADE_NAME**](#ucs_blade_name)
- [**UCS_CERTIFICATES**](#ssl-certificates-ucs_certificates)
- [**UCS_FAULT_SETTINGS**](#ucs_fault_settings)


**Note**


For more information, refer to the documentation on [Adding Variables to Hosts](https://docs.itrsgroup.com/docs/opsview/6.11.7/adding-a-new-variable/index.html#adding-a-variable-to-a-host).



### Apply Changes

Apply Changes and the system will now be monitored:

![View Output](https://docscdn.itrsgroup.com/opsview/images/opspacks-infrastructure-cisco-ucs-output-infrastructure-cisco-ucs-blade.png)

## Available Variables

### UCS_CREDENTIALS

The Value is not used and therefore can be set to anything. Override the arguments with your credentials.

| Plugin&nbsp;Parameter | Position&nbsp;in Variable | Name | Description |
|:---------------------:|:-------------------------:|:-----|:------------|
| N/A (Opsview UI Only) | Value | UCS Credentials | The credentials for your Cisco UCS |
| `--api-server-url` | Arg1 | UCS API Server URL | The server URL for your Cisco UCS Manager or CIMC Supervisor |
| `--username` | Arg2 | UCS Username | The username for your Cisco UCS user |
| `--password` | Arg3 | UCS Password | The password for your Cisco UCS user |

### UCS_BLADE_NAME


**Warning**


The actual DN name assigned to the blade must be used instead of the user-defined label name to help prevent UCS API retrieval errors. For example, given a Blade with a user label `Blade-1` and DN path `chassis-1/blade-1`, the correct argument to use would be `chassis-1/blade-1`.



| Plugin&nbsp;Parameter | Position&nbsp;in Variable | Name | Description |
|:---------------------:|:-------------------------:|:-----|:------------|
| `--blade-name` | Value | UCS Blade DN | Name of the Blade to monitor |

### UCS_FAULT_SETTINGS

The Value is not used and therefore can be set to anything. Override the arguments with your settings.

The fault severity must be one of; 'critical', 'major', 'minor', 'warning', 'info', 'cleared' (default: 'major').

The fault limit, limits the number of faults displayed (default: '10'). Leave this blank to display all faults.

| Plugin&nbsp;Parameter | Position&nbsp;in Variable | Name | Description |
|:---------------------:|:-------------------------:|:-----|:------------|
| N/A (Opsview UI Only) | Value | UCS Fault Settings | Optional configuration options for fault service checks |
| `--fault-severity` | Arg1 | UCS Fault Severity | The minimum severity level of faults to display |
| `--fault-limit` | Arg2 | UCS Fault Limit | The maximum number of faults to display |

### SSL Certificates: UCS_CERTIFICATES


**Opsview Cloud**


For Opsview Cloud customers, please contact [ITRS Support](https://www.itrsgroup.com/about/contact) for assistance with setting up certificate files, as they require Orchestrator access.



Additionally, you can use the **UCS_CERTIFICATES** variable to pass in your SSL certificates for use when connecting to the service provider to gather metrics:

The Value is not used and therefore can be set to anything. Override the arguments with your certificates.

| Parameter | Position in Variable | Name | Description |
|:---------:|:--------------------:|:-----|:------------|
| `--ca-path` | Arg1 | CA Certificate Path | Path to the CA Certificate |
| `--client-cert` | Arg2 | Client Certificate Path | Path to the Client Certificate |
| `--client-key` | Arg3 | Client Key Path | Path to the Client Key |

## Plugin help

Plugin: `check_cisco_ucs`


**Secure Args**


This plugin uses the [Secure Args](https://docs.itrsgroup.com/docs/opsview/6.11.7/configuration/secure-arguments/index.html) feature for argument passing.



For mode-specific help, run the plugin with the `-h -m <mode>` flags. This will list the required and optional Variable Arguments for that mode.
The appropriate mode for each Service Check is listed here:

| Service&nbsp;Check&nbsp;Name | Mode |
|:-----------------------------|:-----|
| UCS - Blade - Adaptors | `UCS.Blade.Adaptors` |
| UCS - Blade - Admin Power | `UCS.Blade.Admin.Power` |
| UCS - Blade - Admin State | `UCS.Blade.Admin.State` |
| UCS - Blade - Association State | `UCS.Blade.Association` |
| UCS - Blade - Checkpoint | `UCS.Blade.Checkpoint` |
| UCS - Blade - Connection Path | `UCS.Blade.Conn.Path` |
| UCS - Blade - Connection State | `UCS.Blade.Conn.State` |
| UCS - Blade - Discovery State | `UCS.Blade.Discovery` |
| UCS - Blade - Faults | `UCS.Blade.Faults` |
| UCS - Blade - HBAs | `UCS.Blade.HBA` |
| UCS - Blade - Local Storage Health | `UCS.Blade.Storage.Health` |
| UCS - Blade - Local Storage Usage | `UCS.Blade.Storage.Usage` |
| UCS - Blade - Managing Instance | `UCS.Blade.Managing.Inst` |
| UCS - Blade - Memory Unit Health | `UCS.Blade.Memory.Units` |
| UCS - Blade - NICs | `UCS.Blade.NIC` |
| UCS - Blade - Operability | `UCS.Blade.Operability` |
| UCS - Blade - Operational State | `UCS.Blade.Oper.State` |
| UCS - Blade - Operational State Qualifier | `UCS.Blade.Oper.Qual` |
| UCS - Blade - Power State | `UCS.Blade.Power` |
| UCS - Blade - Presence | `UCS.Blade.Presence` |
| UCS - Blade - Processor Health | `UCS.Blade.Processor.Health` |
| UCS - Blade - Processor Usage | `UCS.Blade.Processor.Usage` |
| UCS - Blade - Revision | `UCS.Blade.Revision` |
| UCS - Blade - Threads | `UCS.Blade.Threads` |


