Gerenciando painéis

Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana que oferecem suporte à versão 9.x do Grafana.

Para espaços de trabalho do Grafana compatíveis com a versão 8.x do Grafana, consulteTrabalhando na versão 8 do Grafana.

Um painel é um conjunto de um ou mais painéis que apresentam visualmente seus dados em uma ou mais linhas.

Para obter mais informações sobre a criação de painéis, consulte Adicionar e organizar painéis.

Criar pastas de painel

As pastas ajudam você a organizar e agrupar painéis, o que é útil quando você tem muitos painéis ou várias equipes usando a mesma instância do Grafana.

Pré-requisitos

Verifique se você tem permissões de administrador do Grafana. Para obter mais informações sobre as permissões do painel, consulte Permissões do painel.

Para criar uma pasta de painel

1. Faça login no Grafana e, no menu lateral, clique em Painéis > Nova pasta

2. Insira um nome exclusivo e clique em Criar.

nota

Ao salvar um painel, você pode selecionar uma pasta para salvar o painel ou criar uma nova pasta.

Gerenciando painéis e pastas

Na página Gerenciar painéis e pastas, você pode:

• Criar uma pasta

• Criar um painel

• Mover painéis para pastas

• Exclua vários painéis

• Navegue até uma página de pasta na qual você pode atribuir permissões de pasta e painel

Página da pasta do painel

Você pode concluir as seguintes tarefas na página da pasta do painel:

• Mova ou exclua painéis em uma pasta.

• Renomeie uma pasta (disponível na guia Configurações).

• Atribua permissões às pastas (que são herdadas pelos painéis na pasta).

Para navegar até a página da pasta do painel, clique na engrenagem que aparece quando você passa o mouse sobre uma pasta na lista de resultados de pesquisa do painel ou na página Gerenciar painéis e pastas.

Permissões do painel

Você pode atribuir permissões a uma pasta. Todas as permissões que você atribuir são herdadas pelos painéis na pasta. Uma Lista de Controle de Acesso (ACL) é usada onde a função da organização, a equipe e um usuário podem receber permissões.

Consulte as permissões para obter mais informações.

Exportar e importar painéis

Você pode usar a interface do usuário do Grafana ou a API HTTP para exportar e importar painéis.

Exportando um painel

A ação de exportação do painel cria um arquivo JSON do Grafana que contém tudo o que você precisa, incluindo layout, variáveis, estilos, fontes de dados, consultas e assim por diante, para que você possa importar o painel posteriormente.

nota

O Grafana baixa um arquivo JSON para sua máquina local.

1. Abra o painel que você deseja exportar.

2. Clique no ícone de compartilhamento.

3. Clique em Export.

4. Clique em Salvar em arquivo.

Tornando um painel portátil

Se quiser exportar um painel para outras pessoas usarem, você pode adicionar variáveis de modelo para coisas como um prefixo métrico (use uma variável constante) e nome do servidor.

Uma variável de modelo do tipoConstant será automaticamente ocultada no painel e também será adicionada como uma entrada necessária quando o painel for importado.

Importando um painel

1. Clique em Painéis > Importar no menu lateral.

2. Execute uma das etapas a seguir.

   • Faça o upload de um arquivo JSON do painel.

   • Cole o URL do painel Grafana.com.

   • Cole o texto JSON do painel diretamente na área de texto.

   O processo de importação permite que você altere o nome do painel, escolha a fonte de dados que você deseja que o painel use e especifique quaisquer prefixos métricos (se o painel usar algum).

Painéis de solução de problemas

Esta seção fornece informações para ajudar você a resolver problemas comuns do painel.

O painel está lento

Se seu painel estiver lento, considere o:

• Você está tentando renderizar dezenas (ou centenas ou milhares) de séries temporais em um gráfico? Isso pode causar atraso no navegador. Tente usar funções como HighestMax (em Graphite) para reduzir a série retornada.

• Às vezes, os nomes das séries podem ser muito grandes. Isso causa tamanhos de resposta maiores. Utilize alias para reduzir o tamanho dos nomes de série retornados.

• Você está consultando muitas séries temporais ou por um longo período de tempo? Ambas as condições podem fazer com que o Grafana ou sua fonte de dados extraiam muitos dados, o que pode torná-los mais lentos.

• Pode ser uma carga alta em sua infraestrutura de rede. Se a lentidão não for consistente, esse pode ser o problema.

Problemas na taxa de atualização do painel

Por padrão, o Grafana consulta sua fonte de dados a cada 30 segundos. Definir uma baixa taxa de atualização em seus painéis gera um stress desnecessário no back-end. Em muitos casos, consultar isso com frequência não é necessário porque os dados não estão sendo enviados ao sistema para que as alterações possam ser vistas.

Se você tiver esse problema, as soluções a seguir são recomendadas.

• Não ative a atualização automática em painéis, painéis ou variáveis, a menos que você precise. Os usuários podem atualizar o navegador manualmente ou você pode definir a taxa de atualização por um período que faça sentido (como a cada dez minutos ou a cada hora).

• Se for necessário, defina a taxa de atualização para uma vez por minuto. Os usuários sempre podem atualizar o painel manualmente.

• Se seu painel tiver um período de tempo mais longo (como uma semana), a atualização automática pode não ser necessária.

Manipular ou renderizar dados nulos é errado ou confuso

Alguns aplicativos publicam dados de forma intermitente. Por exemplo, eles só publicam uma métrica quando ocorre um evento. Por padrão, os gráficos Grafana conectam linhas entre os pontos de dados.