首先通过日志排查问题，使用kubectl logs查看Pod日志，支持多容器指定和实时跟踪；其次用kubectl exec进入容器检查环境变量、网络连通性及.NET运行时版本；开发环境中可通过端口转发启用远程调试，需镜像包含vsdbg工具并开放调试端口；生产环境应集成OpenTelemetry实现分布式追踪，暴露Prometheus指标并结合Grafana监控.NET运行时性能，设置告警应对异常；最终建立日志、指标、链路三位一体的可观测体系，提升问题响应效率。
调试 Kubernetes 中的 .NET 微服务需要结合日志、监控、网络和运行时诊断工具。直接在 Pod 中排查问题是最常见的方式，下面介绍几种实用方法。
查看容器日志
每个 .NET 微服务运行在独立的 Pod 容器中，最直接的调试方式是查看其输出日志。
- 使用 kubectl logs <pod-name> 查看标准输出和错误信息
- 如果 Pod 有多个容器，用 -c <container-name> 指定目标容器
- 添加 --follow 实时跟踪日志，类似 tail -f
- 启用结构化日志（如 Serilog 或 Microsoft.Extensions.Logging.JsonConsole）能更方便地排查异常堆栈和请求上下文
进入容器执行诊断命令
当日志不足以定位问题时，可以进入正在运行的容器内部检查环境。
- 使用 kubectl exec -it <pod-name> -- /bin/sh 进入容器 shell
- 检查配置文件路径、环境变量（printenv）是否正确加载
- 验证网络连通性，比如用 curl 调用依赖服务或健康检查接口
- 确认 .NET 运行时版本（dotnet --info）与预期一致
启用远程调试（开发环境）
在开发或测试环境中，可通过端口转发实现远程调试。
- 确保镜像包含调试工具（如 vsdbg），基础镜像推荐使用 mcr.microsoft.com/dotnet/sdk
- 部署时开放调试端口（通常是 5899 或 4024）
- 使用 kubectl port-forward <pod-name> 5899:5899 将调试端口映射到本地
- 在 Visual Studio 或 VS Code 中连接到 localhost:5899 进行断点调试
使用分布式追踪和指标监控
生产环境应避免手动介入，建议集成可观测性体系。
- 通过 OpenTelemetry 收集请求链路，分析性能瓶颈或失败调用
- 暴露 Prometheus 格式的指标（如 HTTP 请求延迟、GC 暂停时间）
- 配合 Grafana 展示 .NET 运行时指标（可使用 dotnet-monitor 工具）
- 设置告警规则，及时发现内存泄漏或高 CPU 使用情况
基本上就这些。关键是建立从日志到指标再到调用链的完整观测能力，再结合临时调试手段快速响应问题。
