• /
  • EnglishEspañolFrançais日本語한국어Português
  • Se connecterDémarrer

Cette traduction automatique est fournie pour votre commodité.

En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.

Créer un problème

Tutoriel NerdGraph : Créer et gérer un dashboard

Vous pouvez utiliser notre API NerdGraph pour créer et gérer .

Présentation

Pour une introduction à notre fonctionnalité personnalisée de dashboard, consultez la documentation du dashboard.

Lorsque vous utilisez NerdGraph pour configurer le dashboard, il est utile de comprendre que nos dashboards sont considérés comme des entités, qui ont leurs propres identifiants d'entité, similaires à d'autres éléments que nous considérons comme des entités, comme les applications de monitoring, les hôtes et les services.

Pour savoir comment ajouter et configurer des widgets et des graphiques dans un dashboard, consultez Configurer des graphiques et d'autres widgets.

dashboard opérations CRUD

Ce document explique comment utiliser notre API NerdGraph pour créer, lire, mettre à jour et supprimer un dashboard (CRUD). Ces opérations modifient l'ensemble dashboard.

Créer un dashboard

Un dashboard nécessite au moins une page. Vous pouvez créer un dashboard avec une ou plusieurs pages, et chaque page peut avoir un ou plusieurs widgets.

  1. Accédez à l'explorateur NerdGraph GraphiQL à l'adresse api.newrelic.com/graphiql.
  2. Utilisez l'API dashboard de NerdGraph pour créer un nouveau dashboard et sa configuration.
  3. Assurez-vous d'inclure tous les champs obligatoires, tels que name, permissions et au moins une page.

Lire un dashboard

  1. Accédez à l'explorateur NerdGraph GraphiQL à l'adresse api.newrelic.com/graphiql.
  2. Utilisez actor > entity() pour trouver le dashboard par son entité GUID.
  3. Utilisez l'API dashboard de NerdGraph pour lire le dashboard existant et sa configuration.

Dans cet exemple, remplacez DASHBOARD_GUID par le GUID réel du dashboard que vous souhaitez lire :

query GetDashboardEntityQuery {
actor {
entity(guid: "DASHBOARD_GUID") {
... on DashboardEntity {
guid
name
description
createdAt
updatedAt
owner {
email
userId
}
permissions
pages {
guid
name
description
createdAt
updatedAt
widgets {
id
visualization {
id
}
layout {
column
row
height
width
}
title
linkedEntities {
guid
}
rawConfiguration
}
}
variables {
name
items {
title
value
}
defaultValues {
value {
string
}
}
nrqlQuery {
accountIds
query
}
options {
excluded
ignoreTimeRange
showApplyAction
}
title
type
isMultiSelection
replacementStrategy
}
}
}
}
}

En fonction des informations que vous souhaitez récupérer, vous pouvez modifier les champs de la requête.

Mettre à jour un dashboard

Pour mettre à jour un dashboard, vous devez fournir la configuration complète du dashboard, y compris toutes ses pages et widgets, même si vous ne mettez à jour qu'un seul élément. L'opération de mise à jour est un remplacement complet du contenu du dashboard.

Important

Lors de la mise à jour d'un dashboard, si le GUID de la page ou l'ID widget ne sont pas fournis, les pages ou le widget existants seront supprimés du dashboard et remplacés par les nouveaux spécifiés dans la mutation.

  1. Accédez à l'explorateur NerdGraph GraphiQL à l'adresse api.newrelic.com/graphiql.
  2. Utilisez l'API dashboard de NerdGraph pour obtenir la configuration dashboard existante en lisant le dashboard par son entité GUID, comme indiqué dans la section Lire un dashboard.
  3. Modifiez les champs que vous souhaitez mettre à jour dans la configuration dashboard.
  4. Utilisez l'API dashboard de NerdGraph pour mettre à jour le dashboard existant avec la configuration modifiée.

Important

Si vous utilisez Facet Linking dans votre widget, lors de la lecture du dashboard, le champ est linkedEntities { guid } mais lors de la mise à jour du dashboard vous devez utiliser linkedEntityGuids: [ "GUID" ].

Supprimer un dashboard

