You are here
Host Template: Network - Cisco ACI - APIC
Monitor your Cisco ACI APIC Nodes with metrics for health state, usage information and a detailed summary of faults.
This Host Template includes the following Service Checks:
Service Check Name | Description | Default Thresholds (Warning, Critical) | UOM |
---|---|---|---|
ACI - APIC - CPU Usage | The live CPU usage for a given APIC | apic_cpu_usage=70,90 | % |
ACI - APIC - Disk Usage | The live disk usage for a given APIC | apic_disk_usage=70,90 | % |
ACI - APIC - Faults | A summary of all faults for a given APIC | apic_node_critical_faults=,0 apic_node_major_faults=,0 apic_node_minor_faults=0, apic_node_warning_faults=0, apic_node_info_faults=, apic_node_cleared_faults=, |
N/A |
ACI - APIC - Health State | The health state for a given APIC | N/A | N/A |
ACI - APIC - Memory Free | The live memory available for a given APIC | N/A | B |
ACI - APIC - Temperature | The live temperature for a given APIC | N/A | N/A |
Usage Instructions
Step 1: Add this Host Template
Add the Network - Cisco ACI - APIC 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.
For more information, refer to Opsview Knowledge Center - Adding Host Templates to Hosts.
Step 2: Add and configure variables required for this Host Template
The Service Checks in this Host Template use the following variables, and they will be added to your Opsview Monitor instance when you import the Opspack:
ACI_CREDENTIALS
The Value is not used and therefore can be set to anything. Override the arguments with your credentials.
Parameter | Position in Variable | Name | Description |
---|---|---|---|
--api-server-url | Arg1 | ACI API Server URL | The server URL for your Cisco ACI |
--username | Arg2 | ACI Username | The username for your Cisco ACI |
--password | Arg3 | ACI Password | The password for your Cisco ACI |
ACI_POD_ID
Parameter | Position in Variable | Name | Description |
---|---|---|---|
--pod-id | Value | ACI Pod ID | The ID of the pod |
ACI_NODE_ID
Parameter | Position in Variable | Name | Description |
---|---|---|---|
--node-id | Value | ACI Node ID | The ID of the node |
ACI_APIC_DISK
This variable can be added multiple times to monitor each disk partition individually. Additionally, giving this argument a value of '.
' (period character, no quotes) will run the check across all disk partitions.
Parameter | Position in Variable | Name | Description |
---|---|---|---|
--disk-name | Arg1 | ACI Disk Name | The name of the ACI APIC disk to monitor |
--ignored-disks | Arg2 | ACI Ignored Disks | Comma separated names of disks to ignore, only used if running the check across all disks |
ACI_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.
Parameter | Position in Variable | Name | Description |
---|---|---|---|
--fault-severity | Arg1 | ACI Fault Severity | The minimum severity level of faults to display |
--fault-limit | Arg2 | ACI Fault Limit | The maximum number of faults to display |
For more information, refer to Opsview Knowledge Center - Adding Variables to Hosts.
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 Check Name | Mode |
---|---|
ACI - APIC - CPU Usage | ACI.APIC.CPU |
ACI - APIC - Disk Usage | ACI.APIC.Disk |
ACI - APIC - Faults | ACI.APIC.Faults |
ACI - APIC - Health State | ACI.APIC.Health |
ACI - APIC - Memory Free | ACI.APIC.Memory |
ACI - APIC - Temperature | ACI.APIC.Temperature |
SSL Certificates
Additionally, if ssl verification is required, you can use the following variable to pass in your SSL certificates for use when connecting to the service provider to gather metrics:
ACI_CERTIFICATES
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. Optional, only required if server verification is needed |
--client-cert | Arg2 | Client Certificate Path | Path to the Client Certificate. Optional, only required if client verification is needed |
--client-key | Arg3 | Client Key Path | Path to the Client Key. Optional, only required if client verification is needed |