Referência

Como o CloudPeek funciona

O que o CloudPeek busca na AWS, quando seus widgets são atualizados, o que eles mostram quando uma atualização falha e quanto tudo isso custa.

Atualizado em 20 de outubro de 2026

Do CloudWatch para a Tela de Início

Uma definição de widgetUm widget de um painel do CloudWatch, uma predefinição ou um widget que um modelo de IA escreveu: o próprio JSON do CloudWatch, dizendo quais métricas ou alarmes e como mostrá-los.
Dados do CloudWatchBuscados na conta do widget com o login dela, direto do seu dispositivo para a AWS.
Um instantâneoOs valores, prontos para desenhar, guardados no seu dispositivo. O widget da Tela de Início o desenha em todos os tamanhos.

Sempre que um widget é atualizado, o CloudPeek:

  1. Lê o painel de novo, no caso de um widget de painel (GetDashboard), e encontra o widget nele, para que as edições feitas no console ou no código apareçam. Predefinições e widgets de IA não têm painel, então pulam esta etapa: um widget de IA guarda a própria definição com o widget, e uma predefinição é recriada a partir da predefinição como esta versão do app a tem, mantendo o título, a região e o intervalo de tempo.
  2. Monta as consultas como o console do CloudWatch faz: intervalo de tempo, período, matemática de métricas, SEARCH e a região de cada métrica. Consulte a Referência de widgets.
  3. Busca os dados com uma solicitação GetMetricData para cada região que o widget usa, em paralelo. Os widgets de alarmes chamam DescribeAlarms na região de cada alarme.
  4. Salva um instantâneo no seu dispositivo, em um armazenamento que só o app e os widgets dele podem ler, e o widget o desenha.

Não há nenhum servidor do CloudPeek no meio: consulte O que sai do seu dispositivo.

Quando os widgets são atualizados

  • Em uma programação: a cada 30 minutos por padrão. Mude isso em Ajustes (no Android, Configurações), em Widgets da Tela de Início, com Atualizar: a cada 30 minutos ou a cada 1, 2 ou 6 horas e, no Android, também a cada 15 minutos. O iOS decide o momento exato, com base na frequência com que você olha seus widgets, e espaça as atualizações em um dia movimentado ou no Modo de Pouca Energia, então considere isso uma referência. O iOS dá a um widget que você olha com frequência cerca de 40 a 70 atualizações por dia, menos do que a cada 15 minutos exigiria, então o iPhone e o iPad não oferecem essa opção: um widget configurado assim em uma versão anterior é atualizado a cada 30 minutos. O Android também decide o momento exato e pode esperar enquanto o celular economiza bateria.
  • Com menos frequência quando a AWS atualiza os dados com menos frequência: o tamanho e a contagem de objetos dos buckets do S3 (BucketSizeBytes e NumberOfObjects), que o S3 informa uma vez por dia, são atualizados no máximo a cada 6 horas, e as cobranças estimadas (AWS/Billing), que a AWS atualiza algumas vezes por dia, no máximo a cada 3 horas. Atualizá-los com mais frequência mostraria os mesmos números e seria cobrado de novo. Um widget que também mostra outra métrica é atualizado conforme a programação. A tela do widget informa quando isso se aplica, como “O S3 atualiza estes dados uma vez por dia, então o widget é atualizado a cada 6 horas, e não a cada 30 minutos.” ou, quando ele não tem dados e já diz “O S3 informa o tamanho dos buckets uma vez por dia.”, apenas “Ele é atualizado a cada 6 horas, e não a cada 30 minutos.”
  • Sempre que você abre o CloudPeek, exceto esses widgets, até que os dados deles precisem ser atualizados de novo.
  • Quando você pede: o botão de atualizar em um widget médio ou maior, puxar para baixo na aba Widgets, Atualizar no menu Mais de um widget ou Atualizar Widgets Agora em Ajustes (no Android, Configurações). Isso busca todos os widgets, até os que têm dados que a AWS atualiza com menos frequência. O widget cujo botão de atualizar você toca mostra que a atualização está em andamento até os novos dados chegarem; no Android, o botão vira um círculo girando, e esse widget é atualizado antes dos outros.

