

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

# Trabalhando com alertas de limite no Amazon Quick Sight
<a name="threshold-alerts"></a>


|  | 
| --- |
|  Aplica-se a: Enterprise Edition  | 

Para se manter informado sobre mudanças importantes em seus dados, você pode criar alertas de limite usando imagens de KPI, medidor, tabela e tabela dinâmica em um painel do Amazon Quick Sight. Com esses alertas, você pode definir limites para os dados e ser notificado por e-mail quando os dados os excederem. Você também pode visualizar e gerenciar seus alertas a qualquer momento em um navegador compatível com o Quick Sight.

Por exemplo, suponhamos que você seja um gerente de sucesso do cliente de uma grande organização e deseja saber quando o número de tickets em uma fila de suporte excede um determinado número. Suponhamos também que você tenha um painel com um elemento visual de KPI, medidor, tabela ou tabela dinâmica que rastreia o número de tickets nesta fila. Nesse caso, é possível criar um alerta e receber uma notificação por e-mail quando o número exceder o limite especificado. Dessa forma, você poderá tomar medidas assim que receber uma notificação.

É possível criar vários alertas para um único elemento visual. Se o elemento visual for atualizado ou excluído pelo autor após a criação de um alerta, as configurações de alerta não serão alteradas. Quando você cria um alerta, o alerta assume todos os filtros aplicados ao elemento visual naquele momento. Se você ou o autor alterarem o filtro, o alerta existente não sofrerá alterações. No entanto, se você criar um novo alerta, ele assumirá as novas configurações de filtragem.

Por exemplo, suponhamos que você tenha um painel com um controle de filtro que pode ser usado para alternar os dados de cada elemento visual no painel de uma cidade dos Estados Unidos para outra. Você tem um elemento visual de KPI no painel que mostra a média de voos que partem com atraso e tem interesse em atrasos de voos que partem de Seattle, Washington, nos Estados Unidos. Você altera o controle de filtro para Seattle e define um alerta no elemento visual. Este alerta rastreará atrasos de voos de Seattle. Amanhã, suponhamos que você também deseja rastrear atrasos de voos que partem de Portland, Oregon. Portanto, você deve alterar o controle de filtro para Portland e criar outro alerta. Este novo alerta rastreará atrasos de voos de Portland. Agora, você tem dois alertas, um para Seattle e outro para Portland, que trabalham de forma independente.

Os alertas de limite não estão disponíveis na região da `eu-central-2` Europa (Zurique).

Para obter mais informações sobre elementos visuais de KPI, medidores, tabelas e tabelas dinâmicas, consulte [Tipos visuais no Amazon Quick Sight](working-with-visual-types.md).

**nota**  
Você não pode criar alertas para imagens em um painel incorporado ou no aplicativo móvel Quick.  
Nos elementos visuais da tabela, alertas de limite não podem ser criados para valores localizados na fonte de campo `Group by`. Os alertas podem ser criados somente para valores que estejam localizados na fonte de campo `Value`.  
Os elementos visuais de KPI que não usam um campo de data e hora como tendência não oferecem suporte a alertas. Um exemplo é um KPI que mostra a diferença em voos entre as transportadoras X e Y em vez de um KPI que mostra a diferença em voos entre as datas A e B. 

Use as seções abaixo para criar e configurar alertas de limite para visuais de KPI, medidor, tabela e tabela dinâmica no Quick Sight.

**Topics**
+ [Permissões de alertas](threshold-alerts-permissions.md)
+ [Como criar alertas](threshold-alerts-creating.md)
+ [Gerenciamento de alertas de limites](threshold-alerts-managing.md)
+ [Investigação de falhas relacionadas aos alertas](threshold-alerts-failures.md)
+ [Programação de alertas](threshold-alerts-scheduling.md)
+ [Usando conectores de ação rápida em alertas de limite](action-connectors-in-threshold-alerts.md)

# Permissões de alertas
<a name="threshold-alerts-permissions"></a>

