You can configure alerts to be delivered through email, webhooks, or in a Webex App space. Regardless of the delivery channel configured, all alerts will always appear in Control Hub. Read more about Alert center and alerts.

For devices, you can create rules to get alerts for:

  • Offline and online events. An event is registered after a device has been offline for approximately 10 minutes or has come back online for approximately 10 minutes ago.

  • Issues that are detected or resolved events. You can select if you want to receive all alerts or mute the ones that you don't wish to receive.

1

Sign in to Control Hub at https://admin.webex.com and select which option to follow.

  1. Single device: Go to Devices. Select one of the devices and click Create Rule on the device details page.

  2. Several devices: Go to Devices. Select the devices that you want to add a rule for and click Edit. From the side panel, click New alert.

  3. All devices: Go to Alerts center and click Manage. Click Create rule.

2

From Service select Devices. Then select the Type and Severity level.

You can give the alert a Title to make it easier to recognize. If you choose a Webex App space as a deliver method, the title is used as the name for that space.



3

Select the devices you want to receive alerts from.

  • Add up to 30 devices manually by writing the device name in the search field.

  • To monitor all devices, select All devices

  • Use saved searches as dynamic target. The dynamic target automatically adds and removes devices to match the saved search. Note that all administrators can see and manage all saved searches.

If you have selected one or more devices from the Devices page, the devices names show up here automatically.
4

If you are setting the alert for Issues detected or resolved events, you can choose to mute alerts you don't want to receive. Click the minus (-) icon next to the name in the Active issues list to move the issue to the Muted issues list.

To move an issue back to the Active issues list, click the plus (+) icon next to the issue in the Muted issues list.

5

Choose the delivery channel that you want to use to receive the alerts. Choose between Email, Webex App space, Webhook, or a combination.

To use the Webex space option, you must enable bots.

To use the webhook option, you must enable webhooks for alerts.

6

Click Save to create the rule.

You can find the rules you’ve created under the Manage tab. If you want to delete a rule you’ve created, select the rule, and click Delete rule.

Alerts for devices running RoomOS

The alert content depends on how you have chosen to receive the alerts. In the tables in this article, we cover all content types.

  • Control Hub: You receive Type and Message.

  • Webhooks: You receive Type and Code.

Account

DisplayName Code Type Message
Account missing accountmissing The owner of this device cannot be found The user or place that this device was associated with is no longer in your organization. Perform a factory reset on the device itself. You can then activate it for a different user or place. Alternatively, delete the device to remove it from this organization.
Valid passwords validpasswords Passphrase vulnerability One or more user accounts on this device does not have a passphrase set. Log into Local Device Controls and ensure all user accounts have passphrases.

AirPlay

DisplayName Code Type Message
Beacon airplaybeacon AirPlay beacon requires Bluetooth AirPlay is set to broadcast a beacon, but Bluetooth is not enabled.
Configuration airplayconfiguration AirPlay requires RoomOS 11 AirPlay is enabled, but won't be available until the RoomOS 11 GUI experience is enabled as well.
Provisioning airplayprovisioning AirPlay provisioning failure Unable to start AirPlay. Make sure you are connected to the Internet.
Provisioning certificates airplayprovisioningcertificates AirPlay provisioning failure There was an issue validating the hardware module certificates. Disable AirPlay and/or contact your Cisco technical support representative.

Amplifier

DisplayName Code Type Message
Detection amplifierdetection Audio amplifier not found The amplifier is required but was not detected. Users may lack audio. Verify the amplifier has power and check the connection between the amplifier and the device.
Fan status amplifierfanstatus System fan not working One or more of the system fans is not working. The camera may overheat. Contact your Cisco technical support representative.

Audio

