安装、运行、升级、卸载Logtail - 日志服务

如果您要使用日志服务Project采集服务器日志，首先需要在目标服务器上安装Logtail客户端。本文介绍如何在目标服务器中安装、运行，升级和卸载Logtail。

概述

日志服务Logtail的使用场景根据目标服务器类型可分为以下两类：

主机场景：适用于物理服务器、云服务器（ECS）等传统计算环境。
容器场景：基于Kubernetes容器化平台部署的业务场景。

请根据您的服务器运行环境选择对应的方案，不同场景的使用流程及配置要求存在差异。若混合环境部署，需分别完成对应环境的安装配置。

主机场景

安装Logtail

安装Logtail有自动安装与手动安装两种方式，当且仅当您使用的是ECS机器，且ECS与Project属于同账号同地域时，日志服务才支持自动安装Logtail。否则请使用手动方式安装Logtail。

自动安装Logtail

手动安装Logtail

若您使用的不是阿里云主账号，而是RAM用户，则需要在安装Logtail前先为RAM用户开通权限。

RAM用户授权

如果您使用RAM用户登录，需具备日志服务的数据接入（Logtail）管理权限与操作OOS资源的权限。

日志服务
在权限助手中，选中数据接入（logtail）。具体操作，请参见配置权限助手。

OOS：日志服务借助运维编排服务OOS，实现在ECS实例中自动安装Logtail。

系统权限：AliyunOOSFullAccess权限。
为RAM用户授予AliyunOOSFullAccess权限的具体操作，请参见为RAM用户授权。

自定义权限：参见如下示例，创建具备操作OOS资源权限的自定义权限策略。具体操作，请参见创建自定义权限策略。

创建自定义权限策略后，您还需为RAM用户授权。具体操作，请参见为RAM用户授权。

{
    "Version": "1",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ecs:DescribeTagKeys",
                "ecs:DescribeTags",
                "ecs:DescribeInstances",
                "ecs:DescribeInvocationResults",
                "ecs:RunCommand",
                "ecs:DescribeInvocations"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "oos:ListTemplates",
                "oos:StartExecution",
                "oos:ListExecutions",
                "oos:GetExecutionTemplate",
                "oos:ListExecutionLogs",
                "oos:ListTaskExecutions"
            ],
            "Resource": "*"
        }
    ]
}

自动安装Logtail请参考：步骤一：安装Logtail与创建机器组。

请根据表格选择Logtail下载与安装方式：

说明

示例代码中${region_id}为日志服务Project所在地域，请参见开服地域后替换，例如华东 1（杭州）对应的${region_id}为cn-hangzhou。

重要

如果您的机器配置较低或操作系统版本较旧，安装 Logtail 2.0 可能会出现兼容性问题，导致软件无法正常运行。在这种情况下，建议使用Logtail 1.8.7版本。安装命令如下：./logtail.sh install ${region_id} -v 1.8.7

主机类型	操作系统	下载方式	安装方式
Linux	ARM	主机可联网，直接下载： `wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh;`	根据网络情况选择安装命令： `#公网方式安装 chmod +x logtail.sh; ./logtail.sh install ${region_id}-internet #服务器分布在海外各地的自建机房或者来自海外云厂商，使用公网传输数据可能会出现网络延迟高、传输不稳定等问题，推荐选择传输加速传输数据。此方式不支持金融云地域 chmod +x logtail.sh; ./logtail.sh install ${region_id}-acceleration #内网方式安装，适用于自建IDC已经打通内网的情况 chmod +x logtail.sh; ./logtail.sh install auto`
	x86-64
	ARM	主机离线，需先在可以访问公网的服务器上下载安装脚本与安装包：`wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh; wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/aarch64/logtail-linux64.tar.gz`	请将安装脚本和安装包拷贝至需要安装Logtail的服务器上后，根据网络情况选择安装命令： `#公网方式安装 chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-internet #服务器分布在海外各地的自建机房或者来自海外云厂商，使用公网传输数据可能会出现网络延迟高、传输不稳定等问题，推荐选择传输加速传输数据。此方式不支持金融云地域 chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-acceleration`
	x86-64	主机离线，需先在可以访问公网的服务器上下载安装脚本与安装包：`wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh; wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail-linux64.tar.gz`
