当您的应用出现异常情况的时候,可以通过查看实例和应用级别的日志来排查问题。EDAS提供了日志目录收藏、日志查看、日志搜索和日志下线的功能。

收藏日志目录

日志目录页面包含 EDAS 相关的默认日志目录,您可以收藏(添加)应用日志目录。收藏日志之后即可查看该目录下的实例日志,详情请参见查看实例日志

在收藏日志目录时还可以将该目录添加到日志服务,以便在日志搜索页面查看和搜索该目录下的应用日志。

说明 收藏目录和取消收藏仅对日志目录可用。
  1. 登录 EDAS 控制台
  2. 在左侧导航栏中选择应用管理 > 应用列表 ,在应用列表页面单击具体的应用名称。
  3. 在应用详情页面左侧的导航栏中选择日志管理 > 日志目录,然后在日志目录页面单击收藏目录
  4. 收藏目录对话框中输入应用日志目录,选择是否将该目录添加到日志服务,然后单击添加
    输入应用日志目录时,请遵循以下要求:
    • 此目录必须在 /home/admin 目录下。
    • 完整目录中必须包含 log 或者 logs
    • 目录最后必须以斜杠 /结尾,表示添加的是一个文件夹。

查看实例日志

在收藏了应用日志后,可以查看实例和应用级别的日志。

  1. 在应用详情页面左侧导航栏中选择日志管理 > 日志目录
  2. 日志目录页面单击日志目录左侧的展开按钮 >,然后在展开的日志文件列表的操作列单击查看
    查看日志目录
    说明 日志框架配置的文件下的日志文件除了可以查看日志详细信息,还可以修改该日志文件的级别。 日志级别由低到高依次为:TRACE、DEBUG、INFO、WARN 和 ERROR。修改后,系统会将所设置的级别及更高级别的日志显示在页面下方。
  3. 实时日志页面顶部单击 ECS 实例 ID/名称/IP 右侧的下拉箭头,选择实例,查看该实例中的日志详细信息。
    查看实时日志详细信息
    在页面右下角单击开启实时追加,可以一直加载文件的最新追加内容(类似于tailf命令的效果)。

将日志目录或文件添加到日志服务

日志服务提供了查看和搜索应用日志的功能。将日志目录或文件添加到日志服务后,即可查看和搜索应用日志。

在将日志目录或文件添加到日志服务时,还可以指定项目(Project )日志库(Logstore)

  • 如果您已经在日志服务中创建了 Project 和 Logstore,可以使用已有的 Project 和 Logstore。
  • 如果您未在日志服务中创建 Project 和 Logstore,可以新建 Project 和 Logstore。EDAS 将按edas-logstore-<日志文件的绝对路径>格式为您创建 Logstore,如a-homeadminlogs
说明 如果您为 RAM 用户,请先由云账号为 RAM 用户授权,详情请参见为 RAM 用户授予日志服务权限
  1. 在应用详情页面左侧导航栏中选择日志管理 > 日志目录
  2. 日志目录页面选择日志目录或文件,然后单击添加到日志服务
    如果您将日志目录添加到日志服务,则该目录下的日志文件默认都添加到日志服务中。您只能基于该日志目录进行分布式搜索,而不能再对该目录下的具体日志文件进行分布式搜索。如果您想对具体日志文件进行分布式搜索,建议不要将整个目录添加到日志服务中。
  3. 添加到日志服务对话框中确认日志目录并设置参数,然后单击确定
    添加到日志服务
    • 应用日志目录:选择的日志目录,不可修改。
    • 来源方式选择新建
      • Project:输入 Project 名称,推荐格式为edas-project-<region-id-timestamp>,如edas-project-cn-qingdao-
      • Logstore:EDAS 将自动按edas-logstore-<日志文件的绝对路径>命名方式为您创建 Logstore,如a-homeadminlogs
      • 日志路径:如果您需要当前目录下的部分日志文件,可以输入文件名的关键字或完整文件名。设置后,当前目录中所有层级路径中的的所有匹配该文件名或文件关键字的称的文件都会被监控采集。文件名称可以是完整名,也支持通配符模式匹配。
    • 来源方式选择使用已有
      • Project:在下拉列表中选择已创建的 Project。
      • Logstore:在下拉列表中选择已创建的 Logstore。
      • 日志路径:如果您需要当前目录下的部分日志文件,可以输入文件名的关键字或完整文件名。设置后,当前目录中所有层级路径中的的所有匹配该文件名或文件关键字的称的文件都会被监控采集。文件名称可以是完整名,也支持通配符模式匹配。

