接入腾讯云 CLS
腾讯云日志服务(Cloud Log Service 简称 CLS)提供一站式的日志数据解决方案,涵盖日志的采集、存储、加工、检索分析、消费投递、生成仪表盘、告警等全方位稳定可靠服务。
本文将简要介绍如何在应用环境中接入腾讯云日志服务(CLS)功能。
开通 CLS
在腾讯云控制台中开通并授权 CLS 服务。
绑定腾讯云账号
授权腾讯云凭据授权后,CODING 团队可以无缝连接控制台中的各项资源,获得更加流畅的 CODING DevOps 云端体验。请参考阅读《绑定腾讯云》。
接入日志服务
在应用环境中的日志页中,选择腾讯云日志服务(CLS)。
选择集群所在地域,系统将自动读取当前区域下的实例,确认后点击“部署”按钮。
连通性测试通过后,选中“腾讯云日志服务”并点击“确定”按钮。
连接性检测通过后即可在环境中查看日志。
为每个服务指定独立的 CLS 日志主题
可以使用环境变量注入的方式让每个服务都关联到指定的 CLS 日志主题。
- OAM 应用
如果你使用 OAM 的方式创建应用,可以通过运维插件的方式插入环境变量。
- 点击「团队设置中心」->「功能设置」->「运维插件」,在「运维插件」页面点击「创建运维插件」,创建如下运维插件。
具体 Yaml 内容如下所示。
apiVersion: apps/v1
kind: Deployment
metadata:
name: {{.name}}
annotations:
coding.oam.trait/cls: "true"
spec:
template:
spec:
containers:
- env:
- name: QCLOUD_CLS_TOPIC_ID
value: {{.topicId}}
- name: QCLOUD_CLS_ACCESS_KEY_ID
valueFrom:
secretKeyRef:
key: QCLOUD_CLS_ACCESS_KEY_ID
name: qcloud-cls
optional: false
- name: QCLOUD_CLS_ACCESS_KEY_SECRET
valueFrom:
secretKeyRef:
key: QCLOUD_CLS_ACCESS_KEY_SECRET
name: qcloud-cls
optional: false
name: {{.name}}
本段 yaml 会在 deployment 里面注入腾讯云的 SecretId 和 SecretKey(通过 secret 引用),也会注入 CLS 日志主题 ID。
- 在「应用管理」->「服务管理」的「运维插件」页签中点击「添加插件」。
- 在「添加插件」中点击日志服务插件后,点击「确定」。
- 在刚添加的运维插件中填入服务相关的日志主题。
为应用添加腾讯云的 SecretId 和 SecretKey,点击应用右上角的「设置」。
在「Yaml 仓库」页签点开「元数据仓库」,点击仓库右侧箭头跳转到代码仓库。
- 在代码仓库中的 secrets 文件夹添加 qcloud-cls.yaml。
内容是经过 base64 编码的腾讯云的 SecretId 和 SecretKey。
在「应用管理」->「配置管理」,可以查看新的 secret。
- 再次发布应用,可在环境的「日志」页签中查看到该服务相关的 CLS 日志。
- Helm 或 kustomize 应用
请在 deployment 中加入如下的环境变量。
apiVersion: apps/v1
kind: Deployment
metadata:
name: xxxxx
spec:
template:
spec:
containers:
- env:
- name: QCLOUD_CLS_TOPIC_ID
value: 您的 CLS 日志主题 ID
- name: QCLOUD_CLS_ACCESS_KEY_ID
valueFrom:
secretKeyRef:
key: QCLOUD_CLS_ACCESS_KEY_ID
name: qcloud-cls
optional: false
- name: QCLOUD_CLS_ACCESS_KEY_SECRET
valueFrom:
secretKeyRef:
key: QCLOUD_CLS_ACCESS_KEY_SECRET
name: qcloud-cls
optional: false
name: xxx
确保集群中有 qcloud-cls 这个 secret,内容如下所示。
其中值是 base64 编码后的腾讯云 SecretId 和 SecretKey。
在阅读中是否遇到以下问题?*
您希望我们如何改进?*
如果您希望得到回复,请留下您的邮箱地址。