View a markdown version of this page

Diferenças entre as versões do Grafana - Amazon Managed Grafana

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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, 10 e 12 da Grafana. Cada uma delas agregou funcionalidades da versão anterior. Os tópicos a seguir descrevem as alterações nas versões 9, 10 e 12, incluindo alterações que podem interromper a funcionalidade que você usa nas versões anteriores.

nota

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

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 12

Os seguintes recursos foram adicionados na versão 12 do Grafana.

Aplicativos detalhados
  • Detalhamento de métricas — Uma experiência sem consultas point-and-click para explorar os dados métricos do Prometheus. Consulte Detalhamento de métricas.

  • Logs Drilldown — Uma experiência sem consultas para navegar nos registros do Loki com padrões de volume e texto. Consulte Detalhamento de registros.

  • Traces Drilldown — Uma experiência sem consultas para explorar rastreamentos de Tempo distribuídos. Consulte Detalhamento de traços.

  • Detalhamento de perfis — Uma experiência sem consultas para navegar pelos dados de perfil do Pyroscope. Consulte Detalhamento de perfis.

Painéis e visualizações
  • Painéis com tecnologia Scenes — O mecanismo de renderização do painel foi reconstruído usando a estrutura Scenes, fornecendo melhor desempenho, melhor suporte a variáveis de modelo e layouts mais flexíveis.

  • Nova visualização da tabela — O painel da tabela foi completamente reconstruído para melhorar o desempenho e novos recursos, incluindo estilo de célula CSS, geração de dicas de ferramentas a partir dos campos da tabela, um rodapé aprimorado, um novo tipo de célula de ações para botões interativos e valores de células formatados automaticamente no Cell Inspect.

  • Melhorias na visualização do Canvas — Os painéis do Canvas agora oferecem suporte a links e ações de dados com um clique, direções de conexão dinâmicas, a capacidade de desativar dicas de ferramentas e melhorias de panorâmica e zoom, oferecendo mais controle sobre layouts interativos orientados por dados.

  • Ações de visualização — Agora você pode adicionar ações interativas às visualizações que acionam chamadas de API ou navegam até URLs, com suporte para variáveis personalizadas, links de dados com um clique e um novo tipo de célula Actions para visualizações de tabelas.

  • Linhas de tabela coloridas com formatação condicional — As visualizações de tabela agora oferecem suporte à formatação condicional em nível de linha, permitindo colorir linhas inteiras com base nos valores dos dados.

  • Alteração percentual da visualização de estatísticas — Os painéis de estatísticas agora exibem a alteração percentual com opções de modo de cores configuráveis, facilitando a visualização rápida das tendências.

  • Suporte de legendas no medidor de barras — As visualizações do medidor de barras agora oferecem suporte a legendas, melhorando a legibilidade ao exibir várias séries.

  • Paginação da linha do tempo estadual — As visualizações da linha do tempo estadual agora oferecem suporte à paginação, facilitando a navegação em grandes conjuntos de dados.

  • Filtros de painel redesenhados — Os filtros da lista de painéis foram redesenhados para uma experiência de navegação mais intuitiva.

  • Tipo de variável Switch — Um novo tipo de variável Switch permite alternar rapidamente entre valores em consultas, simplificando as interações do painel.

  • Opções estáticas para variáveis de consulta — As variáveis de consulta agora oferecem suporte a opções estáticas, oferecendo mais controle sobre os valores das variáveis sem exigir uma consulta à fonte de dados.

  • Filtros ad hoc aprimorados — Os filtros ad hoc agora oferecem suporte aprimorado em todas as fontes de dados, facilitando a filtragem dinâmica dos dados do painel.

  • Melhor controle da região de tempo com a sintaxe Cron — As anotações agora oferecem suporte à sintaxe Cron para regiões de tempo, fornecendo um controle mais preciso sobre as anotações baseadas em tempo.

  • Desempenho aprimorado do mapa geográfico — As visualizações do mapa geográfico agora são renderizadas significativamente mais rápido com otimizações de desempenho aprimoradas.

  • Marcadores de navegação — Agora você pode marcar páginas usadas com frequência no menu de navegação para acesso rápido.

  • Definir cores de limite a partir da consulta — A transformação Config from query agora oferece suporte à configuração dinâmica de cores de limite com base nos resultados da consulta.

  • Formato de moeda personalizado aprimorado — Uma nova opção de formato de moeda personalizado permite exibir valores financeiros exatos com controle decimal preciso.

  • Intervalos de tempo rápidos configuráveis pelo servidor — Os administradores agora podem configurar as opções de intervalo de tempo rápido disponíveis nos seletores de tempo do painel.

  • Banner de anúncio — Agora, os administradores podem exibir banners de anúncio para comunicar informações importantes aos usuários do espaço de trabalho.

