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

אתה צופה בתיעוד של Apigee Edge.
הצג תיעוד של Apigee X.

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

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

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

מידע על Google Book API

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

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

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 שקורא לו. לאחר מכן, אתם מפעילים את שרת ה-proxy של ה-API כדי לשלוח את הבקשות שלכם ל-Google Book API.

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

באמצעות אותו תהליך אפשר ליצור שרת proxy ל-API עבור נקודת הקצה של /volumes ב-Google Book API. בשלב 5 של התהליך, כשיוצרים שרת proxy ל-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 Edge API מגיעים מהערכים שמאוחסנים במשתנים. חלק מהנתונים נשמרים באופן אוטומטי במשתני flow של Edge, כמו הערכים של פרמטרים של שאילתות שהועברו לשרת proxy של ה-API. מידע נוסף על משתני זרימה מוגדרים מראש זמין במאמר סקירה כללית של משתני זרימה.

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

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

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

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

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

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

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

$.items[0].volumeInfo.averageRating

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

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

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

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

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

המדיניות הזו מופיעה בשרת proxy של ה-API בממשק המשתמש של 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, משתמשים במדיניות של Collector 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 של Google Analytics, אם לא ניתן לפענח את המשתנים או שהמשתנה לא מוגדר.

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

request.queryparam.queryParamName

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

request.queryparam.q

הוסיפו את המדיניות הזו לשרת ה-API של ממשק ה-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 ולפני שליחת התשובה ללקוח המבקש. לכן, חשוב לצרף את כללי המדיניות לטופס הקדם-תגובה של 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>

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

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

אכלוס הנתונים מ-Analytics

אחרי שפורסים את שרת ה-API, מפעילים את שרת ה-proxy כדי לאכלס נתונים ב-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 כדי להציג את הנתונים המדויקים שאתם רוצים לראות. תוכלו ליצור דוח בהתאמה אישית באמצעות כל אחד מהמדדים והמאפיינים המובנים ב-Edge. בנוסף, תוכלו להשתמש בכל אחד מנתוני הניתוח שחילצתם באמצעות המדיניות של StatisticsCollector.

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

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

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

    Edge

    כדי לגשת לדף 'דוחות מותאמים אישית' דרך ממשק המשתמש של Edge:

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

    Classic Edge (ענן פרטי)

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

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

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

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

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

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

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

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

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

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

שימוש ב-Edge Metrics API של הנתונים הסטטיסטיים על הנתונים המותאמים אישית ב-Analytics. בבקשה לדוגמה:

  • המשאב בכתובת ה-URL אחרי /stats מציין את המאפיין הרצוי. בדוגמה הזו משיגים נתונים עבור המאפיין booktitle.
  • פרמטר השאילתה select כדי לציין את המדדים לאחזור. בקשה זו מחזירה ניתוח נתונים על סמך הסכום של 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

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

$ 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

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

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

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

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

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

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

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

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

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