מדריך קלאודפלייר בעברית
לאתר הראשי כל המדריכים קלוד קוד קלוד דסקטופ גרוק CLI גרוק בוט MCP קרסור וואטסאפ OpenClaw n8n בענן n8n בהתקנה עצמית

תיעוד 53

מאפייני API של אנליטיקה

עודכן לאחרונה: 16 באפריל 2026

הדף הזה מתאר מאפייני API שאפשר להשתמש בהם בבקשות אל DNS analytics API.

אזהרה

ה-DNS analytics API, יחד עם מאפייני ה-API הבאים, יוצאו משימוש בקרוב.

כדי לגשת ללוח האנליטיקה החדש, עברו אל DNS Analytics ↗︎. עיינו ב-אנליטיקה ויומנים לפרטים.

#מדדים

מדד הוא ערך מספרי שמבוסס על תכונה של הנתונים, לדוגמה ספירת שאילתות.

בבקשות API, מדדים מוגדרים בפרמטר metrics. אם צריך לציין כמה מדדים, הפרידו ביניהם בפסיקים.

מדדשםדוגמהיחידה
queryCountספירת שאילתות1000ספירה
uncachedCountספירת שאילתות שלא במטמון1ספירה
staleCountספירת שאילתות מיושנות1ספירה
responseTimeAvgזמן תגובה ממוצע1.0זמן באלפיות שנייה
responseTimeMedianחציון זמן התגובה1.0זמן באלפיות שנייה
responseTime90thזמן תגובה באחוזון ה-901.0זמן באלפיות שנייה
responseTime99thזמן תגובה באחוזון ה-991.0זמן באלפיות שנייה

#ממדים

אפשר להשתמש בממדים כדי לפרק את הנתונים לפי תכונות נתונות.

בבקשות API, ממדים מוגדרים בפרמטר dimensions. אם צריך לציין כמה ממדים, הפרידו ביניהם בפסיקים.

ממדשםדוגמההערות
queryNameשם השאילתהexample.com
queryTypeסוג השאילתהAAAAסוגים שהוגדרו על ידי IANA ↗︎. סוגים לא ידועים ריקים.
responseCodeקוד תגובהNOERRORקודי תגובה שהוגדרו על ידי IANA ↗︎. תמיד באותיות גדולות.
responseCachedתגובה במטמוןCachedCached או Uncached.
coloNameשם ColoSJCקוד PoP.
originמקור2001:db8::1המקור ששימש לפתרון השאילתה. ריק אם לא רלוונטי, או אם השאילתה נענתה מהמטמון.
dayOfWeekיום בשבוע1פירוק לפי יום בשבוע. יום שני הוא 1, ויום ראשון הוא 7.
tcpTCP11 או 0, בהתאם לפרוטוקול שבשימוש.
ipVersionגרסת IP6גרסת פרוטוקול ה-IP שבשימוש (כרגע 4 או 6).
querySizeBucketסל גודל שאילתה16-31סל גודל שאילתה בכפולות של 16.
responseSizeBucketסל גודל תגובה16-31סל גודל תגובה בכפולות של 16.

#מסננים

מסננים משתמשים בצורה dimension operator expression, כאשר כל חלק מתאים לדברים הבאים:

  • ממד: מציין את הממד לסינון. לדוגמה, queryName.
  • אופרטור: מגדיר את סוג התאמת המסנן לשימוש. אופרטורים ספציפיים לממדים.
  • ביטוי: מציין את הערכים לכלול או להוציא מהתוצאות. ביטויים משתמשים בתחביר של ביטוי רגולרי (regex).

#אופרטורי מסנן

אופרטורשםדוגמהתיאורמקודד ל-URL
==שווהqueryName==example.comהחזרת תוצאות שבהן queryName הוא בדיוק example.com.%3D%3D
!=לא שווהresponseCode!=NOERRORהחזרת תוצאות שבהן responseCode שונה מ-NOERROR.!%3D
>גדול מdimension>1000החזרת תוצאות שבהן ממד גדול מ-1000.%3E
<קטן מdimension<1000החזרת תוצאות שבהן ממד קטן מ-1000.%3C
>=גדול או שווהdimension>=1000החזרת תוצאות שבהן ממד גדול מ-1000 או שווה לו.%3E%3D
<=קטן או שווהdimension<=1000החזרת תוצאות שבהן ממד קטן מ-1000 או שווה לו.%3C%3D

#שילוב מסננים

שלבו מסננים באמצעות לוגיקה בוליאנית של OR ו-AND:

  • ל-AND יש עדיפות על OR בכל הביטויים.

  • האופרטור OR מוגדר באמצעות פסיק , או מילת המפתח OR מוקפת ברווחים.

  • האופרטור AND מוגדר באמצעות נקודה פסיק ; או מילת המפתח AND מוקפת ברווחים.

    הערה

    שימו לב שנקודה פסיק היא תו שמור בכתובות URL (RFC 1738 ↗︎) ויש לקודד אותה באחוזים כ-%3B.

#דוגמאות עם OR

  • responseCode==NOERROR,responseCode==NXDOMAIN מציין שקוד התגובה הוא NOERROR או NXDOMAIN.
  • coloName==SJC OR coloName==LAX מציין שאילתות ב-SJC או ב-LAX.

#דוגמאות עם AND

  • responseCode==NOERROR;queryType==AAAA מציין שקוד התגובה הוא NOERROR וסוג השאילתה הוא AAAA.
  • queryType==AAAA AND coloName==SJC מציין שאילתות AAAA ב-SJC.