Se você for administrador, poderá controlar quem em sua organização pode definir alertas de limite no Quick Sight criando uma política de permissões personalizada. Para definir permissões personalizadas no Rápido, escolha seu nome de usuário no canto superior direito de qualquer página do Rápido, escolha **Gerenciar Rápido** e, em seguida, escolha Permissões **personalizadas**.

# Como criar alertas
<a name="threshold-alerts-creating"></a>

Use o procedimento apresentado a seguir para criar alertas de limite para elementos visuais de KPI ou medidores em um painel.

**Criar um alarme**

1. Abra o Quick e navegue até o painel que você deseja.

   Para obter mais informações sobre a visualização de painéis como assinante do painel no Quick, consulte. [Interagindo com os painéis do Amazon Quick Sight](exploring-dashboards.md)

1. No painel, selecione o elemento visual para o qual deseja criar um alerta, abra o menu no canto superior direito e escolha **Criar alerta**.

1. No menu no canto superior direito do elemento visual, escolha o ícone **Criar alerta**.

   Como alternativa, você pode escolher o ícone de alerta na barra de ferramentas em azul no canto superior direito. Em seguida, na página **Criar alerta** que é aberta, selecione o elemento visual de KPI, medidor, tabela ou tabela dinâmica para o qual você deseja criar um alerta e, depois, clique em **Próximo**.

   Você também pode criar alertas em elementos visuais de tabela ou de tabela dinâmica ao selecionar uma célula e escolher **Criar alerta**. É possível criar alertas somente para células individuais. Não é possível criar alertas para colunas inteiras ou para valores que usam uma agregação personalizada. Para obter mais informações sobre as agregações personalizadas, consulte [Funções agregadas](calculated-field-aggregations.md).

1. Na página **Criar alerta** que abre à direita, faça o seguinte:

   1. Em **Nome**, insira um nome para o alerta.

      Por padrão, o nome do elemento visual é usado para o nome do alerta. Você pode alterá-lo, se desejar.

   1. Em **Valor a ser rastreado**, escolha um valor para o qual você deseja definir o limite. As informações apresentadas variarão de acordo com o tipo de elemento visual para o qual você está criando um alerta.

      Os valores disponíveis para esta opção são baseados nos valores que o autor do painel define no elemento visual. Por exemplo, suponhamos que você tenha um elemento visual de KPI que mostra uma diferença percentual entre duas datas. Diante disso, você visualiza duas opções de valores para o alerta: diferença percentual e real.

      Se houver somente um valor no elemento visual, você não poderá alterar essa opção. O valor corresponderá ao valor atual e será exibido para que você possa usá-lo como referência ao escolher um limite. Por exemplo, se você estiver definindo um alerta sobre o custo médio, esse valor mostrará qual é o custo médio atual (suponhamos que seja USD 5). Com este valor de referência, você pode tomar decisões mais informadas ao definir seu limite.

   1. Em **Condição**, escolha uma condição para o limite. 

      Você pode escolher as condições apresentadas a seguir.
      + **Está acima de**: define uma regra na qual o alerta será acionado se o valor do alerta for superior ao limite definido.
      + **Está abaixo de**: define uma regra na qual o alerta será acionado se o valor do alerta for inferior ao limite definido.
      + **É igual a**: define uma regra na qual o alerta será acionado se o valor do alerta for igual ao limite definido.

   1. Em **Limite**, insira um valor para solicitar o alerta.

   1. Em **Preferência de notificação**, escolha com que frequência você deseja receber notificações sobre uma violação do limite definido.

      Você pode escolher entre as opções a seguir.
      + **Sempre que possível**: esta opção alerta você sempre que o limite for excedido. Se você escolher esta opção, poderá receber alertas várias vezes ao dia.
      + **No máximo diariamente**: esta opção alerta você uma vez por dia quando o limite é excedido.
      + **No máximo semanalmente**: esta opção alerta você uma vez por semana quando o limite é excedido.

   1. (Opcional) Escolha **Envie-me um e-mail quando não houver dados**. Ao selecionar esta opção, você receberá notificações quando não houver dados para verificar a regra de alerta.

   1. Escolha **Salvar**.

      Uma mensagem no canto superior direito aparece indicando que o alerta foi salvo. Se seus dados ultrapassarem o limite definido, você receberá uma notificação por e-mail no endereço associado à sua conta Quick. 

