צפייה בטופולוגיה של האפליקציה

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

הסבר על מפת הטופולוגיה

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

  • צמתים מייצגים את השירותים ועומסי העבודה של האפליקציה:

    טופולוגיה של אפליקציה לדוגמה.

  • קצוות מייצגים את תעבורת הנתונים של האפליקציה בין השירותים ועומסי העבודה:

    בממשק של Edge מוצגים נתוני השהיה ושיעור השגיאות.

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

לפני שמתחילים

כדי ליצור את מפת הטופולוגיה של האפליקציה, נתוני המעקב צריכים לכלול תוויות ספציפיות לאפליקציה. התוויות האלה זמינות רק אם הטמעתם את OpenTelemetry באפליקציה, שלחתם את נתוני המעקב אל Telemetry API ורשמתם את האפליקציה ב-App Hub.

כדי להתחיל, צריך לבצע את הפעולות הבאות:

  1. מגדירים את התכונה 'מעקב אחרי אפליקציות' כמו שמתואר במאמר הגדרת התכונה 'מעקב אחרי אפליקציות'. ההגדרה של מעקב אחר אפליקציות כוללת קביעת התצורה של היקף ברירת המחדל של המעקב כך שכל הפרויקטים שבהם מאוחסנים נתוני המעקב יופיעו ברשימה.
  2. אם אתם משתמשים בתיקייה לניהול אפליקציות, בפרויקט שלכם תהיה מדיניות ברירת מחדל של הגבלת שימוש בשירות, שתמנע מכם להשתמש ב-App Topology API. כדי לפתור את הבעיה, מישהו עם התפקיד Organization Policy Administrator צריך להוסיף את apptopology.googleapis.com לרשימת ההיתרים של המדיניות בפרויקט לניהול תיקיות שבו האפליקציה מופעלת. הערה: יכול להיות שתהיה מדיניות גם ברמת הארגון. מידע נוסף מופיע במאמר בנושא הגבלת השימוש במשאבים.

  3. Enable the Observability, App Topology, Cloud Trace, and Telemetry APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

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

  4. כדי לקבל את ההרשאות שנדרשות להצגת הטופולוגיה של האפליקציה, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM‏ App Topology viewer (roles/apptopology.viewer) בפרויקט. להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

    ההרשאות הנדרשות

    כדי לראות את הטופולוגיה של האפליקציה, נדרשות ההרשאות הבאות:

    • כדי ליצור טופולוגיה: apptopology.applicationTopologies.generate

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

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

הצגת מפת הטופולוגיה

  1. נכנסים לדף Application monitoring במסוף Google Cloud :

    מעבר אל מעקב אחר אפליקציות

    אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים בתוצאה שכותרת המשנה שלה היא Monitoring.

  2. בבורר הפרויקטים במסוף Google Cloud , בוחרים את פרויקט המארח או את פרויקט הניהול של App Hub.

  3. בוחרים אפליקציה מהרשימה.

  4. לוחצים על הכרטיסייה טופולוגיה. מופיעה מפת הטופולוגיה של האפליקציה.

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

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

פתרון בעיות

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