Para verificar se uma suspeita de falha corresponde às observações de uma região específica, consulte o status do serviço e o histórico do período escolhido. Compare a região e os registros de data e hora com os logs da aplicação. O resultado responde a uma pergunta específica: há um sinal regional registrado nos dados armazenados e quão recente é o registro correspondente.
A especificação do UptimeScout descreve métodos separados para status e histórico. Na resposta de status, o campo de nível superior `status` informa o resultado da solicitação à API; o sinal do serviço está em `service.status`. O histórico contém intervalos de tempo agregados, a resolução e o número de amostras. Esses dados são úteis para o diagnóstico inicial e como anexo a um relatório de incidente.
1. Prepare o serviço, a região e a licença
O exemplo abaixo usa o identificador de serviço `github` e a região `US`. Para sua verificação, use um ID válido do catálogo do UptimeScout e o código da região onde o problema foi observado. As regiões disponíveis podem variar conforme o serviço; antes de interpretar os dados, confira `available_regions` na resposta.

Instale o Python 3.10+ e o SDK seguindo as instruções do projeto. Defina a chave na variável de ambiente `UPTIMESCOUT_LICENSE_KEY` e não a inclua no código nem nos logs. O exemplo faz duas consultas usando o cliente documentado, mantém as respostas JSON originais na memória e as imprime para inspeção. Trata-se de um exemplo de integração, não de um relatório de um teste executado aqui.
import json
import os
from uptimescout import Client, UptimeScoutError
client = Client(os.environ["UPTIMESCOUT_LICENSE_KEY"], timeout=30)
try:
status_data = client.status("github", region="US", lang="ru")
history_data = client.history("github", region="US", hours=24, lang="ru")
except UptimeScoutError as error:
raise SystemExit(f"API request failed: HTTP {error.status}")
print(json.dumps(
{"status": status_data, "history": history_data},
ensure_ascii=False,
indent=2,
))
O SDK Python oficial do UptimeScout documenta o cliente, os métodos `status` e `history` e a autenticação Bearer usada internamente. Para instalação e versões, siga as instruções atuais do repositório; o trecho mostrado pressupõe que o SDK já esteja instalado.
2. Confirme que está lendo o sinal, não o status da solicitação
Na resposta, confira os campos `service.status`, `service.observed_at`, `service.stale` e a região informada. O campo de nível superior `status` diz respeito ao sucesso da solicitação à API, não à disponibilidade do próprio serviço. Salve também o horário da solicitação, o ID do serviço e os parâmetros da região: assim, ficará claro a qual registro a conclusão se refere.
Se a observação estiver marcada como recente e `service.status` indicar degradação ou interrupção, registre isso como um sinal regional e compare-o com os próprios logs, erros de conexão e verificações da aplicação. O campo `stale` indica se a observação armazenada ultrapassou a janela de atualidade definida. Se for `true` ou se o campo necessário estiver ausente, considere desconhecida a disponibilidade atual com base nessa resposta; não transforme um registro desatualizado ou incompleto em uma conclusão sobre o estado presente.
O UptimeScout descreve os dados como sinais regionais armazenados: eles servem de referência para o diagnóstico, não como medição direta de disponibilidade nem como confirmação de uma falha global. Portanto, formule o resultado com precisão: “foi encontrado um sinal deste tipo para a região, registrado no horário indicado”. A comparação com as próprias verificações mostrará se esse sinal externo é compatível com a experiência dos usuários da sua aplicação.
3. Compare o histórico e a resolução dos intervalos
O método de histórico retorna agregações temporais. Na resposta, confira `resolution_seconds`, `samples`, `counts` e `effective_start`; salve também os limites de tempo efetivos dos intervalos. A documentação descreve o alinhamento em UTC: intervalos de três minutos para janelas de até uma hora, de cinco minutos para até três horas, de uma hora para até um dia e diários para janelas mais longas. Agregações antigas armazenadas podem manter uma resolução declarada mais grosseira.

Por isso, escolha a janela de acordo com a pergunta. Para um incidente breve, use um intervalo curto adequado e apresente a resolução junto com o resultado. Para um período longo, indique que o histórico pode estar agregado por dia: um ponto diário não permite reconstruir a dinâmica minuto a minuto.
Intervalos ausentes representam dados desconhecidos, não evidência de funcionamento normal. Mantenha o número de amostras e os limites dos intervalos junto aos valores agregados. Isso ajuda a entender até que ponto o histórico cobre o período investigado e em quais dados a conclusão se baseia.
4. Prepare um registro de incidente verificável
Para o relatório, basta salvar as respostas originais e os campos normalizados: serviço, região, horário da solicitação, `service.status`, `observed_at`, `stale`, janela de histórico escolhida, `resolution_seconds`, número de amostras e `effective_start`. Deixe os valores ausentes como ausentes: zero e ausência de dados têm significados diferentes.
Em seguida, compare essas informações com as verificações internas do mesmo período: códigos de resposta, erros de conexão, região de hospedagem e registros de data e hora. Se os dados divergirem, preserve ambos os lados. Uma observação regional do UptimeScout e uma verificação de um endpoint específico representam pontos de observação diferentes; portanto, a divergência por si só exige investigação, não a escolha da resposta mais conveniente.
Em caso de erro da API, consulte o código HTTP: a especificação lista parâmetros inválidos, ausência de licença, licença inválida, cota excedida e indisponibilidade temporária. Corrija a causa correspondente. Um erro na solicitação não é o status do serviço que está sendo verificado.
O que enviar à pessoa de plantão
No resumo, informe o serviço, a região, o horário da observação, a atualidade do registro e a resolução do histórico. Identifique separadamente os intervalos sem dados como desconhecidos e anexe os logs internos do mesmo período. Assim, a equipe terá um sinal regional verificável, sem confundir o estado da solicitação à API, as observações do UptimeScout e as medições próprias da aplicação.