阿里云首页 弹性容器实例

开启Core dump

本文介绍如何开启Core dump,以便在容器异常终止时查看分析Core dump文件,找出问题原因。

背景信息

在Linux中,如果程序突然异常终止或者崩溃时,操作系统会将程序当时的内存状态记录下来,保存在一个文件中,这种行为就叫做Core dump。此时,您可以查看分析Core dump文件,找出问题原因。

Linux中支持Core dump(Action为Core)的Signal如下图所示。

更多信息,请参见Core dump file

功能概述

ECI默认关闭Core dump,避免磁盘占用过多而导致业务不可用。您可以根据需要选择以下一种方式了开启Core dump:

  • 方式一:开启Core dump运维任务

    手动开启Core dump后,将生成一个运维任务。在容器运行异常终止或者退出时,触发Core dump生成的core文件将自动保存到OSS中。

  • 方式二:自定义设置core文件保存路径

    支持自定义设置core文件保存到外挂存储中,设置保存路径后,将自动开启Core dump。在容器运行异常终止或者退出时,触发Core dump生成的core文件,将保存到指定的外挂存储的路径下。

说明

  • 方式一便于操作,但有时效和地域限制,可用于临时调试和诊断程序。

    • 方式一生成的运维任务为一次性任务,执行成功获取到一次Core文件后,将会关闭Core dump,并且运维任务有一定的期限(12小时),超出时间后任务将会失效。

    • 方式一基于阿里云对象存储OSS和消息服务MNS,因此ECI支持的地域中,以下不支持OOS和MMS的地域暂不支持使用该方式:华北2(北京)、华北6(乌兰察布)、华南2(河源)、华南3(广州)、华东5(南京)。

  • 方式二需要额外配置外挂存储,在程序运行状态不稳定的情况下,可以采用该方式确保能够获取到core文件,但如果程序有问题,反复重启可能会产生大量core文件。

方式一:开启Core dump运维任务

控制台

  1. 登录弹性容器实例控制台,创建一个ECI实例。

  2. 开启Core dump。

    1. 单击实例ID打开实例详情页面。

    2. 单击运维页签,然后单击开启

      单击开启后,将生成一个运维任务,未触发Core dump时,任务状态为等待中

      开启coredump
  3. 触发Core dump。

    在容器内执行sleep 100命令后同时按Ctrl键和\键,触发Core dump,生成的core文件将自动保存到OSS中。coredump2

  4. 下载core文件。

    在实例详情页的运维页签下,可以查看Core dump对应的运维任务。触发Core dump生成core文件后,运维任务的状态将变为成功,此时单击对应结果列中的下载即可下载core文件到本地。

    coredump3

    如果下载没有反应,请检查浏览器的网站权限设置。例如Chrome浏览器可以参考以下方式开启权限:

    1. 打开弹性容器实例控制台,单击浏览器地址栏前面的浏览器图标图标,选择网站设置浏览器设置1

    2. 将配置项不安全内容改为允许浏览器设置2

OpenAPI

  1. 创建一个ECI实例。

    调用CreateContainerGroup接口创建ECI实例时,请勿设置CorePattern。

  2. 开启Core dump。

    调用CreateInstanceOpsTask接口创建运维任务,将OpsType设为coredump,OpsValue设为enable,即可开启Core dump。更多信息,请参见CreateInstanceOpsTask

  3. 触发Core dump。

    在容器内执行sleep 100命令后同时按Ctrl键和\键,触发Core dump,生成的core文件将自动保存到OSS中。coredump2

  4. 下载Core文件。

    调用DescribeInstanceOpsRecords接口查看运维任务的结果,从返回信息的ResultContent中,可以获取core文件保存在OSS中的地址,访问该地址即可下载core文件。

方式二:自定义设置core文件保存路径

配置说明

ECI支持自定义设置core文件保存路径,设置后将自动开启Core dump。core文件一般用于离线分析问题,因此设置core文件的保存路径时,一般采用外挂存储,而不是保存在容器本地路径,避免容器退出而丢失core文件。配置方式如下:

注意

配置的路径不能以|开头,即不能通过Core dump来配置可执行程序。

  • OpenAPI

    调用CreateContainerGroup接口创建ECI实例时,可传入CorePattern参数来设置core文件保存路径:

    CorePattern = "/xx/xx/core"
  • Kubernetes

    创建Pod时,可添加如下Annotation来设置core文件保存路径:

    annotations:
        k8s.aliyun.com/eci-core-pattern: "/xx/xx/core"

配置示例

以OpenAPI场景,挂载NAS作为外挂存储为例:

  1. 创建一台ECI实例A,挂载NAS并设置core文件保存路径。

    调用CreateContainerGroup接口创建ECI实例A时传入以下参数,将NAS的/dump/目录挂载到容器的/data/dump-a/目录,将core文件保存路径设置为/data/dump/core

    'Volume.1.Name': 'volume1',
    'Volume.1.Type': 'NFSVolume',
    'Volume.1.NFSVolume.Path': '/dump/',
    'Volume.1.NFSVolume.Server': '143b24****-gfn3.cn-beijing.nas.aliyuncs.com',
    
    'Container.1.VolumeMount.1.Name': 'volume1',
    'Container.1.VolumeMount.1.MountPath': '/data/dump-a/',
    
    'CorePattern':'/data/dump-a/core',
  2. 在实例A的容器任意目录下触发Core dump。

    如下示例,在容器内执行sleep 100命令后同时按Ctrl键和\键,触发Core dump后,core文件已保存到容器的/data/dump-a/路径下。

    coredump4
  3. 释放ECI实例A。

  4. 将同一NAS挂载到另一台ECI实例B。

    调用CreateContainerGroup接口创建ECI实例B时传入以下参数,将同一NAS的/dump/目录挂载到容器的/data/dump-b/目录。

    'Volume.1.Name': 'volume1',
    'Volume.1.Type': 'NFSVolume',
    'Volume.1.NFSVolume.Path': '/dump/',
    'Volume.1.NFSVolume.Server': '143b24****-gfn3.cn-beijing.nas.aliyuncs.com',
    
    'Container.1.VolumeMount.1.Name': 'dvolume1',
    'Container.1.VolumeMount.1.MountPath': '/data/dump-b/',
  5. 在实例B的容器中查看core文件。

    如下示例,在容器的/data/dump-b/路径下可以看到core文件,core文件保存到外挂存储后,并没有随着实例A的释放而丢失,您仍可以查看分析core文件。

    coredump5