使用推薦工具 CLI 和 API

Network Analyzer 會使用Recommender 指令。建議工具是 Google Cloud 服務,可提供 Google Cloud 產品和服務的使用建議。如需推薦工具洞察類型的完整清單,請參閱推薦工具洞察類型

要求洞察資訊

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:您要列出洞察資料的專案 ID。您也可以列出資料夾、機構或帳單帳戶的所有洞察資料。
  • LOCATION:列出洞察資料的位置,例如 globaleuropeasia-east1us-central1-a
  • INSIGHT_TYPE:要要求的 Network Analyzer 洞察類型,例如 google.networkanalyzer.vpcnetwork.connectivityInsight

    如需深入分析類型的完整清單,請參閱「深入分析群組和類型」。

以下欄位為選填:

  • EXPRESSION:將這個布林值篩選器套用至您要列出的每個資源。

    如果運算式評估為 True,系統就會列出該項目。如需篩選運算式的詳細資訊和範例,請執行 $ gcloud topic filters 或參閱 gcloud topic filters 說明文件

  • LIMIT:列出的資源數量上限;預設的資源數量上限為無限制。

  • PAGE_SIZE:每頁列出的資源數量上限。

    預設的頁面大小由服務決定;否則,系統不會分頁。Paging 可能會在 FILTERLIMIT 之前或之後套用。

  • SORT_BY:資源的排序依據,以逗號分隔的欄位鍵名稱清單。

    預設順序為遞增。如要指定遞減順序,請在欄位前方加上 ~ (波浪號)。

API

如要取得 Google Cloud 專案的深入分析資料,請對 projects.locations.insightTypes.insights 方法發出 GET 要求:

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

更改下列內容:

  • PROJECT_ID:專案 ID。
  • LOCATION:列出洞察資料的位置,例如 globaleuropeasia-east1us-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:要說明的洞察資料 ID。
  • PROJECT_ID:包含洞察資料的專案 ID。
  • LOCATION:要列出洞察資料的位置。
  • INSIGHT_TYPE:洞察的 Network Analyzer 洞察類型,例如 google.networkanalyzer.vpcnetwork.connectivityInsight

    如需深入分析類型的完整清單,請參閱「深入分析群組和類型」。

API

如要取得洞察資料的詳細資料,請對 projects.locations.insightTypes.insights 方法發出 GET 要求:

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

更改下列內容:

  • PROJECT_ID:專案 ID。
  • LOCATION:洞察結果的位置。
  • INSIGHT_TYPE:洞察的 Network Analyzer 洞察類型,例如 google.networkanalyzer.vpcnetwork.connectivityInsight

    如需深入分析類型的完整清單,請參閱「深入分析群組和類型」。

  • INSIGHT_ID:洞察 ID。

洞察群組和類型

如要進一步瞭解網路分析器深入分析,請參閱「深入分析群組和類型」。