使用 Recommender CLI 和 API

网络分析器使用 Recommender 命令。Recommender 是一项 Google Cloud 服务，可为 Google Cloud 产品和服务提供使用建议。如需查看 Recommender 数据分析类型的完整列表，请参阅 Recommender 数据分析类型。

请求数据分析

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：请求的网络分析器数据分析类型，例如 google.networkanalyzer.vpcnetwork.connectivityInsight。

    如需查看数据分析类型的完整列表，请参阅数据分析组和类型。

以下字段是可选的：

  • EXPRESSION：将此布尔过滤条件应用于您要列出的每个资源。

    如果表达式的计算结果为 True，则系统会列出相应项。如需了解详情以及过滤条件表达式的示例，请运行 $ gcloud topic filters 或查看 gcloud topic filters 文档。

  • LIMIT：要列出的资源数上限；列出的默认资源数量不受限制。

  • PAGE_SIZE：每页列出的资源数上限。

    默认页大小由服务确定，否则不进行分页。可以在 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：要列出的网络分析器数据分析类型，例如 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：数据分析的网络分析器数据分析类型，例如 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：数据分析的网络分析器数据分析类型，例如 google.networkanalyzer.vpcnetwork.connectivityInsight。

    如需查看数据分析类型的完整列表，请参阅数据分析组和类型。

  • INSIGHT_ID：数据分析的 ID。

数据分析组和类型

如需详细了解网络分析器数据分析，请参阅数据分析组和类型。