Diferenças entre as versões do Grafana

Ao criar um espaço de trabalho do Grafana, você deve escolher uma versão do Grafana para criar. Você pode escolher entre as versões compatíveis com as versões 8, 9 e 10 do Grafana. Cada uma delas agregou funcionalidades da versão anterior. Os tópicos a seguir descrevem as alterações nas versões 9 e 10, incluindo alterações na versão 10 que podem pausar a funcionalidade que você usa na versão 9.

nota

Você pode ler a documentação específica da versão para usar o espaço de trabalho do Grafana nos tópicos Trabalhar no Grafana versão 8, Trabalhar no Grafana versão 9 e Trabalhar no Grafana versão 10.

Para observações detalhadas por versão e mais informações da Grafana Labs, consulte What's new in Grafana na documentação da Grafana Labs.

Grafana versão 10

Os seguintes recursos foram adicionados no Grafana versão 10.

• 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 do Grafana. GitHub

Alterações significativas

O Grafana versão 10.4 inclui as alterações das versões 9.5 a 10.4 do Grafana. As versões 10.0 e 10.3 do Grafana tiveram algumas mudanças que podem pausar a funcionalidade em alguns casos. Ao atualizar para uma nova versão, é recomendável testar em um ambiente que não seja de produção antes de atualizar os espaços de trabalho de produção.

As alterações a seguir podem afetar alguns usuários que estão atualizando para a versão 10 do Grafana.

• Angular descontinuado — Os plug-ins que usam o Angular não serão mais suportados 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 recurso 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.

Para obter mais detalhes sobre mudanças importantes e as que afetam os desenvolvedores de plug-ins, consulte os seguintes tópicos na documentação da Grafana Labs:

• Mudanças significativas no Grafana v10.0

• Mudanças significativas no Grafana v10.3

Grafana versão 9

Os recursos a seguir foram adicionados ao Grafana v9.

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

Alterações significativas

A versão 9.4 do Grafana inclui uma série de novos recursos e melhorias, com base nas versões anteriores. Essa versão teve algumas alterações que podem interromper a funcionalidade em alguns casos. Ao atualizar para uma nova versão, recomendamos que você teste em um ambiente que não seja de produção antes de atualizar seus espaços de trabalho de produção.

As seguintes alterações podem afetar alguns usuários que estão atualizando para a versão 9.4 do Grafana. Para obter uma lista detalhada dessas mudanças, consulte o changelog do Grafana 9.4 em. GitHub

• API descontinuada — A /api/tsdb/query API 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 suportadas.

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

  Ação necessária: consulte a fonte de dados do Azure Monitor 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 7.4.0, removido na 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 suportadas.

  Ação necessária: Use secureJsonData.password secureJsonData.basicAuthPassword e. 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 fixed_interval propriedade. Fornece consistência 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: em vez disso, use o modo Dados brutos. Veja a edição #62236 em GitHub.

• Suporte à versão do Elasticsearch — As versões mais antigas do Elasticsearch não são mais suportadas.

  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 Heatmap atualizada — Os painéis Heatmap usam uma nova implementação a partir da versão 9.1.0.

  Desempenho de renderização significativamente aprimorado. Os baldes são colocados em bordas razoáveis (1m, 5m, 30s). As células redondas não são mais suportadas.

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

• Migração de back-end do InfluxDB — o comportamento de análise de dados do InfluxDB mudou.

  O recurso de migração de back-end do InfluxDB toggle (influxdbBackendMigration) foi reintroduzido devido a problemas de processamento de back-end. Por padrão, os dados do InfluxDB são analisados no front-end. Se você atualizou para 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 time campo como Time em panel.json oudashboard.json. Veja a edição #64842 em GitHub.

• Formato da mensagem de log atualizado — A estrutura da mensagem de log foi alterada.

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

• Otimização do formato de dados Loki — Os dados de registros 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 Explore and Logs funcionam sem alterações. Outros painéis ou transformações podem precisar de ajustes.

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

• Manipulação de valores NaN — NaN representação consistente em todas as fontes de dados do Prometheus e do Loki.

  NaNos valores 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 da etiqueta reservada — As etiquetas que começam com grafana_ são reservadas.

  Os rótulos configurados manualmente, começando com, grafana_ podem ser substituídos. Marcadores 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 sequências de correspondência em barras para frente para o comportamento anterior: (.*) torna-se. /(.*)/ Veja a edição #48179 em GitHub.