הרצת שאילתות

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

סוגי טופולוגיות

ב-App Topology אפשר להריץ שאילתות לגבי Google Cloud משאבים בGoogle Cloud פרויקט ושאילתות לגבי אפליקציות ב-מרכז האפליקציות בפרויקט או בתיקייה לניהול אפליקציות. כשיוצרים אפליקציות של מרכז האפליקציות בתיקייה, אפשר לראות את קשרי הגומלין בין המשאבים בפרויקטים בתיקייה הזו כשמריצים שאילתות ב-App Topology.

ב-Cloud Hub, האפשרות App Topology מספקת כמה תחומים לסוגים ספציפיים של שאלות. כל דומיין מאפשר לכם לשלוח שאילתות לגבי קבוצה ספציפית של נתונים בסיסיים.

• תקינות ופתרון בעיות – למהנדסי Site Reliability‏ (SRE) ולמשתמשים אחרים שמתמקדים בתקינות ובמהימנות של שירותים בזמן הריצה. אפשר לראות התראות פתוחות לגבי אירועי פריסה ולנתח את התנועה בין רכיבי האפליקציה או משאבים מבוססי-סוכן.

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

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

בנוסף, App Topology מספקת גרפים של טופולוגיה שמתמקדים בשימושים ספציפיים באזורים אחרים של Google Cloud.

הטבלה הבאה תעזור לכם להחליט באיזה כלי טופולוגיה להשתמש:

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

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

1. מזהים את Google Cloud הפרויקט שרוצים להגדיר.

   • נתוני האבטחה והתאימות שמוצגים ב-Security Command Center זמינים רק לפרויקטים ולאפליקציות בארגון Google Cloud . אם אתם רוצים להעביר פרויקט לארגון, תוכלו להיעזר בהוראות להעברת פרויקטים.
   • אם הגדרתם תיקייה לניהול אפליקציות לאפליקציות של מרכז האפליקציות, צריך להפעיל ממשקי API ולהעניק הרשאות שמתוארות בהוראות האלה בפרויקט הניהול של התיקייה.

2. כדי להציג נתונים של שרשרת אספקת תוכנה, כמו אישור המקור של Build, צריך להגדיר תובנות של Developer Connect.

