jsonscraper
שווקים
חזרה ליומן

UptimeScout: איך לבדוק אם הייתה תקלה בשירות באזור של המשתמש

ניתוח מקרה מעשי: איסוף היסטוריית תצפיות לפי אזור והבחנה בין אות עדכני לפרק זמן לא ידוע

מדיניות עריכה דיווח על שגיאה

כשמשתמשים במדינה אחת מדווחים על בעיות, בעוד הצוות רואה שהשירות פועל כרגיל, כדאי לבדוק את התצפיות באזור שלהם. ממשק ה-API של UptimeScout מאפשר לבקש היסטוריה של שירות נבחר לפי קוד אזורי ולקבל מרווחי זמן לצד מספר המדידות. התוצאה היא טבלה שניתן לבדוק במסגרת בירור הפנייה: זמן המרווח, רזולוציה, התפלגות האותות ומספר הדגימות.

כתבה: UptimeScout: איך לבדוק אם הייתה תקלה בשירות באזור של המשתמש
תקציר: בדיקת זמינות אזורית יכולה לענות על השאלה אם אירוע שדווח על ידי משתמש תואם לתצפיות של UptimeScout. מדריך לתהליך שניתן לשחזור: בחירת שירות ואזור, בקשת היסטוריה, בדיקת עדכניות ורזולוציית הנתונים, ושמירת התוצאה לצד התשובה המקורית.
תפקיד התמונה: תמונת שער — הרעיון המרכזי
מדור: 
נושא חזותי: צילום מערכתי של מפת הפסקות אזוריות מקופלת
האזור וחלון הזמן מגדירים את גבולות בדיקת הזמינות.© jsonscraper · נוצר באמצעות בינה מלאכותית

התרחיש המעשי כאן הוא אבחון של חשד לתקלה אזורית. נתוני הקלט: מזהה שירות מקטלוג UptimeScout, קוד אזור כגון US או GB, וחלון היסטוריה. התוצאה מסייעת להשוות את מועד דיווח המשתמש לתצפיות השירות. ה-API מתאר את הנתונים כאותות של זמינות נצפית; בדיקת השירות מועילה למיקוד הבירור, אך אינה תחליף לבדיקות של היישום שלכם.

קודם מאמתים את השירות ואת האזור

התחילו בקטלוג: מצאו את השירות הרצוי לפי שם או מחרוזת חיפוש, ואז שמרו את המזהה המדויק שלו. מפרט OpenAPI של UptimeScout מתאר חיפוש באמצעות GET /v1/services והפרמטרים q, service, region, limit ו-offset. בדוח אבחון עדיף לשמור את המזהה ולא רק את השם המוצג, כדי שבקשה חוזרת תפנה לאותו פריט בקטלוג.

האזור מוגדר באמצעות קוד נפרד בן שתי אותיות. חשוב לשמור אותו לצד התוצאה: תשובה עבור US ותשובה ללא מסנן אזורי עונות על שאלות שונות. אם צריך להציג את התיאור ברוסית, הפרמטר lang=ru קובע את שפת התיאור, ואילו הפרמטר region בוחר את התצפיות. התיעוד מפריד במפורש בין שני הייעודים האלה.

מבקשים היסטוריה במקום סטטוס יחיד

לצורך בירור אירוע, השתמשו ב-/v1/history עם הפרמטרים service ו-region הנדרשים. הפרמטר hours קובע את חלון ההיסטוריה; המפרט מתיר ערכים שבין שעה אחת ל-2160 שעות. הבקשה כוללת גם את lang. לפי OpenAPI, ההרשאה מועברת באמצעות רישיון בתבנית Bearer. בהרצה מעשית, שמרו את המפתח במשתנה סביבה ואל תכתבו אותו ליומן הבקשות.

import os
import requests

response = requests.get(
    "https://api.uptimescout.com/v1/history",
    headers={"Authorization": f"Bearer {os.environ['UPTIMESCOUT_LICENSE_KEY']}"},
    params={"service": "github", "region": "GB", "hours": 24, "lang": "ru"},
    timeout=30,
)
response.raise_for_status()
data = response.json()
print(data)

זוהי דוגמת בקשה מינימלית, לא תוצאה שפורסמה של חקירה אמיתית. המזהה github והאזור GB מופיעים כפרמטרים לדוגמה: לפני השימוש בחרו את השירות והאזור הרלוונטיים למשימה שלכם. כדאי לשמור את התשובה כולה בקובץ JSON, ולהוסיף במערכת הביקורת שדות נפרדים עבור זמן קבלתה ותיאור הבקשה. כך אפשר לחזור על הבירור ולראות באיזה צילום מצב של הנתונים נעשה שימוש.

הרזולוציה והפערים הם חלק מהתוצאה

במערך history חשובים השדות observed_at, resolution_seconds, aggregated, samples ו-counts. הרזולוציה מציינת את משך מרווח הזמן; samples מראה כמה תצפיות נכללו באגרגציה, ו-counts מכיל את התפלגות האותות. בחנו אותם יחד: לשורה אחת עם מספר קטן של דגימות יש משקל שונה בניתוח מאשר לאגרגציה המבוססת על מספר רב של תצפיות.

