Importar, exportar y agregar dashboards y gráficos

Puede emplear el dashboard para visualizar y realizar un seguimiento del estado de su sistema, abordar problemas y planear pasos adicionales. Aprenda a compartir toda esa información con su equipo, clientes u otras partes interesadas con varias opciones de importación y exportación.

Importar un dashboard como JSON

Puede importar un dashboard como JSON cuando desee modificar un dashboard listo para usar a nivel de código. Por ejemplo, si desea crear un dashboard personalizado fusionando dos dashboards existentes, puede modificar el JSON de un dashboard base y luego importarlo nuevamente a New Relic.

Para importar un dashboard como JSON:

1. Vaya a one.newrelic.com > All capabilities > Dashboards.

2. Abra el JSON de un dashboard existente haciendo clic en el icono ... y seleccionando Download dashboard.

3. Elija JSON de las opciones de formato y seleccione Copy to clipboard.

4. Vuelva a la página Dashboards .

5. En la esquina superior derecha, haga clic en Import dashboard.

6. Pega tu código JSON.

7. Elija la configuración de cuenta y licencias para el dashboard. No puede cambiar la cuenta una vez que la configuró, pero puede cambiar las licencias en cualquier momento.

8. Haga clic en Save.

Exportar un dashboard

Para exportar un dashboard como archivo JSON, PDF o PNG:

1. En la esquina superior derecha del dashboard, haga clic en el icono ... y seleccione Download dashboard.

2. Elija JSON, PDF o PNG como formato de salida.

3. (Opcional) Para PDF o PNG, establezca el ancho y alto de exportación, en píxeles. Ambos tienen un valor predeterminado de 1920 x 1080.

4. Haga clic en Download.

New Relic no admite visualizaciones personalizadas al exportar un dashboard como PDF o PNG a través de la UI.

Para exportar como PDF o PNG con opciones adicionales, como anulaciones de variables de plantilla y filtros de entidad, utilice la API de NerdGraph.

Exportar dashboard y gráficos mediante la API de NerdGraph

Use la API de NerdGraph para exportar mediante programación dashboards y widgets de gráficos individuales como imágenes de instantáneas. La API admite opciones que no están disponibles en la UI, incluidas dimensiones personalizadas, anulaciones de variables de plantilla y filtros de entidad.

Exportar un dashboard como PDF o PNG

La mutación dashboardCreateSnapshotUrl genera una URL de instantánea para una página completa del dashboard.

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

Esquema de mutación:

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
}

Referencia de parámetros:

Ejemplos:

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'"
    }
  )
}

Obtener una imagen de gráfico

La mutación dashboardWidgetCreateSnapshotUrl genera una URL de instantánea PNG para un solo widget de gráfico. El widget no necesita existir en un dashboard —puede definirlo en línea, lo que hace que esto sea útil para generar imágenes de gráficos mediante programación.

Esquema de mutación:

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

type WidgetSnapshotResult {
  url: String!
}

El parámetro widget acepta un DeclarativeUiWidget — un objeto JSON con tres capas anidadas:

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 está construyendo la definición del widget desde un dashboard que ha exportado como JSON, utilice este mapeo de campos:

Ejemplos:

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

Exportar un gráfico como CSV

Para exportar el gráfico de tabla de dashboard como un archivo CSV, en la esquina superior derecha del gráfico, haga clic en ... y seleccione Export as CSV.

Consulta y explora gráficos

Para obtener detalles sobre lo que puede hacer con los gráficos, consulte Opciones de consultas y gráficos.