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

Monitor your Cisco UCS Chassis 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 - Chassis - Admin State | Admin state of the Chassis | N/A | N/A |
| UCS - Chassis - Blades | Information on the Blade Servers connected to this Chassis | N/A | N/A |
| UCS - Chassis - Config State | Config state of the Chassis | N/A | N/A |
| UCS - Chassis - Connection Path | Connection path of the Chassis | N/A | N/A |
| UCS - Chassis - Connection State | Connection state of the Chassis | N/A | N/A |
| UCS - Chassis - Faults | Fault information for the Chassis | chassis_critical_faults: &#8203;N/A,`0`
chassis_major_faults: &#8203;N/A,`0`
chassis_minor_faults: &#8203;`0`,N/A
chassis_warning_faults: &#8203;`0`,N/A
chassis_info_faults: &#8203;N/A,N/A
chassis_cleared_faults: &#8203;N/A,N/A | N/A |
| UCS - Chassis - IO Cards | Information on the IO Cards on this Chassis | N/A | N/A |
| UCS - Chassis - Managing Instance | Managing Instance of the Chassis | N/A | N/A |
| UCS - Chassis - Operability | Operability of the Chassis | N/A | N/A |
| UCS - Chassis - Overall State | Overall state of the Chassis | N/A | N/A |
| UCS - Chassis - Power State | Power state of the Chassis | N/A | N/A |
| UCS - Chassis - PSUs | PSU stats for the Chassis | N/A | N/A |
| UCS - Chassis - Redundancy Qualifier | Redundancy qualifier of the Chassis | N/A | N/A |
| UCS - Chassis - Redundancy State | Redundancy state of the Chassis | N/A | N/A |
| UCS - Chassis - Revision | Revision number of the Chassis | N/A | N/A |
| UCS - Chassis - Thermal State | Thermal state of the Chassis | 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 - Chassis** 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_CHASSIS_NAME**](#ucs_chassis_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-chassis.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_CHASSIS_NAME

| Plugin&nbsp;Parameter | Position&nbsp;in Variable | Name | Description |
|:---------------------:|:-------------------------:|:-----|:------------|
| `--chassis-name` | Value | UCS Chassis Name | Name of the Chassis 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 - Chassis - Admin State | `UCS.Chassis.Admin` |
| UCS - Chassis - Blades | `UCS.Chassis.Blades` |
| UCS - Chassis - Config State | `UCS.Chassis.Config` |
| UCS - Chassis - Connection Path | `UCS.Chassis.Conn.Path` |
| UCS - Chassis - Connection State | `UCS.Chassis.Conn.State` |
| UCS - Chassis - Faults | `UCS.Chassis.Faults` |
| UCS - Chassis - IO Cards | `UCS.Chassis.IO.Cards` |
| UCS - Chassis - Managing Instance | `UCS.Chassis.Managing.Inst` |
| UCS - Chassis - Operability | `UCS.Chassis.Operability` |
| UCS - Chassis - Overall State | `UCS.Chassis.Overall` |
| UCS - Chassis - Power State | `UCS.Chassis.Power` |
| UCS - Chassis - PSUs | `UCS.Chassis.PSUs` |
| UCS - Chassis - Redundancy Qualifier | `UCS.Chassis.Redundancy.Qual` |
| UCS - Chassis - Redundancy State | `UCS.Chassis.Redundancy.State` |
| UCS - Chassis - Revision | `UCS.Chassis.Revision` |
| UCS - Chassis - Thermal State | `UCS.Chassis.Thermal` |


