Apps Datadog

Rejoignez la bêta !

Les Apps Datadog sont actuellement en version bêta, mais vous pouvez facilement accéder à cette fonctionnalité ! Utilisez ce formulaire pour envoyer une demande dès aujourd’hui. Dès celle-ci approuvée, vous pourrez libérer votre créativité et développer votre App pour vous ou votre organisation, et même la publier sur le catalogue des Apps Datadog pour que toute la communauté puisse en profiter !

Qu’est-ce qu’une App ?

Les Apps Datadog permettent aux développeurs d’étendre les fonctionnalités natives de Datadog au moyen de widgets de dashboard personnalisés. Par exemple, si vous souhaitez utiliser une vue non prise en charge par Datadog ou un workflow de remédiation couramment exécuté dans une plateforme tierce, vous pouvez écrire une App pour ajouter cette fonctionnalité dans Datadog.

Configuration

Créer une App

  1. Créez une App Datadog.

$ yarn create @datadog/app

  1. Accédez au dossier que vous venez de créer.

$ cd starter-kit

  1. Configurez votre environnement de développement.

$ yarn start

Cette commande lance votre serveur de développement local sur http://localhost:3000/.

L'App a été chargée

Si vous voyez ce message, votre App est en cours d’exécution.

Notez qu’il existe deux pages différentes : http://localhost:3000 : Un contrôleur principal qui assure l’orchestration de vos différentes extensions (comme les widgets, les menus ou les fenêtres contextuelles). Cette page s’avèrera utile lorsque vous aurez enrichi les fonctionnalités de votre App.

http://localhost:3000/widget : Les composants des widgets, fenêtres contextuelles ou autres éléments qui nécessitent un affichage dédié.

Consultez le Guide d’utilisation de la plateforme de développement (en anglais) pour en savoir plus sur cette architecture.

  1. Accédez à votre Plateforme de développement dans Datadog et cliquez sur + New App en haut à droite.
Nouvelle App
  1. Saisissez le nom de votre App. Choisissez un nom descriptif pour la différencier des autres Apps que vous pourriez créer.

  2. Vous accédez alors au dashboard de votre nouvelle App. De là, vous avez la possibilité de modifier le nom choisi, de saisir une description plus détaillée, ou de modifier l’icône de l’App.

Informations de base de l'interface de modification d'App

Ajouter votre App à un dashboard

  1. Pour pouvoir ajouter votre App à un dashboard, vous devez d’abord l’activer en cliquant sur UI Extensions à gauche.
Bouton Enable UI Extensions de l'interface de modification d'App

Une fois cette vue chargée, cliquez sur le bouton Enable UI Extensions.

  1. D’autres options pour votre App s’affichent alors.

Assurez-vous de modifier l’URL racine et l’URL racine du mode debugging en fonction de la version localhost du widget que vous utilisez. Le chemin vers le contrôleur principal est /widget. Ces URL changeront au cours du développement de votre App et lorsque vous commencerez à l’héberger sur votre propre infrastructure.

  1. Activez l’option Dashboard Custom Widget. Vous devrez peut-être faire défiler le volet du milieu vers le bas pour afficher cette option. Le JSON du widget est alors géré sur la droite.
Écran UI Extensions de l'interface de modification d'App

Notez que ce JSON contient une valeur intitulée Your first widget. Il s’agit du nom de votre widget, qui apparaît dans le menu pour l’ajouter à vos dashboards.

  1. Accédez à votre dashboard et ajoutez un widget.
Ajouter un widget à un dashboard
  1. La section Custom Widgets est située en bas de la barre latérale. Recherchez votre widget dans la liste, et ajoutez-le à votre dashboard.
Custom Widget
  1. Un aperçu de votre nouveau widget apparaît, ainsi que plusieurs options. Faites défiler la fenêtre contextuelle et cliquez sur Done pour ajouter le widget à votre dashboard.
Nouvelle App Nouvelle App 2

Pour créer le build de votre App, exécutez yarn build dans votre terminal. Ensuite, déplacez le site statique généré vers la solution d’hébergement de votre choix et mettez à jour les URL dans les paramètres de l’App.

Accès via API OAuth

Lorsque cette fonctionnalité est activée, les utilisateurs doivent s’authentifier pour pouvoir utiliser l’App. Vous avez la possibilité d’intégrer votre mécanisme d’authentification existant (par exemple, une connexion par nom d’utilisateur/mot de passe basée sur des cookies) à la Plateforme de développement.

Exemples d’App

Starter kit

Sentiment analysis