Windows	32位	中国地域：Logtail安装包 32位	解压安装包，以管理员身份运行Windows PowerShell或cmd，进入`logtail_installer`目录（您的安装包的解压目录）。根据网络情况选择安装命令： `#公网方式安装 .\logtail_installer.exe install ${region_id}-internet #服务器分布在海外各地的自建机房或者来自海外云厂商，使用公网传输数据可能会出现网络延迟高、传输不稳定等问题，推荐选择传输加速传输数据。此方式不支持金融云地域 .\logtail_installer.exe install ${region_id}-acceleration`
		海外地域：Logtail安装包 32位
	64位	中国地域：Logtail安装包 64位
		海外地域：Logtail安装包 64位

批量安装Logtail

批量安装Logtail有如下两种方式：

OOS编排：适合有权限要求场景，并发度较高，适合大规模批量操作。具体请参考使用OOS批量安装或升级Logtail。
ECS云助手功能：简单易用，直接通过命令的方式执行临时任务。具体操作步骤如下所示：

登录ECS管理控制台。
在左侧导航栏，选择运维与监控 > 云助手。
在页面左侧顶部，选择目标资源所在的资源组和地域。
选择您要安装Logtail的ECS服务器，并单击发送命令。
确认云助手是在线状态（如果不是在线状态，请参见安装云助手Agent，完成云助手安装。），并单击下一步。
在脚本编辑框中输入安装命令（此处以公网安装方式为例，更多安装命令，请参见安装Logtail），并单击执行。等待命令执行完成，然后在输出栏查看结果，确认安装成功。
此处用到的安装命令如下所示：
```
#!/bin/bash
region_id='cn-hangzhou'
wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh
chmod +x logtail.sh
./logtail.sh install ${region_id}-internet
```
重要
安装Logtail后，如果ECS的网络由经典网络切换至VPC，则需要更新Logtail配置。更多信息，请参见ECS经典网络切换为VPC后，如何更新Logtail配置。

启动和停止Logtail

Linux

Windows

启动Logtail
```
sudo /etc/init.d/ilogtaild start
```
停止Logtail
```
sudo /etc/init.d/ilogtaild stop
```

登录目标服务器。
选择开始 > 控制面板 > 管理工具 > 服务。
在服务对话框中，选择对应的服务。
- 如果是0.x.x.x版本，选择LogtailWorker服务。
- 如果是1.0.0.0及以上版本，选择LogtailDaemon服务。
右键选择对应的操作，包括启动、停止或重新启动。

查看Logtail状态及版本

Linux

Windows

查看Logtail状态

使用sudo /etc/init.d/ilogtaild status命令查看Logtail状态。若系统返回ilogtail is running，表示已安装Logtail。如果Logtail状态显示未运行，请卸载后重新安装。

查看Logtail版本

Logtail会将版本信息存储在/usr/local/ilogtail/app_info.json文件的logtail_version字段中。您可以通过以下命令查看Logtail版本信息。

cat /usr/local/ilogtail/app_info.json

返回结果如下所示：

{
   "logtail_version" : "0.16.30",
}

查看Logtail状态

您可以通过查看Logtail状态确定是否已在目标服务器上安装Logtail。

打开运行窗口，输入services.msc，打开服务窗口。
查看LogtailDaemon服务（Logtail 1.0.0.0及以上版本）或LogtailWorker服务（Logtail 0.x.x.x版本）的运行状态。
如果显示正在运行，表示已安装Logtail。

查看Logtail版本

您可以通过安装路径下的app_info.json文件中的logtail_version字段查看Logtail版本。

例如，以下内容表示Logtail的版本号为1.0.0.0。

{
    "logtail_version" : "1.0.0.0"
}

升级Logtail

Linux

Windows

