שימוש ב-Recommender CLI וב-API

Network Analyzer משתמש בפקודות של שירות ההמלצות. רשימה מלאה של סוגי התובנות של שירות ההמלצות זמינה במאמר בנושא סוגי התובנות.

בקשה לקבלת תובנות

gcloud

כדי להציג את המדדים של Google Cloud פרויקט, מריצים את הפקודה הבאה:

gcloud recommender insights list \
    --project=PROJECT_ID \
    --location=LOCATION \
    --insight-type=INSIGHT_TYPE \
    --filter=EXPRESSION \
    --limit=LIMIT \
    --page-size=PAGE_SIZE \
    --sort-by=SORT_BY \
    --format=json

מחליפים את מה שכתוב בשדות הבאים:

• ‫PROJECT_ID: מזהה הפרויקט שרוצים להציג את התובנות לגביו. אפשר גם לראות רשימה של כל התובנות לגבי תיקייה, ארגון או חשבון לחיוב.
• ‫LOCATION: המיקום שרוצים להציג לגביו תובנות, למשל global,‏ europe,‏ asia-east1 או us-central1-a.

• ‫INSIGHT_TYPE: סוג התובנה של Network Analyzer שרוצים לבקש, כמו google.networkanalyzer.vpcnetwork.connectivityInsight.

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

השדות הבאים הם אופציונליים:

• ‫EXPRESSION: הוספת מסנן בוליאני לכל משאב שרוצים שיופיע ברשימה.

  אם הערך של הביטוי הוא True, הפריט ייכלל. לפרטים נוספים ולדוגמאות לביטויי סינון, מריצים את הפקודה $ gcloud topic filters או מעיינים במסמכי התיעוד של gcloud topic filters.

• ‫LIMIT: המספר המקסימלי של המשאבים שיופיעו ברשימה. ברירת המחדל היא שהמספר לא מוגבל.

• ‫PAGE_SIZE: המספר המקסימלי של המשאבים שיופיעו בכל דף

  גודל הדף שמוגדר כברירת מחדל נקבע על ידי השירות. אחרת, אין חלוקה לדפים. יכול להיות שהחלוקה לדפים תתווסף לפני או אחרי FILTER ו-LIMIT.

• ‫SORT_BY: רשימה מופרדת בפסיקים של שמות מפתחות של שדות משאבים, שלפיהם רשימת המשאבים תמוין.

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

API

כדי לקבל תובנות לגבי פרויקט ב- Google Cloud , שולחים בקשת GET ל-method‏ projects.locations.insightTypes.insights:

https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/insightTypes/INSIGHT_TYPE/insights

מחליפים את מה שכתוב בשדות הבאים:

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫LOCATION: המיקום שרוצים להציג לגביו תובנות, למשל global,‏ europe,‏ asia-east1 או us-central1-a.

• ‫INSIGHT_TYPE: סוג התובנה של Network Analyzer שרוצים להציג, למשל google.networkanalyzer.vpcnetwork.connectivityInsight.

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

בדוגמה הבאה אפשר לראות תגובה לדוגמה לפקודה הזו:

{
  "name": "projects/{project_number}/locations/{location}/insightTypes/google.networkanalyzer.hybridconnectivity.dynamicRouteInsight/insights/{insight_id}",
  "description": "Dynamic route is fully shadowed by a peering subnet route",
  "content": {
    "networkUri": "//compute.googleapis.com/projects/{project_id}/global/networks/{network_name}",
    "region": "{location}",
    "ipRange": "{ip_range}",
    "priority": 100,
    "nextHopUri": "//compute.googleapis.com/projects/{project_id}/regions/{location}/vpnTunnels/{tunnel_name}",
    "cloudRouterUri": "//compute.googleapis.com/projects/{project_id}/regions/{location}/routers/{router_name}",
    "shadowingRouteUris": [
      "//compute.googleapis.com/projects/{project_id}/global/routes/{route_name}"
    ],
    "shadowingRouteType": "PEERING_SUBNET"
  },
  "lastRefreshTime": "2022-09-15T21:10:57.187942979Z",
  "observationPeriod": "611870.625920374s",
  "stateInfo": {
    "state": "ACTIVE"
  },
  "category": "PERFORMANCE",
  "targetResources": [
    "//compute.googleapis.com/projects/{project_id}/regions/{location}/vpnTunnels/{tunnel_name}"
  ],
  "insightSubtype": "DYNAMIC_ROUTE_FULLY_SHADOWED",
  "severity": "MEDIUM"
}

תיאור פרטי התובנה

gcloud

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

gcloud recommender insights describe INSIGHT_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --insight-type=INSIGHT_TYPE

מחליפים את מה שכתוב בשדות הבאים:

• ‫INSIGHT_ID: המזהה של התובנה שרוצים לתאר.
• ‫PROJECT_ID: מזהה הפרויקט שמכיל את התובנה.
• ‫LOCATION: המיקום שלגביו רוצים להציג את התובנות.

• ‫INSIGHT_TYPE: סוג התובנה של Network Analyzer, לדוגמה google.networkanalyzer.vpcnetwork.connectivityInsight.

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

API

כדי לקבל פרטים על תובנה, שולחים בקשת GET אל השיטה projects.locations.insightTypes.insights:

https://recommender.googleapis.com/v1/projects/PROJECT/locations/LOCATION/insightTypes/INSIGHT_TYPE/insights/INSIGHT_ID

מחליפים את מה שכתוב בשדות הבאים:

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫LOCATION: המיקום של התובנה.

• ‫INSIGHT_TYPE: סוג התובנה של Network Analyzer, לדוגמה google.networkanalyzer.vpcnetwork.connectivityInsight.

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

• ‫INSIGHT_ID: מזהה התובנה.

סוגים של קבוצות תובנות

מידע נוסף על תובנות ב-Network Analyzer זמין במאמר קבוצות וסוגים של תובנות.