• Home
  • API
  • Environment
  • Settings
  • Schemas
  • Health cards

Settings API - Health cards schema table

Health cards (builtin:ua.health-cards)

Specifies the behavior of health cards.

Schema IDSchema groupsScope
builtin:ua.health-cards
  • group:unified-analysis
ua-screen
Retrieve schema via Settings API
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:ua.health-cards
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:ua.health-cards
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:ua.health-cards

Authentication

To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

PropertyLabelTypeDescriptionRequired
keyKeytext

Unique key, which is used to map to this health card in the screen layout config

required
tilesTileslist

Collection of tiles definition in health card

required
conditionsList of conditionsset

All conditions from the list need to be fulfilled for the Health card to be visible

required

Request body objects

The Tile object
PropertyLabelTypeDescriptionRequired
displayNameDisplay nametext-required
metricSelectorMetric selector expressiontext

Used for displaying last value and for matching events to mark health of the tile.

For example, if you want to show the available disk space of a host, use
builtin:host.disk.free.

The filter for the ME id will be applied automatically.

The Metric Browser gives an overview of all the metrics an the available operations for every metric.

required
additionalMetricSelectorsAdditional metric selector expressionsAdditionalMetricSelectorsType

Used only for matching events to mark health of the tile.

optional
displayMetricValueDisplay metric valueboolean

When true, value of the selected metric will be displayed in the tile

optional
foldTransformationFold transformationenum

Define fold transformation of the displayed value

required
anchorAnchorAnchor

Define element to scroll to on click.

optional
conditionsList of conditionsset

All conditions from the list need to be fulfilled for the Tile to be visible

required
The Anchor object
PropertyLabelTypeDescriptionRequired
cardNameCard nametext

Card display name which is used to scroll on click.

required
chartNameChart nametext

Optional chart name. If card supports scrolling to chart, it will be picked to display. Use chart display name to match.

optional
The AdditionalMetricSelectorsType object
PropertyLabelTypeDescriptionRequired
collection-set-required