重要

升级Logtail时，请使用upgrade命令。若使用install命令，将会执行覆盖安装，丢失原配置。
升级过程中，Logtail会短暂停止运行，升级完成后，Logtail 将自动启动，并注册为开机启动项。升级仅覆盖必要的文件，配置文件和Checkpoint文件将被保留，确保升级期间日志不会丢失。

说明

示例代码中${region_id}为日志服务Project所在地域，请参见开服地域后替换，例如华东 1（杭州）对应的${region_id}为cn-hangzhou。

请根据表格选择Logtail升级方式：

操作系统	下载方式	升级方式
ARM与x86-64	主机可联网：`wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh;`	下载完成后执行升级命令：`chmod +x logtail.sh; sudo ./logtail.sh upgrade;`

ARM	主机离线，需先在可以访问公网的服务器上下载安装脚本与安装包： `wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh; wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/aarch64/logtail-linux64.tar.gz;`	请将安装脚本和安装包拷贝至需要升级Logtail的服务器上后，执行如下升级命令：`chmod +x logtail.sh; ./logtail.sh upgrade-local;`
x86-64	主机离线，需先在可以访问公网的服务器上下载安装脚本与安装包：`wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh; wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail-linux64.tar.gz;`

如果显示以下信息，则表示升级成功。

stop successfully
Stop logtail successfully.
Upgrading logtail files ...
Upgrade logtail files successfully.
Starting logtail ...
ilogtail is running
Upgrade logtail successfully.
{
        "UUID" : "XXXXXXXX-XXXX",
        "compiler" : "GCC 9.3.1",
        "hostname" : "xxx",
        "instance_id" : "XXXXXXXX-XXXX_172.16.0.75_1730950372",
        "ip" : "172.16.0.75",
        "logtail_version" : "2.0.8",
        "os" : "Linux; 5.10.134-13.an8.x86_64; #1 SMP Mon Jan 9 10:39:46 CST 2023; x86_64",
        "update_time" : "2024-11-07 11:32:52"
}

升级的操作和安装Logtail的操作相同，您只需要下载并解压最新的安装包，然后按照步骤执行安装。更多信息，请参见安装Logtail。

重要

升级相当于自动卸载并重新安装，会删除您原先安装目录中的内容，请您在执行升级前做好备份工作。
在Windows 64位操作系统中，如果您要将32位Logtail升级到64位，需要先卸载32位的Logtail，再重新安装64位的Logtail。

卸载Logtail

Linux

Windows

根据日志服务Project所在地域，获取对应的${region_id}。替换${region_id}后，执行以下命令卸载Logtail。

重要

各地域对应的${region_id}请参见开服地域，例如华东 1（杭州）对应的${region_id}为cn-hangzhou。

wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh uninstall

以管理员身份运行Windows PowerShell或cmd进入logtail_installer目录（安装包的解压目录），执行如下命令。

.\logtail_installer.exe uninstall

卸载成功后，您的Logtail的安装目录会被删除，但仍有部分配置被保留在C:\LogtailData目录中，您可以根据实际情况进行手动删除。遗留信息包括：

checkpoint：存放所有Logtail插件的Checkpoint信息。只有您使用了Logtail插件后，才会出现此文件。
user_config.d：存放本地采集配置的目录。
其中以.json结尾的文件会被视为采集配置，格式类似于/usr/local/ilogtail/user_log_config.json。
logtail_check_point：存放Logtail主体部分的Checkpoint信息。
users：存放您所配置的用户标识文件。

容器场景

安装Logtail组件

当您使用的是ACK集群且集群与日志服务属于同一个阿里云账号时，参考ACK集群安装方式。若使用自建集群或ACK集群与日志服务属于不同的阿里云账号，请参考自建集群安装方式。

ACK集群安装方式

自建集群安装方式

重要

此操作仅适用于专有版Kubernetes和托管版Kubernetes。

为已有的ACK集群安装Logtail组件

新建ACK集群时安装Logtail组件

