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 luego seleccione Copy JSON.

3. Vuelva a la página Dashboards .

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

5. Pega tu código JSON.

6. 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.

7. Haga clic en Save.

Exportar un dashboard como PDF

Para exportar su dashboard como un archivo PDF, en la esquina superior derecha del dashboard, haga clic en el icono ... y seleccione Export dashboard as PDF.

Considere lo siguiente al exportar un dashboard como PDF a través de la UI:

• No se admiten visualizaciones personalizadas.

Para exportar como PDF o PNG con opciones adicionales, como dimensiones personalizadas y anulaciones de variables de plantilla, use 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 resulta útil para generar imágenes de gráficos de forma programática.

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.

Tenga en cuenta lo siguiente al exportar un gráfico como CSV:

• Los datos siempre se exportan en hora UTC
• Exportar no admite funciones de agregador como average()
• La exportación no admite la cláusula COMPARE_WITH
• En algunos escenarios, la UI puede realizar un formateo adicional de los datos que no se replican en el CSV exportado, lo que puede generar pequeñas discrepancias (como -1.1E-17 se representa como 0 en la UI pero no en el CSV).
• No es posible exportar los resultados de una consulta entre cuentas.

Consulta y explora gráficos

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