DisplayName Code Type Message
Internal speaker disabled audiointernalspeakerdisabled Internal speaker disabled The internal speaker is disabled. It is possible to enable it again in 'All Configurations'.
Pairing interference audiopairinginterference Signal interference from other devices Audio pairing - Interference from other ultrasound sources. If you are prevented from pairing between this device and phones or laptops, try turning off the ultrasound on interfering devices, for example, other video devices.
Pairing noise audiopairingnoise Signal interference from other devices There is an ultrasound signal interference in this room from other devices (for example other video systems) that could prevent pairing with your phone and laptop. To resolve, try turning off the ultrasound on interfering devices.
Pairing rate audiopairingrate Unable to verify the ultrasound signal Unable to verify the ultrasound signal which enables pairing with phones and laptops. This could be due to a missing or faulty speaker, an external speaker that doesn't support ultrasound, the volume on an external speaker being too low, sub-optimal microphone placement, or interference from other ultrasound sources.
Pairing signal to noise ratio audiopairingsnr Audio pairing interference Audio pairing - Low signal to noise ratio. To resolve, try turning off the ultrasound on interfering devices.
Pairing token decode audiopairingtokendecode Audio pairing self token not decoded Audio pairing - Self token not decoded. This could be due to a missing or faulty speaker, an external speaker that doesn't support ultrasound, the volume on an external speaker being too low, sub-optimal microphone placement, or interference from other ultrasound sources.
Ec reference delay ecreferencedelay Audio delay The audio loop delay detected is at least: {{delay}} ms. There seems to be an audio delay introduced by the external equipment connected to the Collaboration device. This may reduce the quality of your meeting experience. Example: If an output TV/monitor is connected, try to find a low latency mode, usually this mode is called gaming or PC. Change the monitor settings to a suitable mode (for example Game mode).
Microphone overloaded microphoneoverloaded Microphone overload Overload detected on microphone {{OverloadedMicrophone}}. Overload of microphones will result in bad audio quality for people calling in to this system and may cause echo issues as well. Please reduce the microphone input level to solve this issue. To resolve, try moving the microphone further away from the sound source and/or reduce the level on any externally connected audio devices, such as mixers, DSPs.
Microphone reinforcement microphonereinforcement Microphone reinforcement misconfigured Microphone reinforcement will not work with current configuration. To fix this, go to Device Configurations > Audio, and check that local reinforcement has been enabled on both the wanted inputs and outputs. Otherwise, disable the setting.
Microphone connected microphonesconnected No microphones connected No microphones are connected to this device.

Battery

DisplayName Code Type Message
Stylus battery stylusbattery Pen batteries low Replace the batteries soon.

Call protocol

DisplayName Code Type Message
Ip stack platform compatibility callprotocolipstackplatformcompatibility Incompatible call protocol The device is configured to call using {{CallProtocolIPStack}}, but only {{IPStack}} is available. Log into Local Device Controls and verify the Conference 1 CallProtocol Stack and Network IPStack match or Network IPStack is set to Dual.
Vcs provisioning compatibility callprotocolvcsprovisioningcompatibility Incompatible VCS protocol The device is configured to call over {{CallProtocolIPStack}} which is incompatible with the {{prov}} address of the VCS. Log into Local Device Controls and verify that Conference CallProtocolIPStack matches the address type of Provisioning ExternalManager Address.
Default registered defaultcallprotocolregistered Call protocol misconfigured The device may not be able to receive or place calls as it is not registered on the default call protocol. Register the device with the selected default call protocol or log into Local Device Controls and change the default.
Invalid sip transport config invalidsiptransportconfig Unified CM security mode misconfiguration The security mode configured by Unified CM is unsupported or incompatible with the configured SIP transport. Verify the Unified CM security mode configuration. Log into Local Device Controls and see Diagnostics page for more details.
Sip encryption sipencryption Encrypted SIP unavailable The device does not support encryption. Setting SIP Transport to TLS will not work.
Sip ice and anat conflict sipiceandanatconflict SIP ICE and ANAT incompatible SIP ICE and Alternative Network Address Types (ANAT) are both enabled. You can only have one enabled at the time. Log into Local Device Controls and disable either SIP ICE or ANAT.
Sip listen port and registration siplistenportandregistration Potential high connection load There may be a high connection load on this device because the SIP ListenPort is on.
Sip or h323 but not both enabled siporh323butnotbothenabled Dual registration unsupported This device has both H.323 and SIP enabled, but these cannot be combined. It will always use SIP. Set either SIP Mode or H323 Mode to Off.
Sip profile registration sipprofileregistration SIP registration failed SIP registration failed. Check connectivity to the SIP proxy, and verify via Local Device Controls that the SIP configuration is correct. Log into Local Device Controls and see Diagnostics page for more details.
Sip profile type sipprofiletype SIP type mismatch This device may have problems calling because SIP Type is {{profile}} and vendor is {{vendor}}. Log into Local Device Controls and change configuration SIP Type to Cisco if registered to a CUCM, and to Standard if not.
Sip connection wxcsipconnection SIP not registered Webex services connected SIP not registered, Webex services connected.
Webex connection wxcwebexconnection SIP registered Webex services not connected SIP registered, Webex services not connected.
WebRTC calling webrtccalling Joining WebRTC calls will fail The organization is provisioned to use WebRTC to join meetings, but this device has WebEngine Mode turned off and cannot join meetings using WebRTC. Turn on Web Engine Mode in Device Configurations.

