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 selecionando Download dashboard.

3. Escolha JSON nas opções de formato e selecione Copy to clipboard.

4. Volte para a página Dashboards .

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

6. Cole seu código JSON.

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

8. Clique em Save.

Exportar um dashboard

Para exportar um dashboard como um arquivo JSON, PDF ou PNG:

1. No canto superior direito do dashboard, clique no ícone ... e selecione Download dashboard.

2. Escolha JSON, PDF ou PNG como o formato de saída.

3. (Opcional) Para PDF ou PNG, defina a largura e a altura de exportação, em pixels. Ambos têm como padrão 1920 x 1080.

4. Clique em Download.

A New Relic não oferece suporte a visualizações personalizadas ao exportar um dashboard como PDF ou PNG por meio da interface.

Para exportar como PDF ou PNG com opções adicionais, como substituições de variáveis de template e filtros de entidade, 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 em PNG para um único widget de gráfico. O widget não precisa existir em um dashboard — é possível defini-lo de forma inline, o que o torna útil para gerar imagens de gráficos de forma programática.

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.

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.