Liveness tests per property

Get-GTMLivenessPerProperty

Synopsis

Get reports on liveness tests per property.

Syntax

Get-GTMLivenessPerProperty [-DomainName] <String> [-PropertyName] <String> [-Date] <String> [[-AgentIP] <String>] [[-TargetIP] <String>] [[-EdgeRCFile] <String>] [[-Section] <String>] [[-AccountSwitchKey] <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

Description

Retrieves a collection of reports containing logs of individual liveness tests that have failed. Liveness tests are run periodically by web agents installed in customer data centers. Liveness scores are used by GTM to decide whether a data center is alive or not.

Liveness tests that fail in succession (tests that run from the same testing agent to the same origin server, which fail with the same error code) are grouped together and represented with a duration. This duration value is in seconds and can sustain for up to 86400 seconds (one day). If it crosses that boundary, GTM logs it as a new failure at the beginning of the next day (00:00 UTC), with the duration reset to that point.

Parameters

‑AccountSwitchKey

An account credential key that lets you move between accounts when using an API client enabled for multiple accounts. To find account switch keys, use Get-AccountSwitchKey.

‑AgentIP

Filters results by Agent IP.

‑Date
Required

The date of a report, in ISO 8601 format of YYYY-MM-DD.

‑DomainName
Required

The full GTM domain name.

‑EdgeRCFile

Your EdgeGrid resource file to authenticate your command. Defaults to ~/.edgerc.

‑PropertyName
Required

The name of Traffic Management property.

‑Section

The section name in your EdgeGrid resource file to retrieve authentication credentials from. Defaults to default.

‑TargetIP

Filters results by Target IP.

Related Links