IBM Cloud Docs
生成直接链路路由报告

生成直接链路路由报告

您可以生成直接链路及其连接已知的所有路径的报告。 此报告允许您验证期望的路由,查看哪些虚拟连接正在向直接链路提供哪些路由,以及查看接收到的路由的下一个中继段地址详细信息。 如果使用跨帐户 VPC 链接功能,您还可以查看正在通过交叉连接路由器路由哪些前缀或子网。

您可以使用 UI,CLI 或 API 来检索路由报告。

路线报告注意事项

使用检修路线报告时,请查看以下注意事项:

  • 在新的虚拟连接 (VPC,经典或 Transit Gateway) 达到 Active 状态后,请允许 5 分钟通过直接链路了解路径。 在学习所有路由之前生成路由报告将生成部分路由报告。
  • 在 BGP 设置为 Established 状态后,大约 5 分钟后,本地路由才会显示。 直到网关完成供应之后,网关路由才会显示。
  • 如果连接公开 0.0.0.0/0 的路由,那么在计算重叠前缀时将忽略该路由。
  • 每个网关在任何时候只有一个报告可用。 如果生成新报告,那么将删除旧报告。
  • 添加或除去连接后,较旧的路由报告可能不准确。 因此,如果在这些连接中更新路由,那么建议您生成新的路由报告。

使用 UI 生成路由报告

要使用 UI 生成路由报告,请执行以下步骤:

  1. 从浏览器打开 IBM Cloud 控制台并登录账户。

  2. 选择左上角的菜单图标 Menu 图标,然后单击 Infrastructure(基础架构 )> Network(网络 )> Direct Link )。

  3. 在 Direct Link 表中,单击要为其生成报告的 Direct Link 名称。

  4. 在“详细信息”页面上,单击 BGP 选项卡,然后向下滚动到 路由 选项卡式视图。 然后,单击 生成报告 链接。

    或者,您可以使用“概述”选项卡上的 路由报告 快捷方式。

    路由报告开始构建,可能需要几分钟才能生成,具体取决于直接链路的复杂性。 请记住,在完成报告处理之前,或者除非单击 取消报告,否则无法生成其他报告。

生成报告后,将在检修路线报告表中显示以下列。

  • Route-指定路由地址 (例如,169.254.0.40/29)。

  • Type-指定路由类型:

    • 连接-指定路由源自的特定连接的名称 (或标识)。
    • 网关 - 在要建立 BGP 的 IBM 路由器上设置。
    • On prem - 源自内部数据中心。

    您可以展开 On-prem 行以查看 AS 路径,下一个中继段和任何冲突。 对于“连接”类型,展开行以显示 AS 路径,本地 pref,源和任何冲突。

  • 已广告-指定是已广告,已学习还是未广告。

    仅当建立 BGP 时,才会公布路由。

  • 冲突-指定是否存在路由冲突。

选择“设置”图标 "设置" 图标 以更改表的行高或编辑列设置。

路由冲突

冲突路由显示在“路由”视图的 冲突 列中。 配置直接链路时,重叠路由是一个常见问题。 如果来自两个或多个连接的路由重叠,那么可能无法正确路由流量。 例如:

显示路由报告
显示路由报告

如果存在多个冲突,请单击链接以打开包含更多信息的侧面板。 解决冲突后,生成新报告。

使用 CLI 生成和查看路由报告

要使用 CLI 生成和查看路由报告,请运行以下命令:

ibmcloud dl route-report-create|rrc GATEWAY_ID [--output format] [--help|-h]

其中:

  • GATEWAY_ID 是网关的 ID。
  • -- output json 以 JSON 格式格式化输出。
    • -help | -h 获取该命令的帮助。

例如,要为直接链路创建检修路线报告,请执行以下操作:

ibmcloud dl route-report-create a771366f-2c8c-49f6-a23b-9d49fad035a3

有关更多信息,请参阅 ibmcloud dl route-report 命令。

使用 API 生成和查看路由报告

要使用 API 生成和查看路由报告,请执行以下步骤:

  1. 使用正确的变量设置 API 环境

  2. 存储要在 API 命令中使用的任何其他变量,例如:

    direct_link_id="11111111-b540-4766-a196-14368f328eb2"
    
  3. 请求报告创建:

    curl -X POST "$directlink_api_endpoint/v1/gateways/$direct_link_id/route_reports?version=$api_version" -H "Authorization: $iam_token"
    

    对于其他调用,您需要知道新创建报告的 ID。 将该标识保存在变量中,例如:

    route_report="22222222-c540-4766-a196-14368f328eb2"
    

    要验证变量是否已保存,请运行 echo $route_report 并确保响应不为空。

  4. 等待报告变为活动状态,然后可以查看其详细信息:

    curl -X GET "$directlink_api_endpointv1/gateways/$direct_link_id/route_reports/$route_report?version=$api_version" -H "Authorization: $iam_token"
    

    有关更多信息,请参阅 网关路由报告 API。