阿里云首页 弹性容器实例

开启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
首页 弹性容器实例 容器配置 开启Core dump