Camera

DisplayName Code Type Message
Pairing camerapairing Lost connection with camera The system can't connect to its camera. Check the cable connection, or download device logs and examine the camera.log file.

Companion mode

DisplayName Code Type Message
Incompability local companionmodeincompatibilitylocal Device incompatible with companion mode There may be unexpected behavior with this device because it is configured for Companion Mode, but it does not support it. Verify this is the only device activated in the place, or replace the device with one that is compatible with Companion Mode.
Incompability remote companionmodeincompatibilityremote Incompatible companion device There may be unexpected behavior with this device because it is configured for companion mode, but the companion device does not support it. Verify this is the only device activated in the place, or replace the other device with one that is compatible with Companion Mode.

Configuration

DisplayName Code Type Message
Configured for test automation configuredfortestautomation Configured for test automation Metrics and log reporting are affected.
Cucm and cloud configurability cucmandcloudconfigurability Cloud configurations could be overwritten This device has Control Mode set to Unified CM on the Unified CM. If Allow Control Hub to manage configurations is ever disabled in Control Hub, Unified CM will undo any configuration changes made in Control Hub.
Cucm vendor configuration file cucmvendorconfigurationfile Unified CM vendor configuration error Unified CM was unable to process the vendor configuration file. Refer to Unified CM documentation.

Display

DisplayName Code Type Message
Missing display missingdisplay Display not found One or more of the required displays was not detected. Users may not see remote participants or the shared content. Check the connections to all displays.
Missing third display missingthirddisplay Third display not found The third display is not connected. Users may not see shared content. Check the connection to the display.
Monitor delay monitordelay Monitor audio delay The monitor connected to this device is adding a delay to the audio. Change the monitor settings to a suitable mode (for example Game mode).

Macro

DisplayName Code Type Message
Error logged macroserrorlogged Macro errors logged One or more of the device's macros have logged errors. See the Macro Editor in Local Device Controls or the Macros window in the device details page in Control Hub for details.
Provisioning status macrosprovisioningstatus Macro provisioning failed The device failed to apply one or more of its provisioned macros. This is usually caused by the macro source code containing invalid JavaScript. See the macro provisioning page in Control Hub and the device logs for further details, and then use Control Hub to correct the problematic macro.
Runtime crashes macrosruntimehashadcrash Macro runtime crashes The macro runtime has reported one or more crashes. Some of the device's macros may not behave as expected. See the device logs for further details.
Runtime responsiveness macrosruntimeresponsiveness Unresponsive macro runtime The macro runtime is unresponsive, or its status cannot be read. The device's macros may not be running. See the device logs for further details.

Media

DisplayName Code Type Message
Blocking detected mediablockingdetected Network ports blocked Firewall may be blocking media on UDP and TCP. Call quality may be impacted. For information regarding the network port requirements see the article Network Requirements for Cisco Webex Services.
Protocol mediaprotocol Network ports blocked Firewall may be blocking media on UDP. Call quality may be impacted. For information regarding the network port requirements see the article Network Requirements for Cisco Webex Services.
Tcp media fallback tcpmediafallback Network ports blocked Firewall may be blocking media on UDP. Call quality may be impacted. For information regarding the network port requirements see the article Network Requirements for Cisco Webex Services.

Network

