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

אתם יכולים להשתמש ב-Recommender API או ב-Google Cloud CLI כדי לראות את התובנות של Network Analyzer. במסמך הזה מוסבר איך לצפות בתובנות לגבי סוג תובנה מסוים ב-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 זמין במאמר בנושא קבוצות וסוגים של תובנות.