Unifi Console

Supported OS Linux Mac OS Windows

통합 버전1.2.0
이 페이지는 아직 영어로 제공되지 않습니다. 번역 작업 중입니다.
현재 번역 프로젝트에 대한 질문이나 피드백이 있으신 경우 언제든지 연락주시기 바랍니다.

Overview

This check monitors Unifi Console through the Datadog Agent.

Setup

The Unifi check is not included in the Datadog Agent package, so you need to install it.

Installation

For Agent v7.21+ / v6.21+, follow the instructions below to install the Unifi check on your host. See Use Community Integrations to install with the Docker Agent or earlier versions of the Agent.

  1. Run the following command to install the Agent integration:

    sudo -u dd-agent -- datadog-agent integration install -t datadog-unifi_console==1.2.0
    
  2. Configure your integration similar to core integrations.

Configuration

  1. Edit the unifi_console.d/conf.yaml file, in the conf.d/ folder at the root of your Agent’s configuration directory to start collecting your Unifi Console performance data. See the sample unifi_console.d/conf.yaml for all available configuration options.

  2. Restart the Agent.

Validation

Run the Agent’s status subcommand and look for unifi_console under the Checks section.

Data Collected

Metrics

unifi_console.device.status
(gauge)
Device status
unifi_console.device.uptime
(gauge)
Device uptime
Shown as second
unifi_console.device.clients
(gauge)
Clients number
unifi_console.device.satisfaction
(gauge)
Device Satisfaction
Shown as percent
unifi_console.device.system.cpu.pct
(gauge)
% of CPU used
Shown as percent
unifi_console.device.system.mem.used
(gauge)
Memory used
Shown as byte
unifi_console.device.system.mem.total
(gauge)
Total Memory
Shown as byte
unifi_console.device.system.mem.buffer
(gauge)
Memory buffer
Shown as byte
unifi_console.device.system.mem.pct
(gauge)
% of memory used
Shown as percent
unifi_console.device.tx_packets
(gauge)
Number of transmitted packets
Shown as packet
unifi_console.device.tx_bytes
(gauge)
Number of transmitted Bytes
Shown as byte
unifi_console.device.tx_errors
(gauge)
Number of transmitted errors
unifi_console.device.tx_dropped
(gauge)
Number of transmitted dropped
unifi_console.device.tx_retries
(gauge)
Number of transmitted retries
unifi_console.device.rx_packets
(gauge)
Number of received packets
Shown as packet
unifi_console.device.rx_bytes
(gauge)
Number of received bytes
Shown as byte
unifi_console.device.rx_errors
(gauge)
Number of received errors
unifi_console.device.rx_dropped
(gauge)
Number of received dropped
unifi_console.device.guests
(gauge)
Number of guests
unifi_console.device.uplink.rx_bytes
(gauge)
Uplink received bytes
Shown as byte
unifi_console.device.uplink.rx_dropped
(gauge)
Uplink number of received dropped
unifi_console.device.uplink.rx_errors
(gauge)
uplink number of received errors
unifi_console.device.uplink.rx_packets
(gauge)
Uplink received packets
Shown as packet
unifi_console.device.uplink.tx_bytes
(gauge)
Uplink transmitted bytes
Shown as byte
unifi_console.device.uplink.tx_dropped
(gauge)
Uplink number of transmitted dropped
unifi_console.device.uplink.tx_errors
(gauge)
Uplink number of transmitted errors
unifi_console.device.uplink.tx_packets
(gauge)
Uplink transmitted packets
Shown as packet
unifi_console.device.uplink.up
(gauge)
Uplink status
unifi_console.client.noise
(gauge)
Client noise in dBm
unifi_console.client.rx_bytes
(gauge)
Client received bytes
Shown as byte
unifi_console.client.rx_packets
(gauge)
Client received packets
Shown as packet
unifi_console.client.rx_rate
(gauge)
Client received rate
Shown as byte
unifi_console.client.satisfaction
(gauge)
Client satisfaction
Shown as percent
unifi_console.client.signal
(gauge)
Client signal in dBm
unifi_console.client.tx_bytes
(gauge)
Client transmitted bytes
Shown as byte
unifi_console.client.tx_packets
(gauge)
Client transmitted packets
Shown as packet
unifi_console.client.tx_rate
(gauge)
Client transmitted rate
Shown as byte
unifi_console.client.tx_retries
(gauge)
Client transmitted retry
unifi_console.client.uptime
(gauge)
Client uptime
Shown as second
unifi_console.client.up
(gauge)
Client up
unifi_console.healthy
(gauge)
Health status

Events

The Unifi Console integration does not include any events.

Service Checks

unifi.can_connect
Returns CRITICAL if the Agent fails to connect to the Unifi Console, otherwise OK.
Statuses: ok, critical

unifi.healthy
Returns CRITICAL if the Unifi Console is not up, otherwise OK.
Statuses: ok, critical

unifi.device
Returns CRITICAL if the device is not in state 1, otherwise OK.
Statuses: ok, critical

unifi.device.uplink
Returns CRITICAL if the device uplink is not up, otherwise OK.
Statuses: ok, critical

Troubleshooting

Need help? Contact Datadog support.

PREVIEWING: jen.gilbert/cdocs-pilot-mobile-sr-setup