查看应用日志并进行分布式搜索

已收藏过该应用日志目录,并将该目录或文件添加到日志服务后,可以查看应用日志并进行分布式搜索。

说明 如果您为 RAM 用户,请先由云账号为 RAM 用户授权,详情请参见为 RAM 用户授予日志服务权限
  1. 在应用详情页面左侧导航栏中选择日志管理 > 日志搜索
    如果已经将某个日志文件添加到日志服务,也可以在日志目录页面日志文件列表的操作列单击搜索
  2. 日志搜索页面日志文件右侧单击下拉箭头,在下拉列表中选择日志目录或日志文件。
  3. 查看应用日志。
    查看应用日志包括原始日志日志聚类LiveTail统计图表
  4. 输入关键字,对应用日志内容进行分布式搜索。

为 RAM 用户授予日志服务权限

如果您是 RAM 用户,需要通过子账号使用日志服务(包括将日志目录或文件添加到日志服务和查看应用日志和分布式搜索),还需要由云账号(主账号)在访问控制 RAM 中为 RAM 用户授权。操作步骤如下:

  1. 使用云账号登录RAM访问控制控制台
  2. 在左侧导航栏中单击用户,然后在用户页面的用户列表中找到您要授权的 RAM 用户,如 doctest,在操作列单击添加权限
    RAM访问控制查找用户
  3. 添加权限页面选择权限下面的系统权限策略右侧的文本框输入log,单击AliyunLogReadOnlyAccess将该权限添加到右侧列表中,单击确定
    说明 被授权主体会默认加载,无需设置。如果您需要同时给多个 RAM 用户授权,在被授权主体下面的文本框通过关键字搜索并添加。
    给RAM用户添加权限
  4. 授权结果页面查看 RAM 用户和被授权的权限,确认无误后,单击完成

将指定日志目录或文件从日志服务中移除

将指定日志目录或文件从日志服务中移除。移除仅仅是从日志服务中移除,实际的日志目录和文件仍然存在,并未删除。包含两个动作:

  • 将日志目录或文件从日志服务的采集规则中移除:移除后,日志服务将不再采集新的数据。

  • 将日志目录或文件从日志服务的采集规则中移除,并删除日志服务中的关联对象:移除后,日志服务将不再采集新的数据。并且当关联对象(Project 和 Logstore)不再被其它应用使用时,将会被从日志服务中移除。该操作将会导致 Logstore 中的数据被删除且无法回滚。

说明 默认日志目录不可以从日志服务中移除。
  1. 日志目录页面选中某个日志目录或文件,然后单击从日志服务中移除
  2. 从日志服务中移除对话框中确认要移除的日志目录或文件,并根据实际需求勾选或不勾选删除日志服务中的关联对象,然后单击确定
    删除日志服务中的关联对象将删除关联对象(Project 和 Logstore),即 Logstore 中的数据被删除。

取消收藏日志目录

取消收藏日志目录即移除指定的应用日志目录。移除后,该日志目录将不再显示在日志目录页面上,也不能再查看该目录下的实例日志,但并不会删除实际的日志目录及文件。

说明 默认目录也可以取消收藏。

在取消收藏日志目录时,还可以选择并从日志服务中移除

  • 如果未从日志服务中移除,则可以查看该目录下的原有应用日志。
  • 如果从日志服务中删除,则不能再查看该目录下的应用日志。
  • 日志目录页面选中某个日志目录,然后单击取消收藏
  • 取消收藏日志目录对话框中,确认要取消收藏的日志目录,选择是否并从日志服务中移除,单击确定