Transformações
  • Matcher de substring em Filtrar por valor — A transformação Filtrar por valor agora inclui um combinador de substring, facilitando a filtragem de dados com base em correspondências parciais de texto.

  • Transformação da linha de tendência — Uma nova transformação da linha de tendência permite que você identifique padrões em seus dados adicionando linhas de tendência e médias móveis às visualizações.

  • Transformação binária para todos os campos numéricos — Agora você pode aplicar a mesma transformação binária a todos os campos numéricos em uma tabela de uma só vez, reduzindo a configuração repetitiva.

  • Nova opção de regex para campos de extração — A transformação Extrair campos agora oferece suporte a expressões regulares, fornecendo uma extração de campo mais poderosa a partir de dados de texto.

  • Atualizações de transformação — Várias melhorias de transformação foram adicionadas, incluindo novos modos e aprimoramentos de usabilidade em todo o pipeline de transformação.

  • Variáveis do painel em todas as transformações — As variáveis do painel agora são suportadas em todos os tipos de transformação, expandindo a flexibilidade dos pipelines de processamento de dados.

Geração de alertas
  • Manter o último estado dos alertas gerenciados pela Grafana — As regras de alerta agora podem ser configuradas para manter seu último estado quando uma consulta não retorna dados ou um erro, evitando alterações desnecessárias no estado de alerta.

  • Redesenho da visualização detalhada do alerta — A visualização detalhada da regra de alerta foi redesenhada com um layout mais claro e informações mais acionáveis.

  • Seletor de modelos de alertas — Um novo seletor de modelos na interface de alertas facilita a escolha e a aplicação de modelos de notificação.

  • Visibilidade aprimorada do alerta pausado — As regras de alerta pausado agora estão mais claramente indicadas na interface do usuário, facilitando a identificação de quais regras não estão sendo avaliadas ativamente.

  • Disponível apenas para alertas gerenciados pelo Grafana: silêncios específicos de regras — Agora você pode criar silêncios que se aplicam a regras de alerta específicas com permissões granulares, fornecendo uma supressão de alertas mais direcionada.

  • Regras de gravação para alertas gerenciados pelo Grafana — As regras de gravação agora estão disponíveis para alertas gerenciados pelo Grafana, permitindo que você pré-compute as consultas usadas com frequência para melhorar o desempenho. Isso substitui o recurso obsoleto de consultas gravadas. Consulte Configurar regras de gravação.

  • Histórico da versão da regra de alerta — As regras de alerta agora mantêm um histórico de versões, permitindo que você acompanhe as alterações e volte às configurações anteriores.

  • Estado de “Recuperação” da regra de alerta gerenciada pelo Grafana — As regras de alerta agora oferecem suporte ao estado de “Recuperação” que indica quando uma condição de alerta não está mais sendo acionada, mas ainda não voltou ao normal.

  • Melhorias nas regras de alerta — As regras de alerta gerenciadas pelo Grafana incluem várias melhorias de usabilidade, incluindo páginas de lista atualizadas, intervalos de tempo ativos, a capacidade de importar regras do Prometheus YAML e uma página de configurações redesenhada.

