Anthos Clusters on Bare Metal 现在是 Bare Metal 上的 Google Distributed Cloud（纯软件）。如需了解详情，请参阅产品概览。

排查与 Google 的连接问题

本文档提供了与 Google 连接相关的问题的问题排查指南。

Network Connectivity Gateway

本部分提供与 Network Connectivity Gateway 相关的问题排查提示。

如果您需要其他帮助，请与 Cloud Customer Care 联系。

验证控制器和网关 Pod 是否正在运行

列出 Network Connectivity Gateway pod：
```
kubectl --kubeconfig CLUSTER_KUBECONFIG get pods \
    --namespace kube-system | grep ncg
```
将 CLUSTER_KUBECONFIG 替换为集群 kubeconfig 文件的路径。

在输出中，验证您是否看到控制器 Pod 和网关 Pod。控制器 Pod 的名称以 ncg-controller 开头，网关 Pod 的名称以 ncgd 开头。例如：
```
ncg-controller-5f5d489b68-r87pp     1/1     Running
ncgd-gvl76                          1/1     Running
```
记下网关 Pod 的名称。您将需要它来执行各种问题排查命令。

检查网关 Pod 日志

检查网关 Pod 的日志中是否存在任何错误：
```
kubectl --kubeconfig CLUSTER_KUBECONFIG logs GATEWAY_POD \
    --namespace kube-system
```
将 GATEWAY_POD 替换为您的网关 Pod 的名称。

在网关 pod 中运行 `ncgcli`

网关 Pod 有一个名为 ncgcli 的命令行工具，可用于获取网关和隧道中流量的相关信息。

使用以下命令在网关 Pod 中运行 ncgcli：

kubectl --kubeconfig CLUSTER_KUBECONFIG exec -it GATEWAY_POD \
    --namespace kube-system -- ncgCLI_COMMAND

将 ncgCLI_COMMAND 替换为 ncgcli 命令。

例如：

kubectl --kubeconfig my-kubeconfig exec ncgd-6hkk2 --namespace kube-system \
    -- ncgcli --help

以下部分提供了更多 ncgcli 命令示例。

IPsec 隧道无法启动

查看 NetworkConnectivityGateway 自定义资源的状态：

kubectl --kubeconfig CLUSTER_KUBECONFIG get NetworkConnectivityGateway \
    --namespace kube-system --output yaml

在输出中，验证您是否看到 Status: Healthy。例如：

apiVersion: networking.gke.io/v1alpha1
kind: NetworkConnectivityGateway
metadata:
  namespace: kube-system
  name: default
spec:
status:
  CurrNode: worker1-node
  CreatedTime: 2021-09-07T03:18:15Z
  LastReportTime: 2021-09-21T23:57:54Z
  Status:  Healthy

查看 OverlayVPNTunnel 自定义资源的状态：

kubectl --kubeconfig CLUSTER_KUBECONFIG get OverlayVPNTunnel \
    --namespace kube-system --output yaml

从网关 pod 内部检查隧道的状态：
```
ncgcli overlay peers show
```

如需了解详情，请参阅 Cloud VPN 问题排查。

无法建立 BGP 会话

验证您是否已为 Cloud Router 和集群中的网关 Pod 之间的 BGP 会话使用链路本地 IP 地址（例如 169.254.1.2 和 169.254.2.2）。

检查 BGP 会话的状态：

kubectl --kubeconfig CLUSTER_KUBECONFIG get OverlayBGPPeer \
    --namespace kube-system --output yaml

从网关 pod 内部检查 BGP 会话的状态：
```
ncgcli overlay routes show
```

如需详细了解如何排查 BGP 会话问题，请参阅以下内容：

即使隧道已启动也出现流量转发问题

如果流量转发失败，请在网关 pod 内部运行 ncgcli 以检查隧道、路由和数据层面编程的状态。

确保已建立连接到对等网关的 IPsec 隧道：
```
ncgcli overlay peers show
```
确认叠加路由已通过 BGP 交换并解析为相应的 IPsec 隧道：
```
ncgcli overlay routes show
```
数据层面中编程的显示路由以及输出应包含叠加路由：
```
ncgcli fast-path routes show
```

调整最大传输单元

最大传输单元 (MTU) 是网络层协议支持的最大数据包的大小（以字节为单位），标头和数据均包括在内。如果由于网络 MTU 限制而导致流量问题，您可以针对 OverlayVPNTunnel 自定义资源配置 MTU。隧道的默认 MTU 为 1380 字节。

如需调整隧道的 MTU，请执行以下操作：

检查隧道的状态：

kubectl --kubeconfig CLUSTER_KUBECONFIG get OverlayVPNTunnel \
    --namespace kube-system --output yaml

status 部分应如以下示例所示：

status:
  IfName: ipsec2
  LastTransition: "2022-06-16T07:13:28Z"
  SLA:
    DiscoveredMTU: 1300
    Jitter(ms): 1
    Latency(ms): 26
    Loss(%): "0.00"

如果 status.SLA.DiscoveredMTU 值小于默认值 1380，请按照以下步骤更改 OverlayVPNTunel 自定义资源中的 Spec.mtu 值以匹配。

打开 OverlayVPNTunnel 自定义资源，以使用 kubectl edit 命令进行修改：
```
kubectl --kubeconfig CLUSTER_KUBECONFIG edit OVERLAY_VPN_TUNNEL_NAME
    --namespace kube-system --output yaml
```
为避免数据包丢失，请为 Network Connectivity Gateway 所使用的两个 OverlayVPNTunnel 自定义资源配置相同的 MTU。

设置 mtu 值以匹配第一步中的 DiscoveredMTU 值：

apiVersion: networking.gke.io/v1alpha1
  kind: OverlayVPNTunnel
  metadata:
    name: vpc2
    namespace: kube-system
  Spec:
    mtu: 1300
    ikeKey:
      name: ike-key
      namespace: kube-system
    localTunnelIP: 169.254.0.2
    peer:
      publicIP: 34.100.10.10
    self:
      publicIP: 70.32.151.5

如需应用更改，请保存并关闭编辑器。

如需详细了解 MTU 及其对流量性能的影响，请参阅 MTU 注意事项。

查看流量和应用级层统计信息

如需查看流量和统计信息，请在网关 Pod 内部运行 ncgcli。

如需流和流量应用的即时视图，请执行以下操作：
```
ncgcli forwarding flows top
```

对于流级层的聚合统计信息：

ncgcli forwarding flows aggregates show

对于接口级层的聚合统计信息：
```
ncgcli interfaces statistics show
```

后续步骤