Diferenças entre as versões do Grafana

Correlações: as correlações definem como os dados em uma fonte de dados são usados para consultar dados em outra fonte de dados, e permitem que a visualização do Explore execute facilmente consultas relacionadas aos dados mostrados. Consulte mais detalhes em Correlações na versão 10 do Grafana.

Subpastas: ao organizar os dashboards, agora você pode usar subpastas para criar uma hierarquia aninhada. Consulte mais detalhes em Criar pastas de dashboards.

Alertas: o Grafana Alerting agora é compatível com alertas de silenciamento. Além disso, o Grafana Alerting não envia mais as notificações três vezes.

Pré-visualização da atualização de alertas: antes de atualizar dos alertas clássicos do dashboard para os alertas da Grafana, você pode ver como os alertas são, e até mesmo fazer alterações que são aplicadas durante a migração. Consulte mais detalhes em Migrar alertas clássicos do dashboard para o Grafana Alerting. A Grafana Labs anunciou que a versão 11 do Grafana, e posteriores, não oferecerá mais suporte aos alertas clássicos do dashboard.

Pacotes de suporte: os pacotes de suporte fornecem uma maneira simples de coletar informações sobre o espaço de trabalho da Grafana para compartilhar com o suporte ao produto. Você pode criar rapidamente um pacote de suporte contendo dados sobre migrações, plug-ins, configurações e muito mais. Consulte mais detalhes em Coletar informações para fins de suporte.

Novas visualizações: três novas visualizações estão disponíveis. O gráfico XY, o Datagrid e o Painel de tendência estão todos disponíveis para espaços de trabalho compatíveis com a versão 10. Os espaços de trabalho da versão 9 também podem usar gráficos XY.

PagerDuty— Os plug-ins corporativos agora incluem um plug-in para PagerDuty.

Reformulação das transformações: a guia Transformações melhorou a experiência do usuário e o design visual. As transformações são categorizadas, e cada tipo de transformação tem uma ilustração para ajudar a escolher a correta.

Enciclopédia métrica Prometheus — A lista suspensa de métricas do Prometheus no criador de consultas Prometheus foi substituída por uma enciclopédia métrica paginada e pesquisável.

Interface de usuário da chave de API descontinuada — As contas de serviço são a forma recomendada de autenticar chamadas para o HTTP da Grafana. APIs Como parte do trabalho da Grafana Labs para descontinuar as chaves de API, você não pode mais criar chaves de API por meio da interface de usuário do espaço de trabalho. Você só pode criar chaves de API por meio do AWS APIs.

Para obter mais informações sobre a descontinuação das chaves de API pelo Grafana Labs, consulte APIKeys: Eliminação das chaves de API na lista de problemas da Grafana. GitHub

Angular descontinuado: plug-ins que usam o Angular não serão mais compatíveis em versões futuras do Grafana. Na versão 10, os painéis que usam o angular mostrarão um banner informando que eles usam um atributo descontinuado, para avisar que não funcionarão em versões futuras.

O alias CloudWatch foi removido — os padrões de aliases no editor de CloudWatch consultas foram substituídos por Label (rótulos dinâmicos).

Abra qualquer dashboard que use o campo Alias e salve-o. O alias é migrado para o Rótulo automaticamente.

Plug-ins mais antigos precisam ser atualizados: os plug-ins para a fonte de dados Athena e Amazon Redshift devem ser atualizados nos espaços de trabalho do Grafana v10. O plug-in da fonte de dados Athena deve ser da versão 2.9.3 ou mais recente; o plug-in da fonte de dados Amazon Redshift deve ser da versão 1.8.3 ou mais recente.

Para obter mais informações sobre como instalar ou atualizar plug-ins, consulte Encontre plug-ins com o catálogo de plug-ins.

O BigQuery plug-in DoIt não é mais suportado — O plug-in de fonte BigQuery de dados DoIT não é mais suportado. Em vez disso, use o plug-in oficial de fonte de BigQuery dados da Grafana Labs.

Mudanças de transformação: o Grafana versão 10 fez algumas alterações de correção de bugs nos nomes e chaves dos campos. Para obter detalhes completos, consulte Transformation breaking changes na documentação da Grafana Labs.

Permissões da fonte de dados APIs — Os endpoints para acessar as permissões da fonte de dados foram alterados. Para obter detalhes completos, consulte Data source permissions changes na documentação da Grafana Labs.

