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 do Enterprise agora incluem um plug-in para o 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 de métricas do Prometheus: a lista suspensa de métricas do Prometheus no construtor de consultas do Prometheus foi substituída por uma enciclopédia paginada e pesquisável de métricas.

Interface de usuário da chave de API descontinuada: as contas de serviço são a forma recomendada de autenticar chamadas para as APIs HTTP do Grafana. 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 das APIs da AWS.

Para obter mais informações sobre a descontinuação das chaves de API pela Grafana Labs, consulte APIKeys: Sunsetting of API keys na lista de problemas do GitHub do Grafana.

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.

Alias no CloudWatch removido: os padrões de alias no editor de consultas do CloudWatch foram substituídos por Rótulo (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.

Plug-in do DoiT BigQuery não mais compatível: o plug-in da fonte de dados DoiT BigQuery não é mais compatível. Em vez disso, use o plug-in oficial da fonte de dados BigQuery 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.

APIs de permissões da fonte de dados: 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 dados Amazon CloudWatch agora pode monitorar métricas entre Contas da AWS e Regiões 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. Acesse Query a data source na documentação pública da Grafana e a Edição #49916 no 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 os issues #48070, #48052, #48046 e #47978 no 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. Consulte o issue #53529 no GitHub. Prometheus: obsoleto na versão 7.4.0, removido na versão 9.2.0. Consulte o issue #50162 no 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. Consulte o issue #54746 no 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. Consulte o issue #49987 no 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. Consulte o issue #45132 no 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. Consulte o issue #50297 no 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. Consulte o issue #62236 no 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. Versões anteriores a 7.10.0 já foram descontinuadas. Consulte o issue #48715 no GitHub.

Formato de URL Explorar descontinuado: URLs compactos do Explorar serão removidos em uma versão futura.

Ação necessária: atualize os links codificados para usar o formato de URL padrão. URLs compactos: &left=["now-1h","now"...]. URLs padrão: &left={"datasource":"test"...}. Consulte o issue #50873 no GitHub.

Alterações na exibição do GitHub OAuth: nome e exibição de login do GitHub atualizados.

O nome do GitHub aparece como nome Grafana. O login do GitHub aparece como login da Grafana. Melhora a clareza da identificação do usuário. Consulte o issue #45438 no 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 aos URLs do painel para testes. Consulte o issue #50229 no 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. Consulte o issue #64842 no 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). Consulte o issue #47584 no 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. Consulte o issue #47153 no 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. Consulte os issues #49475 e #45389 no 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. Consulte o issue #42334 no 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). Consulte o issue #50262 no 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 /(.*)/. Consulte o issue #48179 no GitHub.