Tutoriel NerdGraph : Exporter le dashboard sous forme de fichiers

Avez-vous besoin de planifier des rapports contenant des graphiques ou des dashboards ? Souhaitez-vous automatiser la manière dont vous partagez votre dashboard ? Vous pouvez obtenir vos dashboardssous forme de fichiers PDF ou PNG par programmation avec une mutation GraphQL . Vous pouvez également exporter le dashboard sous forme de fichiers PDF à l'aide de l'UI.

Par exemple, vous pouvez générer des versions statiques et instantanées de votre dashboard New Relic et les envoyer à Slack ou les télécharger sous forme de fichiers.

Exporter les pages dashboard

1. Obtenir le dashboard du GUID : Cliquez sur le icône dashboard à côté du nom du pour accéder au mémo widget et voir le dashboard du GUID.

2. Obtenez les GUID des pages individuelles à l'aide de la requête ci-dessous :

   {
     actor {
       entitySearch(
         query: "id ='YOUR_PAGE_GUID' OR parentId ='YOUR_PAGE_GUID' AND tags.isDashboardPage = 'true'"
       ) {
         results {
           entities {
             guid
             name
             ... on DashboardEntityOutline {
               guid
               name
               dashboardParentGuid
             }
           }
         }
       }
     }
   }

   Copier

3. Exécutez la mutation dashboardCreateSnapshotURL dans l’ explorateur NerdGraphQL autant de fois que de pages dashboard que vous souhaitez exporter. Il vous suffit de fournir le de la dashboard page de souhaitée GUID en tant que paramètre.

4. Obtenez le lien pour récupérer votre page dashboard au format PDF. Le lien ressemble à :

   https://gorgon.nr-assets.net/image/e0c22263-2d88-40bc-940a-b885dbc1d98d?format=PDF&width=2000&height=2000

   Copier

5. Configurez le fichier exporté, si nécessaire.

Configurer le fichier que vous récupérez

Modifiez le lien renvoyé pour changer le format de votre export (PDF ou PNG), ou le redimensionner.

Par exemple, si vous obtenez le lien :

https://gorgon.nr-assets.net/image/e0c22263-2d88-40bc-940a-b885dbc1d98d?format=PDF&width=2000&height=2000

Vous pourriez :

• Remplacez PDF par PNG pour obtenir une image.
• Modifiez les champs de largeur et de hauteur pour ajuster la taille à vos besoins. La valeur maximale est 2000.

Dépannage

Voici ce qu'il faut faire si vous rencontrez l'une des erreurs suivantes lorsque vous essayez d'exporter un dashboard:

• Depuis New Relic UI: We ran into an error while creating the PDF. Please try again

• Extrait de New Relic NerdGraph : Operation on dashboard entity failed with guid:YOUR_GUID with cause: Error 504 calling Gorgon with url https://chart-image.service.newrelic.com/dashboard-url-from-guid/YOUR_GUID: upstream request timeout

Ces erreurs peuvent être provoquées si la génération du PDF dépasse le temps de réponse maximal de l'API. Si vous rencontrez ces erreurs, vérifiez si l'un des widgets de votre dashboard dispose d'une grande fenêtre temporelle. Par exemple, vous pouvez comparer les données d’un mois entier avec celles des mois précédents. Si vous voyez une grande fenêtre temporelle, essayez de la réduire.

Une autre cause possible de ces erreurs est que votre dashboard peut avoir un grand nombre de widgets. Si vous avez un widget que vous n'utilisez pas, vous pouvez essayer d'en supprimer certains pour voir si cela résout l'erreur.