DisplayName Code Type Message
Current network quality currentnetworkquality Reduced audio and video quality Network issues might cause participants to experience reduced audio and video quality.
H320 gateway status h320gatewaystatus ISDN link pairing failed The ISDN link pairing failed, or the ISDN link is in an error state. Log into Local Device Controls and see ISDN Link and H.320 Gateway Status for more details.
H320 gatekeeper status h323gatekeeperstatus H.323 registration failed H.323 registration failed. Check connectivity to the H.323 gatekeeper and verify that the H.323 configuration is correct.
Isdn link ip stack isdnlinkipstack Wrong IP stack for ISDN link The device cannot connect to ISDN Link because IPStack configuration is set to IPv4. IPv6 is required for an ISDN Link connection.
Itl installation itlinstallation ITL verification failed The Initial Trust List could not be installed because its signature failed verification. Log into Local Device Controls and see Diagnostics page for more details.
Quality networkquality Packet loss detected During the last call we detected a level of packet loss that may have impacted the call quality. Packet loss is typically caused by network congestion.
Switch configuration networkswitchconfiguration Ethernet switches misconfigured The device has more Ethernet switches for peripherals configured than detected. Verify the configuration Peripherals Profile NetworkSwitches.
Thousand eyes status thousandeyesstatus ThousandEyes configuration error Please contact your ThousandEyes administrator.
Tls verify required certs tlsverifyrequiredcerts SIP encryption missing CA certificate Encrypted SIP has been enabled, but no CA certificate is installed. Log into Local Device Controls and add Security Certificates CA to fix TLS verification, or disable TLS verification in the SIP Configuration for unencrypted SIP traffic.
Vcs anatonvcs VCS proxy does not support ANAT The device has Alternative Network Address Types enabled, but is registered with a VCS proxy which does not support ANAT. Disable ANAT on the device.
Cap filter configuration capfoperationstate SIP registration blocked A Certificate Authority Proxy Function operation is still pending. This must completed before SIP registration will succeed.
Cap filter operation state capsetfilterconfiguration Possible media setup issues The capset filter configuration is set. This affects what media codecs get negotiated on SIP/H.323 calls and may cause media setup issues. Only use this in agreement with Cisco. If you experience media setup issues, clear the configured xConfiguration Conference CapsetFilter value.
Certificate expiry certificateexpiry Certificate expiration A certificate has expired or is about to expire. Update the certificate. Log into Local Device Controls and see Diagnostics page for more details.
Ctl installation ctlinstallation CTL verification failed The Certificate Trust List could not be installed because its signature failed verification. Log into Local Device Controls and see Diagnostics page for more details.

Provisioning

DisplayName Code Type Message
Developer options provisioningdeveloperoptions Software upgrade override This device has been configured to not automatically upgrade by an engineer. Check if this is intentional as outdated software can cause problems. This configuration is available to change in the xAPI as {{xconfigpath}}.
Mode and status provisioningmodeandstatus Provisioning failed Provisioning this device failed. Log into Local Device Controls and see Diagnostics page for more details.
Webex and webex edge enabled provisioningstatus Provisioning error Device activation failed due to a provisioning error. Log into Local Device Controls and see Diagnostics page for more details.

Room scheduling

DisplayName Code Type Message
Configuration roomschedulingconfiguration Hybrid Calendar not enabled The system is configured for room scheduling, but hybrid calendar is not enabled.

Signage

DisplayName Code Type Message
Bad video format alert signagebadvideoformatalert Failed to play a signage video A video configured in signage could not be played because the format is unsupported. Verify all videos configured in Device Signage are mp4 files with a maximum resolution of 1920×1080.
Failed to load signagefailedtoload Failed to load signage The web site used as signage could not be loaded. Check that the URL is correct and working. Signage is temporarily disabled and standard half-wake state is shown until this issue has been resolved.
Terminated unexpectedly signageterminatedunexpectedly Signage terminated unexpectedly The web site used as signage caused the web engine to terminate unexpectedly. The web site might be using too much resources. Signage is temporarily disabled and standard half-wake state is shown until this issue has been resolved.

Software

DisplayName Code Type Message
Out of date softwareoutofdate Software is out of date If this issue persists, start the update from the device's user interface or contact Cisco support. Outdated software is a security liability.
Upgrade availability softwareupgradeavailability Software is not available for this product There is no available software for this product in the current channel. The device will not upgrade automatically. Please assign the device to a channel with supported software.
Upgrade compatibility softwareupgradecompatibility RoomOS release incompatibility Microsoft Teams Rooms is only supported on software channels with RoomOS March 2023 or newer releases. This device is automatically adjusted to support the latest compatible release for the selected channel. Change the software upgrade channel, or upgrade the RoomOS release of the selected channel for this device to use a compatible version.
Upgrade keeps failing softwareupgradekeepsfailing Failed to download new software The device has repeatedly failed to download new software. Check that the device has a working network connection, that DNS is configured and it is not blocked by firewalls or proxies.
Update available webexsoftwareupdateavailable Software update available A software update is available for this device. Apply it to stay up-to-date with our latest features and security patches. Read more