登录容器服务管理控制台。
在集群列表页面中，单击目标集群最右侧的更多 > 运维管理 > 组件管理
在日志与监控页签中，找到logtail-ds，然后单击安装。

安装完成后，日志服务会自动生成名k8s-log-${your_k8s_cluster_id}的Project，并在该Project下生成名为k8s-group-${your_k8s_cluster_id}的机器组和名为config-operation-log的Logstore。

重要

请勿删除名为config-operation-log的Logstore。

登录容器服务管理控制台。
在左侧导航栏中，单击集群列表。
在集群列表页面中，单击创建集群。
在组件配置配置项页中，选中使用日志服务。
说明
本操作仅介绍开启日志服务的关键步骤。关于创建集群的具体操作，请参见创建ACK托管集群。
当选中使用日志服务后，会出现创建项目（Project）的提示。关于日志服务管理日志的组织结构，请参见项目（Project）。有以下两种创建Project方式。
- 使用已有Project
  您可以选择一个已有的Project来管理采集到的容器日志。
- 创建新Project
  日志服务自动创建一个Project来管理采集到的容器日志。其中ClusterID为您新建的Kubernetes集群的唯一标识。

登录日志服务控制台。
创建Project。具体操作，请参见创建项目Project。
建议创建一个以k8s-log-custom-开头的Project，例如k8s-log-custom-sd89ehdq。
登录您的Kubernetes集群。

执行如下命令安装Logtail及其他依赖组件。

重要

请确保用于执行脚本的机器中，已安装kubectl命令。
目前，alibaba-log-controller组件只支持Kubernetes 1.6及以上版本。

下载安装包并解压。

中国地域

wget https://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/kubernetes/0.5.3/alibaba-cloud-log-all.tgz; tar xvf alibaba-cloud-log-all.tgz; chmod 744 ./alibaba-cloud-log-all/k8s-custom-install.sh

海外地域

wget https://logtail-release-ap-southeast-1.oss-ap-southeast-1.aliyuncs.com/kubernetes/0.5.3/alibaba-cloud-log-all.tgz; tar xvf alibaba-cloud-log-all.tgz; chmod 744 ./alibaba-cloud-log-all/k8s-custom-install.sh

修改配置文件./alibaba-cloud-log-all/values.yaml。

# ===================== 必需要补充的内容 =====================
# 目标Project名称。
SlsProjectName: 
# Project所属地域。
Region: 
# Project所属阿里云账号ID，需使用双引号（""）包裹。
AliUid: "11**99"
# 阿里云账号或RAM用户的AccessKey ID和AccessKey Secret，需具备AliyunLogFullAccess权限。
AccessKeyID: 
AccessKeySercret: 
# 自定义集群ID，命名只支持大小写，数字，短划线(-)。
ClusterID: 
# ==========================================================
# 是否开启指标采集相关组件，可选参数: true、false, 默认true。
SlsMonitoring: true
# 网络类型，可选参数：Internet、Intranet，默认使用Internet。
Net: Internet
# 容器运行时是否为containerd，可选参数: true, false, 默认false。
SLS_CONTAINERD_USED: true

命令中各参数说明如下所示，请根据实际情况替换。

参数	说明
`SlsProjectName`	配置为您在步骤2中创建的Project名称。
`Region`	您的Project所在的地域ID。例如华东1（杭州）的地域ID为`cn-hangzhou`。更多信息，请参见开服地域。
`AliUid`	Project所属账号的阿里云账号（主账号）ID，需使用双引号包裹（""），例如`AliUid: "11**99"`。如何获取，请参见获取日志服务所在的阿里云账号（主账号）ID。
`AccessKeyID`	Project所属账号的阿里云账号的AccessKey ID。推荐使用RAM用户的AccessKey，并授予RAM用户AliyunLogFullAccess权限。相关操作，请参见创建RAM用户及授权。
`AccessKeySercret`	Project所属账号的阿里云账号的AccessKey Secret。推荐使用RAM用户的AccessKey并授予RAM用户AliyunLogFullAccess权限。相关操作，请参见创建RAM用户及授权。
`ClusterID`	自定义集群ID，命名只支持大小写字母、数字、短划线(-)。该参数对应后面操作中的`${your_k8s_cluster_id}`。重要不同的Kubernetes集群，请勿配置相同的集群ID。
`SlsMonitoring`	是否开启指标采集相关组件，可选项： true（默认值）：开启。 false：不开启。
`Net`	网络类型。网络类型选择请参见网络选择的示例。可选项： Internet（默认值）：公网。 Intranet：内网。
`SLS_CONTAINERD_USED`	容器运行时是否为containerd，可选项： true：开启。 false（默认值）：不开启。重要在使用containerd作为容器运行时的自建Kubernetes集群中，若未开启相关参数，可能导致日志无法被Logtail采集。