כתבה: UptimeScout: איך לבדוק אם הייתה תקלה בשירות באזור של המשתמש
תקציר: בדיקת זמינות אזורית יכולה לענות על השאלה אם אירוע שדווח על ידי משתמש תואם לתצפיות של UptimeScout. מדריך לתהליך שניתן לשחזור: בחירת שירות ואזור, בקשת היסטוריה, בדיקת עדכניות ורזולוציית הנתונים, ושמירת התוצאה לצד התשובה המקורית.
תפקיד התמונה: איור תומך 2 — היבט מסוים ושונה
מדור: רזולוציה ופערים הם חלק מהתוצאה
סדר קריאת ההיסטוריה: אזור, משבצות זמן, רזולוציה ופערים.© jsonscraper · איור שנוצר באמצעות בינה מלאכותית

UptimeScout מתארת את ההיסטוריה כמשבצות זמן בעלות מרווחי מדידה שונים בהתאם לחלון שנבחר: מרווחים של דקה ושל חמש דקות לתקופות קצרות, מרווחים של שעה ליום, ומרווחים של יום לתקופות ארוכות. לאגרגציות ישנות שנשמרו עשויה להיות רזולוציה גסה יותר. לכן אל תסיקו ש״התקלה התחילה בדיוק בדקה הזאת״ כאשר השורה מייצגת אגרגציה של שעה או יום. הסתמכו על הערך בפועל של resolution_seconds ועל השדות effective_start ו-history_resolution בתשובה, כדי לציין את גבולות המסקנה האפשרית.

יש להתייחס למרווח חסר כאל לא ידוע. המפרט מבקש במפורש להתייחס לפערים כאל מרווחים לא ידועים: מקום ריק בהיסטוריה אינו מציין כשלעצמו לא פעילות תקינה ולא תקלה. בדוח, הכלל הפשוט הזה מונע מילוי שגוי של פערים בסטטוס ״תקין״ או באפסים.

משווים את ההיסטוריה לאות הנוכחי

אם צריך לבדוק את המצב בזמן הפנייה, בקשו את /v1/status עבור אותו service ואותו region. באובייקט השירות בדקו יחד את status, observed_at ו-stale; התיעוד מציג את השדות האלה כדרך להבין את מצב האות ועדכניותו. הסטטוס ברמה העליונה מתייחס לתוצאת בקשת ה-API, בעוד service.status מתאר את אות הזמינות של השירות המסוים. ההבחנה הזאת מועילה במיוחד בדוחות אוטומטיים: תשובת HTTP מוצלחת ומצב השירות החיצוני הם דברים שונים.

כדי לבדוק כמה תלויות, אפשר לעבור אל /v1/statuses, ולאחר מכן להשתמש בהיסטוריה רק עבור השירותים והאזורים שבהם זוהתה חריגה. המפרט מספק גם את /v1/summary ואת /v1/incidents. באבחון באמצעות הנתיב האחרון, חשוב להביא בחשבון את תפקידו המדויק: נקודת הקצה מחזירה אותות חריגה עדכניים, לא אירועים מאומתים של ספק השירות עצמו. לכן התוצאה היא סיבה לביצוע בדיקה נוספת, ולא מסקנה מוכנה לגבי הגורם.

איך לנסח מסקנה בלי לנחש

שמרו בשורת הדוח את service ID,‏ region, תקופת הבקשה, observed_at,‏ resolution_seconds,‏ samples,‏ counts וסימון של פערים. הוסיפו קישור לפנייה או לאירוע פנימי בנפרד משדות ה-API. לאחר מכן השוו את טווח הזמן ליומני היישום, למעקב רשת אזורי ולדיווח המשתמש. אם גבולות הזמן של האגרגציה רחבים יותר ממשך האירוע, נסחו את התוצאה בהתאם: התצפיות באזור שנבחר, בחלון הזמן שנקבע, כוללות את האותות הבאים — ברזולוציה ובמספר הדגימות המצוינים.

בירור כזה מספק לצוות הכוננות דרך פעולה מועילה: לבדוק את הצד האזורי של השירות החיצוני, או להמשיך לאבחן את היישום ואת הרשת של המשתמש. האפשרות לשחזר את הבדיקה תלויה בשמירת פרמטרי הבקשה ונתוני ה-JSON המקוריים; איכות המסקנה הזמנית תלויה בהתייחסות מפורשת לרזולוציה, ל-samples ולמרווחים הלא ידועים. במקרה של בדיקת זמינות, זו התוצאה המעשית: לא רק תווית סטטוס נוכחית, אלא רשומה מוגבלת בזמן ובאזור, שעמית יכול לבדוק מחדש.

אֲנָשִׁים

עדיין לא רשומים אנשים עבור מאמר זה.

המשיכו לקרואאיך לקרוא את UptimeScout incidents: אות לתקלה אינו עדיין אירוע מאומת
קרא את המאמר הבא

הפכו את מה שקראתם לאינטגרציה עובדת

גלו את ממשקי ה-API לנתונים חברתיים של jsonscraper, בדקו בקשות ובנו את תהליך העבודה הבא.

גלה API