# Gerenciamento de alertas de limites
<a name="threshold-alerts-managing"></a>

Você pode editar os alertas existentes, ativá-los ou desativá-los, ou visualizar o histórico dos momentos em que o alerta foi acionado. Use os procedimentos apresentados a seguir para fazer isso.

**Editar um alerta existente**

1. Abra o Quick, escolha **Painéis** e, em seguida, navegue até o painel para o qual você deseja editar um alerta.

1. Na página Painéis, escolha **Alertas** no canto superior direito.

1. Na página **Gerenciar alertas** que é aberta, localize o alerta que você deseja editar e, em seguida, escolha **Editar** abaixo do nome do alerta.

   Você pode editar o nome, a condição e o limite do alerta.

1. Escolha **Salvar**.

**Visualizar o histórico de quando um alerta foi acionado**

1. Abra o Quick, escolha **Painéis** e, em seguida, navegue até o painel do qual você deseja visualizar o histórico de alertas.

1. Na página Painéis, escolha **Alertas** no canto superior direito.

1. Na página **Gerenciar alertas** que é aberta, localize o alerta cujo histórico de alertas você deseja visualizar e, em seguida, escolha **Histórico** abaixo do nome do alerta.

**Ativar ou desativar um alerta existente**

1. Abra o Quick, escolha **Painéis** e navegue até o painel para o qual você deseja ativar ou desativar um alerta.

1. Na página Painéis, escolha **Alertas** no canto superior direito.

1. Na página **Gerenciar alertas** que é aberta, localize o alerta que você deseja ativar ou desativar e, em seguida, selecione ou desmarque a alternância pelo nome do alerta.

   O alerta estará ativado quando o botão de alternância estiver azul e desativado quando o botão de alternância estiver cinza.

**Excluir um alerta existente**

1. Abra o Quick, escolha **Painéis** e navegue até o painel do qual você deseja excluir um alerta.

1. Na página Painéis, escolha **Alertas** no canto superior direito.

1. Na página **Gerenciar alertas** que é aberta, encontre o alerta que deseja ativar ou desativar, escolha o menu de três pontos ao lado do alerta e, em seguida, selecione **Excluir** no menu suspenso.

# Investigação de falhas relacionadas aos alertas
<a name="threshold-alerts-failures"></a>

Quando um alerta falha, o Quick envia uma notificação por e-mail sobre a falha. Os alertas podem apresentar falhas por vários motivos, incluindo os seguintes:
+ O conjunto de dados que o alerta está usando foi excluído.
+ O proprietário do alerta perdeu as permissões para o conjunto de dados ou para determinadas linhas ou colunas no conjunto de dados.
+ O proprietário do alerta perdeu o acesso ao painel.
+ Não há dados para os dados rastreados pelo alerta.

Quando ocorre uma falha, o Quick envia uma notificação e desativa o alerta se o motivo da falha provavelmente não for corrigido. Por exemplo, se o alerta falhar devido à perda de acesso a um painel ou se o painel tiver sido excluído. Caso contrário, o Quick tentará verificar novamente se há violações de limites em seus dados. Depois de quatro falhas, o Quick desliga o alerta e notifica que o alerta está desativado. Se o alerta puder ser verificado novamente, o Quick enviará uma notificação para você.

Para investigar por que um alerta falhou, verifique se você ainda tem acesso ao painel. Verifique também se você tem permissões para o conjunto de dados adequado e para as linhas e colunas corretas no conjunto de dados. Se você perdeu o acesso ou as permissões, entre em contato com o proprietário do painel. Se você tiver as permissões e o acesso necessários, pode ser necessário editar o alerta para evitar futuras falhas relacionadas aos alertas.