安装Logtail及其他依赖组件。

bash ./alibaba-cloud-log-all/k8s-custom-install.sh; kubectl apply -R -f result

安装完成后，在该Project下自动创建如下日志服务资源。

重要

请勿删除名为config-operation-log的Logstore。
在自建Kubernetes集群上安装时，默认为Logtail授予privileged权限，主要为避免删除其他Pod时可能出现的container text file busy错误。更多信息，请参见Bug 1468249、Bug 1441737和 issue 34538。

资源类型	资源名称	作用	示例
机器组	k8s-group-${your_k8s_cluster_id}	logtail-daemonset的机器组，主要用于日志采集场景。	k8s-group-my-cluster-123
	k8s-group-${your_k8s_cluster_id}-statefulset	logtail-statefulset的机器组，主要用于指标采集场景。	k8s-group-my-cluster-123-statefulset
	k8s-group-${your_k8s_cluster_id}-singleton	单实例机器组，主要用于部分单实例采集配置。	k8s-group-my-cluster-123-singleton
Logstore	config-operation-log	用于采集和存储log-controller日志。	无

查看Logtail状态、版本及IP地址

运行如下命令，查看Logtail状态。

kubectl get po -n kube-system | grep logtail

返回结果如下：

NAME            READY     STATUS    RESTARTS   AGE
logtail-ds-gb92k   1/1       Running   0          2h
logtail-ds-wm7lw   1/1       Running   0          4d

运行如下命令，查看Logtail的版本号、IP地址等信息。

kubectl exec logtail-ds-gb92k -n kube-system cat /usr/local/ilogtail/app_info.json

返回结果如下：

{
   "hostname" : "logtail-ds-gb92k",
   "instance_id" : "0EBB2B0E-0A3B-11E8-B0CE-0A58AC140402_172.20.4.2_1517810940",
   "ip" : "192.0.2.0",
   "logtail_version" : "0.16.2",
   "os" : "Linux; 3.10.0-693.2.2.el7.x86_64; #1 SMP Tue Sep 12 22:26:13 UTC 2017; x86_64",
   "update_time" : "2021-02-05 06:09:01"
}

升级与回滚Logtail

在升级前，您需要对Logtail组件相关描述文件进行备份。

重要

升级期间（数秒内），因Logtail容器重启，可能出现少量数据被重复或丢失采集的情况。

kubectl get ds -n kube-system logtail-ds -o yaml > logtail-ds.yaml
kubectl get deployment -n kube-system alibaba-log-controller -o yaml > alibaba-log-controller.yaml
kubectl get crd aliyunlogconfigs.log.alibabacloud.com -o yaml > aliyunlogconfigs-crd.yaml
kubectl get cm -n kube-system alibaba-log-configuration -o yaml > alibaba-log-configuration.yaml
kubectl get aliyunlogconfigs --all-namespaces -o yaml > aliyunlogconfigs-cr.yaml

