Présentation

Les Powerpacks sont des groupes de widgets modélisés qui démultiplient l’expertise en matière de graphiques sous forme de blocs de construction de dashboards réutilisables. Les Powerpacks sont soit prédéfinis (créés par Datadog, disponibles pour tous les clients), soit personnalisés (créés par un utilisateur et disponibles uniquement au sein de son organisation). Pour plus d’informations sur les bonnes pratiques relatives aux Powerpacks, consultez le guide Démultiplier l’expertise en matière de graphiques avec les Powerpacks.

Configuration

Créer un Powerpack

Créez un Powerpack à partir d’un groupe existant dans un dashboard :

1. Depuis l’en-tête d’un groupe de dashboard, cliquez sur l’icône « Save as Powerpack ».
2. Renseignez les détails pour rendre le Powerpack détectable par votre organisation.
3. Ajoutez des tags sous « Add Search Categories » pour organiser vos Powerpacks. Cela permet aux membres de l’équipe de trouver le bon Powerpack à ajouter à leur dashboard.
4. Choisissez les filtres qui doivent être configurables pour les utilisateurs du Powerpack.

Remarque : après la création d’un Powerpack, le groupe d’origine est remplacé par une instance du Powerpack.

Mettre à jour un powerpack

Les modifications apportées à un Powerpack se synchronisent sur tous les dashboards où votre Powerpack est utilisé.

Pour modifier l’apparence ou la mise en page d’un Powerpack :

1. Passez la souris sur l’en-tête et cliquez sur le menu au trois barres.
2. Sélectionnez Edit Powerpack Layout dans le menu Powerpack Actions. Remarque : la mise en page des Powerpacks ne peut pas être modifiée sur les timeboards.
3. Apportez les modifications souhaitées à la mise en page du Powerpack ou à un widget individuel et sélectionnez Confirm Changes.
4. Si ce Powerpack est utilisé dans plusieurs dashboards, une invite s’ouvre pour confirmer les instances du Powerpack affectées par cette mise à jour.

Pour modifier les détails du Powerpack :

1. Passez la souris sur l’en-tête et cliquez sur le menu au trois points.
2. Sélectionnez Edit Powerpack Details dans le menu Powerpack Actions.
3. Modifiez les informations du Powerpack, les catégories de recherche ou la configuration des filtres, puis sélectionnez Update Powerpack.
4. Si ce Powerpack est utilisé dans plusieurs dashboards, une invite s’ouvre pour confirmer les instances du Powerpack affectées par cette mise à jour.

Remarque : vous devez disposer des autorisations de modification pour effectuer des mises à jour du Powerpack ou modifier les autorisations.

Utiliser les Powerpacks

Ajouter ou supprimer une instance de Powerpack

Après avoir créé un Powerpack, vous pouvez ajouter une instance de ce Powerpack à plusieurs dashboards.

Pour ajouter une instance de Powerpack au dashboard :

1. Cliquez sur Add Widgets pour ouvrir le panneau de widgets.
2. Cliquez sur l’onglet Powerpacks pour afficher les Powerpacks disponibles. Vous pouvez effectuer une recherche par texte ou par tags prédéfinis.
3. Cliquez sur le Powerpack souhaité pour ouvrir la configuration de l’instance du Powerpack.
4. Sélectionnez les valeurs de filtre et le mode de contrôle des filtres.
   • Filtres Powerpack : la valeur sélectionnée s’applique aux widgets à l’intérieur de l’instance du Powerpack.
   • Filtres de dashboard : contrôlés par les template variables du dashboard.
5. Cliquez sur Confirm.

Pour supprimer une instance de Powerpack du dashboard :

1. Cliquez sur le menu au trois points dans l’en-tête de l’instance.
2. Sélectionnez Remove from Dashboard.

Personnaliser une instance de Powerpack

Les modifications apportées à une instance de Powerpack ne s’appliquent pas aux autres instances de Powerpack dans d’autres dashboards.

Pour personnaliser les instances de Powerpack affichées dans votre dashboard :

1. Cliquez sur le menu au trois points dans l’en-tête de l’instance.
2. Sélectionnez une option dans le menu Powerpack Actions :
   1. Edit Display Options : personnalisez le style de l’en-tête du groupe, les couleurs d’affichage et le nom.
   2. Detach Instance : dissociez l’instance du Powerpack d’origine.
   3. Remove from Dashboard : supprimez l’instance du dashboard.
   4. Edit Powerpack Layout : personnalisez la mise en page des widgets dans l’instance.
   5. Edit Powerpack Details : personnalisez le titre, la description et les tags associés.
3. Choisissez de nouvelles options de style pour l’en-tête, mettez à jour le titre du groupe ou configurez les filtres utilisés par votre Powerpack.
4. Configurez les valeurs de tags de votre instance de Powerpack.

Supprimer un Powerpack

Seul l’auteur d’un Powerpack peut le supprimer. Après la suppression d’un Powerpack, les instances existantes du Powerpack restent intactes, mais elles affichent une alerte indiquant que le Powerpack a été supprimé. Pour supprimer cette alerte, dissociez l’instance et convertissez-la en groupe de widgets.

Pour supprimer un Powerpack :

1. Cliquez sur Add Widgets pour ouvrir le panneau de widgets.
2. Sélectionnez Delete Powerpack.

Autorisations des Powerpacks

Pour modifier les autorisations de modification d’un Powerpack :

1. Passez la souris sur l’en-tête et cliquez sur le menu au trois points.
2. Sélectionnez Modify Permissions dans le menu Powerpack Actions.
3. Mettez à jour les utilisateurs disposant des autorisations de modification pour le Powerpack.

API

Ce widget peut être utilisé avec l’API Dashboards. Le tableau ci-dessous définit le schéma JSON du widget :

{
  "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"
}

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

Diffuser l'expertise des créateurs de graphiques avec les powerpacksGUIDE Enregistrez les widgets du dashboard dans des groupes réutilisables avec les PowerpacksBLOG Widget GroupeDOCUMENTATION Créer des dashboards avec JSONDOCUMENTATION