# Programação de alertas
<a name="threshold-alerts-scheduling"></a>

Quando você cria um alerta, o Quick verifica se há violações em seus dados em relação aos limites definidos com base em quando seu conjunto de dados está programado para ser atualizado. As informações apresentadas no alerta variam de acordo com o tipo de elemento visual para o qual você está criando um alerta. Para conjuntos de dados do SPICE, as regras de alerta são verificadas após uma atualização bem-sucedida do conjunto de dados do SPICE. Para conjuntos de dados de consulta direta, as regras de alerta são verificadas em um horário aleatório entre 18h e 8h no local Região da AWS que contém o conjunto de dados por padrão.

Se você for proprietário de um conjunto de dados, poderá definir uma programação de avaliação de alertas nas configurações do conjunto de dados. Consulte o procedimento apresentado a seguir para saber como fazer isso.

**Definir uma programação de avaliação de alertas para um conjunto de dados**

1. Em Rápido, escolha **Dados** na barra de navegação à esquerda.

1. Escolha o conjunto de dados para o qual você deseja agendar avaliações de alertas.

1. Escolha **Definir programação de alertas**.

1. Na página **Definir programação de alertas** que é aberta, faça o seguinte:
   + Em **Time zone** (Fuso horário), escolha um fuso horário.
   + Em **Repetições**, escolha com que frequência você deseja que os dados sejam avaliados.
   + Em **Inicia**, insira o horário em que você deseja que a avaliação de alerta seja iniciada.

# Usando conectores de ação rápida em alertas de limite
<a name="action-connectors-in-threshold-alerts"></a>

## Pré-requisitos
<a name="action-connectors-in-threshold-alerts-prerequisites"></a>

Antes de começar, certifique-se de [criar pelo menos um conector de ação](builtin-services-integration.md).

O conector deve atender aos seguintes requisitos:
+ Usa o **método de autenticação Service Auth**
+ Usa uma das seguintes integrações:
  + Atlassian Jira Cloud
  + Microsoft Outlook
  + Salesforce
  + ServiceNow

## Ative ações rápidas em um painel para usar conectores de ação
<a name="enable-quick-actions-on-dashboards-for-threshold-alert"></a>

**Para habilitar ações rápidas em um painel para usar conectores de ação**

1. Se existir um painel, acesse a análise de origem do painel. Caso contrário, [crie uma nova análise](quickstart-createanalysis.md).

1. Selecione **Publish**.

1. Escolha entre **Novo painel** ou **Substituir painel existente**.

1. Escolha a caixa de seleção **Ativar ações rápidas** em **Opções do painel**.

1. Escolha **Publicar painel**.

## Use conectores de ação em um alerta de limite
<a name="use-action-connectors-in-threshold-alert"></a>

**Para usar conectores de ação em um alerta de limite**

1. Abra um painel com a opção **Ativar publicação de ações rápidas** ativada.

1. Passe o mouse sobre um visual compatível com alertas de limite. Os tipos de imagens que suportam alertas podem ser encontrados [aqui](threshold-alerts.md).

1. Escolha o ícone da campainha.

1. O painel **Criar alerta** é aberto à direita.

1. Escolha **Add Action**.

1. Um menu é exibido com uma lista de todos os conectores de ação e ações compatíveis.

1. Escolha a ação desejada na lista.

1. Um formulário de **ação** aparece no painel direito.

1. Insira todas as informações que você precisa incluir na ação.

1. Alguns campos permitem a inclusão de valores de preenchimento automático. Escolha **Preenchimento automático** para abrir o menu. Escolha os valores que você precisa e eles serão adicionados ao texto inserido.
   + **Valor**: injeta o valor atual que foi usado pelo alerta para avaliar a condição do alerta
   + **Nome do alerta**: injeta o nome do alerta
   + **Condição**: injeta a condição de alerta
   + **Limite**: injeta o valor limite
   + **Tudo**: injeta todos os itens acima

