jsonscraper
市場
ジャーナルに戻る

地域シグナルの確認:UptimeScoutのサービス状況を履歴と照合する方法

地域別の観測と履歴を取得し、時刻と鮮度を確認したうえで、アプリケーションのログと照合します。

編集方針 誤りを報告する

障害の疑いが特定地域の観測と一致するかを確認するには、サービスの状況と選択した期間の履歴を取得します。地域とタイムスタンプをアプリケーションのログと照合してください。この結果から分かるのは、保存データに地域シグナルが記録されているか、また該当レコードがどの程度新しいかという点です。

UptimeScoutの仕様書には、状況確認と履歴取得の個別のメソッドが記載されています。状況レスポンスでは、トップレベルの`status`がAPIリクエストの結果を示し、サービスのシグナルは`service.status`に格納されます。履歴には、集計された時間区間、解像度、サンプル数が含まれます。これらは初期診断やインシデント報告への添付資料として役立ちます。

1. サービス、地域、ライセンスを準備する

以下の例では、サービスIDに`github`、地域に`US`を使用します。実際の確認では、UptimeScoutのカタログにある有効なIDと、問題が観測された地域のコードを指定してください。利用可能な地域はサービスごとに異なる場合があります。解釈する前に、レスポンスの`available_regions`を確認してください。

記事:地域シグナルの確認:UptimeScoutのサービス状況を履歴と照合する方法
概要:UptimeScoutの地域シグナルを段階的に診断します。Python SDKでリクエストし、`service.status`、`observed_at`、`stale`を確認してから、履歴とその解像度を照合します。
画像の役割:カバー画像 — 中心となる考え方
セクション:1. サービス、地域、ライセンスを準備する
ビジュアルの内容:インシデント対応用のワークシートを俯瞰した編集写真風イラスト。米国の地域マップが、2つのnの横に置かれている
地図上の地域を、タイムスタンプと履歴の欠落箇所に照らして確認します。© jsonscraper · AI生成

Python 3.10以降をインストールし、プロジェクトの手順に従ってSDKを導入します。キーは環境変数`UPTIMESCOUT_LICENSE_KEY`に設定し、コードやログには含めないでください。この例では、ドキュメントに記載されたクライアントを使って2つのリクエストを実行し、元のJSONレスポンスをメモリに保持して確認用に出力します。これは統合例であり、ここで実行したテストの報告ではありません。

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,
))

公式のUptimeScout Python SDKには、クライアント、`status`と`history`の各メソッド、内部でのBearer認証が記載されています。インストールとバージョンについては、リポジトリの最新の手順に従ってください。上記のコードはSDKがインストール済みであることを前提としています。

2. リクエストの状態ではなくシグナルを確認する

レスポンスの`service.status`、`service.observed_at`、`service.stale`、およびレスポンスの地域を確認してください。トップレベルの`status`はAPIリクエストの成功を示すもので、サービス自体の可用性を示すものではありません。結論がどのレコードに基づくのか分かるように、リクエスト時刻、サービスID、地域のパラメーターも保存してください。

観測が最新とされ、`service.status`が劣化または停止を示す場合は、それを地域シグナルとして記録し、自社のログ、接続エラー、アプリケーションのチェック結果と比較します。`stale`フィールドは、保存された観測が設定済みの鮮度期間を超えているかどうかを示します。値が`true`の場合、または必要なフィールドが存在しない場合は、このレスポンスから現在の可用性を判断できないと明記してください。古い記録や不完全な記録を、現時点の状態に関する結論として扱ってはいけません。

UptimeScoutは、データを保存された地域シグナルとして説明しています。これは診断の手がかりであり、稼働率の直接測定でも、全世界に及ぶ障害の確認でもありません。したがって、結果は「この地域で、指定時刻にこの種のシグナルが記録された」と正確に表現してください。自社のチェック結果と照合することで、この外部シグナルがアプリケーションのユーザー体験と一致するか確認できます。

3. 履歴と区間の解像度を照合する

履歴メソッドは時間単位の集計データを返します。レスポンスでは`resolution_seconds`、`samples`、`counts`、`effective_start`を確認し、実際の時間区間の境界も保存してください。ドキュメントによると、区間はUTCに合わせられます。1時間以内のウィンドウでは3分、3時間以内では5分、24時間以内では1時間、それより長いウィンドウでは1日単位です。以前に保存された集計データには、より粗い解像度が引き継がれている場合があります。

記事:地域シグナルの確認:UptimeScoutのサービス状況を履歴と照合する方法
概要:UptimeScoutの地域シグナルを段階的に診断します。Python SDKでリクエストし、`service.status`、`observed_at`、`stale`を確認してから、履歴とその解像度を照合します。
画像の役割:補助イラスト2 — 別の具体的な側面
セクション:3. 履歴と区間の解像度を照合する
ビジュアルの内容:明るい背景のシンプルな編集用インフォグラフィック。4つの連続したパネルに示されているのは
レスポンスの各フィールドと、地域シグナルおよび履歴を確認する手順。© jsonscraper · AI生成イラスト

そのため、確認したい内容に応じて期間を選んでください。短いインシデントには適切な短期間の範囲を使い、結果とあわせて解像度を示します。長期間については、履歴が日単位で集計されている可能性を明記してください。日単位のデータ点から、分単位の推移を復元することはできません。

欠落した区間は未知のデータであり、正常稼働の証拠ではありません。集計値とあわせてサンプル数と区間の境界を保存してください。これにより、履歴が対象期間をどの程度カバーしているか、また結論がどのデータに基づくかを把握できます。

4. 検証可能なインシデント記録を作成する

報告書には、元のレスポンスと正規化したフィールドを保存すれば十分です。具体的には、サービス、地域、リクエスト時刻、`service.status`、`observed_at`、`stale`、選択した履歴の期間、`resolution_seconds`、サンプル数、`effective_start`です。値が欠落している場合は欠落のままにしてください。ゼロとデータなしは異なる意味を持ちます。

次に、同じ期間の内部チェック、つまりレスポンスコード、接続エラー、ホスティング地域、タイムスタンプと照合します。データが食い違う場合は、双方を保存してください。UptimeScoutの地域観測と特定のエンドポイントへのチェックは、異なる観測地点を表します。したがって、不一致があれば都合のよい方を選ぶのではなく、確認が必要です。

APIエラーが発生した場合は、HTTPコードを確認してください。仕様には、無効なパラメーター、ライセンスの未指定、無効なライセンス、クォータ超過、一時的な利用不能が挙げられています。該当する原因を修正してください。リクエストのエラーは、確認対象のサービスの状態ではありません。

当番担当者に伝える内容

簡潔な報告には、サービス、地域、観測時刻、記録の鮮度、履歴の解像度を記載してください。データのない区間は未知として別途明記し、同じ期間の内部ログを添付します。こうすることで、APIリクエストの状態、UptimeScoutの観測、アプリケーション独自の測定を混同せずに、検証可能な地域シグナルをチームに伝えられます。

人々

この記事にはまだ人物がリストされていません。

読み続けてくださいUptimeScout incidents の読み方:障害シグナルは確認済みインシデントではない
次の記事を読む

読んだ内容を実用的な連携へ

jsonscraperのソーシャルデータAPIを調べ、リクエストを試し、次のワークフローを構築しましょう。

APIを探す