使用推薦工具 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：列出洞察資料的位置，例如 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：每頁列出的資源數量上限。

    預設的頁面大小由服務決定；否則，系統不會分頁。Paging 可能會在 FILTER 和 LIMIT 之前或之後套用。

  • 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：列出洞察資料的位置，例如 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：要說明的洞察資料 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。

洞察群組和類型

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