-
Notifications
You must be signed in to change notification settings - Fork 4
Get UnifiDailyGatewayStats
external help file: UniFiTooling-help.xml HelpVersion: 1.1.0 Locale: en-US Module Guid: 7fff91a0-02eb-4df2-84d5-c7d3cd7f7a5d Module Name: UniFiTooling online version: https://github.com/Enatec/UniFiTooling/raw/master/docs/Get-UnifiDailyGatewayStats.md schema: 2.0.0
Get daily statistics for a USG via API on the UniFi SDN Controller.
Get-UnifiDailyGatewayStats [[-UnifiSite] <String>] [[-Start] <String>] [[-End] <String>]
[[-Attributes] <String[]>] [<CommonParameters>]
Get daily statistics for a UniFi Security Gateway (USG) via Ubiquiti (UBNT) UniFi RESTful API request on the UniFi SDN Controller.
For convenience, we return the traffic Megabytes and not in bytes (as the UniFi does it).
We also return real timestamps instead of the epoc/unix timestaps that the UniFi API returns.
Sample output: Time : 2/1/2019 1:00:00 AM mem : 33.23 cpu : 3.25 lan-rx_errors : 0 lan-rx_bytes : 1715484318.69231 lan-rx_kb : 1675277.65 lan-rx_mb : 1636.01 lan-rx_gb : 1.6 lan-rx_packets : 16370719.6153846 lan-rx_dropped : 125 wan-rx_errors : 0 wan-rx_packets : 20559905.0769231 wan-rx_dropped : 1214 lan-tx_errors : 0 lan-tx_bytes : 30648673319.6923 lan-tx_kb : 29930345.04 lan-tx_mb : 29228.85 lan-tx_gb : 28.54 lan-tx_tb : 0.03 lan-tx_packets : 25358762.6923077 lan-tx_dropped : 0 wan-tx_errors : 0 wan-tx_bytes : 1047615654 wan-tx_kb : 1023062.16 wan-tx_mb : 999.08 wan-tx_gb : 0.98 wan-tx_packets : 11374571.2307692 wan-tx_dropped : 0
You might filter out all the 0 values, we keep them to prevent any null pointer expetions!
You can Filter for whatever parameter you like (e.g. with Select-Object)
BUG: The loadavg_ attributes are not working at the moment. The UniFi SDN Controller does not return any values for them!
Get-UnifiDailyGatewayStats
Get daily statistics for the USG (UniFi Security Gateway) in the default site
(Get-UnifiDailyGatewayStats -Start '1548971935421' -End '1548975579019')
Get daily statistics for the USG (UniFi Security Gateway) in the default site for a given time period.
(Get-UnifiDailyGatewayStats -Start '1548980058135')
Get daily statistics for the USG (UniFi Security Gateway) in the default site for the last 60 minutes (was the timestamp while the sample was created)
(Get-UnifiDailyGatewayStats -UnifiSite 'contoso')[-1]
Get daily statistics for the USG (UniFi Security Gateway) in the site 'contoso'
Get-UnifiDailyGatewayStats -Attributes 'mem','cpu','loadavg_5','lan-rx_errors','wan-rx_errors','lan-tx_errors','wan-tx_errors','lan-rx_bytes','wan-rx_bytes','lan-tx_bytes','wan-tx_bytes','lan-rx_packets','wan-rx_packets','lan-tx_packets','wan-tx_packets','lan-rx_dropped','wan-rx_dropped','lan-tx_dropped','wan-tx_dropped')
Get all Values from the API
ID of the client-device to be modified
Type: String
Parameter Sets: (All)
Aliases: Site
Required: False
Position: 1
Default value: Default
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: FalseStartpoint in UniFi Unix timestamp in milliseconds
Type: String
Parameter Sets: (All)
Aliases: Startpoint, StartTime
Required: False
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: FalseEndpoint in UniFi Unix timestamp in milliseconds
Type: String
Parameter Sets: (All)
Aliases: EndPoint, EndTime
Required: False
Position: 3
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: Falsearray containing attributes (strings) to be returned, defaults to mem, cpu, and zime (Time is mandatory)
Type: String[]
Parameter Sets: (All)
Aliases: attribs, UniFiAttributes
Required: False
Position: 4
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: FalseThis cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
Defaults to the past year (52724 hours)
A USG (UniFi Security Gateway) is required on the site you querry!