Pour supprimer un dashboard, vous devez fournir le GUID de l'entité du dashboard que vous souhaitez supprimer. Cette opération exécute une suppression logique qui vous permet de récupérer votre dashboard.

  1. Accédez à l'explorateur NerdGraph GraphiQL à l'adresse api.newrelic.com/graphiql.
  2. Utilisez l'API dashboard de NerdGraph pour supprimer le dashboard par son entité GUID.
  3. Confirmez la suppression en cochant le status et le errors.

Annuler la suppression d'un dashboard

Vous pouvez récupérer un dashboard précédemment supprimé en fonction d'un GUID d'entité dashboard. La balise personnalisée ne peut pas être récupérée.

  1. Accédez à l'explorateur NerdGraph GraphiQL à l'adresse api.newrelic.com/graphiql.
  2. Utilisez l'API dashboard de NerdGraph pour restaurer le dashboard par son entité GUID.
  3. Confirmez la suppression en cochant errors le cas échéant.

Opérations de la page du dashboard

Cette opération modifie une page spécifique d'un dashboard.

Mettre à jour une page dashboard

Vous pouvez mettre à jour une page d'un dashboard existant en fonction d'une entité GUID de page dashboard. Vous devez spécifier l'élément de dashboard complet et mis à jour, de la métadonnées à configuration widget.

  1. Accédez à l'explorateur NerdGraph GraphiQL à l'adresse api.newrelic.com/graphiql.
  2. Utilisez l'API dashboard de NerdGraph pour obtenir la configuration dashboard existante en lisant le dashboard par son entité GUID, comme indiqué dans la section Lire un dashboard.
  3. Identifiez et extrayez la page que vous souhaitez mettre à jour depuis le dashboard.
  4. Modifiez les champs que vous souhaitez mettre à jour dans la page.
  5. Utilisez dashboardUpdatePage() pour modifier la page.
  6. Cochez errors le cas échéant.

Important

Lors de la mise à jour d'une page, si les identifiants widget ne sont pas fournis, le widget existant sera supprimé du dashboard et remplacé par les nouveaux spécifiés dans la mutation.

Conseil

  • Vous pouvez ajouter un nouveau widget à une page en l'incluant dans l'éventail widgets sans champ id.
  • Vous pouvez supprimer un widget d'une page en l'omettant de l'éventail widgets.

Widget de mises à jour dans une page

Vous pouvez mettre à jour un ensemble de widgets existants d'une page de dashboard étant donné un GUID d'entité de page dashboard. Vous devez spécifier l'ensemble des widgets à mettre à jour et leur configuration complète.

Important

Cette opération ne permet pas d'ajouter ou de supprimer un widget d'une page. Pour ajouter ou supprimer un widget, utilisez l'opération Mettre à jour une page de dashboard .

  1. Accédez à l'explorateur NerdGraph GraphiQL à l'adresse api.newrelic.com/graphiql.
  2. Utilisez l'API dashboard de NerdGraph pour obtenir la configuration dashboard existante en lisant le dashboard par son entité GUID, comme indiqué dans la section Lire un dashboard.
  3. Identifiez et extrayez le widget de la page que vous souhaitez mettre à jour depuis le dashboard.
  4. Modifiez les champs que vous souhaitez mettre à jour dans le widget.
  5. Utilisez dashboardUpdateWidgetsInPage() pour modifier le widget.
  6. Cochez errors le cas échéant.
mutation UpdateWidgetsInPage(
$pageGuid: EntityGuid!
$widgets: [DashboardUpdateWidgetInput!]!
) {
dashboardUpdateWidgetsInPage(guid: $pageGuid, widgets: $widgets) {
errors {
type
description
}
}
}

Et voici les variables à utiliser avec cette mutation :

{
"guid": "PAGE_GUID",
"widgets": [
{
"id": "WIDGET_ID",
"visualization": { "id": "viz.billboard" },
"layout": { "column": 1, "row": 1, "height": 3, "width": 4 },
"title": "Updated Total Transaction Count",
"linkedEntityGuids": [],
"rawConfiguration": {
"nrqlQueries": [
{
"accountIds": [1],
"query": "SELECT count(*) FROM Transaction"
}
]
}
}
]
}

Autres opérations

Opération

Type d'opération GraphQL