Explore e registre
  • Nova visualização de registros — Um novo painel de visualização de registros fornece renderização aprimorada de registros com um novo componente seletor de campo para personalizar quais campos são exibidos.

  • Visualizador de linha de log JSON — O aplicativo Logs Drilldown agora inclui um visualizador JSON para linhas de log estruturadas, facilitando a inspeção de dados de log formatados em JSON.

  • Pesquisa de direção direta para Loki — As consultas de Loki no Explore agora oferecem suporte à pesquisa de direção direta, permitindo que você pesquise registros do mais antigo para o mais recente.

  • Correlações no Explore — Agora você pode adicionar correlações externas URLs diretamente do Explore, permitindo uma navegação perfeita entre fontes de dados e sistemas externos. Consulte Correlações na versão 12 da Grafana.

Fontes de dados
  • Migração da fonte de dados do Amazon Managed Service para Prometheus — A partir desta versão, o suporte à autenticação Sigv4 no plug-in Core Prometheus foi descontinuado. Quando você atualiza para a versão 12 do Grafana, todas as fontes de dados do Amazon Managed Service for Prometheus que usavam anteriormente o plug-in Core Prometheus são migradas automaticamente para o plug-in Amazon Managed Service for Prometheus. Todos os painéis que usam essas fontes de dados são atualizados automaticamente para refletir essa alteração.

  • Amazon CloudWatch Logs Insights com PPL e SQL — Agora você pode consultar o Amazon CloudWatch Logs Insights usando PPL (Piped Processing Language) e a sintaxe SQL, além da linguagem de consulta padrão.

  • Suporte entre contas do Amazon CloudWatch Metric Insights — O Amazon CloudWatch Metric Insights agora oferece suporte à observabilidade entre contas, permitindo que você consulte métricas em várias. Contas da AWS

  • Detecção de anomalias e análise de padrões do Amazon CloudWatch Logs — A fonte de CloudWatch dados da Amazon agora oferece suporte à detecção de anomalias de log e à análise de padrões para identificar padrões incomuns em seus dados de log.

  • OpenSearch PPL e consultas de amostra — A fonte de OpenSearch dados agora oferece suporte à linguagem PPL e a consultas de amostra para facilitar a criação de consultas.

  • Autenticação MSSQL do Windows Active Directory — A fonte de dados do Microsoft SQL Server agora oferece suporte à autenticação do Windows Active Directory (Kerberos).

  • Remoção dos antigos Tempo e Loki Search — As interfaces antigas do Tempo Search e do Loki Search foram removidas em favor da experiência de pesquisa baseada no TraceQL.

  • BigQuery Representação de conta de serviço — A fonte de BigQuery dados agora oferece suporte à representação de conta de serviço para uma autenticação mais flexível.

  • Variáveis de modelo do Google Sheets — A fonte de dados do Google Sheets agora oferece suporte a variáveis de modelo para consultas de dados dinâmicas.

  • Suporte a macros de séries temporais para fontes de dados SQL — O criador de consultas visuais para fontes de dados SQL agora oferece suporte a macros de séries temporais, simplificando as consultas baseadas em tempo.

  • Suporte ao Unity Catalog no Databricks — O plug-in Grafana Databricks agora oferece suporte ao Unity Catalog para governança unificada de dados.

  • Suporte a consultas brutas do Honeycomb — A fonte de dados do Honeycomb agora oferece suporte a consultas brutas para recursos avançados de consulta.

  • GitHub Autenticação de aplicativos — A fonte de GitHub dados agora oferece suporte à autenticação de GitHub aplicativos como alternativa aos tokens de acesso pessoal.

Autenticação e segurança
  • Chaves de API migradas para contas de serviço — As chaves de API foram totalmente descontinuadas e migradas automaticamente para contas de serviço, fornecendo recursos aprimorados de segurança e gerenciamento. Consulte Usando contas de serviço.

  • OAuth e melhorias no tratamento de sessões SAML — O gerenciamento de sessões OAuth e provedores de autenticação SAML foi aprimorado para maior confiabilidade e segurança.

  • Suporte do Entra Workload Identity — O Grafana agora oferece suporte ao Microsoft Entra Workload Identity para autenticação em ambientes Azure.

  • OAuth2 para Alertmanager e Mimir — Agora você pode configurar a OAuth2 autenticação nas configurações HTTP para fontes de dados vanilla Alertmanager e Mimir.