请根据集群情况选择组件升级方式，当您使用的是ACK集群且集群与日志服务属于同一个阿里云账号时，参考ACK集群升级方式。若使用自建集群或ACK集群与日志服务属于不同的阿里云账号，请参考自建集群升级方式。
ACK集群升级方式
自建集群升级方式
一般情况下，推荐您使用自动升级方式。如果您在logtail-ds的DaemonSet中或者在alibaba-log-controller的Deployment中修改过参数（例如环境变量），那么为了使您的修改不被重置，请使用手动升级方式。
自动升级
手动升级
升级Logtail latest版本
重要
自动升级会重置您在logtail-ds和alibaba-log-controller中手动修改的配置。
登录容器服务管理控制台。
在集群列表页面中，单击目标集群最右侧的更多 > 运维管理 > 组件管理
在日志与监控页签中，找到logtail-ds，然后单击升级。
在升级组件对话框中，单击确定。
重要
如果无法升级到最新版本的Logtail，说明您的Kubernetes集群版本太旧。请先升级Kubernetes集群或者使用手动升级方式。
执行升级操作后，您可以在容器服务管理控制台上查看logtail-ds pod状态。如果logtail-ds pod状态都为running，表示升级成功。
重要
手动升级不会根据最新版本的Logtail组件更新您的配置，部分特性优化可能不可用。
手动升级包括升级logtail-ds和alibaba-log-controller。一般情况下，您只需要升级logtail-ds即可获取新版本Logtail提供的采集能力。当您需要获取新版Logtail CRD方式的采集能力时，需要升级alibaba-log-controller。以下步骤以logtail-ds为例。
登录容器服务管理控制台。
在集群列表页面中，单击目标集群最右侧的更多 > 运维管理 > 组件管理
选择工作负载 > 守护进程集。
说明
当您要升级alibaba-log-controller时，请选择工作负载 > 无状态，然后在kube-system命名空间下，找到alibaba-log-controller，完成升级。
选择命名空间为kube-system，然后单击logtail-ds对应的编辑。
检查如下环境变量是否存在。
如果不存在ALIYUN_LOGTAIL_CONFIG、ALIYUN_LOGTAIL_USER_ID、ALIYUN_LOGTAIL_USER_DEFINED_ID这三个环境变量，可能是因为您的Logtail版本太旧，您可以提交工单咨询升级方法。
单击镜像Tag对应的选择镜像Tag。
在镜像Tag对话框中，单击最新版本，然后单击确定。
在页面右侧，单击更新。
执行升级操作后，您可以在容器服务管理控制台上查看logtail-ds pod状态。如果logtail-ds pod状态都为running，表示升级成功。
由于Logtail latest版本对应的YAML文件太旧，当您使用该版本时，升级和体验新功能都可能遇到问题，推荐您升级到最新版本。操作步骤如下：
存储已有的AliyunLogConfig CRD。
请根据实际情况替换log-crds.yaml。

kubectl get AliyunLogConfig -A -o yaml > log-crds.yaml

卸载logtail-ds组件。
在阿里云容器服务管理控制台的日志与监控页签中，找到logtail-ds，然后单击卸载。具体操作入口，请参见卸载Logtail。
安装logtail-ds组件。
在阿里云容器服务管理控制台的日志与监控页签中，找到logtail-ds，然后单击安装。具体操作入口，请参见安装Logtail组件。
部署您已存储的AliyunLogConfig CRD。
请根据实际情况替换log-crds.yaml。

kubectl apply -f log-crds.yaml
说明
建议通过安装最新Logtail组件进行更新，如果只更新部分组件（如logtail-ds、alibaba-log-controller）的镜像版本号可能导致升级失败。
重新安装Logtail组件，即可完成自动升级。具体操作，请参见安装Logtail组件。

如果您要回滚到某个版本，可参考如下步骤。

说明

升级前备份的YAML文件中包含不少冗余信息，需要您手动删除后，才能用于恢复Logtail配置。您可以使用kubectl-neat工具完成此操作。需要删除的字段为metadata.creationTimestamp、metadata.generation、metadata.resourceVersion、metadata.uid和status。

根据业务需求判断升级之后的新Logtail配置是否需要保留。
如果不需要保留，则可以删除升级之后的新Logtail配置。

删除备份文件中的冗余信息。

