简介:iLogtail是阿里云中简单日志服务又名“SLS”的采集部分。 它用于收集遥测数据,例如日志、跟踪和指标,目前已经正式开源(https://github.com/alibaba/ilogtail)。本文通过介绍ilogtail如何在K8S环境进行安装、配置、使用的最简流程,帮助用户使用预编译版本快速上手ilogtail日志采集。
使用前准备
- 开通阿里云日志服务并创建了Project(具体步骤参见上一节《ilogtail使用入门-主机环境日志采集到SLS》)
- 准备一个具备公网访问权限的K8S集群,服务器架构为X86-64。
创建日志配置
1.跳转到日志服务控制台(sls.console.aliyun.com),点击上一节中已经创建的project。
2.进入Project查询页面后,点击左侧边栏的“放大镜”图标,展开logstore管理界面,点击“+”,弹出“创建Logstore”右侧边栏。按照提示进行配置,输入logstore名称后,点击“确认”。
3.logstore创建成功后,取消数据接入向导。点击左侧边栏中的“立方体”按钮,在弹出的“资源”浮层中选择“机器组”。在展开的“机器组”左边栏中,点击右上角的“四方格”图标,在弹出的浮层中选择“创建机器组”。
4.在“创建机器组”有侧边栏中按提示配置,“机器组标识”选择“用户自定义标识”,“名称”、“机器组Topic”、“用户自定义标识”建议保持一致。“用户自定义标识”是其中最为重要的一个配置,本教程中使用“my-k8s-group”,后续在安装ilogtail时会再次用到。“点击”确认保存机器组。
5.再次点击左侧边栏的“放大镜”图标,展开logstore管理界面,点击第2步中创建的logstore的“向下展开”图标,弹出“配置Logstore”菜单。点击“logtail配置”的“+”按钮。
6.在弹出的“快速接入数据”对话框中搜索“kube”,并选择“Kubernertes-文件”。在弹出的“提示”框中单机“继续”。
7.在“Kubernertes文件”配置界面,直接选择“使用现有机器组”。
8.跳转到“机器组配置”界面,选择第4步中创建的机器组,点击“>”按钮将其加入到“应用机器组”中,然后点击“下一步”。
9.在ilogtail配置中仅修改“配置名称”和“日志路径”两个必填项,点击“下一步”确认。
10.完成索引配置。这一步不对任何选项进行修改,直接点击下一步完成配置。
安装ilogtail
1.登陆可以控制K8S集群的中控机。编辑ilogtail的ConfigMap YAML。
$ vim alicloud-log-config.yaml
在Vim中粘贴如下内容并保存(注意,修改注释中提示的字段,7-11行)。
apiVersion: v1 kind: ConfigMap metadata:name: alibaba-log-configurationnamespace: kube-system data:log-project: "my-project" #修改为实际project名称log-endpoint: "cn-wulanchabu.log.aliyuncs.com" #修改为实际endpointlog-machine-group: "my-k8s-group" #可以自定义机器组名称log-config-path: "/etc/ilogtail/conf/cn-wulanchabu_internet/ilogtail_config.json" #修改cn-wulanchabu为实际project地域log-ali-uid: "*********" #修改为阿里云UIDaccess-key-id: "" #本教程用不上access-key-secret: "" #本教程用不上cpu-core-limit: "2"mem-limit: "1024"max-bytes-per-sec: "20971520"send-requests-concurrency: "20"
2.计算alicloud-log-config.yaml的sha256 hash,并编辑ilogtail的DaemonSet YAML。
$ sha256sum alicloud-log-config.yaml f370df37916797aa0b82d709ae6bfc5f46f709660e1fd28bb49c22da91da1214 alicloud-log-config.yaml $ vim logtail-daemonset.yaml
在Vim中粘贴如下内容并保存(注意,修改注释中提示的字段,21、25行)。
apiVersion: apps/v1 kind: DaemonSet metadata:name: logtail-dsnamespace: kube-systemlabels:k8s-app: logtail-ds spec:selector:matchLabels:k8s-app: logtail-dsupdateStrategy:type: RollingUpdatetemplate:metadata:labels:k8s-app: logtail-dskubernetes.io/cluster-service: "true"version: v1.0annotations:checksum/config: f370df37916797aa0b82d709ae6bfc5f46f709660e1fd28bb49c22da91da1214 #必须修改为alicloud-log-config.yaml的hashspec:containers:- name: logtailimage: registry.cn-wulanchabu.aliyuncs.com/log-service/logtail:latest #可以修改为距离k8s集群最近的地域resources:limits:cpu: 2memory: 1024Mirequests:cpu: 100mmemory: 256MilivenessProbe:httpGet:path: /livenessport: 7953scheme: HTTPinitialDelaySeconds: 30periodSeconds: 60securityContext:privileged: trueenv:- name: HTTP_PROBE_PORTvalue: "7953"- name: "ALIYUN_LOGTAIL_CONFIG"valueFrom:configMapKeyRef:name: alibaba-log-configurationkey: log-config-path- name: "ALIYUN_LOGTAIL_USER_ID"valueFrom:configMapKeyRef:name: alibaba-log-configurationkey: log-ali-uid- name: "ALIYUN_LOGTAIL_USER_DEFINED_ID"valueFrom:configMapKeyRef:name: alibaba-log-configurationkey: log-machine-group- name: "ALICLOUD_LOG_ACCESS_KEY_ID"valueFrom:configMapKeyRef:name: alibaba-log-configurationkey: access-key-id- name: "ALICLOUD_LOG_ACCESS_KEY_SECRET"valueFrom:configMapKeyRef:name: alibaba-log-configurationkey: access-key-secret- name: "ALICLOUD_LOG_DOCKER_ENV_CONFIG"value: "true"- name: "ALICLOUD_LOG_ECS_FLAG"value: "false"- name: "ALICLOUD_LOG_DEFAULT_PROJECT"valueFrom:configMapKeyRef:name: alibaba-log-configurationkey: log-project- name: "ALICLOUD_LOG_ENDPOINT"valueFrom:configMapKeyRef:name: alibaba-log-configurationkey: log-endpoint- name: "ALICLOUD_LOG_DEFAULT_MACHINE_GROUP"valueFrom:configMapKeyRef:name: alibaba-log-configurationkey: log-machine-group- name: "ALIYUN_LOG_ENV_TAGS"value: "_node_name_|_node_ip_"- name: "_node_name_"valueFrom:fieldRef:fieldPath: spec.nodeName- name: "_node_ip_"valueFrom:fieldRef:fieldPath: status.hostIP# resource limit for logtail self process- name: "cpu_usage_limit"valueFrom:configMapKeyRef:name: alibaba-log-configurationkey: cpu-core-limit- name: "mem_usage_limit"valueFrom:configMapKeyRef:name: alibaba-log-configurationkey: mem-limit- name: "max_bytes_per_sec"valueFrom:configMapKeyRef:name: alibaba-log-configurationkey: max-bytes-per-sec- name: "send_request_concurrency"valueFrom:configMapKeyRef:name: alibaba-log-configurationkey: send-requests-concurrencyvolumeMounts:- name: sockmountPath: /var/run/- name: rootmountPath: /logtail_hostreadOnly: truemountPropagation: HostToContainerterminationGracePeriodSeconds: 30tolerations:- operator: "Exists"hostNetwork: truednsPolicy: "Default"volumes:- name: sockhostPath:path: /var/run/- name: roothostPath:path: /
3.应用YAML配置,创建ConfigMap和DaemonSet。
$ kubectl apply -f alicloud-log-config.yaml configmap/alibaba-log-configuration created $ kubectl apply -f logtail-daemonset.yaml daemonset.apps/logtail-ds created
4.等待1分钟,检查DeamonSet是否正常运行
$ kubectl get -f logtail-daemonset.yaml
这个时候控制台应该打印出类似以下的消息,代表安装成功
NAME DESIRED CURRENT READY UP-TO-DATE AVAILABLE NODE SELECTOR AGE logtail-ds 3 3 3 3 3 <none> 2m1s
上报日志并查看
1.创建一个用于持续生成日志的Pod。
$ vim demo-pod.yaml
在Vim中粘贴如下内容并保存(注意,可能需要修改注释中提示的字段,8-9行)。
apiVersion: v1 kind: Pod metadata:labels:name: demo-podname: demo-pod spec: # imagePullSecrets: # Comment out to enable specific image pull secret # - name: myregistrykey # repleace it to specific registry key containers containers:- image: busyboximagePullPolicy: IfNotPresentname: demo-podcommand: ["/bin/sh"]args: ["-c", "while true; do echo $(date) >>/tmp/demo.log; sleep 10; done"]resources: {}securityContext:capabilities: {}privileged: falseterminationMessagePath: /dev/termination-logdnsPolicy: ClusterFirstrestartPolicy: Always
应用YAML配置,创建Pod
$ kubectl apply -f demo-pod.yaml pod/demo-pod created
2.回到Web控制台,点击配置完成界面的“查询日志”跳转到日志查询界面。点击页面左侧的“放大镜”图标,选中logstore,点击“眼睛”图标,在左侧出现的“消费预览”侧边栏中尝试调整Shard和时间范围,点击预览查看上报的日志。
What's Next
你可以进入下一节学习《ilogtail使用入门-iLogtail本地部署方案》
了解容器采集原理《通过DaemonSet-控制台方式采集容器标准输出》
也可以学习ilogtail采集的更多用法:
- 通过DaemonSet-控制台方式采集容器文本日志
- 采集容器日志
- 如何获取容器的Label和环境变量
原文链接
本文为阿里云原创内容,未经允许不得转载。