Acessibilidade
  • GeoMap suporte ao teclado — GeoMap as visualizações agora oferecem suporte à navegação pelo teclado para melhorar a acessibilidade.

  • Suporte de teclado de atalho do painel — Os painéis do painel agora oferecem suporte a atalhos de teclado para ações comuns.

  • Melhorias no cabeçalho e no movimento reduzido — A estrutura do título foi aprimorada para leitores de tela e o suporte a movimentos reduzidos foi adicionado para usuários que preferem animação mínima.

Alterações significativas

Importante

Os alertas antigos foram totalmente removidos — Os alertas antigos são completamente removidos no Amazon Managed Grafana v12, e os espaços de trabalho com configurações de alerta legadas não serão iniciados. Você deve migrar do alerta legado para o Alerta Grafana antes de atualizar para a v12. Consulte Migrar alertas clássicos do dashboard para o Grafana Alerting e Alertas clássicos do dashboard.

Importante

O suporte ao AngularJS foi removido — o suporte ao AngularJS foi completamente removido no Amazon Managed Grafana v12, portanto, os plug-ins baseados em Angular não serão carregados e os painéis que os usam exibirão erros. Você deve migrar todos os plug-ins baseados em Angular para alternativas do React antes de atualizar. Consulte Encontre plug-ins com o catálogo de plug-ins para gerenciar plug-ins em seu espaço de trabalho.

Importante

As chaves de API são removidas — as chaves de API são totalmente removidas no Amazon Managed Grafana v12 em favor das contas de serviço, e as chaves de API existentes não funcionarão mais. Você deve criar contas de serviço para substituir todas as chaves de API e atualizar a automação para usar os tokens da conta de serviço antes da atualização. Consulte Usando contas de serviço.

Importante

Limite de resultados da avaliação da regra de alerta — O número de resultados da avaliação da consulta por regra de alerta agora está limitado a 500. Se a consulta de condição de uma regra de alerta produzir mais resultados do que esse limite, a avaliação resultará em um erro. Para receber alertas quando esse erro ocorrer, Alert state if execution error or timeout configure-o Error nas configurações da regra de alerta. Consulte Estado e integridade das regras de alertas.

Importante