System

DisplayName Code Type Message
Configuration file configurationfile Configuration failed The configuration file received by the endpoint is either malformed or its signature failed verification. Log into Local Device Controls and see Diagnostics page for more details.
First time wizard not completed firsttimewizardnotcompleted First time wizard not completed The first time wizard is still active. Stop it by running the SystemUnit FirstTimeWizard Stop command.
HDMI cec mode no sound hdmicecmodenosound HDMI CEC mode off CEC mode is turned off on video in HDMI 1. This will result in no sound from the internal loudspeaker. To solve this issue, set CEC mode back to On.
Soon to be deactivated soontobedeactivated Device credentials will soon expire A device that has been offline for a year will lose its Webex registration. Make sure the device comes online within {{expireInDays}} days to avoid having to reregister it.
Connection controlsystemconnection No control system connected The device is configured to have a control system connected, but none are detected at the moment. Please check if there is a control system connected, and whether the connection is working as it should.
Missing encryption key missingencryptionkey Missing encryption option key Please add an encryption option key.
Ntp status ntpstatus Time server not reachable The connection to an NTP server could not be established. The time displayed on your endpoint may be wrong.

Temperature

DisplayName Code Type Message
Check temperaturecheck High temperature Device temperature is too high.

Touch panel

DisplayName Code Type Message
Connection touchpanelconnection Touch panel required There is no touch panel connected to the device. Check the cable connecting the touch panel to the device.

Ultrasound

DisplayName Code Type Message
Config settings ultrasoundconfigsettings Ultrasound pairing may fail Automatic pairing with this device via ultrasound may not work. Log into Local Device Controls and increase the ultrasound volume on the device.
Speaker availability ultrasoundspeakeravailability No embedded ultrasound speaker Automatic pairing with this device via ultrasound will not work because the device does not have an embedded ultrasound speaker.

Video

DisplayName Code Type Message
Osd video output osdvideooutput Main display not detected Verify that the main display is turned on and connected to the correct display output on the video device.

Web view

DisplayName Code Type Message
Failed to load embeddedwebviewfailedtoload WebApps page failed The web page displayed by WebApps could not be loaded. Log into Local Device Controls, see WebApps configuration and verify the configured web pages are accessible.
Terminated unexpectedly embeddedwebviewterminatedunexpectedly WebApps page terminated A web page displayed by WebApps has terminated unexpectedly.

Webex Edge for devices

DisplayName Code Type Message
Status provmodewebexandwebexedgeenabled Provisioning conflict The device is configured for both Webex and Webex Edge connectivity, which cannot be combined. Verify configuration for Provisioning Mode is Auto, CUCM, Edge, Off, TMS or VCS and then set Provisioning WebexEdge to On
Account plus webex edge enabled webexaccountpluswebexedgeenabled Incompatible Webex activation The device is configured for Webex Edge, but is using a Webex account. Reactivate with a new Webex Edge activation code for on-premises device, or configure Provisioning WebexEdge to Off and Provisioning Mode to Webex for cloud registration.
Account plus provisioning mode webexedgeaccountplusprovmodewebex Incompatible Webex Edge activation The device is configured for Webex, but is using a Webex Edge account. Reactivate with a new Webex activation code for cloud registration, or change provisioning mode and configure Provisioning WebexEdge to On for on-premises device.
Must upgrade software webexmustupgradecesoftware Software upgrade required The current software is unsupported for Webex Edge for Devices. Upgrade software to restore Webex Edge functionality. Read more
Should upgrade software webexshouldupgradecesoftware Software upgrade recommended Webex Edge for Devices requires up to date software to maintain maximum functionality. The current software on this device is older than recommended; there is a chance some Webex Edge for Devices functionality may stop working in the future if no action is taken. Read more

xAPI

DisplayName Code Type Message
Access denied internalxapiaccessdenied Internal xAPI access denied Internal xAPI access was requested and denied. Contact accessmodeinternal@cisco.com to learn more.
Usage internalxapiusage Internal xAPI usage Internal xAPI access was requested. This feature is deprecated and will be removed in future software releases.