Get-AuvikDeviceStatistics

SYNOPSIS

Provides historical device statistics such as bandwidth, CPU utilization and memory utilization

SYNTAX

Get-AuvikDeviceStatistics [-StatId] <String> [[-Tenants] <String[]>] [-FilterFromTime] <DateTime>
 [[-FilterThruTime] <DateTime>] [-FilterInterval] <String> [[-FilterDeviceType] <String>]
 [[-FilterDeviceId] <String>] [[-PageFirst] <Int64>] [[-PageAfter] <String>] [[-PageLast] <Int64>]
 [[-PageBefore] <String>] [-AllResults] [<CommonParameters>]

DESCRIPTION

The Get-AuvikDeviceStatistics cmdlet provides historical device statistics such as bandwidth, CPU utilization and memory utilization

EXAMPLES

EXAMPLE 1

Get-AuvikDeviceStatistics -StatId bandwidth -FilterFromTime 2023-10-03 -FilterInterval day

Provides the first 100 historical device statistics from the defined date at the defined interval

EXAMPLE 2

Get-AuvikDeviceStatistics -StatId bandwidth -FilterFromTime 2023-10-03 -FilterInterval day -PageFirst 1000 -AllResults

Provides all historical device statistics from the defined date at the defined interval

PARAMETERS

-StatId

ID of statistic to return

Allowed values: “bandwidth”, “cpuUtilization”, “memoryUtilization”, “storageUtilization”, “packetUnicast”, “packetMulticast”, “packetBroadcast”

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Tenants

Comma delimited list of tenant IDs to request info from

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-FilterFromTime

Timestamp from which you want to query

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: True
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilterThruTime

Timestamp to which you want to query (defaults to current time)

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilterInterval

Statistics reporting interval

Allowed values: “minute”, “hour”, “day”

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 5
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilterDeviceType

Filter by device type

Allowed values: “unknown”, “switch”, “l3Switch”, “router”, “accessPoint”, “firewall”, “workstation”, “server”, “storage”, “printer”, “copier”, “hypervisor”, “multimedia”, “phone”, “tablet”, “handheld”, “virtualAppliance”, “bridge”, “controller”, “hub”, “modem”, “ups”, “module”, “loadBalancer”, “camera”, “telecommunications”, “packetProcessor”, “chassis”, “airConditioner”, “virtualMachine”, “pdu”, “ipPhone”, “backhaul”, “internetOfThings”, “voipSwitch”, “stack”, “backupDevice”, “timeClock”, “lightingDevice”, “audioVisual”, “securityAppliance”, “utm”, “alarm”, “buildingManagement”, “ipmi”, “thinAccessPoint”, “thinClient”

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 6
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilterDeviceId

Filter by device ID

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 7
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PageFirst

For paginated responses, the first N elements will be returned Used in combination with page[after]

Default Value: 100

Type: Int64
Parameter Sets: (All)
Aliases:

Required: False
Position: 8
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-PageAfter

Cursor after which elements will be returned as a page The page size is provided by page[first]

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 9
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PageLast

For paginated responses, the last N services will be returned Used in combination with page[before]

Default Value: 100

Type: Int64
Parameter Sets: (All)
Aliases:

Required: False
Position: 10
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-PageBefore

Cursor before which elements will be returned as a page The page size is provided by page[last]

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 11
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AllResults

Returns all items from an endpoint

Highly recommended to only use with filters to reduce API errors\timeouts

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

N\A

RELATED LINKS

https://celerium.github.io/Celerium.Auvik/site/Statistics/Get-AuvikDeviceStatistics.html