EC2Launch v2 故障排除 - Amazon Elastic Compute Cloud
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

EC2Launch v2 故障排除

本节介绍了 EC2Launch v2 的常见故障排除场景以及有关查看 Windows 事件日志的信息。

常见故障排除场景

本节介绍常见的故障排除场景和解决步骤。

服务无法设置壁纸

解析

  1. 确保存在 %AppData%\Roaming\Microsoft\Windows\Start Menu\Programs\Startup\setwallpaper.lnk

  2. 检查 %ProgramData%\Amazon\EC2Launch\log\agent.log 是否发生任何错误。

服务无法运行用户数据

可能的原因:服务可能在运行用户数据之前失败。

解析

  1. 检查 %ProgramData%\Amazon\EC2Launch\state\previous-state.json

  2. 查看 bootnetworkpreReadypostReadyLocalData 是否全部标记为成功。

  3. 如果其中一个阶段失败,请检查 %ProgramData%\Amazon\EC2Launch\log\agent.log 中的具体错误。

服务只执行一次任务

解析

  1. 检查任务的频率。

  2. 如果服务已在 Sysprep 之后运行,并且任务频率设置为 once,则该任务不会再次运行。

  3. 如果您希望任务在每次运行 EC2Launch v2 时运行,请将任务的频率设置为 always

服务无法运行任务

解析

  1. 检查 %ProgramData%\Amazon\EC2Launch\log\agent.log 中的最新条目。

  2. 如果没有发生错误,请尝试从 %ProgramFiles%\Amazon\EC2Launch\EC2Launch.exe 手动运行服务以查看任务是否成功。

Windows 事件日志

EC2Launch v2 发布重要事件的 Windows 事件日志,例如服务启动、Windows 已就绪以及任务成功和失败。事件标识符唯一标识特定事件。每个事件都包含阶段、任务和级别信息以及描述。您可以使用事件标识符为特定事件设置触发器。

事件 ID 格式

下表显示了 EC2Launch v2 事件标识符的格式。

3 2 1 0

S

T

L

表中的字母和数字代表以下事件类型和定义。

Event type 定义

S(阶段)

0 – 服务级别消息

1 – Boot

2 – Network

3 – PreReady

5 – Windows 准备就绪

6 – Postready

7 – UserData

T(任务)

由相应的两个值表示的任务在每个阶段都不同。要查看事件的完整列表,请参阅 Windows 事件日志架构

L(事件级别)

0 – 成功

1 – 信息性

2 – 警告

3 – 错误

事件 ID 示例

以下是示例事件 ID。

  • 5000 – Windows 已准备好使用

  • 3010 – PreReady 阶段中的激活 Windows 任务已成功执行

  • 6013 – Postready 本地数据阶段中的设置壁纸任务遇到错误

Windows 事件日志架构

消息/事件 ID 事件消息

. . .0

Success

. . .1

Informational

. . .2

Warning

. . .3

Error

x

EC2Launch service-level logs

0

EC2Launch Service exited successfully

1

EC2Launch Service starting

2

Error stopping EC2Launch service

10

Replace state.json with previous-state.json
100 Serial Port
200 Sysprep
300 PrimaryNic
400 Metadata

x000

Stage (1 digit), Task (2 digits), Status (1 digit)

1000

Boot

1010

Boot - extend_root_partition
2000 Network

2010

Network - add_routes

3000

PreReady

3010

PreReady - activate_windows

3020

PreReady - install_egpu_manager

3030

PreReady - set_monitor_on

3040

PreReady - set_hibernation

3050

PreReady - set_admin_account

3060

PreReady - set_dns_suffix

3070

PreReady - set_wallpaper

3080

PreReady - set_update_schedule

3090

PreReady - output_log

3100

PreReady - enable_open_ssh

5000

Windows is Ready to use

6000

PostReadyLocalData
7000 PostReadyUserData

6010/7010

PostReadyLocal/UserData - set_wallpaper

6020/7020

PostReadyLocal/UserData - set_update_schedule

6030/7030

PostReadyLocal/UserData - set_hostname

6040/7040

PostReadyLocal/UserData - execute_program

6050/7050

PostReadyLocal/UserData - execute_script

6060/7060

PostReadyLocal/UserData - manage_package

6070/7070

PostReadyLocal/UserData - initialize_volume

6080/7080

PostReadyLocal/UserData - write_file

6090/7090

PostReadyLocal/UserData - start_ssm

7100

PostReadyUserData - enable_open_ssh

6110/7110

PostReadyLocal/UserData - enable_jumbo_frames