Mudanças significativas no Grafana v10.0

Mudanças significativas no Grafana v10.3

Alertas: as regras de alerta gerenciadas pelo Grafana agora são compatíveis com os nomes de grupos.

Explore: crie um dashboard na visualização Explore.

Consultas do Prometheus: um novo construtor de consultas para consultas do Prometheus (usando o PromQL) facilita escrever as consultas.

Consultas do Loki: um novo construtor de consultas para consultas do Loki (usando o PromQL) facilita escrever as consultas.

Tokens de API e contas de serviço: as contas de serviço simplificam o acesso à máquina no Grafana, ajudando você a gerenciar tokens de API.

Gerenciamento de plug-ins: você pode habilitar o gerenciamento de plug-ins para instalar, remover ou atualizar os plug-ins da comunidade no espaço de trabalho. Isso lhe dá acesso a mais fontes de dados e visualizações, além possibilitar que você controle a versão de cada plug-in que você usa.

Rastreamento de métricas: configure uma fonte de dados de rastreamento para adicionar links às métricas com consultas e tags.

Painel Canvas: uma nova visualização de painel com elementos estáticos e dinâmicos para criar painéis personalizados orientados por dados com imagens e texto sobreposto.

Interface reorganizada: interface de usuário atualizada com navegação mais fácil no console do Grafana.

CloudWatch: A fonte de CloudWatch dados da Amazon agora pode monitorar métricas de forma transversal Regiões da AWS. Contas da AWS

Logs: a interface para detalhes dos logs foi aprimorada.

Geral: correções de bugs e pequenas melhorias globais.

API descontinuada: a API /api/tsdb/query foi removida.

Ação necessária: use /api/ds/query em vez disso. Consulte Consultar uma fonte de dados na documentação pública da Grafana e a Edição #49916 em. GitHub

Mudanças no endpoint da API: vários endpoints da API de alerta agora exigem o UID da fonte de dados em vez do ID numérico.

Endpoints afetados:, api/v1/rule/test, api/prometheus/, api/ruler/, api/alertmanager/

Ação necessária: atualize as chamadas de API para usar o UID da fonte de dados como parâmetro de caminho. Consulte as edições #48070, #48052, #48046 e #47978 em GitHub.

Consultas do Azure Monitor removidas: as consultas do Application Insights e do Insight Analytics não são mais compatíveis.

Obsoleto no Grafana 8.0, removido no 9.0. As consultas obsoletas não serão executadas.

Ação necessária: consulte Azure Monitor data source na documentação pública da Grafana para obter orientação sobre migração.

Modo de acesso do navegador removido: o modo de acesso do navegador não está mais disponível para fontes de dados do InfluxDB e do Prometheus.

Ação necessária: alterne para o modo de acesso ao servidor na configuração da fonte de dados. InfluxDB: obsoleto na versão 8.0.0, removido na versão 9.2.0. Veja a edição #53529 em GitHub. Prometheus: obsoleto na versão 7.4.0, removido na versão 9.2.0. Veja a edição #50162 em GitHub.

Acesso restrito às configurações do painel: você não pode mais abrir as configurações do painel ao editar painéis.

As configurações do painel são bloqueadas quando o modo de edição do painel está ativo. Feche o modo de edição do painel antes de acessar as configurações do painel. Veja a edição #54746 em GitHub.

Criptografia de senha da fonte de dados: senhas não criptografadas não são mais compatíveis.

Ação necessária: use secureJsonData.password e secureJsonData.basicAuthPassword. Anteriormente descontinuado na v8.1.0. Veja a edição #49987 em GitHub.

Comportamento padrão da fonte de dados: a seleção padrão da fonte de dados não afeta mais os painéis existentes.

A fonte de dados padrão só se aplica a novos painéis. Alterar o padrão não atualizará os painéis existentes. Os painéis salvos anteriormente mantêm a configuração da fonte de dados. Veja a edição #45132 em GitHub.

Propriedade do intervalo do Elasticsearch alterada: especificação do intervalo de consulta atualizada para o Elasticsearch 7.x.

Alterado de interval para a propriedade fixed_interval. Fornece uniformidade com o Elasticsearch 8.x. A maioria das consultas não mostrará alterações visíveis. Veja a edição #50297 em GitHub.