3. מפעילים את App Topology API,‏ מאגר משאבי ענן ו-Observability API, אם הם עדיין לא מופעלים.

   תפקידים שנדרשים להפעלת ממשקי API

   כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד 'בעלים' (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד 'אדמין בממשק Service Usage' (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

   הפעלת ממשקי ה-API

4. אופציונלי: כדי לראות את התנועה של הסוכן, צריך להגדיר את אפליקציות ה-AI.

5. אופציונלי: הגדרת Security Command Center לנתוני אבטחה ותאימות. מפעילים את Security Command Center ברמת הארגון ומגדירים את התכונות שרוצים להשתמש בהן. אפשר לשלוח שאילתות לנתונים מ-Security Command Center רק במסלולי Premium ו-Enterprise.

6. נותנים הרשאות למשתמשים להריץ שאילתות על נתונים ולצפות בתרשימי טופולוגיה.

7. אם אתם מגנים על שירותים בגבולות גזרה של VPC Service Controls, צריך לעדכן את גבולות הגזרה כך שיכלול את App Topology ושירותים שמספקים נתונים בסיסיים. מידע נוסף

התפקידים הנדרשים

התפקיד Cloud Hub Operator כולל את ההרשאות הנדרשות להצגת נתונים של כל הדומיינים ב-Cloud Hub, וגם נתונים של טופולוגיות Google Cloud אחרות.

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

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

מידע על שאילתות

שאילתות של App Topology מורכבות מכמה רכיבים:

• צמתים – משאבים שזוהו Google Cloud או משאבים שנרשמו באפליקציות של מרכז האפליקציות. דוגמאות לצמתים:

  • מכונה וירטואלית ב-Compute Engine
  • קובץ אימג' של קונטיינר ב-Artifact Registry
  • נציג
  • התראה ב-Cloud Monitoring
  • אפליקציה, שירות או עומס עבודה במרכז האפליקציות
  • נקודת חולשה

  בונה השאילתות מקבץ את הצמתים לפי שירות.

• פסוקית WHERE: מסנן שמוחל על צומת כדי לשפר את השאילתה על סמך המאפיינים הספציפיים של הצומת.

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

  • contained in
  • sends traffic to
  • owns
  • depends on

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

השאילתה מגדירה את הצמתים העיקריים של החקירה: – K8s Apps Deployment – פריסה של Google Kubernetes Engine ‏ (GKE) – Docker Image – קובץ אימג' של קונטיינר שמאוחסן ב-Artifact Registry – Vulnerability

החיבורים contains ו-contained in מציינים את הקשרים בין הצמתים:

• K8s Apps Deployment contains Vulnerability
• Vulnerability contained in Docker Image

המשפט Where מסנן את תוצאות הפגיעות כדי להציג CVE ספציפי.

• Where Id = CVE-2026-24061

מגבלות

זמינות הנתונים:

• במעקב אחר חיבורים מוצגים נתונים של זמן אחזור ושיעור שגיאות מהשעה האחרונה של הנתונים. אי אפשר לשנות את טווח הזמן.
• ‫Google Cloud Observability לא תומך בטלמטריה לכל השירותים ועומסי העבודה של מרכז האפליקציות. רשימה של משאבי התשתית הנתמכים זמינה במאמר תשתית נתמכת של ניטור אפליקציות.
• כשמציגים טופולוגיה של אפליקציה ב-מרכז האפליקציות, המשאבים שאפשר לשתף בין אפליקציות לא נכללים בהדמיה.
• כשמוחקים אירוע של תובנות מ-Developer Connect, יכול להיות שהאירוע עדיין יופיע בתוצאות של שאילתות לגבי App Topology למשך כמה ימים.
• לגבי נתוני אבטחה ותאימות שסופקו על ידי Security Command Center:
  • הנתונים שסיפקת נמצאים במצב תצוגה מקדימה
  • הנתונים זמינים רק לפרויקטים ולאפליקציות בארגון Google Cloud.

הרצת שאילתה

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

איך להשתמש בהצעה לשאילתה או לשנות אותה

App Topology מספק הצעות לשאילתות שאפשר להשתמש בהן ללא שינויים, או להתאים אותן לדרישות הספציפיות שלכם.

1. נכנסים לדף App Topology במסוף Google Cloud .

   מעבר אל App Topology

2. בחלונית יצירת שאילתה, בוחרים את הכרטיסייה של הדומיין שרוצים לנתח.

3. בקטע Quick Queries (שאילתות מהירות), לוחצים על שאילתה כדי לראות תצוגה מקדימה של רכיבי השאילתה.

4. כדי להשתמש בשאילתה, לוחצים על שימוש בהצעה. השאילתה מופיעה בקטע Show.

5. משנים את פרטי השאילתה בעורך בהתאם לצרכים.

   • כדי להוסיף רכיב לשאילתה, לוחצים על סמל הפלוס (add) לצד הצומת.
   • כדי להסיר רכיב, לוחצים על סמל הסגירה close.
   • כדי לשנות את הערך של פסקה Where, לוחצים על הערך.

   אפשר ללחוץ על ביטול undo כדי לבטל שינוי, או על ביצוע מחדש redo כדי להחיל מחדש שינויים שבוטלו באמצעות ביטול.

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

   לדוגמה, אם בחרתם בשאילתה Vulnerabilities in Kubernetes deployments, הרכיבים הם:

   Application
     contains Workload
       depends on K8s Apps Deployment
          contains Vulnerability
             Where Id = Empty value
   

   כדי להשתמש בשאילתה, צריך לציין נקודת חולשה לחיפוש על ידי החלפת Empty value במזהה CVE, כמו CVE-2026-24061.

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

   Application
     contains Workload
       contains Deployment Event
         contains artifact Docker Image
           contains Vulnerability
             Where Id = CVE-2026-24061
   

6. כשמסיימים לערוך את השאילתה, לוחצים על הפעלת השאילתה. אם תוצאות השאילתה כוללות Google Cloud משאבים שזוהו או משאבים שרשומים באפליקציות ב-מרכז האפליקציות, מוצג גרף טופולוגיה.

   אי אפשר ליצור תרשימים מתוצאות של שאילתות שכוללות רק סוגי נתונים כמו מחרוזות או ספירות.

   אפשר לערוך את השאילתה על סמך התוצאות ואז ללחוץ על Run query כדי לעדכן את תרשים הטופולוגיה.

   אם לא נמצאו תוצאות, כדאי לצמצם את השאילתה.

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

יצירת שאילתות מותאמות אישית

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

1. נכנסים לדף App Topology במסוף Google Cloud .

   מעבר אל App Topology

2. בחלונית יצירת שאילתה, בוחרים את הכרטיסייה של הדומיין שרוצים לנתח.

3. בקטע הצגה, לוחצים על add, בוחרים משאב או ממצא כצומת הראשי של השאילתה ולוחצים על המשך.

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

5. כדי לבצע שינויים נוספים בשאילתה, אפשר להוסיף, לערוך או להסיר רכיבים.

   • כדי להוסיף רכיב לשאילתה, לוחצים על סמל הפלוס (add) לצד הצומת.
   • כדי להסיר רכיב, לוחצים על סמל הסגירה close.
   • כדי לשנות את הערך של פסקה Where, לוחצים על הערך.

   אפשר ללחוץ על ביטול undo כדי לבטל שינוי, או על ביצוע מחדש redo כדי להחיל מחדש שינוי שבוטל באמצעות ביטול.

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

6. כשמסיימים לערוך את השאילתה, לוחצים על הפעלת השאילתה. אם תוצאות השאילתה כוללות Google Cloud משאבים שזוהו או משאבים שרשומים באפליקציות ב-מרכז האפליקציות, מוצג גרף טופולוגיה.

   אי אפשר ליצור תרשימים מתוצאות של שאילתות שכוללות רק סוגי נתונים כמו מחרוזות או ספירות.

   אפשר לערוך את השאילתה על סמך התוצאות ואז ללחוץ על Run query כדי לעדכן את תרשים הטופולוגיה.

   אם לא נמצאו תוצאות, כדאי לצמצם את השאילתה.

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

איך ליצור אינטראקציה עם טופולוגיה

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

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

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

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

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

• כדי לבחור את העמודות שיוצגו בטבלה, לוחצים על Column display options view_column.
• כדי לסנן את הטבלה לפי מאפיינים ספציפיים, בוחרים את המאפיינים בשדה Filter.
• אפשר גם למיין כל עמודה בסדר עולה או יורד.