Importar, exportar e adicionar dashboards e gráficos

Você pode usar o painel para visualizar e monitorar a integridade do seu sistema, resolver problemas e planejar outras etapas. Aprenda a compartilhar todas essas informações com sua equipe, clientes ou outras partes interessadas com diversas opções de importação e exportação.

Importe um dashboard como JSON

Você pode importar um dashboard como JSON quando quiser modificar um dashboard pronto para uso no nível do código. Por exemplo, se quiser criar um dashboard personalizado mesclando dois dashboards existentes, você pode modificar o JSON de um dashboard base e importá-lo de volta para New Relic.

Para importar um dashboard como JSON:

1. Vá para one.newrelic.com > All capabilities > Dashboards.

2. Abra o JSON de um dashboard existente clicando no ícone ... e selecione Copy JSON.

3. Volte para a página Dashboards .

4. No canto superior direito, clique em Import dashboard.

5. Cole seu código JSON.

6. Escolha as configurações de conta e permissão para o dashboard. Você não pode alterar a conta depois de defini-la, mas pode alterar as permissões a qualquer momento.

7. Clique em Save.

Exportar um dashboard como PDF

Para exportar seu dashboard como um arquivo PDF, no canto superior direito do dashboard, clique no ícone ... e selecione Export dashboard as PDF.

Considere o seguinte ao exportar um dashboard como PDF pela interface:

• Visualizações personalizadas não são suportadas.

Para exportar como PDF ou PNG com opções adicionais, como dimensões personalizadas e substituições de variáveis de modelo, use a API do NerdGraph.

Exportar dashboards e gráficos via API NerdGraph

Use a API NerdGraph para exportar programaticamente dashboards e widgets de gráficos individuais como imagens de snapshot. A API suporta opções não disponíveis na interface, incluindo dimensões personalizadas, sobrescrições de variáveis de template e filtros de entidade.

Exportar um dashboard como PDF ou PNG

A mutação dashboardCreateSnapshotUrl gera um URL de snapshot para uma página completa do dashboard.

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

Esquema de mutação:

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
}

Referência de parâmetros:

Exemplos:

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

Obter uma imagem de gráfico

A mutação dashboardWidgetCreateSnapshotUrl gera um URL de snapshot PNG para um único widget de gráfico. O widget não precisa existir em um dashboard — você pode defini-lo inline, o que o torna útil para gerar imagens de gráficos programaticamente.

Esquema de mutação:

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

type WidgetSnapshotResult {
  url: String!
}

O parâmetro widget aceita um DeclarativeUiWidget — um objeto JSON com três camadas aninhadas:

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

Se você estiver criando a definição do widget a partir de um dashboard que exportou como JSON, use este mapeamento de campos:

Exemplos:

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 um gráfico como CSV

Para exportar o gráfico da tabela de dashboard como um arquivo CSV, no canto superior direito do gráfico, clique em ... e selecione Export as CSV.

Considere o seguinte ao exportar um gráfico como CSV:

• Os dados sempre são exportados no horário UTC
• Exportar não suporta funções de agregador como average()
• A exportação não suporta a cláusula COMPARE_WITH
• Em alguns cenários, a interface pode realizar formatação adicional dos dados que não são replicados no CSV exportado, o que pode levar a pequenas discrepâncias (como -1.1E-17 renderizado como 0 na interface, mas não no CSV).
• Não é possível exportar os resultados de consultas entre contas.

Consultar e explorar gráficos

Para obter detalhes sobre o que você pode fazer com os gráficos, consulte Opções de consulta e gráficos.