Importer, exporter et ajouter des dashboards et des graphiques

Vous pouvez utiliser le dashboard pour visualiser et suivre l'état de votre système, résoudre les problèmes et planifier les étapes ultérieures. Apprenez à partager toutes ces informations avec votre équipe, vos clients ou d’autres parties prenantes grâce à diverses options d’importation et d’exportation.

Importer un dashboard au format JSON

Vous pouvez importer un dashboard au format JSON lorsque vous souhaitez modifier un dashboard prêt à l'emploi au niveau du code. Par exemple, si vous souhaitez créer un dashboard personnalisé en fusionnant deux dashboards existants, vous pouvez modifier le JSON d'un dashboard de base, puis le réimporter dans New Relic.

Pour importer un dashboard au format JSON :

1. Allez à one.newrelic.com > All capabilities > Dashboards.

2. Ouvrez le JSON d’un dashboard existant en cliquant sur l’icône ..., puis sélectionnez Copy JSON.

3. Retournez à la page Dashboards .

4. Dans le coin supérieur droit, cliquez sur Import dashboard.

5. Collez votre code JSON.

6. Choisissez les paramètres de compte et d'autorisation pour le dashboard. Vous ne pouvez pas modifier le compte une fois que vous l'avez configuré, mais vous pouvez modifier les autorisations à tout moment.

7. Cliquez sur Save.

Exporter un dashboard au format PDF

Pour exporter votre dashboard sous forme de fichier PDF, dans le coin supérieur droit du dashboard, cliquez sur l'icône ... et sélectionnez Export dashboard as PDF.

Tenez compte des éléments suivants lors de l’exportation d’un dashboard au format PDF via l’interface utilisateur :

• Les visualisations personnalisées ne sont pas prises en charge.

Pour exporter au format PDF ou PNG avec des options supplémentaires telles que des dimensions personnalisées et des remplacements de variables de modèle, utilisez l’ API NerdGraph.

Exporter des dashboards et des graphiques via l'API NerdGraph

Utilisez l'API NerdGraph pour exporter par programmation des dashboards et des widgets de graphiques individuels sous forme d'images instantanées. L'API prend en charge des options non disponibles dans l'interface utilisateur, notamment les dimensions personnalisées, les surcharges de variables de modèle et les filtres d'entité.

Exporter un dashboard au format PDF ou PNG

La mutation dashboardCreateSnapshotUrl génère une URL d’instantané pour une page de dashboard complète.

{
  actor {
    entitySearch(
      query: "parentId ='YOUR_DASHBOARD_GUID' AND tags.isDashboardPage = 'true'"
    ) {
      results {
        entities {
          guid
          name
        }
      }
    }
  }
}

Schéma de mutation :

mutation {
  dashboardCreateSnapshotUrl(
    guid: EntityGuid!
    params: SnapshotUrlInput
  ): String
}

input SnapshotUrlInput {
  timeWindow: SnapshotUrlTimeWindowInput
  display: SnapshotUrlDisplayInput
  variables: [SnapshotUrlVariableInput!]
  filter: String
  format: SnapshotUrlFormat
}

input SnapshotUrlTimeWindowInput {
  beginTime: EpochMilliseconds
  endTime: EpochMilliseconds
  duration: Milliseconds
}

input SnapshotUrlDisplayInput {
  width: Int
  height: Int
}

input SnapshotUrlVariableInput {
  name: String!
  values: [String!]!
}

enum SnapshotUrlFormat {
  PDF
  PNG
}

Référence des paramètres :

Exemples :

mutation {
  dashboardCreateSnapshotUrl(guid: "YOUR_DASHBOARD_PAGE_GUID")
}

mutation {
  dashboardCreateSnapshotUrl(
    guid: "YOUR_DASHBOARD_PAGE_GUID"
    params: { format: PNG, display: { width: 1920, height: 1080 } }
  )
}

