ניתוח תוכן של הודעות API באמצעות ניתוח מותאם אישית

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X.
מידע

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

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

בסרטון הזה נדגים איך משתמשים במדיניותStatStatsCollector כדי לחלץ נתוני ניתוח בהתאמה אישית מבקשה/תגובה ל-API ולעדכן את הנתונים האלה ל-Edge API Analytics. אחר כך נסביר איך להציג את נתוני הניתוח בדוח בממשק המשתמש של Edge או באמצעות ממשק ה-API של Edge.

מידע על Google Book API

במאמר הזה נסביר איך לתעד נתונים בהתאמה אישית של ניתוח נתונים מבקשות לשרת proxy של API אל Google Books API. ה-API של Google Books מאפשר לחפש ספרים לפי כותר, נושא, מחבר ומאפיינים אחרים.

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

curl https://www.googleapis.com/books/v1/volumes?q=davinci%20code

הקריאה מחזירה מערך JSON של פריטים שנמצאו שתואמים לקריטריוני החיפוש. למטה מוצג רכיב המערך הראשון בתגובה (שימו לב שחלק מהתוכן הושמט מטעמי פשטות):

{
 "kind": "books#volumes",
 "totalItems": 1799,
 "items": [
  {
   "kind": "books#volume",
   "id": "ohZ1wcYifLsC",
   "etag": "4rzIsMdBMYM",
   "selfLink": "https://www.googleapis.com/books/v1/volumes/ohZ1wcYifLsC",
   "volumeInfo": {
    "title": "The Da Vinci Code",
    "subtitle": "Featuring Robert Langdon",
    "authors": [
     "Dan Brown"
    ],
    "publisher": "Anchor",
    "publishedDate": "2003-03-18",
    "description": "MORE THAN 80 MILLION COPIES SOLD ....",
    "industryIdentifiers": [
     {
      "type": "ISBN_10",
      "identifier": "0385504217"
     },
     {
      "type": "ISBN_13",
      "identifier": "9780385504218"
     }
    ],
    "readingModes": {
     "text": true,
     "image": true
    },
    "pageCount": 400,
    "printType": "BOOK",
    "categories": [
     "Fiction"
    ],
    "averageRating": 4.0,
    "ratingsCount": 710,
    "maturityRating": "NOT_MATURE",
    "allowAnonLogging": true,
    "contentVersion": "0.18.13.0.preview.3",
    "panelizationSummary": {
     "containsEpubBubbles": false,
     "containsImageBubbles": false
    },
...
   "accessInfo": {
    "country": "US",
    "viewability": "PARTIAL",
    "embeddable": true,
    "publicDomain": false,
    "textToSpeechPermission": "ALLOWED_FOR_ACCESSIBILITY",
    "epub": {
     "isAvailable": true,
     "acsTokenLink": "link"
    },
    "pdf": {
     "isAvailable": true,
     "acsTokenLink": "link"
    },
...
   }
  }

שימו לב שכמה אזורים בתגובה הודגשו:

  • מספר תוצאות חיפוש
  • דירוג ממוצע של ספר
  • מספר הדירוגים
  • זמינות גרסאות PDF של הספר

בקטעים הבאים מוסבר איך לאסוף נתונים סטטיסטיים לגבי התחומים האלה של התגובה, וגם לגבי פרמטר השאילתה, q, שמכיל את הקריטריונים לחיפוש.

יצירת שרת proxy ל-API עבור Google Book API

כדי לאסוף נתונים סטטיסטיים עבור Google Book API, עליכם ליצור שרת proxy של Edge API שקורא לו. לאחר מכן, צריך להפעיל את שרת ה-API של שרת ה-API כדי לשלוח את הבקשות אל Google Book API.

שלב 2: יצירת שרת proxy ל-API במדריך ליצירת שרת proxy ל-API. בסרטון מוסבר איך ליצור שרת proxy שקורא לממשק ה-API של https://mocktarget.apigee.net. שימו לב שלשרת proxy שמתואר במדריך הזה אין צורך במפתח API כדי לקרוא אותו.

מבצעים את אותו תהליך כדי ליצור שרת proxy ל-API עבור נקודת הקצה /volumes של Google Book API. בשלב 5 של התהליך, כשיוצרים את שרת ה-API של ה-API, צריך להגדיר את המאפיינים הבאים שיפנו ל-Google Books API:

  • שם שרת proxy: "mybooksearch"
  • נתיב הבסיס של שרת ה-proxy: "/mybooksearch"
  • ב-API הקיים: "https://www.googleapis.com/books/v1/volumes"

אחרי שיוצרים ופורסים את שרת ה-Proxy, אפשר לקרוא לו באמצעות הפקודה curl בטופס:

curl http://org_name-env_name.apigee.net/mybooksearch?q=davinci%20code

כאשר org_name ו-env_name מציינים את הארגון והסביבה שבהם פרסתם את שרת ה-proxy. לדוגמה:

curl http://myorg-test.apigee.net/mybooksearch?q=davinci%20code

איסוף נתונים של ניתוח נתונים בהתאמה אישית

איסוף נתוני ניתוח מבקשת API הוא תהליך דו-שלבי:

  1. מחלצים את הנתונים שרוצים וכותבים אותם במשתנה.

    כל הנתונים שמועברים אל Edge API Analytics מגיעים מערכים ששמורים במשתנים. חלק מהנתונים מאוחסנים באופן אוטומטי במשתני זרימה מוגדרים מראש של Edge, כמו הערכים של הפרמטרים של השאילתה שמועברים לשרת ה-API של ה-API. מידע נוסף על משתני התהליך שמוגדרים מראש זמין במאמר סקירה כללית על משתני זרימה.

    אפשר להשתמש במדיניות חילוץ משתנים כדי לחלץ תוכן מותאם אישית מבקשה או מתגובה, ולכתוב את הנתונים האלה במשתנה.

  2. כתיבת נתונים ממשתנה ב-Edge API Analytics.

    אפשר להשתמש במדיניות StatStats Collector כדי לכתוב נתונים ממשתנה אל Edge API Analytics. הנתונים יכולים להגיע ממשתני זרימה מוגדרים מראש של Edge או ממשתנים שנוצרו על ידי המדיניות 'חילוץ משתנים'.

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

שימוש במדיניות 'חילוץ משתנים' כדי לחלץ נתוני ניתוח

כדי להעביר את נתוני Analytics ל-API Analytics, צריך לחלץ אותם ולשמור אותם במשתנה, שהוא משתנה זרימה שמוגדר מראש על ידי Edge או משתנים מותאמים אישית שהגדרתם. כדי לכתוב נתונים למשתנה, יש להשתמש במדיניות חילוץ משתנים.

המדיניות לחילוץ משתנים יכולה לנתח מטענים ייעודיים של הודעות עם ביטויי JSONPath או XPath. כדי לחלץ את המידע מתוצאות חיפוש JSON של Google Book API, יש להשתמש בביטוי JSONPath. לדוגמה, כדי לחלץ את הערך של averageRating מהפריט הראשון במערך תוצאות JSON, הביטוי JSONPath הוא:

$.items[0].volumeInfo.averageRating

לאחר ההערכה של JSONPath, המדיניות לחילוץ משתני כותבת את הערך שחולץ למשתנה.

בדוגמה הזו נשתמש במדיניות 'חילוץ משתנים' כדי ליצור ארבעה משתנים:

  • responsejson.totalitems
  • responsejson.ratingscount
  • responsejson.avgrating
  • responsejson.pdf

במשתנים האלה, responsejson הוא קידומת, ו-totalitems, ratingscount, avgrating ו-pdf הם שמות המשתנים.

במדיניות לחילוץ משתנים שבהמשך מוסבר איך לחלץ נתונים מתגובת JSON ולכתוב אותם במשתנים מותאמים אישית. כל רכיב <Variable> משתמש במאפיין name שמציינים את השם של המשתנים המותאמים אישית ואת ביטוי ה-JSONPath המשויך. הרכיב <VariablePrefix> מציין את הקידומת של המשתנה.

יש להוסיף את המדיניות הזו לשרת ה-API של שרת ה-proxy בממשק המשתמש של Edge. אם יוצרים את שרת ה-proxy של ה-API בפורמט XML, צריך להוסיף את המדיניות לקובץ בשם /apiproxy/policies בשם ExtractVars.xml:

<ExtractVariables name="ExtractVars">
    <Source>response</Source>
    <JSONPayload>
        <Variable name="totalitems">
            <JSONPath>$.totalItems</JSONPath>
        </Variable>
        <Variable name="ratingscount">
            <JSONPath>$.items[0].volumeInfo.ratingsCount</JSONPath>
        </Variable>
        <Variable name="avgrating">
            <JSONPath>$.items[0].volumeInfo.averageRating</JSONPath>
        </Variable>
        <Variable name="pdf">
            <JSONPath>$.items[0].accessInfo.pdf.isAvailable</JSONPath>
        </Variable>
    </JSONPayload>
    <VariablePrefix>responsejson</VariablePrefix>
    <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
</ExtractVariables>

שימוש במדיניות 'אוסף הנתונים הסטטיסטיים' כדי לכתוב נתונים בשירות Analytics

כדי לכתוב נתונים ממשתנה ל-Edge API Analytics, משתמשים במדיניות StatStats Collector (אוסף הנתונים הסטטיסטיים). הפורמט של מדיניות 'אוסף הנתונים הסטטיסטיים' הוא:

<StatisticsCollector>
<DisplayName>Statistics Collector-1</DisplayName>
    <Statistics>
        <Statistic name="statName" ref="varName" type="dataType">defVal</Statistic>
       …
    </Statistics>
</StatisticsCollector>

איפה:

  • statName מציין את השם שבו משתמשים לאזכור הנתונים הסטטיסטיים בדוח מותאם אישית.
  • varName מציין את שם המשתנה שמכיל את נתוני הניתוח שרוצים לאסוף. אפשר להגדיר את המשתנה הזה ב-Edge או שהוא יכול להיות משתנה מותאם אישית שנוצר על ידי המדיניות לחילוץ משתנים.
  • dataType מציין את סוג הנתונים של הנתונים המתועדים כמחרוזת, מספר שלם, מספר צף, ארוך, כפול או בוליאני.

    לגבי נתונים מסוג מחרוזת, אתה מפנה לנתונים הסטטיסטיים כמאפיין בדוח מותאם אישית. בסוגים של נתונים מספריים (מספרים שלמים/צפים/ארוכים/כפולים), אתם מתייחסים לנתונים הסטטיסטיים כמאפיין או כמדד בדוח מותאם אישית.

  • אפשר גם לציין ב-defValue ערך ברירת מחדל למשתנה מותאם אישית. הערך הזה יישלח אל API Analytics אם לא ניתן לפענח את המשתנים או אם המשתנה לא מוגדר.

בדוגמה הבאה משתמשים במדיניות StatStats Collector (אוסף הנתונים הסטטיסטיים) כדי לאסוף נתונים עבור המשתנים שנוצרו על ידי המדיניות חילוץ Variables. אתם גם אוספים את הערך של פרמטר השאילתה שמועבר לכל קריאה ל-API. מפנים לפרמטרים של שאילתות באמצעות משתנה הזרימה המוגדר מראש:

request.queryparam.queryParamName

לפרמטר השאילתה בשם "q", יש להתייחס אליו כך:

request.queryparam.q

מוסיפים את המדיניות הזו לשרת ה-API בממשק המשתמש של Edge. לחלופין, אם אתם יוצרים את שרת ה-API של ה-API ב-XML, אתם יכולים להוסיף קובץ בשם /apiproxy/policies בשם AnalyzeBookResults.xml, עם התוכן הבא:

<StatisticsCollector name="AnalyzeBookResults">
 <Statistics>
        <Statistic name="totalitems" ref="responsejson.totalitems" type="integer">0</Statistic>
        <Statistic name="ratingscount" ref="responsejson.ratingscount" type="integer">0</Statistic>
        <Statistic name="avgrating" ref="responsejson.avgrating" type="float">0.0</Statistic>
        <Statistic name="pdf" ref="responsejson.pdf" type="boolean">true</Statistic>
        <Statistic name="booktitle" ref="request.queryparam.q" type="string">none</Statistic>
 </Statistics>
</StatisticsCollector>

צירוף כללי מדיניות לתהליך התגובה של ProxyEndpoint

כדי שדברים יפעלו כמו שצריך, יש לצרף את המדיניות לזרימת שרת ה-proxy של ה-API במיקום המתאים. במקרה כזה, המדיניות חייבת לפעול אחרי שהתגובה מתקבלת מ-Google Book API ולפני שהתגובה נשלחת ללקוח ששולח את הבקשה. לכן, צריך לצרף את המדיניות ל-PreFlow של תגובת ProxyEndpoint.

ההגדרה לדוגמה של ProxyEndpoint שמופיעה למטה מפעילה תחילה את המדיניות ExtractVars כדי לנתח את הודעת התגובה. לאחר מכן המדיניות שנקראת AnalyzeBookResults מעבירה את הערכים האלה אל API Analytics:

<ProxyEndpoint name="default">
    ><PreFlow name="PreFlow">
        <Request/>
        <Response>
            <Step>
                <Name>Extract-Vars</Name>
            </Step>
            <Step>
                <Name>AnalyzeBookResults</Name>
            </Step>
        </Response>
    </PreFlow>
 <HTTPProxyConnection>
  <!-- Base path used to route inbound requests to this API proxy -->
  <BasePath>/mybooksearch</BasePath>
  <!-- The named virtual host that defines the base URL for requests to this proxy -->
  <VirtualHost>default</VirtualHost>
 </HTTPProxyConnection>
 <RouteRule name="default">
 <!-- Connects the proxy to the target defined under /targets -->
  <TargetEndpoint>default</TargetEndpoint>
 </RouteRule>
</ProxyEndpoint>

פריסת שרת ה-API של שרת ה-proxy

אחרי שמבצעים את השינויים האלה, צריך לפרוס את שרת ה-proxy של ה-API שהגדרתם.

אכלוס נתוני הניתוח

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

מובי דיק:

curl https://org_name-env_name.apigee.net/mybooksearch?q=mobey%20dick

קוד דה וינצ'י:

curl https://org_name-env_name.apigee.net/mybooksearch?q=davinci%20code 

נעלמת:

curl https://org_name-env_name.apigee.net/mybooksearch?q=gone%20girl  

משחקי הכס:

curl https://org_name-env_name.apigee.net/mybooksearch?q=game%20of%20thrones   

הצגת ניתוח הנתונים

Edge מספק שתי דרכים להצגת נתוני ניתוח בהתאמה אישית:

  • ממשק המשתמש של Edge תומך בדוחות מותאמים אישית שמאפשרים להציג את הנתונים בתרשים גרפי.
  • ה-API של המדדים מאפשר לכם לאחזר נתוני ניתוח על ידי ביצוע קריאות REST ל-Edge API. אפשר להשתמש ב-API כדי ליצור תצוגות חזותיות משלך בצורת ווידג'טים בהתאמה אישית, שאפשר להטמיע בפורטלים או באפליקציות בהתאמה אישית.

הפקת דוח של נתונים סטטיסטיים באמצעות ממשק המשתמש של Edge

דוחות בהתאמה אישית מאפשרים להתעמק בנתונים סטטיסטיים ספציפיים של ה-API, כדי להציג בצורה מדויקת את הנתונים שרוצים לראות. אפשר ליצור דוח מותאם אישית באמצעות כל אחד מהmetrics והמאפיינים המובנים ב-Edge. בנוסף, תוכלו להשתמש בכל אחד מנתוני הניתוח שחילצתם באמצעות המדיניותStatisticsCollector.

כשיוצרים מדיניות 'אוסף נתונים סטטיסטיים', צריך לציין את סוג הנתונים של הנתונים שנאספים. בסוג הנתונים של המחרוזת, יש להתייחס לנתונים הסטטיסטיים כמאפיין בדוח מותאם אישית. לסוגים של נתונים מספריים (מספרים שלמים/צפים/ארוכים/כפולים), יש להתייחס לתאריך הסטטיסטי בדוח מותאם אישית כמאפיין או כמדד. מידע נוסף זמין במאמר ניהול דוחות בהתאמה אישית.

יצירת דוח בהתאמה אישית באמצעות ממשק המשתמש של Edge:

  1. גש לדף 'דוחות מותאמים אישית' כפי שמתואר בהמשך.

    Edge

    כדי לגשת לדף 'דוחות בהתאמה אישית' באמצעות ממשק המשתמש של Edge:

    1. נכנסים לאתר apigee.com/edge.
    2. בסרגל הניווט הימני, בוחרים באפשרות ניתוח > דוחות מותאמים אישית > דוחות.

    Classic Edge (ענן פרטי)

    כדי לגשת לדף 'דוחות בהתאמה אישית' באמצעות ממשק המשתמש הקלאסי Edge:

    1. נכנסים אל http://ms-ip:9000. ms-ip הוא כתובת ה-IP או שם ה-DNS של הצומת של שרת הניהול.
    2. בוחרים באפשרות Analytics > דוחות בסרגל הניווט העליון.

  2. בדף 'דוחות בהתאמה אישית', לוחצים על +דוח בהתאמה אישית.
  3. מציינים שם דוח, למשל mybookreport.
  4. בוחרים מדד מובנה, כמו תנועה, ופונקציית צבירה, כמו Sum.

    לחלופין, בוחרים אחד מהנתונים הסטטיסטיים המספריים שיצרתם באמצעות המדיניות StatStatsCollector. לדוגמה, בוחרים באפשרות ratingscount ופונקציית צבירה של Sum.

  5. בוחרים מאפיין מובנה, כמו שרת proxy ל-API, או כל אחד מהמחרוזת או הנתונים הסטטיסטיים המספריים שיצרתם באמצעות המדיניות StatisticsCollector.

    לדוגמה, בוחרים באפשרות שם הספר. בדוח יוצג הסכום של ratingscount לפי booktitle:

    דוח ספרים בהתאמה אישית
  6. לוחצים על שמירה. הדוח יופיע ברשימה של כל הדוחות בהתאמה אישית.
  7. כדי להפיק את הדוח, בוחרים בשם הדוח. כברירת מחדל, בדוח מוצגים נתונים מהשעה האחרונה.

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

    תרשים של דוח ספרים

קבלת נתונים סטטיסטיים באמצעות Edge API

שימוש ב-Edge metrics API כדי להציג נתונים סטטיסטיים על ניתוח נתונים בהתאמה אישית. בבקשה לדוגמה הבאה:

  • המשאב לכתובת ה-URL שמופיע אחרי /stats מציין את המאפיין הרצוי. בדוגמה הזו אתם מקבלים נתונים עבור המאפיין booktitle.
  • פרמטר השאילתה select לציון הmetrics שיש לאחזר. הבקשה הזו מחזירה ניתוח נתונים על סמך הסכום של ratingscount.
  • הפרמטר timeRange מציין את מרווח הזמן לנתונים שהוחזרו. טווח הזמן הוא בפורמט:

    MM/DD/YYYY%20HH:MM~MM/DD/YYYY%20HH:MM

הקריאה המלאה ל-API היא:

curl -X GET "https://api.enterprise.apigee.com/v1/organizations/org_name/environments/env_name/stats/booktitle?select=sum(ratingscount)&timeRange=04/21/2019&2014:00:00~04/22/2019&2014:00:00" /
-u email:password

אמורה להופיע תשובה בטופס:

{
  "environments": [
    {
      "dimensions": [
        {
          "metrics": [
            {
              "name": "sum(ratingscount)",
              "values": [
                "5352.0"
              ]
            }
          ],
          "name": "gone girl"
        },
        {
          "metrics": [
            {
              "name": "sum(ratingscount)",
              "values": [
                "4260.0"
              ]
            }
          ],
          "name": "davinci code"
        },
        {
          "metrics": [
            {
              "name": "sum(ratingscount)",
              "values": [
                "1836.0"
              ]
            }
          ],
          "name": "game of thrones"
        },
        {
          "metrics": [
            {
              "name": "sum(ratingscount)",
              "values": [
                "1812.0"
              ]
            }
          ],
          "name": "mobey dick"
        }
      ],
      "name": "prod"
    }
  ],
  "metaData": {
    "errors": [],
    "notices": [
      "query served by:9b372dd0-ed30-4502-8753-73a6b09cc028",
      "Table used: uap-prod-gcp-us-west1.edge.edge_api_raxgroup021_fact",
      "Source:Big Query"
    ]
  }
}

ב-Edge metrics API יש הרבה אפשרויות. לדוגמה, ניתן למיין את התוצאות בסדר עולה או בסדר יורד. בדוגמה הבאה צריך להזין סדר עולה:

curl -X GET "https://api.enterprise.apigee.com/v1/organizations/org_name/environments/env_name/stats/booktitle?select=sum(ratingscount)&timeRange=04/21/2019&2014:00:00~04/22/2019&2014:00:00&sort=ASC" /
-u email:password

ניתן גם לסנן את התוצאות על ידי ציון הערכים של המאפיינים הרצויים. בדוגמה הבאה, הדוח מסונן לפי התוצאות של המונחים 'Gone Girl' ו-'The Da Vinci Code':

$ curl -X GET "https://api.enterprise.apigee.com/v1/organizations/org_name/environments/env_name/stats/booktitle?select=sum(ratingscount)&timeRange=04/21/2019&2014:00:00~04/22/2019&2014:00:00&filter=(booktitle%20in%20'gone%20girl'%2C%20'davinci%20code')" /
-u email:password

יצירת משתנים מותאמים אישית לניתוח נתונים באמצעות בונה הפתרונות

בונה הפתרונות מאפשר ליצור משתנים מותאמים אישית לניתוח נתונים באמצעות תיבת דו-שיח קלה לשימוש בממשק המשתמש.

כדאי לקרוא את הקטע הקודם, איסוף נתונים בהתאמה אישית של ניתוח נתונים, שמסביר איך המדיניות 'חילוץ משתנים' ו'אוסף הנתונים הסטטיסטיים' פועלת באופן יזום כדי לעדכן משתנים מותאמים אישית ל-Edge API Analytics. כפי שתראו, ממשק המשתמש פועל לפי אותו דפוס, אבל הוא מספק דרך נוחה להגדיר את כל הפריטים דרך ממשק המשתמש. אפשר לנסות את הדוגמה של Google Books API באמצעות ממשק המשתמש במקום לערוך ולצרף כללי מדיניות באופן ידני.

תיבת הדו-שיח 'בונה הפתרונות' מאפשרת לכם להגדיר משתנים של ניתוח נתונים ישירות בממשק המשתמש. הכלי הזה יוצר כללי מדיניות ומצרף אותם לשרת ה-API של ה-API. כללי המדיניות מחלצים משתנים של תחומי עניין מבקשות או תגובות, ומעבירים את המשתנים שנשלפו אל Edge API Analytics.

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

  1. עבור לדף הסקירה הכללית של שרת ה-proxy בממשק המשתמש של Edge.
  2. לוחצים על פיתוח.
  3. בדף 'פיתוח', בוחרים באפשרות אוסף Analytics בהתאמה אישית מהתפריט 'כלים'. תופיע תיבת הדו-שיח של בונה הפתרונות.
  4. בתיבת הדו-שיח של פותר הפתרונות, מגדירים קודם שני כללי מדיניות: חילוץ משתני ואוסף סטטיסטיקה. לאחר מכן צריך להגדיר לאן לצרף את כללי המדיניות האלה.
  5. מציינים את הנתונים שרוצים לחלץ:
    • Location Type (סוג המיקום): בוחרים את סוג הנתונים שרוצים לאסוף ומאיפה רוצים לאסוף אותם. אפשר לבחור נתונים מהצד של הבקשה או מהתגובה. לדוגמה, Request: Query Parameter או Response: XML Body.
    • מקור המיקום: מזהים את הנתונים שרוצים לאסוף. לדוגמה, השם של פרמטר השאילתה או ה-XPath לנתוני XML בגוף התגובה.
  6. צריך לציין name (וסוג) משתנה שישמש את המדיניות של Stats Collector כדי לזהות את הנתונים שחולצו. ניתן לעיין בהגבלות על מתן שמות בנושא זה.

    השם שבו בחרת יופיע בתפריט הנפתח של מאפיינים או של מדדים בממשק המשתמש של הכלי ליצירת דוחות בהתאמה אישית.
  7. בוחרים את המקום שבו בתהליך ה-API של שרת ה-proxy שאליו רוצים לצרף את משתני המדיניות לחילוץ ואוסף הנתונים הסטטיסטיים שנוצרו. להנחיות, תוכלו לקרוא את המאמר "צירוף מדיניות לתהליך התגובה של ProxyEndpoint". כדי שדברים יפעלו כמו שצריך, יש לצרף את המדיניות ל-API של שרת ה-proxy במיקום המתאים. צריך לצרף את כללי המדיניות בשלב שבו המשתנים שרוצים לכלול נמצאים בהיקף (מאוכלסים).
  8. לוחצים על +אוסף כדי להוסיף עוד משתנים מותאמים אישית.
  9. בסיום, לוחצים על בניית פתרון.

  10. שומרים ופורסים את שרת ה-proxy.

עכשיו אתם יכולים ליצור דוח בהתאמה אישית עבור הנתונים, כמתואר למעלה.