终极指南：如何利用werf实现Kubernetes应用的实时监控与日志管理

终极指南：如何利用werf实现Kubernetes应用的实时监控与日志管理

【免费下载链接】werfA solution for implementing efficient and consistent software delivery to Kubernetes facilitating best practices.项目地址: https://gitcode.com/gh_mirrors/we/werf

werf是一款强大的Kubernetes应用交付工具，它通过集成Helm和kubedog库，为用户提供了高效的资源监控和日志管理能力。本文将详细介绍如何使用werf跟踪应用状态、配置日志显示以及利用事件监控功能，帮助开发者轻松掌握Kubernetes应用的运行状况。

资源状态跟踪：实时掌握部署进度 🚀

werf通过kubedog库实现了高级资源状态跟踪功能，默认对所有支持的资源类型启用跟踪：

• 所有发布资源
• 由发布资源间接创建的部分资源
• 通过<name>.external-dependency.werf.io/resource注解引用的非发布资源

对于Deployment、StatefulSet、DaemonSet、Job和Flagger Canary等资源，werf使用专用状态跟踪器，不仅能准确判断资源部署是否成功，还能跟踪子资源（如Deployment创建的Pods）的状态。其他资源则使用通用跟踪器，基于集群中可用信息预测部署成功与否。

werf资源构建与部署流程示意图，展示了从基础镜像到最终部署的完整状态跟踪过程

自定义部署失败标准

默认情况下，werf在单个资源部署出现超过两个错误时会中止部署。您可以通过werf.io/failures-allowed-per-replica注解修改允许的最大错误数：

apiVersion: apps/v1 kind: Deployment metadata: name: myapp annotations: werf.io/failures-allowed-per-replica: "5"

通用跟踪器将资源4分钟无活动视为部署错误，可通过werf.io/no-activity-timeout注解调整超时时间：

apiVersion: apps/v1 kind: Deployment metadata: name: myapp annotations: werf.io/no-activity-timeout: 10m

禁用状态跟踪和忽略错误

如需禁用资源状态跟踪并忽略部署错误，可添加以下注解：

apiVersion: apps/v1 kind: Deployment metadata: name: myapp annotations: werf.io/fail-mode: IgnoreAndContinueDeployProcess werf.io/track-termination-mode: NonBlocking

容器日志显示：精准掌控应用输出 📝

werf借助kubedog库能够自动显示Deployment、StatefulSet、DaemonSet和Job对象创建的容器日志。通过灵活的注解配置，您可以自定义日志显示方式。

控制日志显示范围

默认情况下，werf仅显示单个副本的日志。使用werf.io/show-logs-only-for-number-of-replicas注解可修改显示的副本数量：

apiVersion: apps/v1 kind: Deployment metadata: name: myapp annotations: werf.io/show-logs-only-for-number-of-replicas: "999"

要完全禁用资源的日志显示，使用werf.io/skip-logs注解：

apiVersion: apps/v1 kind: Deployment metadata: name: myapp annotations: werf.io/skip-logs: "true"

容器级日志过滤

通过werf.io/show-logs-only-for-containers注解可指定显示特定容器的日志：

apiVersion: apps/v1 kind: Deployment metadata: name: myapp annotations: werf.io/show-logs-only-for-containers: "backend,frontend"

相反，使用werf.io/skip-logs-for-containers注解可排除特定容器的日志：

apiVersion: apps/v1 kind: Deployment metadata: name: myapp annotations: werf.io/skip-logs-for-containers: "sidecar"

日志内容过滤

使用werf.io/log-regex注解可仅显示匹配正则表达式的日志行：

apiVersion: apps/v1 kind: Deployment metadata: name: myapp annotations: werf.io/log-regex: ".*ERROR.*"

针对特定容器的日志过滤，使用werf.io/log-regex-for-<容器名>注解：

apiVersion: apps/v1 kind: Deployment metadata: name: myapp annotations: werf.io/log-regex-for-backend: ".*ERROR.*"

要隐藏匹配特定模式的日志行，使用werf.io/log-regex-skip或werf.io/log-regex-skip-for-<容器名>注解：

apiVersion: apps/v1 kind: Deployment metadata: name: myapp annotations: werf.io/log-regex-skip: ".*DEBUG.*" werf.io/log-regex-skip-for-backend: ".*INFO.*"

事件资源显示：全面了解系统动态 🔍

werf还能显示跟踪资源的Events，只需为资源添加werf.io/show-service-messages: "true"注解：

apiVersion: apps/v1 kind: Deployment metadata: name: myapp annotations: werf.io/show-service-messages: "true"

werf与Helm集成示意图，展示了日志和监控功能的实现架构

总结：提升Kubernetes应用可观测性的最佳实践

通过werf提供的监控和日志管理功能，开发者可以实时掌握Kubernetes应用的部署状态和运行情况。合理配置各种注解，能够精准过滤和显示关键信息，大大提高问题诊断效率。

werf的监控与日志管理功能主要通过以下方式实现：

1. 基于kubedog库的高级资源状态跟踪
2. 灵活的日志显示和过滤配置
3. 资源事件监控

这些功能使得werf成为Kubernetes应用交付的理想选择，帮助团队实现高效、一致的软件交付流程。

有关更多详细信息，请参阅官方文档：docs/pages_en/usage/deploy/tracking.md。

【免费下载链接】werfA solution for implementing efficient and consistent software delivery to Kubernetes facilitating best practices.项目地址: https://gitcode.com/gh_mirrors/we/werf