mutation {
  dashboardCreateSnapshotUrl(
    guid: "YOUR_DASHBOARD_PAGE_GUID"
    params: {
      variables: [
        { name: "environment", values: ["production"] }
        { name: "region", values: ["us-east-1", "eu-west-1"] }
      ]
      filter: "env = 'production' AND service = 'checkout'"
    }
  )
}

Obtenir une image de graphique

La mutation dashboardWidgetCreateSnapshotUrl génère une URL d’instantané PNG pour un seul widget de graphique. Le widget n’a pas besoin d’exister sur un dashboard — vous pouvez le définir en ligne, ce qui le rend utile pour générer des images de graphiques par programmation.

Schéma de mutation :

mutation {
  dashboardWidgetCreateSnapshotUrl(
    widget: DeclarativeUiWidget!
  ): WidgetSnapshotResult
}

type WidgetSnapshotResult {
  url: String!
}

Le paramètre widget accepte un DeclarativeUiWidget — un objet JSON avec trois couches imbriquées :

declarative/widget envelope
└── widget node        ← title and widget-level props
    └── visualization  ← visualization type and configuration

{
  "type": "declarative/widget",
  "version": 1,
  "content": {
    "type": "widget",
    "props": {
      "title": "My Chart Title"
    },
    "content": {
      "type": "visualization",
      "id": "viz.line",
      "props": {
        // visualization-specific config (nrqlQueries, colors, thresholds, etc.)
      }
    }
  }
}

Si vous créez la définition du widget à partir d’un dashboard que vous avez exporté au format JSON, utilisez cette modélisation de champ :

Exemples :

mutation {
  dashboardWidgetCreateSnapshotUrl(
    widget: {
      version: 1
      type: "declarative/widget"
      content: {
        type: "widget"
        props: { title: "Throughput by environment" }
        content: {
          type: "visualization"
          id: "viz.line"
          props: {
            nrqlQueries: [
              {
                accountIds: [YOUR_ACCOUNT_ID]
                query: "SELECT count(*) FROM Transaction TIMESERIES"
              }
            ]
            legend: { enabled: true }
          }
        }
      }
    }
  ) {
    url
  }
}

mutation {
  dashboardWidgetCreateSnapshotUrl(
    widget: {
      version: 1
      type: "declarative/widget"
      content: {
        type: "widget"
        props: { title: "Error rate" }
        content: {
          type: "visualization"
          id: "viz.billboard"
          props: {
            nrqlQueries: [
              {
                accountIds: [YOUR_ACCOUNT_ID]
                query: "SELECT percentage(count(*), WHERE error IS true) AS 'Error rate' FROM Transaction SINCE 1 hour ago"
              }
            ]
            thresholds: [
              { alertSeverity: "WARNING", value: 1 }
              { alertSeverity: "CRITICAL", value: 5 }
            ]
          }
        }
      }
    }
  ) {
    url
  }
}

Exporter un graphique au format CSV

Pour exporter un graphique de tableau de dashboard sous forme de fichier CSV, dans le coin supérieur droit du graphique, cliquez sur ... et sélectionnez Export as CSV.

Tenez compte des éléments suivants lors de l’exportation d’un graphique au format CSV :

• Les données sont toujours exportées en heure UTC
• L'exportation ne prend pas en charge les fonctions d'agrégation telles que average()
• L'exportation ne prend pas en charge la clause COMPARE_WITH
• Dans certains scénarios, l'UI peut effectuer un formatage supplémentaire des données qui ne sont pas répliquées dans le fichier CSV exporté, ce qui peut entraîner de petites divergences (comme le rendu de -1.1E-17 sous la forme 0 dans l'UI mais pas dans le fichier CSV)
• Vous ne pouvez pas exporter les résultats d'une requête inter-comptes.

requête et exploration des graphiques

Pour plus de détails sur ce que vous pouvez faire avec les graphiques, voir Options d'interrogation et de création de graphiques.