Configurar um espaço de trabalho do Amazon Managed 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á.

Configurar um espaço de trabalho do Amazon Managed Grafana

A configuração do Amazon Managed Grafana pode ser separada em configuração da autenticação e permissões do Amazon Managed Grafana e configuração do espaço de trabalho do Grafana. Esta seção inclui informações sobre a configuração do espaço de trabalho do Grafana.

Para obter mais informações sobre como configurar a autenticação e as permissões do Amazon Managed Grafana, consulte os tópicos a seguir.

Você pode modificar a configuração do espaço de trabalho do Grafana no Amazon Managed Grafana na guia de opções de configuração do espaço de trabalho ao visualizar as propriedades do espaço de trabalho.

Fazer alterações na configuração da instância do Grafana pode fazer com que a instância seja reiniciada para recarregar as novas configurações. Depois que as alterações na configuração forem feitas, os usuários talvez precisem atualizar qualquer página do navegador que mostre o espaço de trabalho do Grafana.

nota

As mesmas opções estão disponíveis quando você cria o espaço de trabalho pela primeira vez.

Para alterar a configuração de um espaço de trabalho do Grafana usando o console do Amazon Managed Grafana
  1. Abra o console do Amazon Managed Grafana em https://console.aws.amazon.com/grafana/.

  2. No painel de navegação à esquerda, escolha o ícone de menu.

  3. Escolha Todos os workspaces.

  4. Escolha o nome do espaço de trabalho que você deseja configurar. Isso abre os detalhes do espaço de trabalho.

  5. Escolha a guia Opções de configuração do espaço de trabalho para ver as opções de configuração de instâncias para a sua instância.

  6. Selecione Editar ao lado de Grafana Alerting ou Gerenciamento de plug-ins.

    • Grafana Alerting

      Você pode habilitar o Grafana Alerting. Para visualizar os alertas do Prometheus no espaço de trabalho do Grafana, marque a caixa de seleção para ativar o Grafana Alerting. Em espaços de trabalho em execução na versão 8 ou 9, isso enviará várias notificações para os alertas do Grafana. Se você usa alertas definidos no Grafana, recomendamos atualizar o espaço de trabalho para a versão 10.4 ou posterior.

      Se, em vez disso, você quiser usar os alertas clássicos do Grafana, desmarque a caixa de seleção ao lado de Ativar o Grafana Alerting. Isso ativa os alertas clássicos do dashboard. Mesmo que você não ative o Grafana Alerting, os alertas existentes do Grafana serão avaliados.

      nota

      Os alertas clássicos do dashboard serão removidos na versão 11. Nos espaços de trabalho do Grafana versão 10, você pode pré-visualizar o recurso de alertas do Grafana. Para ter mais informações, consulte Migrar alertas clássicos do dashboard para o Grafana Alerting.

    • Gerenciamento de plug-ins

      Para ativar o gerenciamento de plug-ins, marque a caixa de seleção Ativar o gerenciamento de plug-ins. Ativar o gerenciamento de plug-ins permite que os administradores no espaço de trabalho do Amazon Managed Grafana instalem, atualizem ou removam plug-ins usando o catálogo de plug-ins do Grafana. Esta opção estará disponível apenas para espaços de trabalho que sejam compatíveis com o Grafana versão 9 ou mais recente.

nota

Caso desative o Grafana Alerting, você perderá todas as alterações feitas na configuração dos alertas enquanto os alertas do Grafana estavam ativados. Isso inclui todas as novas regras de alerta que você criou.

Para obter mais informações sobre como usar o Grafana Alerting e os efeitos de ativá-lo ou desativá-lo, consulte Alertas no Grafana versão 10.

A próxima seção mostra como fazer alterações na configuração da instância do Grafana usando a AWS CLI ou a API do Amazon Managed Grafana.

Definir a configuração com a API ou a AWS CLI

Você pode definir a configuração do espaço de trabalho do Grafana usando a AWS CLI ou a API do Amazon Managed Grafana.

nota

A configuration é uma string JSON para permitir futuras configurações que serão adicionadas posteriormente.

AWS CLI
Para atualizar a configuração da instância do Amazon Managed Grafana usando a AWS CLI

Execute o comando a seguir para ativar os recursos de alertas e gerenciamento de plug-ins do Grafana para uma instância. Substitua as strings <region> e <workspace-id> pelos valores apropriados para a instância.

aws grafana update-workspace-configuration \ --region region \ --workspace-id <workspace-id> \ --configuration '{"plugins": {"pluginAdminEnabled": true}, "unifiedAlerting": {"enabled": true}}'

A configuração atualmente é compatível com as opções a seguir. Eles ativam ou desativam o Grafana Alerting ou o gerenciamento de plug-ins.

  • Para habilitar o Grafana Alerting, use esta opção de configuração:

    --configuration '{"unifiedAlerting": { "enabled": true }}'
  • Para habilitar o gerenciamento de plug-ins, use esta opção de configuração:

    --configuration '{"plugins": {"pluginAdminEnabled": true }}'

    Esta opção está disponível apenas em espaços de trabalho que sejam compatíveis com o Grafana versão 9 ou mais recente.

Amazon Managed Grafana API
Para atualizar a configuração da instância do Amazon Managed Grafana usando a API

Use a ação a seguir para ativar os recursos de alertas e gerenciamento de plug-ins do Grafana para uma instância. Substitua a string <workspace-id> por um valor apropriado para a instância.

PUT /workspaces/<workspace-id>/configuration HTTP/1.1 Content-type: application/json { "configuration": "{ \"unifiedAlerting\": { \"enabled\": true }, \"plugins\": { \"pluginAdminEnabled\": true }}" }

A configuração atualmente é compatível com as opções a seguir. Eles ativam ou desativam o Grafana Alerting ou o gerenciamento de plug-ins.

  • Para habilitar o Grafana Alerting, use esta opção de configuração:

    "configuration": "{\"unifiedAlerting\": { \"enabled\": true }}"
  • Para habilitar o gerenciamento de plug-ins, use esta opção:

    "plugins": "{\"pluginAdminEnabled\": true }"

    Esta opção está disponível apenas em espaços de trabalho que sejam compatíveis com o Grafana versão 9 ou mais recente.