cat logtail-ds.yaml | kubectl-neat > neat-logtail-ds.yaml
cat alibaba-log-controller.yaml | kubectl-neat > neat-alibaba-log-controller.yaml
cat aliyunlogconfigs-crd.yaml | kubectl-neat > neat-aliyunlogconfigs-crd.yaml
cat alibaba-log-configuration.yaml | kubectl-neat > neat-alibaba-log-configuration.yaml
cat aliyunlogconfigs-cr.yaml | kubectl-neat > neat-aliyunlogconfigs-cr.yaml

应用精简后的备份文件，恢复Logtail配置。

kubectl apply -f neat-logtail-ds.yaml
kubectl apply -f neat-alibaba-log-controller.yaml
kubectl apply -f neat-aliyunlogconfigs-crd.yaml
kubectl apply -f neat-alibaba-log-configuration.yaml
kubectl apply -f neat-aliyunlogconfigs-cr.yaml

卸载Logtail

请根据集群情况选择组件卸载方式，当您使用的是ACK集群且集群与日志服务属于同一个阿里云账号时，参考ACK集群卸载方式。若使用自建集群或ACK集群与日志服务属于不同的阿里云账号，请参考自建集群卸载方式。

ACK集群卸载方式

自建集群卸载方式

登录容器服务管理控制台。
在集群列表页面中，单击目标集群最右侧的更多 > 运维管理 > 组件管理
在日志与监控页签中，找到logtail-ds，然后单击卸载。
根据界面提示单击确定，完成卸载。

如何卸载已安装的logtail-ds、alibaba-log-controller等组件？

执行kubectl delete -R -f result卸载已安装的logtail-ds、alibaba-log-controller等组件。

集群常见问题

如何查看镜像版本？

您可以通过镜像仓库查看。

多个Kubernetes集群如何共用一个日志服务Project？

如果您希望将多个集群中的容器日志采集到同一个日志服务Project中，安装其他集群日志服务组件时，将安装参数中的设置与您第一次安装集群日志服务组件时保持一致。

如何查看Logtail日志？

Logtail日志存储在Logtail容器中的/usr/local/ilogtail/目录中，文件名为ilogtail.LOG和logtail_plugin.LOG。

Logtail容器中的标准输出并不具备参考意义，请忽略以下标准输出内容。

start umount useless mount points, /shm$|/merged$|/mqueue$
umount: /logtail_host/var/lib/docker/overlay2/3fd0043af174cb0273c3c7869500fbe2bdb95d13b1e110172ef57fe840c82155/merged: must be superuser to unmount
umount: /logtail_host/var/lib/docker/overlay2/d5b10aa19399992755de1f85d25009528daa749c1bf8c16edff44beab6e69718/merged: must be superuser to unmount
umount: /logtail_host/var/lib/docker/overlay2/5c3125daddacedec29df72ad0c52fac800cd56c6e880dc4e8a640b1e16c22dbe/merged: must be superuser to unmount
......
xargs: umount: exited with status 255; aborting
umount done
start logtail
ilogtail is running
logtail status:
ilogtail is running

如何查看Kubernetes集群中日志服务相关组件的状态？

执行如下命令进行查看。

kubectl get deploy alibaba-log-controller -n kube-system
kubectl get ds logtail-ds -n kube-system

alibaba-log-controller启动失败，该怎么处理？

请确认您是否按照以下方式进行安装。

在Kubernetes集群的Master节点中执行安装命令。
安装命令参数中输入的是您的集群ID。

如果由于以上问题安装失败，请使用kubectl delete -f deploy命令删除已生成的安装模板并重新执行安装命令。

如何查看Kubernetes集群中Logtail-ds DaemonSet状态？

执行kubectl get ds -n kube-system命令查看Logtail-ds DaemonSet状态。

说明

Logtail容器所在的命名空间，默认为kube-system。

如何查看Logtail的运行日志？

Logtail运行日志保存在/usr/local/ilogtail/目录下，文件名为ilogtail.LOG，轮转文件会压缩存储为ilogtail.LOG.x.gz。例如执行如下命令查看日志。