1. Algumas ações oferecem suporte à capacidade de incluir um anexo. Opcionalmente, você pode anexar um PDF da planilha do painel atual com essas ações marcando a caixa de seleção **Incluir esta planilha como PDF**.

1. Escolha **Adicionar ação** para adicionar a ação ao alerta.

1. De volta ao painel **Criar alerta**, a ação configurada é adicionada ao alerta na parte inferior.

1. Configure todos os outros campos desejados do alerta e escolha **Salvar**.

1. Quando seu limite configurado é violado, essa ação deve ser invocada. Para saber mais sobre quando um alerta de limite é avaliado, consulte [Programação de alertas](threshold-alerts-scheduling.md).

## Segurança e personalizações
<a name="threshold-alert-security-and-customizations"></a>

** Permissions/Capability Personalização personalizada**
+ Capacidade de **ações**: você não pode ver ou usar ações se seu usuário ou função tiver restrições à permissão para usar o recurso Ações
+ Capacidade **de exportação para PDF**:
  + Novas ações nos alertas: você não verá a opção de anexar um PDF da planilha ao adicionar uma nova ação a um alerta se seu usuário ou função tiver a permissão restrita de usar o recurso **Exportar para PDF**.
  + Ações existentes em alertas: Se você tiver alertas existentes com ações contendo anexos em PDF, essas ações serão enviadas sem os anexos em PDF quando seu usuário ou função for impedido de usar o recurso **Exportar** para PDF.

Para saber mais sobre permissões personalizadas, consulte [Criação de um perfil de permissões personalizado no Amazon Quick](create-custom-permissions-profile.md).

**Segurança em nível de linha (RLS) /Segurança em nível de coluna (CLS)**
+ Novas ações em alertas: se seu painel contiver um conjunto de dados com RLS ou CLS, então
  + Você não pode adicionar ações a novos alertas que rastreiam o conjunto de dados com RLS ou CLS
  + Você pode adicionar ações a novos alertas que rastreiam um conjunto de dados diferente sem RLS ou CLS, mas não pode incluir anexos em PDF nessas ações
+ Ações existentes em alertas: se você adicionar RLS ou CLS a um conjunto de dados depois de criar alertas com ações,
  + As ações existentes nos alertas que rastreiam esse conjunto de dados deixarão de funcionar completamente
  + As ações existentes nos alertas que rastreiam um conjunto de dados diferente no mesmo painel serão enviadas sem anexos em PDF

Para saber mais sobre o RLS, consulte Como [usar a segurança em nível de linha no Amazon Quick](row-level-security.md).

Para saber mais sobre o CLS, consulte Como [usar a segurança em nível de coluna para restringir o acesso a um conjunto](row-level-security.md) de dados.

**Opções de publicação do painel**
+ Habilite a geração de PDF para planilhas interativas
  + Novas ações em alertas: você não verá a opção de anexar um PDF da planilha ao adicionar uma nova ação em alerta se seu painel tiver a opção **Habilitar geração de PDF para publicação de planilhas interativas** desativada.
  + Ações existentes em alertas: Se você tiver alertas existentes com ações contendo anexos em PDF, essas ações serão enviadas sem os anexos em PDF quando a opção **Habilitar geração de PDF para publicação de planilhas interativas for desativada em** seu painel.
+ Ativar ações rápidas
  + Novas ações nos alertas: você não verá a opção de adicionar uma ação ao alerta se o painel tiver a opção **Ativar publicação de ações rápidas** desativada.
  + Ações existentes em alertas: Suas ações existentes em alertas deixarão de funcionar completamente quando a opção **Ativar publicação de ações rápidas** for desativada em seu painel.

Para saber mais sobre as opções de publicação de painéis, consulte [Publicação de painéis](creating-a-dashboard.md).