Widget Powerpack

Información general

Los widgets Powerpack no son compatibles con screenboards.

Los Powerpacks son grupos de widgets con plantillas que escalan la experiencia gráfica como bloques de construcción de cuadros de mando reutilizables. Los Powerpacks pueden ser preestablecidos (creados por Datadog, disponibles para todos los clientes) o personalizados (creados por un usuario y solo disponibles dentro de tu organización). Para obtener más información sobre las mejores prácticas de Powerpack, consulta la guía Scale Graphing expertise with Powerpacks (Experiencia en gráficos a escala con Powerpacks).

Configuración

Creación de un Powerpack

Crear un Powerpack a partir de un grupo existente en dashboard:

Iconos de la cabecera del grupo del dashboard que elevan la opción Guardar como icono de Powerpack.
  1. En la cabecera de un grupo dashboard, haz clic en el icono “Guardar como Powerpack”.
  2. Rellena los datos para que tu organización pueda descubrir el Powerpack.
  3. Añade etiquetas (tags) en “Añadir categorías de búsqueda” para organizar tus Powerpacks. Esto permite a los miembros del equipo encontrar el Powerpack correcto para añadir a su dashboard.
  4. Elige qué filtros deben ser configurables para los usuarios del Powerpack.

Nota: Después de crear un Powerpack, el grupo original se sustituye por una instancia del Powerpack.

Actualización de un Powerpack

Los cambios realizados en un Powerpack se sincronizan en todos los dashboards en los que se utilice el Powerpack.

Para modificar el aspecto o el diseño de un Powerpack:

  1. Pasa el cursor por encima de la cabecera y haz clic en el menú kebab.
  2. Selecciona Edit Powerpack Layout (Editar diseño de Powerpack) en el menú Acciones de Powerpack.
  3. Realiza los cambios que desees en el diseño del Powerpack o en cualquier widget individual y selecciona Confirm Changes (Confirmar cambios).
  4. Si este Powerpack se utiliza en varios dashboards, se abrirá un mensaje para verificar las instancias del Powerpack afectadas por esta actualización.
Opciones del menú de acciones para actualizar un Powerpack y la instancia Powerpack a la que se accede a través de kebab en la cabecera del Powerpack.

Para realizar cambios en los Detalles del Powerpack:

  1. Pasa el cursor por encima de la cabecera y haz clic en el menú kebab.
  2. Selecciona Edit Powerpack Details (Editar detalles del Powerpack) en el menú Acciones del Powerpack.
  3. Realiza cambios en la información de Powerpack, en las categorías de búsqueda o en el filtro configuración y selecciona Update Powerpack (Actualizar Powerpack).
  4. Si este Powerpack se utiliza en varios dashboards, se abrirá un mensaje para verificar las instancias del Powerpack afectadas por esta actualización.

Nota: Debes tener edit permissions (permisos de edición) para realizar cualquier actualización en el Powerpack o para modificar los permisos.

Utilizar Powerpacks

Añadir una instancia Powerpack

Después de crear un Powerpack, puedes añadir una instancia de ese Powerpack a múltiples dashboards.

Para añadir una instancia de Powerpack al dashboard:

  1. Haz clic en la pestaña “Powerpacks” de la bandeja widget para encontrar los Powerpacks disponibles. Puedes buscar con texto, así como las etiquetas predefinidas.
  2. Haz clic en el Powerpack que desees añadir a tu dashboard para abrir la configuración de la instancia del Powerpack.
  3. Selecciona los valores de los filtros y cómo se controlan.
    • Filtros Powerpack - el valor seleccionado se aplica a widgets dentro de la instancia Powerpack.
    • Filtros de dashboard - controlados por variables de plantilla de dashboard.
  4. Haz clic en Confirm (Confirmar).

Personalizar una instancia de Powerpack

Los cambios en una instancia de Powerpack no se aplican a otras instancias de Powerpack en otros dashboards.

Para personalizar las instancias de Powerpack que aparecen en su dashboard:

  1. Haz clic en el menú kebab de la cabecera de la instancia.
  2. Selecciona Edit Display Options (Editar opciones de visualización) en el menú Acciones de la instancia.
  3. Elige nuevas opciones de estilo para la cabecera, actualiza el título del grupo o configura los filtros utilizados por tu Powerpack.
  4. Configurar los valores de etiqueta de tu instancia Powerpack. Verifica Add to dashboard (Añadir a dashboard), para utilizar esto como una variable de plantilla de dashboard.
Opciones de configuración de una instancia de Powerpack

Permisos Powerpack

Para realizar cambios en los permisos de edición de un Powerpack:

  1. Pasa el cursor por encima de la cabecera y haz clic en el menú kebab.
  2. Selecciona Modify Permissions (Modificar permisos) en el menú Acciones de Powerpack.
  3. Actualizar qué usuarios tienen permisos de edición para el Powerpack.

API

Este widget puede utilizarse con la API de dashboards. Ve la siguiente tabla para la definición de esquema de JSON de widget:

Expand All

Field

Type

Description

background_color

string

Background color of the powerpack title.

banner_img

string

URL of image to display as a banner for the powerpack.

powerpack_id [required]

string

UUID of the associated powerpack.

show_title

boolean

Whether to show the title or not.

default: true

template_variables

object

Powerpack template variables.

controlled_by_powerpack

[object]

Template variables controlled at the powerpack level.

name [required]

string

The name of the variable.

prefix

string

The tag prefix associated with the variable.

values [required]

[string]

One or many template variable values within the saved view, which will be unioned together using OR if more than one is specified.

controlled_externally

[object]

Template variables controlled by the external resource, such as the dashboard this powerpack is on.

name [required]

string

The name of the variable.

prefix

string

The tag prefix associated with the variable.

values [required]

[string]

One or many template variable values within the saved view, which will be unioned together using OR if more than one is specified.

title

string

Title of the widget.

type [required]

enum

Type of the powerpack widget. Allowed enum values: powerpack

default: powerpack

{
  "background_color": "string",
  "banner_img": "string",
  "powerpack_id": "df43cf2a-6475-490d-b686-6fbc6cb9a49c",
  "show_title": false,
  "template_variables": {
    "controlled_by_powerpack": [
      {
        "name": "host1",
        "prefix": "string",
        "values": [
          "my-host",
          "host1",
          "host2"
        ]
      }
    ],
    "controlled_externally": [
      {
        "name": "host1",
        "prefix": "string",
        "values": [
          "my-host",
          "host1",
          "host2"
        ]
      }
    ]
  },
  "title": "string",
  "type": "powerpack"
}

Leer más