Remarques

dashboardCreateSnapshotUrl()

mutation

Créer une opération d'instantané de page dashboard. Vous pouvez créer une URL publique pour une entité GUID de page dashboard donnée. La page dashboard est ensuite accessible sous la forme d’un instantané statique dans l’URL publique résultante. L'URL résultante sera obsolète trois mois après sa création. Consultez Gérer les instantanés dashboard via l'API pour plus d'informations.

actor > dashboard > liveUrls()

requête

Répertoriez toutes les opérations d'URL en direct. Vous pouvez obtenir la liste complète des URL en direct auxquelles vous avez accès. Une URL en direct est un mécanisme qui vous permet de partager publiquement des pages dashboard et des widgets avec des données à jour ou en direct. Consultez Gérer les URL des graphiques en direct via l'API pour plus d'informations.

dashboardWidgetRevokeLiveUrl()

mutation

Révoquer l'opération d'URL en direct du widget. Vous pouvez révoquer une URL en direct précédemment créée d'un widget. Par conséquent, l’URL en direct ne sera plus disponible au public. Consultez Gérer les URL des graphiques en direct via l'API pour plus d'informations.

dashboardCreateLiveUrl()

mutation

Créez une URL dashboard en direct accessible au public. Pour plus d'informations, consultez Créer, mettre à jour et révoquer les URL du dashboard de partage public.

dashboardUpdateLiveUrl()

mutation

Mettre à jour la date d’expiration d’une URL dashboard en direct accessible au public. Pour plus d'informations, consultez Créer, mettre à jour et révoquer les URL du dashboard de partage public.

dashboardRevokeLiveUrl()

mutation

Révoquer l'URL dashboard en direct accessible au public. Pour plus d'informations, consultez Créer, mettre à jour et révoquer les URL du dashboard de partage public.

dashboardUpdateLiveUrlCreationPolicies()

mutation

Seul un gestionnaire de domaine d’authentification peut utiliser cette mutation pour activer ou désactiver la politique Live URL Creation pour les comptes. L'utilisateur peut créer des URL en direct pour le dashboard dans les comptes où cette politique est activée.

Dashboards multi-comptes

Avec NerdGraph, vous pouvez créer des requêtes de données à partir de plusieurs comptes New Relic . Vous pouvez également créer un dashboard à l'aide de données provenant de plusieurs comptes en ajoutant des identifiants de compte à l'éventail accountIds.

Voici un exemple de création d'un dashboard multi-comptes :

Limites

Nous avons limité les valeurs que vous pouvez définir pour certaines propriétés dashboard . Cela nous permet de maintenir le dashboard en bon état tout en améliorant sa convivialité.

Limites du dashboard

Limite

Valeur

Nombre maximal de pages dans un dashboard

25

Longueur maximale d'un nom dashboard

255

Longueur maximale d'une description dashboard

1024

Limites de la page du dashboard

Limite

Valeur

Nombre maximal de widgets dans une page dashboard

150

Longueur maximale d'un nom de page dashboard

255

Longueur maximale d'une description de page dashboard

1024

Limites des widgets

Limite

Valeur

Longueur maximale d'un titre de widget

255

Nombre maximal d'entités liées à un widget

1

Nombre maximal de requêtes dans un widget

20

Colonne de disposition maximale d'un widget

12

Colonne de disposition minimale d'un widget

1

Ligne de disposition minimale d'un widget

1

Largeur de mise en page maximale d'un widget

12

Largeur minimale de mise en page d'un widget

1

Hauteur de mise en page maximale d'un widget

32

Hauteur minimale de mise en page d'un widget

1

Les erreurs des citoyens de première classe

Toutes les mutations dashboard offrent un moyen de demander des erreurs lors de leur exécution. Cela signifie que vous pouvez effectuer vos mutations dashboard et vérifier la réponse afin de détecter les problèmes potentiels attendus. Chaque erreur a un type et une description pour vous aider à identifier la source du problème.

Gardez à l'esprit qu'il s'agit d'erreurs attendues dont nous sommes conscients à l'avance. Vous devez également vérifier les erreurs inattendues qui seront renvoyées dans le champ d’erreurs GraphQL standard.

Droits d'auteur © 2025 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.