Dados carregados nos últimos cinco minutos, pelo app ou por outro widget, são reaproveitados em vez de buscados e cobrados de novo, a menos que você tenha pedido uma atualização ou que uma atualização tenha falhado desde então. Os dados de armazenamento do S3 e de faturamento são reaproveitados da mesma forma até precisarem ser atualizados de novo.

As notificações de alarme vêm dessas atualizações, então só são tão rápidas quanto elas: consulte Receber notificação quando um alarme disparar.

Quando uma atualização falha

  • O widget mantém os últimos dados e diz o motivo e a idade deles: “Login expirado · dados de sex. 14:05” nos widgets médios e grandes, ou “Sem atualização desde 14:05” nos pequenos.
  • Dados com mais de um dia ficam esmaecidos, para não passarem por atuais.
  • Depois de uma falha passageira da rede ou da AWS, um widget com dados recentes tenta de novo em até 10 minutos. Outras falhas, como um login que terminou, esperam a próxima atualização programada: elas precisam que você faça algo antes.
  • Depois que o iPhone ou o iPad reinicia, os widgets não conseguem ler seus logins até você desbloqueá-lo pela primeira vez. Eles tentam de novo a cada poucos minutos no início e depois com menos frequência.
  • Se o armazenamento seguro do Android não puder ser lido por um momento, os widgets dizem “Não foi possível ler seu login salvo. Nova tentativa em breve.” e tentam de novo em poucos minutos no início e depois com menos frequência.

Todas as mensagens, e o que fazer em cada caso, estão em Solução de problemas.

Quanto custa

O CloudPeek é gratuito. O que ele solicita à AWS é cobrado na sua conta da AWS, pelos preços normais do CloudWatch:

O quêCobranças da AWS
Cada atualização de um widget de métricas: uma solicitação GetMetricData por regiãoUS$ 0,01 por 1.000 métricas solicitadas, contando as métricas ocultas, como as que a matemática de métricas lê, e cada métrica que uma expressão SEARCH encontra. Um widget com 5 métricas atualizado a cada 30 minutos solicita cerca de 7.200 por mês: cerca de 7 centavos de dólar. Os widgets de armazenamento do S3 e de faturamento são atualizados com menos frequência, então custam menos.
Cada atualização de um widget de painel também lê o painel dele (GetDashboard); os widgets de alarmes chamam DescribeAlarms em vez de GetMetricDataSolicitações de API, cobradas por solicitação e não por métrica. O nível gratuito do CloudWatch cobre o primeiro milhão de cada conta por mês. Consulte Preços do CloudWatch.
Ver um widget em outro intervalo de tempo na tela dele, ou com a semana anteriorMais uma busca GetMetricData das métricas dele para cada intervalo de tempo em que você tocar, e duas com a semana anterior: consulte Outro intervalo de tempo e a semana anterior.
Painéis que você criaOs três primeiros são gratuitos; depois, US$ 3 por mês cada um. Predefinições e widgets de IA não precisam de painel.
Escrever um widget de IA, uma vezCerca de um centavo de dólar no Amazon Bedrock, cobrado na conta; ou alguns centavos com o Claude Sonnet 5.5, cobrados na sua conta da Anthropic. Consulte Widgets de IA.

Ajustes (no Android, Configurações) estima quanto seus widgets custam, em Atualizar, e muda a estimativa conforme você muda o intervalo, como “Seus 7 widgets solicitam 40 métricas por atualização: cerca de US$ 0,58 por mês, atualizando a cada 30 minutos.” A estimativa conta cada widget no próprio intervalo e considera que ele é atualizado conforme a programação. Quantas métricas uma expressão SEARCH encontra só se sabe quando ela é executada, então, para widgets com buscas, a estimativa diz quanto cada métrica encontrada acrescenta por mês.

Para acompanhar isso, adicione a predefinição Chamadas de GetMetricData: ela mostra em um gráfico as chamadas de GetMetricData da sua conta a cada hora.

Quando um painel muda

Os widgets de um painel o acompanham: eles reencontram o widget de origem depois que ele é movido, redimensionado, renomeado ou editado, e mantêm a última versão se ele não for encontrado. Como as alterações chegam ao seu celular tem os detalhes.