Modo de documento bruto do Elasticsearch descontinuado: alterações no modo de exibição na fonte de dados do Elasticsearch.

Ação necessária: use o modo Dados brutos em vez disso. Veja a edição #62236 em GitHub.

Suporte à versão do Elasticsearch: as versões mais antigas do Elasticsearch não são mais compatíveis.

Ação necessária: atualize o Elasticsearch para a versão 7.10.0 ou posterior. As versões abaixo da 7.10.0 já passaram. end-of-life Veja a edição #48715 em GitHub.

Formato de URL do Explore descontinuado — O Compact Explore URLs será removido em uma versão futura.

Ação necessária: atualize os links codificados para usar o formato de URL padrão. Compacto URLs:&left=["now-1h","now"...]. Padrão URLs:&left={"datasource":"test"...}. Veja a edição #50873 em GitHub.

GitHub OAuth alterações de exibição — exibição de GitHub nome e login atualizados.

GitHub O nome aparece como nome Grafana. GitHub o login aparece como login da Grafana. Melhora a clareza da identificação do usuário. Veja a edição #45438 em GitHub.

Implementação do painel de mapa de calor atualizada: os painéis de mapa de calor usam uma nova implementação a partir da versão 9.1.0.

Desempenho de renderização significativamente aprimorado. Os buckets são colocados em bordas razoáveis (1m, 5m, 30s). Células arredondadas não são mais compatíveis.

Ação necessária: teste seus painéis de mapa de calor após a atualização. Desabilite a nova implementação definindo o sinalizador do atributo useLegacyHeatmapPanel como verdadeiro, se necessário. Adicione ?__feature.useLegacyHeatmapPanel=true ao painel URLs para testes. Veja a edição #50229 em GitHub.

Migração de backend do InfluxDB: o comportamento de análise de dados do InfluxDB mudou.

A alternância do atributo de migração de backend do InfluxDB (influxdbBackendMigration) foi reintroduzido devido aos problemas de processamento de backend. Por padrão, os dados do InfluxDB são analisados no frontend. Se você atualizou para a versão 9.4.4 e adicionou transformações nos dados do InfluxDB, esses painéis não serão renderizados.

Ação necessária: remova os painéis afetados e recrie-os ou edite o campo time como Time em panel.json ou dashboard.json. Veja a edição #64842 em GitHub.

Formato da mensagem de log atualizado: a estrutura da mensagem de log foi alterada.

lvl agora é level. eror e dbug agora são error e debug. Maior precisão do carimbo de data/hora. Opção de recusa disponível com alternância de atributos oldlog (temporária). Veja a edição #47584 em GitHub.

Otimização do formato de dados do Loki: os dados de logs do Loki usam um formato de quadro de dados mais eficiente.

Quadro de dados único com coluna de rótulos em vez de quadros de dados separados. Os painéis Explorar e Logs funcionam sem alterações. Outros painéis ou transformações podem precisar de ajustes.

Ação necessária: substituir a transformação de rótulos para campos pela transformação de campos de extração. Veja a edição #47153 em GitHub.

Manipulação de valores NaN: representação de NaN constante entre as fontes de dados do Prometheus e do Loki.

Os valores NaN permanecem como NaN em vez de serem convertidos paranull. A mudança deve ser praticamente invisível para os usuários. Afeta tanto o painel quanto os caminhos de alerta. Veja as edições #49475 e #45389 em GitHub.

Links de redefinição de senha invalidados: os links de redefinição de senha existentes não funcionarão após a atualização.

Os links de redefinição de senha enviados antes da atualização são inválidos. Os usuários devem solicitar novos links de redefinição de senha. Os links expiram após 2 horas. Veja a edição #42334 em GitHub.

Prefixo do rótulo reservado: os rótulos que começam com grafana_ são reservados.

Os rótulos configurados manualmente, começando com grafana_, podem ser substituídos. Rótulos reservados atuais: grafana_folder (título da pasta que contém o alerta). Veja a edição #50262 em GitHub.

Melhorias na transformação: a transformação Renomear por regex agora oferece suporte a padrões globais.

Os padrões globais usam o formato /<stringToReplace>/g. Algumas transformações podem se comportar de forma diferente. Coloque as strings de correspondência entre barras para o comportamento anterior: (.*) torna-se /(.*)/. Veja a edição #48179 em GitHub.