安装、运行、升级、卸载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云助手功能：简单易用，直接通过命令的方式执行临时任务。具体操作步骤如下所示：

1. 登录ECS管理控制台。

2. 在左侧导航栏，选择运维与监控 > 云助手。

3. 在页面左侧顶部，选择目标资源所在的资源组和地域。

4. 选择您要安装Logtail的ECS服务器，并单击发送命令。

5. 确认云助手是在线状态（如果不是在线状态，请参见安装云助手Agent，完成云助手安装。），并单击下一步。

6. 在脚本编辑框中输入安装命令（此处以公网安装方式为例，更多安装命令，请参见安装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状态及版本

cat /usr/local/ilogtail/app_info.json

{
   "logtail_version" : "0.16.30",
}

{
    "logtail_version" : "1.0.0.0"
}

升级Logtail

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

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

.\logtail_installer.exe uninstall

容器场景

安装Logtail组件

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

查看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

1. 在升级前，您需要对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

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

   ACK集群升级方式

   自建集群升级方式

   一般情况下，推荐您使用自动升级方式。如果您在logtail-ds的DaemonSet中或者在alibaba-log-controller的Deployment中修改过参数（例如环境变量），那么为了使您的修改不被重置，请使用手动升级方式。

   自动升级

   手动升级

   升级Logtail latest版本

   重要

   自动升级会重置您在logtail-ds和alibaba-log-controller中手动修改的配置。

   1. 登录容器服务管理控制台。

   2. 在集群列表页面中，单击目标集群最右侧的更多 > 运维管理 > 组件管理

   3. 在日志与监控页签中，找到logtail-ds，然后单击升级。

   4. 在升级组件对话框中，单击确定。

      重要

      如果无法升级到最新版本的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为例。

   1. 登录容器服务管理控制台。

   2. 在集群列表页面中，单击目标集群最右侧的更多 > 运维管理 > 组件管理

   3. 选择工作负载 > 守护进程集。

      说明

      当您要升级alibaba-log-controller时，请选择工作负载 > 无状态，然后在kube-system命名空间下，找到alibaba-log-controller，完成升级。

   4. 选择命名空间为kube-system，然后单击logtail-ds对应的编辑。

   5. 检查如下环境变量是否存在。

      如果不存在ALIYUN_LOGTAIL_CONFIG、ALIYUN_LOGTAIL_USER_ID、ALIYUN_LOGTAIL_USER_DEFINED_ID这三个环境变量，可能是因为您的Logtail版本太旧，您可以提交工单咨询升级方法。

   6. 单击镜像Tag对应的选择镜像Tag。

   7. 在镜像Tag对话框中，单击最新版本，然后单击确定。

   8. 在页面右侧，单击更新。

      执行升级操作后，您可以在容器服务管理控制台上查看logtail-ds pod状态。如果logtail-ds pod状态都为running，表示升级成功。

   由于Logtail latest版本对应的YAML文件太旧，当您使用该版本时，升级和体验新功能都可能遇到问题，推荐您升级到最新版本。操作步骤如下：

   1. 存储已有的AliyunLogConfig CRD。

      请根据实际情况替换log-crds.yaml。

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

   2. 卸载logtail-ds组件。

      在阿里云容器服务管理控制台的日志与监控页签中，找到logtail-ds，然后单击卸载。具体操作入口，请参见卸载Logtail。

   3. 安装logtail-ds组件。

      在阿里云容器服务管理控制台的日志与监控页签中，找到logtail-ds，然后单击安装。具体操作入口，请参见安装Logtail组件。

   4. 部署您已存储的AliyunLogConfig CRD。

      请根据实际情况替换log-crds.yaml。

      kubectl apply -f  log-crds.yaml

   说明

   建议通过安装最新Logtail组件进行更新，如果只更新部分组件（如logtail-ds、alibaba-log-controller）的镜像版本号可能导致升级失败。

   重新安装Logtail组件，即可完成自动升级。具体操作，请参见安装Logtail组件。

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

   说明

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

   1. 根据业务需求判断升级之后的新Logtail配置是否需要保留。

      如果不需要保留，则可以删除升级之后的新Logtail配置。

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

      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

   3. 应用精简后的备份文件，恢复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集群与日志服务属于不同的阿里云账号，请参考自建集群卸载方式。

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

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

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