kubectl exec logtail-ds-gb92k -n kube-system tail /usr/local/ilogtail/ilogtail.LOG

返回结果如下：

[2018-02-05 06:09:02.168693] [INFO] [9] [build/release64/sls/ilogtail/LogtailPlugin.cpp:104] logtail plugin Resume:start
[2018-02-05 06:09:02.168807] [INFO] [9] [build/release64/sls/ilogtail/LogtailPlugin.cpp:106] logtail plugin Resume:success
[2018-02-05 06:09:02.168822] [INFO] [9] [build/release64/sls/ilogtail/EventDispatcher.cpp:369] start add existed check point events, size:0
[2018-02-05 06:09:02.168827] [INFO] [9] [build/release64/sls/ilogtail/EventDispatcher.cpp:511] add existed check point events, size:0 cache size:0 event size:0 success count:0

如何重启某个Pod中的Logtail？

停止Logtail。
其中logtail-ds-gb92k表示容器名，kube-system表示命名空间，请根据实际情况替换。

kubectl exec logtail-ds-gb92k -n kube-system /etc/init.d/ilogtaild stop

返回如下结果表示停止成功。

kill process Name: ilogtail pid: 7
kill process Name: ilogtail pid: 9
stop success

启动Logtail。
其中logtail-ds-gb92k表示容器名，kube-system表示命名空间，请根据实际情况替换。

kubectl exec logtail-ds-gb92k -n kube-system /etc/init.d/ilogtaild start

返回如下结果表示启动成功。

ilogtail is running

关于阿里云

阿里云全球基础设施

快速入门

全球办事处

2024年巴黎奥运会 New

罗兰加洛斯球场 - 岁月沉淀的辉煌 New

协和广场 - “打破”障碍 New

马恩河畔韦尔水上运动体育场 - 可持续的体育运动 New

国际广播中心 - 优质图像、声音和数据触达数十亿观众 New

客户成功案例 New

阿里云信任中心

合规计划

云合规资源

合规常见问题

云产品快报 New

Cloud Forward

新闻报道

阿里云电子期刊 New

阿里云调研分析报告

公告

阿里云出海业务 New

“橙”云出海服务联盟

Asia Accelerator Hot

信息合规

China Gateway - MLPS 2.0 合规 New

China Gateway - 网络

China Gateway - 全球应用加速 New

China Gateway - 安全

China Gateway - 数据安全 New

ICP支持服务 Hot

China Gateway - 全域数据中台 New

China Gateway - 一方数据中台 New

China Gateway - 业务中台 New

China Gateway - 智能客服解决方案 New

China Gateway - 在线教育

China Gateway - 域名注册

在阿里云工作

经验丰富的专业人士

学生和毕业生

免费试用

定价

优惠中心

降价

花钱更少，部署更多

FinOps

云服务器 ECS

轻量应用服务器 SAS

GPU 云服务器

无影云电脑 EDS

对象存储 OSS

云企业网 CEN

Web 应用防火墙 WAF

域名

容器计算服务 ACS

办公安全平台 SASE

智能媒体服务 IMS

边缘安全加速 ESA（原DCDN）

智能媒体管理 IMM

专属钉钉

宜搭

大模型服务平台（百炼）

Apsara Prime - 轻松选择云产品

阿里云 ECS-满足您所有云主机需求

1TB CDN — 立即获取免费的 1 TB 出站流量套餐

安全 — 受到攻击？ 获取免费安全支持

短信服务 - 现已免费开放测试

云服务器 ECS Hot

云盒

计算巢服务

专有宿主机 Hot

弹性裸金属服务器（神龙）

GPU 云服务器 Featured

轻量应用服务器 SAS Hot

弹性伸缩

无影云手机 Beta

无影云电脑 EDS Featured

批量计算

弹性高性能计算 E-HPC

超级计算集群 SCC

函数计算 FC

安全 — 受到攻击？获取免费安全支持