Usage statistics for a dashboard. The viewer field and all view-count fields (total_views, viewed_at, total_views_by_type) are populated only when Real User Monitoring (RUM) is active for the org.

Hierarchy

  • DashboardUsageAttributes

Constructors

Properties

additionalProperties?: {
    [key: string]: any;
}

A container for additional, undeclared properties. This is a holder for any undeclared properties as specified with the 'additionalProperties' keyword in the OAS document.

Type declaration

  • [key: string]: any

A user referenced from a dashboard usage record (author or viewer).

createdAt?: Date

When the dashboard was created.

dashboardQualityScore?: number

The dashboard quality score ranges from 0 to 1, with higher scores indicating stronger signals of quality and usefulness. The value is null when no score is available.

The score considers the following factors:

  • Dashboard and widget naming, including whether the dashboard uses a default or templated name
  • The number of data widgets, excluding container and text widgets
  • Confirmed broken queries
  • Recent activity, based on the last view date or, when no view date is available, the last edit or creation date

Dashboards linked from monitors do not receive lower scores because of their naming or lack of recent activity. An age-based adjustment helps prevent newly created dashboards from receiving disproportionately low scores. Queries lower the score only when confirmed broken.

editedAt?: Date

When the dashboard was most recently edited.

orgId: number

The Datadog organization that owns the dashboard.

teams?: string[]

Teams the dashboard is tagged with.

title?: string

The dashboard title.

totalViews?: number

Total view count for the dashboard. Counts only views captured by Real User Monitoring (RUM); 0 in orgs without RUM.

totalViewsByType?: {
    [key: string]: number;
}

View counts keyed by view type (in_app, embed, public, shared, api, unknown). Counts only views captured by Real User Monitoring (RUM); empty in orgs without RUM.

Type declaration

  • [key: string]: number
viewedAt?: Date

When the dashboard was most recently viewed. Populated only when Real User Monitoring (RUM) is active for the org; null in orgs without RUM.

A user referenced from a dashboard usage record (author or viewer).

widgetCount?: number

The total number of widgets on the dashboard.

widgetCountByType?: {
    [key: string]: number;
}

Widget counts keyed by widget type. The map includes group widgets and widgets without requests.

Type declaration

  • [key: string]: number

Generated using TypeDoc