Anotações limitadas a 3 milhões — O número de anotações agora está limitado a 3 milhões por espaço de trabalho. Se mais de 3 milhões de anotações forem criadas, as anotações mais antigas serão excluídas primeiro.

  • A fonte de dados de entrada foi removida — O plug-in da fonte de dados de entrada foi completamente removido, portanto, você deve migrar os painéis afetados para a fonte de TestData dados antes da atualização. Consulte a TestData documentação na documentação do Grafana Labs.

  • O comportamento da filtragem de consultas muda — O botão “Desativar consulta” agora é “Ocultar response/Show resposta” e as respostas das consultas ocultas não são mais retornadas aos painéis. Portanto, revise suas configurações de consulta e atualize os painéis se faltarem dados após a atualização. Consulte Alterações na filtragem de consultas na documentação do Grafana Labs.

  • A fonte de dados UIDs deve seguir um formato mais rígido — a fonte de dados agora UIDs deve usar somente caracteres alfanuméricos, hífens e sublinhados, portanto, você deve atualizar qualquer não compatível UIDs e suas referências de painel antes da atualização. Consulte Formato UID de fonte de dados mais rígido na documentação da Grafana Labs.

  • A visualização do painel URLs foi alterada para painéis repetidos — O formato do URL para visualizar painéis repetidos individuais foi alterado e o antigo URLs retornará os erros de “Painel não encontrado”. Portanto, atualize quaisquer marcadores ou automação abrindo os painéis no modo de visualização para obter o novo URLs. Consulte Alterações no URL da visualização em painel na documentação do Grafana Labs.

  • Pastas com barras iniciais exigem correspondências com escape — A introdução de subpastas pode quebrar as regras de alerta vinculadas a pastas que contêm barras, portanto, atualize as políticas de notificação com correspondências com escape (por exemplo,grafana_folder=MyFolder\/sub-folder) ou renomeie as pastas para remover barras antes da atualização. Consulte Criar pastas de dashboards e Configurar políticas de notificação.

  • Mudanças no comportamento da variável $value do modelo de alerta — A $value variável nos modelos de notificação de alerta agora retorna o valor da consulta ao consultar uma única fonte de dados, portanto, revise os modelos de alerta que usam $value e atualizam a formatação, se necessário. Consulte Modelos de rótulos e anotações.

  • Permissões de acesso às regras de alerta relaxadas — Os requisitos de permissão para acessar as regras de alerta foram relaxados. Veja Usar permissões o que há de novo no Grafana v11.1 na documentação do Grafana Labs.

  • Regras de gravação habilitadas por padrão — As regras de gravação agora estão habilitadas por padrão no Grafana Alerting. Consulte Configurar regras de gravação.

  • Endpoint POST da configuração interna do Alertmanager removido — O endpoint POST da configuração interna do Grafana Alertmanager foi removido, portanto, você deve atualizar as integrações da API para usar os novos endpoints de provisionamento (por exemplo,) antes da atualização. POST /api/v1/provisioning/alert-rules

  • Permissões de visualizador e editor expandidas — Agora os visualizadores podem ler e escrever anotações e os editores podem criar e excluir anotações. Consulte Usar permissões.

  • Permissões do criador alteradas — As permissões concedidas ao criador de um recurso (como um painel ou pasta) foram alteradas, portanto, revise suas configurações de controle de acesso após a atualização. Consulte Alteração nas permissões do criador na documentação do Grafana Labs.

  • Permissões associadas à chave de API removidas — As permissões anteriormente associadas às chaves de API foram removidas como parte da migração completa para contas de serviço. Consulte Remoção das permissões associadas à chave de API na documentação do Grafana Labs.

  • Migração do ponto de contato do SNS — os pontos de contato do SNS são migrados automaticamente para um novo notificador do SNS. Essa migração não exige nenhuma ação manual. No entanto, o esquema de configurações do ponto de contato para o SNS foi alterado. Veja um Criar canal de notificação exemplo do formato de solicitação atualizado.

  • Limite de resultados da avaliação da regra de alerta — O número de resultados da avaliação da consulta por regra de alerta agora está limitado a 500. Se a consulta de condição de uma regra de alerta produzir mais resultados do que esse limite, a avaliação resultará em um erro. Para receber alertas quando esse erro ocorrer, configure Alert state if execution error or timeout nas configurações da regra de alerta. Error

  • Autenticação SigV4 removida do plug-in Core Prometheus — O suporte à autenticação SigV4 no plug-in Core Prometheus foi removido. Quando você atualiza para a versão 12 do Grafana, todas as fontes de dados do Amazon Managed Service for Prometheus que usavam anteriormente o plug-in Core Prometheus são migradas automaticamente para o plug-in Amazon Managed Service for Prometheus. Todos os painéis que usam essas fontes de dados são atualizados automaticamente para refletir essa alteração. Consulte Conecte-se a uma fonte de dados do Amazon Managed Service for Prometheus.

O Amazon Managed Grafana v12 inclui recursos do Grafana de código aberto v11.0 a v12.4. Para recursos AWS específicos, consulte o Guia do usuário do Amazon Managed Grafana. Para obter informações detalhadas sobre as novidades, consulte O que há de novo no Grafana para v11.x e v12.x na documentação do Grafana Labs. As versões 11.x e 12.x incluem alterações que podem interromper a funcionalidade, portanto, teste em um ambiente que não seja de produção antes de atualizar os espaços de trabalho de produção.

Para obter mais detalhes sobre mudanças importantes, consulte os seguintes tópicos na documentação do Grafana Labs:

Grafana 12

Grafana 11

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

Para obter mais detalhes sobre mudanças importantes, consulte os seguintes tópicos na documentação do Grafana Labs:

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 atributos e melhorias, com base nas versões anteriores. Essa versão teve algumas mudanças que podem pausar a funcionalidade em alguns casos. Ao atualizar para uma nova versão, recomendamos testar em um ambiente que não seja de produção antes de atualizar os 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 /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.